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"
}Endpoint: POST /api/VbtApi/GetIncomingDespatchAdviceListByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<SearchRequestModel>
<Skip>0</Skip>
<Take>100</Take>
<OrderByName>IssueDate</OrderByName>
<OrderByType>DESC</OrderByType>
<Query>
<IssueDate>
<StartDate>2026-08-01T00:00:00+03:00</StartDate>
<EndDate>2026-08-01T23:59:59+03:00</EndDate>
</IssueDate>
<IsErpProcessed>false</IsErpProcessed>
</Query>
</SearchRequestModel>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
}Endpoint: POST /api/VbtApi/UpdateIncomingDespatchAdviceErpProcessStatusByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<DespatchAdviceErpProcessRequestModel>
<Ettn>aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee</Ettn>
<ErpProcessBranch>MERKEZ</ErpProcessBranch>
<IsErpProcessed>true</IsErpProcessed>
</DespatchAdviceErpProcessRequestModel>Tam Kabul Yanıtı
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" }
}
]
}Endpoint: POST /api/VbtApi/AddOutgoingReceiptAdviceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<ReceiptAdviceRequestModel>
<Id>0</Id>
<ReceiptAdviceExternalId>ERP-RCP-20260801-0001</ReceiptAdviceExternalId>
<IsOocumentNumberIncluded>false</IsOocumentNumberIncluded>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-08-01T15:00:00+03:00</IssueDate>
<LineCountNumeric>1</LineCountNumeric>
<DespatchDocumentReference>
<Id>aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee</Id>
<IssueDate>2026-08-01T09:00:00+03:00</IssueDate>
<DocumentType>DESPATCHADVICE</DocumentType>
</DespatchDocumentReference>
<ReceiptLine>
<ReceiptLineRequestModel>
<Id>1</Id>
<ReceivedQuantity>
<UnitCode>C62</UnitCode>
<Value>10</Value>
</ReceivedQuantity>
<ReceivedDate>2026-08-01T14:45:00+03:00</ReceivedDate>
<DespatchLineReference>
<LineId>1</LineId>
</DespatchLineReference>
<Item>
<Name>Örnek Ürün</Name>
</Item>
</ReceiptLineRequestModel>
</ReceiptLine>
</ReceiptAdviceRequestModel>Endpoint: POST /api/VbtApi/AddOutgoingReceiptAdviceByUbl
Body: ReceiptAdviceUblRequestModel (JSON); aşağıdaki UBL, FileBytes içeriğidir.
İmzasız UBL: cac:Signature imza üstverisidir; bu örnekte kriptografik ds:Signature yoktur. Dosya için IsSigned=false kullanılmalıdır. XML doğrudan HTTP body değildir; UTF-8 dosya byte’ları JSON taşıma modelinin FileBytes alanında Base64 gönderilir.
<?xml version="1.0" encoding="utf-8"?>
<ReceiptAdvice xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2" xmlns:ext="urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2" xmlns="urn:oasis:names:specification:ubl:schema:xsd:ReceiptAdvice-2">
<ext:UBLExtensions>
<ext:UBLExtension>
<ext:ExtensionContent />
</ext:UBLExtension>
</ext:UBLExtensions>
<cbc:UBLVersionID>2.1</cbc:UBLVersionID>
<cbc:CustomizationID>TR1.2.1</cbc:CustomizationID>
<cbc:ProfileID>TEMELIRSALIYE</cbc:ProfileID>
<cbc:ID>RCP2026000000001</cbc:ID>
<cbc:CopyIndicator>false</cbc:CopyIndicator>
<cbc:UUID>66666666-7777-8888-9999-000000000001</cbc:UUID>
<cbc:IssueDate>2026-08-01</cbc:IssueDate>
<cbc:IssueTime>15:00:00</cbc:IssueTime>
<cbc:ReceiptAdviceTypeCode>SEVK</cbc:ReceiptAdviceTypeCode>
<cbc:LineCountNumeric>1</cbc:LineCountNumeric>
<cac:DespatchDocumentReference>
<cbc:ID>aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee</cbc:ID>
<cbc:IssueDate>2026-08-01</cbc:IssueDate>
<cbc:DocumentType>DESPATCHADVICE</cbc:DocumentType>
</cac:DespatchDocumentReference>
<cac:Signature>
<cbc:ID schemeID="VKN_TCKN">9876543210</cbc:ID>
<cac:SignatoryParty>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">9876543210</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Örnek Alıcı Ltd. Şti.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Teslim Sokak</cbc:StreetName>
<cbc:BuildingNumber>25</cbc:BuildingNumber>
<cbc:CitySubdivisionName>Çankaya</cbc:CitySubdivisionName>
<cbc:CityName>Ankara</cbc:CityName>
<cbc:PostalZone>06550</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>TR</cbc:IdentificationCode>
<cbc:Name>Türkiye</cbc:Name>
</cac:Country>
</cac:PostalAddress>
</cac:SignatoryParty>
<cac:DigitalSignatureAttachment>
<cac:ExternalReference>
<cbc:URI>#Signature_RCP2026000000001</cbc:URI>
</cac:ExternalReference>
</cac:DigitalSignatureAttachment>
</cac:Signature>
<cac:DeliveryCustomerParty>
<cac:Party>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">9876543210</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Örnek Alıcı Ltd. Şti.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Teslim Sokak</cbc:StreetName>
<cbc:BuildingNumber>25</cbc:BuildingNumber>
<cbc:CitySubdivisionName>Çankaya</cbc:CitySubdivisionName>
<cbc:CityName>Ankara</cbc:CityName>
<cbc:PostalZone>06550</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>TR</cbc:IdentificationCode>
<cbc:Name>Türkiye</cbc:Name>
</cac:Country>
</cac:PostalAddress>
</cac:Party>
</cac:DeliveryCustomerParty>
<cac:DespatchSupplierParty>
<cac:Party>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1234567890</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Örnek Gönderici A.Ş.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Örnek Caddesi</cbc:StreetName>
<cbc:BuildingNumber>10</cbc:BuildingNumber>
<cbc:CitySubdivisionName>Kadıköy</cbc:CitySubdivisionName>
<cbc:CityName>İstanbul</cbc:CityName>
<cbc:PostalZone>34710</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>TR</cbc:IdentificationCode>
<cbc:Name>Türkiye</cbc:Name>
</cac:Country>
</cac:PostalAddress>
</cac:Party>
</cac:DespatchSupplierParty>
<cac:ReceiptLine>
<cbc:ID>1</cbc:ID>
<cbc:ReceivedQuantity unitCode="C62">10</cbc:ReceivedQuantity>
<cbc:RejectReasonCode />
<cbc:ReceivedDate>2026-08-01</cbc:ReceivedDate>
<cbc:TimingComplaintCode />
<cbc:TimingComplaint />
<cac:DespatchLineReference>
<cbc:LineID>1</cbc:LineID>
</cac:DespatchLineReference>
<cac:Item>
<cbc:Name>Örnek Ürün</cbc:Name>
</cac:Item>
</cac:ReceiptLine>
</ReceiptAdvice>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" }
}
]
}Endpoint: POST /api/VbtApi/AddOutgoingReceiptAdviceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<ReceiptAdviceRequestModel>
<Id>0</Id>
<ReceiptAdviceExternalId>ERP-RCP-20260801-0002</ReceiptAdviceExternalId>
<IsOocumentNumberIncluded>false</IsOocumentNumberIncluded>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-08-01T15:10:00+03:00</IssueDate>
<LineCountNumeric>1</LineCountNumeric>
<DespatchDocumentReference>
<Id>bbbbbbbb-cccc-dddd-eeee-ffffffffffff</Id>
<IssueDate>2026-08-01T10:00:00+03:00</IssueDate>
<DocumentType>DESPATCHADVICE</DocumentType>
</DespatchDocumentReference>
<ReceiptLine>
<ReceiptLineRequestModel>
<Id>1</Id>
<ReceivedQuantity>
<UnitCode>C62</UnitCode>
<Value>8</Value>
</ReceivedQuantity>
<ShortQuantity>
<UnitCode>C62</UnitCode>
<Value>2</Value>
</ShortQuantity>
<RejectReason>
<string>İki adet ürün teslim edilmedi.</string>
</RejectReason>
<ReceivedDate>2026-08-01T15:00:00+03:00</ReceivedDate>
<DespatchLineReference>
<LineId>1</LineId>
</DespatchLineReference>
<Item>
<Name>Örnek Ürün</Name>
</Item>
</ReceiptLineRequestModel>
</ReceiptLine>
</ReceiptAdviceRequestModel>Endpoint: POST /api/VbtApi/AddOutgoingReceiptAdviceByUbl
Body: ReceiptAdviceUblRequestModel (JSON); aşağıdaki UBL, FileBytes içeriğidir.
İmzasız UBL: cac:Signature imza üstverisidir; bu örnekte kriptografik ds:Signature yoktur. Dosya için IsSigned=false kullanılmalıdır. XML doğrudan HTTP body değildir; UTF-8 dosya byte’ları JSON taşıma modelinin FileBytes alanında Base64 gönderilir.
<?xml version="1.0" encoding="utf-8"?>
<ReceiptAdvice xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2" xmlns:ext="urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2" xmlns="urn:oasis:names:specification:ubl:schema:xsd:ReceiptAdvice-2">
<ext:UBLExtensions>
<ext:UBLExtension>
<ext:ExtensionContent />
</ext:UBLExtension>
</ext:UBLExtensions>
<cbc:UBLVersionID>2.1</cbc:UBLVersionID>
<cbc:CustomizationID>TR1.2.1</cbc:CustomizationID>
<cbc:ProfileID>TEMELIRSALIYE</cbc:ProfileID>
<cbc:ID>RCP2026000000002</cbc:ID>
<cbc:CopyIndicator>false</cbc:CopyIndicator>
<cbc:UUID>66666666-7777-8888-9999-000000000002</cbc:UUID>
<cbc:IssueDate>2026-08-01</cbc:IssueDate>
<cbc:IssueTime>15:10:00</cbc:IssueTime>
<cbc:ReceiptAdviceTypeCode>SEVK</cbc:ReceiptAdviceTypeCode>
<cbc:LineCountNumeric>1</cbc:LineCountNumeric>
<cac:DespatchDocumentReference>
<cbc:ID>bbbbbbbb-cccc-dddd-eeee-ffffffffffff</cbc:ID>
<cbc:IssueDate>2026-08-01</cbc:IssueDate>
<cbc:DocumentType>DESPATCHADVICE</cbc:DocumentType>
</cac:DespatchDocumentReference>
<cac:Signature>
<cbc:ID schemeID="VKN_TCKN">9876543210</cbc:ID>
<cac:SignatoryParty>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">9876543210</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Örnek Alıcı Ltd. Şti.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Teslim Sokak</cbc:StreetName>
<cbc:BuildingNumber>25</cbc:BuildingNumber>
<cbc:CitySubdivisionName>Çankaya</cbc:CitySubdivisionName>
<cbc:CityName>Ankara</cbc:CityName>
<cbc:PostalZone>06550</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>TR</cbc:IdentificationCode>
<cbc:Name>Türkiye</cbc:Name>
</cac:Country>
</cac:PostalAddress>
</cac:SignatoryParty>
<cac:DigitalSignatureAttachment>
<cac:ExternalReference>
<cbc:URI>#Signature_RCP2026000000002</cbc:URI>
</cac:ExternalReference>
</cac:DigitalSignatureAttachment>
</cac:Signature>
<cac:DeliveryCustomerParty>
<cac:Party>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">9876543210</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Örnek Alıcı Ltd. Şti.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Teslim Sokak</cbc:StreetName>
<cbc:BuildingNumber>25</cbc:BuildingNumber>
<cbc:CitySubdivisionName>Çankaya</cbc:CitySubdivisionName>
<cbc:CityName>Ankara</cbc:CityName>
<cbc:PostalZone>06550</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>TR</cbc:IdentificationCode>
<cbc:Name>Türkiye</cbc:Name>
</cac:Country>
</cac:PostalAddress>
</cac:Party>
</cac:DeliveryCustomerParty>
<cac:DespatchSupplierParty>
<cac:Party>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1234567890</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Örnek Gönderici A.Ş.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Örnek Caddesi</cbc:StreetName>
<cbc:BuildingNumber>10</cbc:BuildingNumber>
<cbc:CitySubdivisionName>Kadıköy</cbc:CitySubdivisionName>
<cbc:CityName>İstanbul</cbc:CityName>
<cbc:PostalZone>34710</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>TR</cbc:IdentificationCode>
<cbc:Name>Türkiye</cbc:Name>
</cac:Country>
</cac:PostalAddress>
</cac:Party>
</cac:DespatchSupplierParty>
<cac:ReceiptLine>
<cbc:ID>1</cbc:ID>
<cbc:ReceivedQuantity unitCode="C62">8</cbc:ReceivedQuantity>
<cbc:ShortQuantity unitCode="C62">2</cbc:ShortQuantity>
<cbc:RejectReasonCode />
<cbc:RejectReason>İki adet ürün teslim edilmedi.</cbc:RejectReason>
<cbc:ReceivedDate>2026-08-01</cbc:ReceivedDate>
<cbc:TimingComplaintCode />
<cbc:TimingComplaint />
<cac:DespatchLineReference>
<cbc:LineID>1</cbc:LineID>
</cac:DespatchLineReference>
<cac:Item>
<cbc:Name>Örnek Ürün</cbc:Name>
</cac:Item>
</cac:ReceiptLine>
</ReceiptAdvice>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" }
}
]
}Endpoint: POST /api/VbtApi/AddOutgoingReceiptAdviceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<ReceiptAdviceRequestModel>
<Id>0</Id>
<ReceiptAdviceExternalId>ERP-RCP-20260801-0003</ReceiptAdviceExternalId>
<IsOocumentNumberIncluded>false</IsOocumentNumberIncluded>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-08-01T15:20:00+03:00</IssueDate>
<LineCountNumeric>1</LineCountNumeric>
<DespatchDocumentReference>
<Id>cccccccc-dddd-eeee-ffff-000000000000</Id>
<IssueDate>2026-08-01T11:00:00+03:00</IssueDate>
<DocumentType>DESPATCHADVICE</DocumentType>
</DespatchDocumentReference>
<ReceiptLine>
<ReceiptLineRequestModel>
<Id>1</Id>
<ReceivedQuantity>
<UnitCode>C62</UnitCode>
<Value>0</Value>
</ReceivedQuantity>
<RejectedQuantity>
<UnitCode>C62</UnitCode>
<Value>10</Value>
</RejectedQuantity>
<RejectReason>
<string>Teslim sırasında ambalaj ve ürün hasarlıydı.</string>
</RejectReason>
<ReceivedDate>2026-08-01T15:15:00+03:00</ReceivedDate>
<DespatchLineReference>
<LineId>1</LineId>
</DespatchLineReference>
<Item>
<Name>Örnek Ürün</Name>
</Item>
</ReceiptLineRequestModel>
</ReceiptLine>
</ReceiptAdviceRequestModel>Endpoint: POST /api/VbtApi/AddOutgoingReceiptAdviceByUbl
Body: ReceiptAdviceUblRequestModel (JSON); aşağıdaki UBL, FileBytes içeriğidir.
İmzasız UBL: cac:Signature imza üstverisidir; bu örnekte kriptografik ds:Signature yoktur. Dosya için IsSigned=false kullanılmalıdır. XML doğrudan HTTP body değildir; UTF-8 dosya byte’ları JSON taşıma modelinin FileBytes alanında Base64 gönderilir.
<?xml version="1.0" encoding="utf-8"?>
<ReceiptAdvice xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2" xmlns:ext="urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2" xmlns="urn:oasis:names:specification:ubl:schema:xsd:ReceiptAdvice-2">
<ext:UBLExtensions>
<ext:UBLExtension>
<ext:ExtensionContent />
</ext:UBLExtension>
</ext:UBLExtensions>
<cbc:UBLVersionID>2.1</cbc:UBLVersionID>
<cbc:CustomizationID>TR1.2.1</cbc:CustomizationID>
<cbc:ProfileID>TEMELIRSALIYE</cbc:ProfileID>
<cbc:ID>RCP2026000000003</cbc:ID>
<cbc:CopyIndicator>false</cbc:CopyIndicator>
<cbc:UUID>66666666-7777-8888-9999-000000000003</cbc:UUID>
<cbc:IssueDate>2026-08-01</cbc:IssueDate>
<cbc:IssueTime>15:20:00</cbc:IssueTime>
<cbc:ReceiptAdviceTypeCode>SEVK</cbc:ReceiptAdviceTypeCode>
<cbc:LineCountNumeric>1</cbc:LineCountNumeric>
<cac:DespatchDocumentReference>
<cbc:ID>cccccccc-dddd-eeee-ffff-000000000000</cbc:ID>
<cbc:IssueDate>2026-08-01</cbc:IssueDate>
<cbc:DocumentType>DESPATCHADVICE</cbc:DocumentType>
</cac:DespatchDocumentReference>
<cac:Signature>
<cbc:ID schemeID="VKN_TCKN">9876543210</cbc:ID>
<cac:SignatoryParty>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">9876543210</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Örnek Alıcı Ltd. Şti.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Teslim Sokak</cbc:StreetName>
<cbc:BuildingNumber>25</cbc:BuildingNumber>
<cbc:CitySubdivisionName>Çankaya</cbc:CitySubdivisionName>
<cbc:CityName>Ankara</cbc:CityName>
<cbc:PostalZone>06550</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>TR</cbc:IdentificationCode>
<cbc:Name>Türkiye</cbc:Name>
</cac:Country>
</cac:PostalAddress>
</cac:SignatoryParty>
<cac:DigitalSignatureAttachment>
<cac:ExternalReference>
<cbc:URI>#Signature_RCP2026000000003</cbc:URI>
</cac:ExternalReference>
</cac:DigitalSignatureAttachment>
</cac:Signature>
<cac:DeliveryCustomerParty>
<cac:Party>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">9876543210</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Örnek Alıcı Ltd. Şti.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Teslim Sokak</cbc:StreetName>
<cbc:BuildingNumber>25</cbc:BuildingNumber>
<cbc:CitySubdivisionName>Çankaya</cbc:CitySubdivisionName>
<cbc:CityName>Ankara</cbc:CityName>
<cbc:PostalZone>06550</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>TR</cbc:IdentificationCode>
<cbc:Name>Türkiye</cbc:Name>
</cac:Country>
</cac:PostalAddress>
</cac:Party>
</cac:DeliveryCustomerParty>
<cac:DespatchSupplierParty>
<cac:Party>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1234567890</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Örnek Gönderici A.Ş.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Örnek Caddesi</cbc:StreetName>
<cbc:BuildingNumber>10</cbc:BuildingNumber>
<cbc:CitySubdivisionName>Kadıköy</cbc:CitySubdivisionName>
<cbc:CityName>İstanbul</cbc:CityName>
<cbc:PostalZone>34710</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>TR</cbc:IdentificationCode>
<cbc:Name>Türkiye</cbc:Name>
</cac:Country>
</cac:PostalAddress>
</cac:Party>
</cac:DespatchSupplierParty>
<cac:ReceiptLine>
<cbc:ID>1</cbc:ID>
<cbc:ReceivedQuantity unitCode="C62">0</cbc:ReceivedQuantity>
<cbc:RejectedQuantity unitCode="C62">10</cbc:RejectedQuantity>
<cbc:RejectReasonCode />
<cbc:RejectReason>Teslim sırasında ambalaj ve ürün hasarlıydı.</cbc:RejectReason>
<cbc:ReceivedDate>2026-08-01</cbc:ReceivedDate>
<cbc:TimingComplaintCode />
<cbc:TimingComplaint />
<cac:DespatchLineReference>
<cbc:LineID>1</cbc:LineID>
</cac:DespatchLineReference>
<cac:Item>
<cbc:Name>Örnek Ürün</cbc:Name>
</cac:Item>
</cac:ReceiptLine>
</ReceiptAdvice>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.
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/GetIncomingDespatchAdviceViewByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<DespatchAdviceViewRequestModel>
<Ettn>aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee</Ettn>
<IsRead>true</IsRead>
</DespatchAdviceViewRequestModel>Endpoint: POST /api/VbtApi/GetIncomingDespatchAdvicePdf
Body: DespatchAdvicePdfRequestModel (JSON)
{
"DespatchAdviceEttns": [
"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
]
}Endpoint: POST /api/VbtApi/GetIncomingDespatchAdvicePdfByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<DespatchAdvicePdfRequestModel>
<DespatchAdviceEttns>
<string>aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee</string>
</DespatchAdviceEttns>
</DespatchAdvicePdfRequestModel>Endpoint: POST /api/VbtApi/GetIncomingDespatchAdviceXmlList
Body: DespatchAdviceXmlRequestModel (JSON)
{
"DespatchAdviceEttns": [
"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
]
}Endpoint: POST /api/VbtApi/GetIncomingDespatchAdviceXmlListByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<DespatchAdviceXmlRequestModel>
<DespatchAdviceEttns>aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee</DespatchAdviceEttns>
</DespatchAdviceXmlRequestModel>