e-İrsaliye

Gelen İrsaliye

Gelen İrsaliye İşlem Örnekleri

Listeleme, ERP işleme ve çıktı alma için JSON/XML; kabul, kısmi kabul ve red için JSON, platform XML ve UBL yanıt örnekleri.

Yeni Gelen Belgeleri Listeleme

Endpoint: POST /api/VbtApi/GetIncomingDespatchAdviceList
Body: SearchRequestModel<IncomingDespatchAdviceGetRequestModel> (JSON)

{
  "Query": {
    "IssueDate": {
      "StartDate": "2026-08-01T00:00:00+03:00",
      "EndDate": "2026-08-01T23:59:59+03:00"
    },
    "IsErpProcessed": false
  },
  "Skip": 0,
  "Take": 100,
  "OrderByName": "IssueDate",
  "OrderByType": "DESC"
}

ERP İşleme Durumu

Bu çağrıyı yalnız ERP kaydı başarıyla tamamlandıktan sonra gönderin.

Endpoint: POST /api/VbtApi/UpdateIncomingDespatchAdviceErpProcessStatus
Body: DespatchAdviceErpProcessRequestModel (JSON)

{
  "Ettn": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "ErpProcessBranch": "MERKEZ",
  "IsErpProcessed": true
}

Tam Kabul Yanıtı

Yanıt penceresi: GİB uygulama kılavuzu irsaliye yanıtını fiili sevkten başlayan yedi günlük pencereyle sınırlar. Gelen belge response'undaki kalan süreyi izleyin; eksik teslim veya red varsa request'i süre dolmadan gönderin. Tam teslimde yanıt vermek isteğe bağlıdır.

Endpoint: POST /api/VbtApi/AddOutgoingReceiptAdvice
Body: ReceiptAdviceRequestModel (JSON)

{
  "ReceiptAdviceExternalId": "ERP-RCP-20260801-0001",
  "IssueDate": "2026-08-01T15:00:00+03:00",
  "CopyIndicator": false,
  "LineCountNumeric": 1,
  "IsDocumentNumberIncluded": false,
  "DespatchDocumentReference": {
    "Id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "IssueDate": "2026-08-01T09:00:00+03:00",
    "DocumentType": "DESPATCHADVICE"
  },
  "ReceiptLine": [
    {
      "Id": "1",
      "ReceivedQuantity": { "UnitCode": "C62", "Value": 10 },
      "ReceivedDate": "2026-08-01T14:45:00+03:00",
      "DespatchLineReference": { "LineId": "1" },
      "Item": { "Name": "Örnek Ürün" }
    }
  ]
}

Kısmi Kabul Yanıtı

Endpoint: POST /api/VbtApi/AddOutgoingReceiptAdvice
Body: ReceiptAdviceRequestModel (JSON)

{
  "ReceiptAdviceExternalId": "ERP-RCP-20260801-0002",
  "IssueDate": "2026-08-01T15:10:00+03:00",
  "CopyIndicator": false,
  "LineCountNumeric": 1,
  "IsDocumentNumberIncluded": false,
  "DespatchDocumentReference": {
    "Id": "bbbbbbbb-cccc-dddd-eeee-ffffffffffff",
    "IssueDate": "2026-08-01T10:00:00+03:00",
    "DocumentType": "DESPATCHADVICE"
  },
  "ReceiptLine": [
    {
      "Id": "1",
      "ReceivedQuantity": { "UnitCode": "C62", "Value": 8 },
      "ShortQuantity": { "UnitCode": "C62", "Value": 2 },
      "RejectReason": ["İki adet ürün teslim edilmedi."],
      "ReceivedDate": "2026-08-01T15:00:00+03:00",
      "DespatchLineReference": { "LineId": "1" },
      "Item": { "Name": "Örnek Ürün" }
    }
  ]
}

Red Yanıtı

Endpoint: POST /api/VbtApi/AddOutgoingReceiptAdvice
Body: ReceiptAdviceRequestModel (JSON)

{
  "ReceiptAdviceExternalId": "ERP-RCP-20260801-0003",
  "IssueDate": "2026-08-01T15:20:00+03:00",
  "CopyIndicator": false,
  "LineCountNumeric": 1,
  "IsDocumentNumberIncluded": false,
  "DespatchDocumentReference": {
    "Id": "cccccccc-dddd-eeee-ffff-000000000000",
    "IssueDate": "2026-08-01T11:00:00+03:00",
    "DocumentType": "DESPATCHADVICE"
  },
  "ReceiptLine": [
    {
      "Id": "1",
      "ReceivedQuantity": { "UnitCode": "C62", "Value": 0 },
      "RejectedQuantity": { "UnitCode": "C62", "Value": 10 },
      "RejectReason": ["Teslim sırasında ambalaj ve ürün hasarlıydı."],
      "ReceivedDate": "2026-08-01T15:15:00+03:00",
      "DespatchLineReference": { "LineId": "1" },
      "Item": { "Name": "Örnek Ürün" }
    }
  ]
}

Hazır UBL ile Yanıt Gönderme

POST /api/VbtApi/AddOutgoingReceiptAdviceByUbl, ReceiptAdviceUblRequestModel alır: FileBytes, IsZipped ve IsSigned. Tam kabul, kısmi kabul ve red için yukarıdaki UBL sekmelerinde tam ReceiptAdvice içeriği vardır. UBL elemanları ve alt bileşenleri ilgili GİB UBL-TR XSD’sindeki xs:sequence sırasına uymalıdır; gönderimden önce XSD ve şematron doğrulaması yapılmalıdır.

DespatchDocumentReference.Id, gerçek gelen irsaliyenin ETTN’si olmalıdır; yanıt kalemleri ve miktarlar o belgeyle eşleşmelidir. Bu giriş modeli ayrıca ReceiptAdviceExternalId veya ReceiverIdentifier almaz. Standart JSON/XML’deki dış referansın UBL’den otomatik geri kazanılacağını varsaymayın.

İmza davranışı: Hazır yanıt UBL’si modele çevrilip standart yanıt akışında yeniden üretilir. IsSigned bayrağı orijinal imzayı koruyan bir kabul yolu sağlamaz; örneklerde IsSigned=false kullanılır. İmzalı/imzasız işlem farkları.
using System;
using System.IO;
using Newtonsoft.Json;

var request = new
{
    FileBytes = Convert.ToBase64String(File.ReadAllBytes("yanit.xml")),
    IsSigned = false,
    IsZipped = false
};

string jsonBody = JsonConvert.SerializeObject(request);

Görsel, PDF ve UBL

Endpoint: POST /api/VbtApi/GetIncomingDespatchAdviceView
Body: DespatchAdviceViewRequestModel (JSON)

{
  "Ettn": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "IsRead": true
}

Endpoint: POST /api/VbtApi/GetIncomingDespatchAdvicePdf
Body: DespatchAdvicePdfRequestModel (JSON)

{
  "DespatchAdviceEttns": [
    "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
  ]
}

Endpoint: POST /api/VbtApi/GetIncomingDespatchAdviceXmlList
Body: DespatchAdviceXmlRequestModel (JSON)

{
  "DespatchAdviceEttns": [
    "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
  ]
}