Giden İrsaliye
Giden İrsaliye Request Örnekleri
Oluşturma, güncelleme, önizleme ve taşıma senaryoları için JSON, platform XML ve UBL örnekleri; İDİS veri kaynağı ve imza sınırları.
Örnekleri Kullanma
Her örnekte doğrudan çağıracağınız JSON endpointini, XML endpointini (ByXml) veya mevcut işlem için UBL içeriğini (ByUbl) seçebilirsiniz. Seçilen panel, tam endpoint yolunu ve o endpointin beklediği body sözleşmesini koddan önce gösterir. VKN, alıcı etiketi, dış referans, adres ve tarihleri test hesabınızdaki gerçek verilerle değiştirin.
OutgoingDespatchAdviceRequestModel serileştirmesidir. UBL-TR DespatchAdvice dosyası göndermek için ayrı ByUbl endpointini ve aşağıdaki Hazır UBL bölümünü kullanın.TEMELIRSALIYE — Request Endpointleri
Endpoint: POST /api/VbtApi/AddOutgoingDespatchAdvice
Body: OutgoingDespatchAdviceRequestModel (JSON)
{
"DespatchAdviceExternalId": "ERP-IRS-20260801-0001",
"ProfileId": "TEMELIRSALIYE",
"DocumentCurrencyCode": "TRY",
"CopyIndicator": false,
"IssueDate": "2026-08-01T09:00:00+03:00",
"DespatchAdviceTypeCode": "SEVK",
"Note": ["Sipariş SO-2026-1042 sevkiyatıdır."],
"LineCountNumeric": 1,
"ReceiverIdentifier": "urn:mail:defaultpk@alici.example",
"IsDocumentNumberIncluded": false,
"DespatchSupplierParty": {
"Party": {
"PartyIdentifications": [{ "SchemeId": "VKN", "Value": "1234567890" }],
"PartyName": "Örnek Gönderici A.Ş.",
"PostalAddress": {
"StreetName": "Örnek Caddesi",
"BuildingNumber": "10",
"CitySubdivisionName": "Kadıköy",
"CityName": "İstanbul",
"PostalZone": "34710",
"Country": { "Name": "Türkiye" }
}
}
},
"DeliveryCustomerParty": {
"Party": {
"PartyIdentifications": [{ "SchemeId": "VKN", "Value": "9876543210" }],
"PartyName": "Örnek Alıcı Ltd. Şti.",
"PostalAddress": {
"StreetName": "Teslim Sokak",
"BuildingNumber": "25",
"CitySubdivisionName": "Çankaya",
"CityName": "Ankara",
"PostalZone": "06550",
"Country": { "Name": "Türkiye" }
}
}
},
"Shipment": {
"Id": { "SchemeId": "", "Value": "SHP-20260801-0001" },
"Delivery": {
"DeliveryAddress": {
"StreetName": "Teslim Sokak",
"BuildingNumber": "25",
"CitySubdivisionName": "Çankaya",
"CityName": "Ankara",
"PostalZone": "06550",
"Country": { "Name": "Türkiye" }
},
"CarrierParty": {
"PartyIdentifications": [{ "SchemeId": "VKN", "Value": "1111111111" }],
"PartyName": "Örnek Lojistik A.Ş.", "PostalAddress": { "StreetName": "Taşıyıcı Caddesi", "BuildingNumber": "5", "CitySubdivisionName": "Çankaya", "CityName": "Ankara", "PostalZone": "06550", "Country": { "Name": "Türkiye" } }
},
"Despatch": {
"ActualDespatchDate": "2026-08-01T09:30:00+03:00",
"ActualDespatchTime": "09:30:00",
"DespatchAddress": {
"StreetName": "Çıkış Deposu Caddesi",
"BuildingNumber": "1",
"CitySubdivisionName": "Tuzla",
"CityName": "İstanbul",
"PostalZone": "34940",
"Country": { "Name": "Türkiye" }
}
}
}
},
"DespatchLine": [
{
"Id": "1",
"DeliveredQuantity": { "UnitCode": "C62", "Value": 10 },
"OrderLineReference": { "LineId": "1" },
"Item": { "Name": "Örnek Ürün", "SellersItemIdentification": "SKU-1001" }
}
]
}Endpoint: POST /api/VbtApi/AddOutgoingDespatchAdviceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingDespatchAdviceRequestModel>
<DespatchAdviceExternalId>ERP-IRS-20260801-0001</DespatchAdviceExternalId>
<ProfileId>TEMELIRSALIYE</ProfileId>
<DocumentCurrencyCode>TRY</DocumentCurrencyCode>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-08-01T09:00:00+03:00</IssueDate>
<DespatchAdviceTypeCode>SEVK</DespatchAdviceTypeCode>
<Note><string>Sipariş SO-2026-1042 sevkiyatıdır.</string></Note>
<LineCountNumeric>1</LineCountNumeric>
<DespatchSupplierParty><Party>
<PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>1234567890</Value></IdRequestModel></PartyIdentifications>
<PartyName>Örnek Gönderici A.Ş.</PartyName>
<PostalAddress><StreetName>Örnek Caddesi</StreetName><BuildingNumber>10</BuildingNumber><CitySubdivisionName>Kadıköy</CitySubdivisionName><CityName>İstanbul</CityName><PostalZone>34710</PostalZone><Country><Name>Türkiye</Name></Country></PostalAddress>
</Party></DespatchSupplierParty>
<DeliveryCustomerParty><Party>
<PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>9876543210</Value></IdRequestModel></PartyIdentifications>
<PartyName>Örnek Alıcı Ltd. Şti.</PartyName>
<PostalAddress><StreetName>Teslim Sokak</StreetName><BuildingNumber>25</BuildingNumber><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></PostalAddress>
</Party></DeliveryCustomerParty>
<Shipment>
<Id><SchemeId /><Value>SHP-20260801-0001</Value></Id>
<Delivery>
<DeliveryAddress><StreetName>Teslim Sokak</StreetName><BuildingNumber>25</BuildingNumber><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></DeliveryAddress>
<CarrierParty><PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>1111111111</Value></IdRequestModel></PartyIdentifications><PartyName>Örnek Lojistik A.Ş.</PartyName><PostalAddress><StreetName>Taşıyıcı Caddesi</StreetName><BuildingNumber>5</BuildingNumber><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></PostalAddress></CarrierParty>
<Despatch><ActualDespatchDate>2026-08-01T09:30:00+03:00</ActualDespatchDate><ActualDespatchTime>09:30:00</ActualDespatchTime><DespatchAddress><StreetName>Çıkış Deposu Caddesi</StreetName><BuildingNumber>1</BuildingNumber><CitySubdivisionName>Tuzla</CitySubdivisionName><CityName>İstanbul</CityName><PostalZone>34940</PostalZone><Country><Name>Türkiye</Name></Country></DespatchAddress></Despatch>
</Delivery>
</Shipment>
<DespatchLine><DespatchLineRequestModel><Id>1</Id><DeliveredQuantity><UnitCode>C62</UnitCode><Value>10</Value></DeliveredQuantity><OrderLineReference><LineId>1</LineId></OrderLineReference><Item><Name>Örnek Ürün</Name><SellersItemIdentification>SKU-1001</SellersItemIdentification></Item></DespatchLineRequestModel></DespatchLine>
<ReceiverIdentifier>urn:mail:defaultpk@alici.example</ReceiverIdentifier>
<IsOocumentNumberIncluded>false</IsOocumentNumberIncluded>
</OutgoingDespatchAdviceRequestModel>Endpoint: POST /api/VbtApi/AddOutgoingDespatchAdviceByUbl
Body: DespatchAdviceUblRequestModel (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"?>
<DespatchAdvice 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:DespatchAdvice-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>IRS2026000000001</cbc:ID>
<cbc:CopyIndicator>false</cbc:CopyIndicator>
<cbc:UUID>11111111-2222-3333-4444-555555555551</cbc:UUID>
<cbc:IssueDate>2026-08-01</cbc:IssueDate>
<cbc:IssueTime>09:00:00</cbc:IssueTime>
<cbc:DespatchAdviceTypeCode>SEVK</cbc:DespatchAdviceTypeCode>
<cbc:Note>Sipariş SO-2026-1042 sevkiyatıdır.</cbc:Note>
<cbc:LineCountNumeric>1</cbc:LineCountNumeric>
<cac:Signature>
<cbc:ID schemeID="VKN_TCKN">1234567890</cbc:ID>
<cac:SignatoryParty>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1234567890</cbc:ID>
</cac:PartyIdentification>
<cac:PostalAddress>
<cbc:StreetName>Örnek Caddesi</cbc:StreetName>
<cbc:CitySubdivisionName>Kadıköy</cbc:CitySubdivisionName>
<cbc:CityName>İstanbul</cbc:CityName>
<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_IRS2026000000001</cbc:URI>
</cac:ExternalReference>
</cac:DigitalSignatureAttachment>
</cac:Signature>
<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: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:Shipment>
<cbc:ID />
<cac:Delivery>
<cac:DeliveryAddress>
<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:DeliveryAddress>
<cac:CarrierParty>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1111111111</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Örnek Lojistik A.Ş.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Taşıyıcı Caddesi</cbc:StreetName>
<cbc:BuildingNumber>5</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:CarrierParty>
<cac:Despatch>
<cbc:ID />
<cbc:ActualDespatchDate>2026-08-01</cbc:ActualDespatchDate>
<cbc:ActualDespatchTime>09:30:00</cbc:ActualDespatchTime>
<cac:DespatchAddress>
<cbc:StreetName>Çıkış Deposu Caddesi</cbc:StreetName>
<cbc:BuildingNumber>1</cbc:BuildingNumber>
<cbc:CitySubdivisionName>Tuzla</cbc:CitySubdivisionName>
<cbc:CityName>İstanbul</cbc:CityName>
<cbc:PostalZone>34940</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>TR</cbc:IdentificationCode>
<cbc:Name>Türkiye</cbc:Name>
</cac:Country>
</cac:DespatchAddress>
</cac:Despatch>
</cac:Delivery>
</cac:Shipment>
<cac:DespatchLine>
<cbc:ID>1</cbc:ID>
<cbc:DeliveredQuantity unitCode="C62">10</cbc:DeliveredQuantity>
<cac:OrderLineReference>
<cbc:LineID>1</cbc:LineID>
<cbc:SalesOrderLineID />
</cac:OrderLineReference>
<cac:Item>
<cbc:Name>Örnek Ürün</cbc:Name>
<cac:SellersItemIdentification>
<cbc:ID>SKU-1001</cbc:ID>
</cac:SellersItemIdentification>
</cac:Item>
</cac:DespatchLine>
</DespatchAdvice>MATBUDAN — Request Endpointleri
Matbu dayanak numarası ve tarihiyle birlikte ProfileId=TEMELIRSALIYE ve DespatchAdviceTypeCode=MATBUDAN gönderilir.
Endpoint: POST /api/VbtApi/AddOutgoingDespatchAdvice
Body: OutgoingDespatchAdviceRequestModel (JSON)
{
"DespatchAdviceExternalId": "ERP-MATBU-20260801-0001",
"ProfileId": "TEMELIRSALIYE",
"DocumentCurrencyCode": "TRY",
"CopyIndicator": false,
"IssueDate": "2026-08-01T10:00:00+03:00",
"DespatchAdviceTypeCode": "MATBUDAN",
"LineCountNumeric": 1,
"ReceiverIdentifier": "urn:mail:defaultpk@alici.example",
"IsDocumentNumberIncluded": false,
"AdditionalDocumentReference": [
{ "Id": "MATBU-IRS-45821", "IssueDate": "2026-08-01T08:45:00+03:00", "DocumentType": "MATBU İRSALİYE" }
],
"DespatchSupplierParty": {
"Party": {
"PartyIdentifications": [{ "SchemeId": "VKN", "Value": "1234567890" }],
"PartyName": "Örnek Gönderici A.Ş.",
"PostalAddress": {
"StreetName": "Örnek Caddesi",
"BuildingNumber": "10",
"CitySubdivisionName": "Kadıköy",
"CityName": "İstanbul",
"PostalZone": "34710",
"Country": { "Name": "Türkiye" }
}
}
},
"DeliveryCustomerParty": {
"Party": {
"PartyIdentifications": [{ "SchemeId": "VKN", "Value": "9876543210" }],
"PartyName": "Örnek Alıcı Ltd. Şti.",
"PostalAddress": {
"StreetName": "Teslim Sokak",
"BuildingNumber": "25",
"CitySubdivisionName": "Çankaya",
"CityName": "Ankara",
"PostalZone": "06550",
"Country": { "Name": "Türkiye" }
}
}
},
"Shipment": {
"Id": { "SchemeId": "", "Value": "SHP-MATBU-0001" },
"Delivery": {
"DeliveryAddress": { "CitySubdivisionName": "Çankaya", "CityName": "Ankara", "PostalZone": "06550", "Country": { "Name": "Türkiye" } },
"CarrierParty": { "PartyIdentifications": [{ "SchemeId": "VKN", "Value": "1111111111" }], "PartyName": "Örnek Lojistik A.Ş.", "PostalAddress": { "StreetName": "Taşıyıcı Caddesi", "BuildingNumber": "5", "CitySubdivisionName": "Çankaya", "CityName": "Ankara", "PostalZone": "06550", "Country": { "Name": "Türkiye" } } },
"Despatch": { "ActualDespatchDate": "2026-08-01T09:00:00+03:00", "ActualDespatchTime": "09:00:00" }
}
},
"DespatchLine": [{ "Id": "1", "DeliveredQuantity": { "UnitCode": "C62", "Value": 4 }, "OrderLineReference": { "LineId": "1" }, "Item": { "Name": "Örnek Ürün" } }]
}Endpoint: POST /api/VbtApi/AddOutgoingDespatchAdviceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingDespatchAdviceRequestModel>
<DespatchAdviceExternalId>ERP-MATBU-20260801-0001</DespatchAdviceExternalId>
<ProfileId>TEMELIRSALIYE</ProfileId>
<DocumentCurrencyCode>TRY</DocumentCurrencyCode>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-08-01T10:00:00+03:00</IssueDate>
<DespatchAdviceTypeCode>MATBUDAN</DespatchAdviceTypeCode>
<LineCountNumeric>1</LineCountNumeric>
<AdditionalDocumentReference><DocumentReferenceRequestModel><Id>MATBU-IRS-45821</Id><IssueDate>2026-08-01T08:45:00+03:00</IssueDate><DocumentType>MATBU İRSALİYE</DocumentType></DocumentReferenceRequestModel></AdditionalDocumentReference>
<DespatchSupplierParty><Party>
<PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>1234567890</Value></IdRequestModel></PartyIdentifications>
<PartyName>Örnek Gönderici A.Ş.</PartyName>
<PostalAddress><StreetName>Örnek Caddesi</StreetName><BuildingNumber>10</BuildingNumber><CitySubdivisionName>Kadıköy</CitySubdivisionName><CityName>İstanbul</CityName><PostalZone>34710</PostalZone><Country><Name>Türkiye</Name></Country></PostalAddress>
</Party></DespatchSupplierParty>
<DeliveryCustomerParty><Party>
<PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>9876543210</Value></IdRequestModel></PartyIdentifications>
<PartyName>Örnek Alıcı Ltd. Şti.</PartyName>
<PostalAddress><StreetName>Teslim Sokak</StreetName><BuildingNumber>25</BuildingNumber><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></PostalAddress>
</Party></DeliveryCustomerParty>
<Shipment><Id><SchemeId /><Value>SHP-MATBU-0001</Value></Id><Delivery>
<DeliveryAddress><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></DeliveryAddress>
<CarrierParty><PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>1111111111</Value></IdRequestModel></PartyIdentifications><PartyName>Örnek Lojistik A.Ş.</PartyName><PostalAddress><StreetName>Taşıyıcı Caddesi</StreetName><BuildingNumber>5</BuildingNumber><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></PostalAddress></CarrierParty>
<Despatch><ActualDespatchDate>2026-08-01T09:00:00+03:00</ActualDespatchDate><ActualDespatchTime>09:00:00</ActualDespatchTime></Despatch>
</Delivery></Shipment>
<DespatchLine><DespatchLineRequestModel><Id>1</Id><DeliveredQuantity><UnitCode>C62</UnitCode><Value>4</Value></DeliveredQuantity><OrderLineReference><LineId>1</LineId></OrderLineReference><Item><Name>Örnek Ürün</Name></Item></DespatchLineRequestModel></DespatchLine>
<ReceiverIdentifier>urn:mail:defaultpk@alici.example</ReceiverIdentifier>
<IsOocumentNumberIncluded>false</IsOocumentNumberIncluded>
</OutgoingDespatchAdviceRequestModel>Endpoint: POST /api/VbtApi/AddOutgoingDespatchAdviceByUbl
Body: DespatchAdviceUblRequestModel (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"?>
<DespatchAdvice 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:DespatchAdvice-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>IRS2026000000002</cbc:ID>
<cbc:CopyIndicator>false</cbc:CopyIndicator>
<cbc:UUID>11111111-2222-3333-4444-555555555552</cbc:UUID>
<cbc:IssueDate>2026-08-01</cbc:IssueDate>
<cbc:IssueTime>10:00:00</cbc:IssueTime>
<cbc:DespatchAdviceTypeCode>MATBUDAN</cbc:DespatchAdviceTypeCode>
<cbc:LineCountNumeric>1</cbc:LineCountNumeric>
<cac:AdditionalDocumentReference>
<cbc:ID>MATBU-IRS-45821</cbc:ID>
<cbc:IssueDate>2026-08-01</cbc:IssueDate>
<cbc:DocumentType>MATBU İRSALİYE</cbc:DocumentType>
</cac:AdditionalDocumentReference>
<cac:Signature>
<cbc:ID schemeID="VKN_TCKN">1234567890</cbc:ID>
<cac:SignatoryParty>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1234567890</cbc:ID>
</cac:PartyIdentification>
<cac:PostalAddress>
<cbc:StreetName>Örnek Caddesi</cbc:StreetName>
<cbc:CitySubdivisionName>Kadıköy</cbc:CitySubdivisionName>
<cbc:CityName>İstanbul</cbc:CityName>
<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_IRS2026000000002</cbc:URI>
</cac:ExternalReference>
</cac:DigitalSignatureAttachment>
</cac:Signature>
<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: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:Shipment>
<cbc:ID />
<cac:Delivery>
<cac:DeliveryAddress>
<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:DeliveryAddress>
<cac:CarrierParty>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1111111111</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Örnek Lojistik A.Ş.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Taşıyıcı Caddesi</cbc:StreetName>
<cbc:BuildingNumber>5</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:CarrierParty>
<cac:Despatch>
<cbc:ID />
<cbc:ActualDespatchDate>2026-08-01</cbc:ActualDespatchDate>
<cbc:ActualDespatchTime>09:00:00</cbc:ActualDespatchTime>
</cac:Despatch>
</cac:Delivery>
</cac:Shipment>
<cac:DespatchLine>
<cbc:ID>1</cbc:ID>
<cbc:DeliveredQuantity unitCode="C62">4</cbc:DeliveredQuantity>
<cac:OrderLineReference>
<cbc:LineID>1</cbc:LineID>
<cbc:SalesOrderLineID />
</cac:OrderLineReference>
<cac:Item>
<cbc:Name>Örnek Ürün</cbc:Name>
</cac:Item>
</cac:DespatchLine>
</DespatchAdvice>IDISIRSALIYE — Yerli Araç ve Dorse
IdisSevkiyatNo hem SE-1234567 hem ES-1234567 değerini kabul eder. Araç ve dorse alanlarını Araç ve Dorse Kimliği kurallarına göre hazırlayın.Endpoint: POST /api/VbtApi/AddOutgoingDespatchAdvice
Body: OutgoingDespatchAdviceRequestModel (JSON)
{
"DespatchAdviceExternalId": "ERP-IDIS-20260801-0001",
"ProfileId": "IDISIRSALIYE",
"DocumentCurrencyCode": "TRY",
"CopyIndicator": false,
"IssueDate": "2026-08-01T11:00:00+03:00",
"DespatchAdviceTypeCode": "SEVK",
"LineCountNumeric": 1,
"ReceiverIdentifier": "urn:mail:defaultpk@alici.example",
"IsDocumentNumberIncluded": false,
"IdisSevkiyatNo": "ES-1234567",
"DespatchSupplierParty": {
"Party": {
"PartyIdentifications": [{ "SchemeId": "VKN", "Value": "1234567890" }],
"PartyName": "Örnek Gönderici A.Ş.",
"PostalAddress": {
"StreetName": "Örnek Caddesi",
"BuildingNumber": "10",
"CitySubdivisionName": "Kadıköy",
"CityName": "İstanbul",
"PostalZone": "34710",
"Country": { "Name": "Türkiye" }
}
}
},
"DeliveryCustomerParty": {
"Party": {
"PartyIdentifications": [{ "SchemeId": "VKN", "Value": "9876543210" }],
"PartyName": "Örnek Alıcı Ltd. Şti.",
"PostalAddress": {
"StreetName": "Teslim Sokak",
"BuildingNumber": "25",
"CitySubdivisionName": "Çankaya",
"CityName": "Ankara",
"PostalZone": "06550",
"Country": { "Name": "Türkiye" }
}
}
},
"Shipment": {
"Id": { "SchemeId": "", "Value": "SHP-IDIS-0001" },
"ShipmentStage": [
{
"TransportMeans": {
"RoadTransport": {
"LicensePlateId": { "SchemeId": "PLAKA", "Value": "34ABC123" }
}
}
}
],
"TransportHandlingUnit": [
{
"TransportEquipment": [
{ "Id": { "SchemeId": "DORSE", "Value": "06AB123" } }
]
}
],
"Delivery": {
"DeliveryAddress": { "CitySubdivisionName": "Çankaya", "CityName": "Ankara", "PostalZone": "06550", "Country": { "Name": "Türkiye" } },
"CarrierParty": { "PartyIdentifications": [{ "SchemeId": "VKN", "Value": "1111111111" }], "PartyName": "Örnek Lojistik A.Ş.", "PostalAddress": { "StreetName": "Taşıyıcı Caddesi", "BuildingNumber": "5", "CitySubdivisionName": "Çankaya", "CityName": "Ankara", "PostalZone": "06550", "Country": { "Name": "Türkiye" } } },
"Despatch": { "ActualDespatchDate": "2026-08-01T11:30:00+03:00", "ActualDespatchTime": "11:30:00" }
}
},
"DespatchLine": [
{
"Id": "1",
"DeliveredQuantity": { "UnitCode": "C62", "Value": 1 },
"OrderLineReference": { "LineId": "1" }, "Item": {
"Name": "İDİS Kapsamındaki Ürün",
"AdditionalItemIdentification": [{ "SchemeId": "ETIKETNO", "Value": "AB1234567" }]
}
}
]
}Endpoint: POST /api/VbtApi/AddOutgoingDespatchAdviceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingDespatchAdviceRequestModel>
<DespatchAdviceExternalId>ERP-IDIS-20260801-0001</DespatchAdviceExternalId>
<ProfileId>IDISIRSALIYE</ProfileId>
<DocumentCurrencyCode>TRY</DocumentCurrencyCode>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-08-01T11:00:00+03:00</IssueDate>
<DespatchAdviceTypeCode>SEVK</DespatchAdviceTypeCode>
<LineCountNumeric>1</LineCountNumeric>
<DespatchSupplierParty><Party><PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>1234567890</Value></IdRequestModel></PartyIdentifications><PartyName>Örnek Gönderici A.Ş.</PartyName><PostalAddress><StreetName>Örnek Caddesi</StreetName><BuildingNumber>10</BuildingNumber><CitySubdivisionName>Kadıköy</CitySubdivisionName><CityName>İstanbul</CityName><PostalZone>34710</PostalZone><Country><Name>Türkiye</Name></Country></PostalAddress></Party></DespatchSupplierParty>
<DeliveryCustomerParty><Party><PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>9876543210</Value></IdRequestModel></PartyIdentifications><PartyName>Örnek Alıcı Ltd. Şti.</PartyName><PostalAddress><StreetName>Teslim Sokak</StreetName><BuildingNumber>25</BuildingNumber><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></PostalAddress></Party></DeliveryCustomerParty>
<Shipment>
<Id><SchemeId /><Value>SHP-IDIS-0001</Value></Id>
<ShipmentStage><TransportMeans><RoadTransport><LicensePlateId><SchemeId>PLAKA</SchemeId><Value>34ABC123</Value></LicensePlateId></RoadTransport></TransportMeans></ShipmentStage>
<Delivery><DeliveryAddress><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></DeliveryAddress><CarrierParty><PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>1111111111</Value></IdRequestModel></PartyIdentifications><PartyName>Örnek Lojistik A.Ş.</PartyName><PostalAddress><StreetName>Taşıyıcı Caddesi</StreetName><BuildingNumber>5</BuildingNumber><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></PostalAddress></CarrierParty><Despatch><ActualDespatchDate>2026-08-01T11:30:00+03:00</ActualDespatchDate><ActualDespatchTime>11:30:00</ActualDespatchTime></Despatch></Delivery>
<TransportHandlingUnit><TransportHandlingUnitRequestModel><TransportEquipment><TransportEquipmentRequestModel><Id><SchemeId>DORSE</SchemeId><Value>06AB123</Value></Id></TransportEquipmentRequestModel></TransportEquipment></TransportHandlingUnitRequestModel></TransportHandlingUnit>
</Shipment>
<DespatchLine><DespatchLineRequestModel><Id>1</Id><DeliveredQuantity><UnitCode>C62</UnitCode><Value>1</Value></DeliveredQuantity><OrderLineReference><LineId>1</LineId></OrderLineReference><Item><Name>İDİS Kapsamındaki Ürün</Name><AdditionalItemIdentification><IdRequestModel><SchemeId>ETIKETNO</SchemeId><Value>AB1234567</Value></IdRequestModel></AdditionalItemIdentification></Item></DespatchLineRequestModel></DespatchLine>
<ReceiverIdentifier>urn:mail:defaultpk@alici.example</ReceiverIdentifier>
<IsOocumentNumberIncluded>false</IsOocumentNumberIncluded>
<IdisSevkiyatNo>ES-1234567</IdisSevkiyatNo>
</OutgoingDespatchAdviceRequestModel>Endpoint: POST /api/VbtApi/AddOutgoingDespatchAdviceByUbl
Body: DespatchAdviceUblRequestModel (JSON); aşağıdaki UBL, FileBytes içeriğidir.
DespatchSupplierParty altında schemeID="SEVKIYATNO" ile gerçek sevkiyat numarası bulunmalıdır. Hazır UBL kullanmadan önce hedef ortamınızda İDİS UBL girişinin desteklendiğini teyit edin; destek bilgisi yoksa JSON veya ByXml kullanın. Veri kaynağı ve gönderim koşulları.İ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"?>
<DespatchAdvice 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:DespatchAdvice-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>IDISIRSALIYE</cbc:ProfileID>
<cbc:ID>IRS2026000000003</cbc:ID>
<cbc:CopyIndicator>false</cbc:CopyIndicator>
<cbc:UUID>11111111-2222-3333-4444-555555555553</cbc:UUID>
<cbc:IssueDate>2026-08-01</cbc:IssueDate>
<cbc:IssueTime>11:00:00</cbc:IssueTime>
<cbc:DespatchAdviceTypeCode>SEVK</cbc:DespatchAdviceTypeCode>
<cbc:LineCountNumeric>1</cbc:LineCountNumeric>
<cac:Signature>
<cbc:ID schemeID="VKN_TCKN">1234567890</cbc:ID>
<cac:SignatoryParty>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1234567890</cbc:ID>
</cac:PartyIdentification>
<cac:PostalAddress>
<cbc:StreetName>Örnek Caddesi</cbc:StreetName>
<cbc:CitySubdivisionName>Kadıköy</cbc:CitySubdivisionName>
<cbc:CityName>İstanbul</cbc:CityName>
<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_IRS2026000000003</cbc:URI>
</cac:ExternalReference>
</cac:DigitalSignatureAttachment>
</cac:Signature>
<cac:DespatchSupplierParty>
<cac:Party>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1234567890</cbc:ID>
</cac:PartyIdentification>
<cac:PartyIdentification>
<cbc:ID schemeID="SEVKIYATNO">ES-1234567</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: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:Shipment>
<cbc:ID />
<cac:ShipmentStage>
<cac:TransportMeans>
<cac:RoadTransport>
<cbc:LicensePlateID schemeID="PLAKA">34ABC123</cbc:LicensePlateID>
</cac:RoadTransport>
</cac:TransportMeans>
</cac:ShipmentStage>
<cac:Delivery>
<cac:DeliveryAddress>
<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:DeliveryAddress>
<cac:CarrierParty>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1111111111</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Örnek Lojistik A.Ş.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Taşıyıcı Caddesi</cbc:StreetName>
<cbc:BuildingNumber>5</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:CarrierParty>
<cac:Despatch>
<cbc:ID />
<cbc:ActualDespatchDate>2026-08-01</cbc:ActualDespatchDate>
<cbc:ActualDespatchTime>11:30:00</cbc:ActualDespatchTime>
</cac:Despatch>
</cac:Delivery>
<cac:TransportHandlingUnit>
<cac:TransportEquipment>
<cbc:ID schemeID="DORSE">06AB123</cbc:ID>
</cac:TransportEquipment>
</cac:TransportHandlingUnit>
</cac:Shipment>
<cac:DespatchLine>
<cbc:ID>1</cbc:ID>
<cbc:DeliveredQuantity unitCode="C62">1</cbc:DeliveredQuantity>
<cac:OrderLineReference>
<cbc:LineID>1</cbc:LineID>
<cbc:SalesOrderLineID />
</cac:OrderLineReference>
<cac:Item>
<cbc:Name>İDİS Kapsamındaki Ürün</cbc:Name>
<cac:AdditionalItemIdentification>
<cbc:ID schemeID="ETIKETNO">AB1234567</cbc:ID>
</cac:AdditionalItemIdentification>
</cac:Item>
</cac:DespatchLine>
</DespatchAdvice>PLAKA, dorse kimliği DORSE şemasıyla gösterilir. Sürücü bilgisi gönderilmiyorsa araç plakası zorunlu değildir; araç veya dorse alanı gönderildiğinde şema ve değer yine doğrulanır. Sürücü gönderildiğinde aynı ShipmentStage içinde araç plakası da bulunmalıdır.IDISIRSALIYE — Yabancı Araç ve Dorse
Yabancı araç ve dorse değerlerinde yalnız büyük harf, rakam, alt çizgi ve tire kullanılır. Araç için YABANCIPLAKA, dorse için YABANCIDORSE veya YABANCIDORSEPLAKA gönderilir.
Endpoint: POST /api/VbtApi/AddOutgoingDespatchAdvice
Body: OutgoingDespatchAdviceRequestModel (JSON)
{
"DespatchAdviceExternalId": "ERP-IDIS-FOREIGN-20260801-0001",
"ProfileId": "IDISIRSALIYE",
"DocumentCurrencyCode": "TRY",
"CopyIndicator": false,
"IssueDate": "2026-08-01T12:00:00+03:00",
"DespatchAdviceTypeCode": "SEVK",
"LineCountNumeric": 1,
"ReceiverIdentifier": "urn:mail:defaultpk@alici.example",
"IsDocumentNumberIncluded": false,
"IdisSevkiyatNo": "SE-7654321",
"DespatchSupplierParty": {
"Party": {
"PartyIdentifications": [{ "SchemeId": "VKN", "Value": "1234567890" }],
"PartyName": "Örnek Gönderici A.Ş.",
"PostalAddress": { "CitySubdivisionName": "Kadıköy", "CityName": "İstanbul", "Country": { "Name": "Türkiye" } }
}
},
"DeliveryCustomerParty": {
"Party": {
"PartyIdentifications": [{ "SchemeId": "VKN", "Value": "9876543210" }],
"PartyName": "Örnek Alıcı Ltd. Şti.",
"PostalAddress": { "CitySubdivisionName": "Çankaya", "CityName": "Ankara", "Country": { "Name": "Türkiye" } }
}
},
"Shipment": {
"Id": { "SchemeId": "", "Value": "SHP-IDIS-FOREIGN-0001" },
"ShipmentStage": [{
"TransportMeans": { "RoadTransport": { "LicensePlateId": { "SchemeId": "YABANCIPLAKA", "Value": "DE-B1234" } } }
}],
"TransportHandlingUnit": [{
"TransportEquipment": [{ "Id": { "SchemeId": "YABANCIDORSEPLAKA", "Value": "BG-TRAILER-77" } }]
}],
"Delivery": {
"DeliveryAddress": { "CitySubdivisionName": "Çankaya", "CityName": "Ankara", "PostalZone": "06550", "Country": { "Name": "Türkiye" } },
"CarrierParty": { "PartyIdentifications": [{ "SchemeId": "VKN", "Value": "1111111111" }], "PartyName": "Örnek Lojistik A.Ş.", "PostalAddress": { "StreetName": "Taşıyıcı Caddesi", "BuildingNumber": "5", "CitySubdivisionName": "Çankaya", "CityName": "Ankara", "PostalZone": "06550", "Country": { "Name": "Türkiye" } } },
"Despatch": { "ActualDespatchDate": "2026-08-01T12:30:00+03:00", "ActualDespatchTime": "12:30:00" }
}
},
"DespatchLine": [{
"Id": "1",
"DeliveredQuantity": { "UnitCode": "C62", "Value": 1 },
"OrderLineReference": { "LineId": "1" }, "Item": { "Name": "İDİS İthal Ürün", "AdditionalItemIdentification": [{ "SchemeId": "ETIKETNO", "Value": "CD7654321" }] }
}]
}Endpoint: POST /api/VbtApi/AddOutgoingDespatchAdviceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingDespatchAdviceRequestModel>
<DespatchAdviceExternalId>ERP-IDIS-FOREIGN-20260801-0001</DespatchAdviceExternalId>
<ProfileId>IDISIRSALIYE</ProfileId>
<DocumentCurrencyCode>TRY</DocumentCurrencyCode>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-08-01T12:00:00+03:00</IssueDate>
<DespatchAdviceTypeCode>SEVK</DespatchAdviceTypeCode>
<LineCountNumeric>1</LineCountNumeric>
<DespatchSupplierParty><Party><PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>1234567890</Value></IdRequestModel></PartyIdentifications><PartyName>Örnek Gönderici A.Ş.</PartyName><PostalAddress><CitySubdivisionName>Kadıköy</CitySubdivisionName><CityName>İstanbul</CityName><Country><Name>Türkiye</Name></Country></PostalAddress></Party></DespatchSupplierParty>
<DeliveryCustomerParty><Party><PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>9876543210</Value></IdRequestModel></PartyIdentifications><PartyName>Örnek Alıcı Ltd. Şti.</PartyName><PostalAddress><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><Country><Name>Türkiye</Name></Country></PostalAddress></Party></DeliveryCustomerParty>
<Shipment>
<Id><SchemeId /><Value>SHP-IDIS-FOREIGN-0001</Value></Id>
<ShipmentStage><TransportMeans><RoadTransport><LicensePlateId><SchemeId>YABANCIPLAKA</SchemeId><Value>DE-B1234</Value></LicensePlateId></RoadTransport></TransportMeans></ShipmentStage>
<Delivery><DeliveryAddress><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></DeliveryAddress><CarrierParty><PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>1111111111</Value></IdRequestModel></PartyIdentifications><PartyName>Örnek Lojistik A.Ş.</PartyName><PostalAddress><StreetName>Taşıyıcı Caddesi</StreetName><BuildingNumber>5</BuildingNumber><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></PostalAddress></CarrierParty><Despatch><ActualDespatchDate>2026-08-01T12:30:00+03:00</ActualDespatchDate><ActualDespatchTime>12:30:00</ActualDespatchTime></Despatch></Delivery>
<TransportHandlingUnit><TransportHandlingUnitRequestModel><TransportEquipment><TransportEquipmentRequestModel><Id><SchemeId>YABANCIDORSEPLAKA</SchemeId><Value>BG-TRAILER-77</Value></Id></TransportEquipmentRequestModel></TransportEquipment></TransportHandlingUnitRequestModel></TransportHandlingUnit>
</Shipment>
<DespatchLine><DespatchLineRequestModel><Id>1</Id><DeliveredQuantity><UnitCode>C62</UnitCode><Value>1</Value></DeliveredQuantity><OrderLineReference><LineId>1</LineId></OrderLineReference><Item><Name>İDİS İthal Ürün</Name><AdditionalItemIdentification><IdRequestModel><SchemeId>ETIKETNO</SchemeId><Value>CD7654321</Value></IdRequestModel></AdditionalItemIdentification></Item></DespatchLineRequestModel></DespatchLine>
<ReceiverIdentifier>urn:mail:defaultpk@alici.example</ReceiverIdentifier>
<IsOocumentNumberIncluded>false</IsOocumentNumberIncluded>
<IdisSevkiyatNo>SE-7654321</IdisSevkiyatNo>
</OutgoingDespatchAdviceRequestModel>Endpoint: POST /api/VbtApi/AddOutgoingDespatchAdviceByUbl
Body: DespatchAdviceUblRequestModel (JSON); aşağıdaki UBL, FileBytes içeriğidir.
DespatchSupplierParty altında schemeID="SEVKIYATNO" ile gerçek sevkiyat numarası bulunmalıdır. Hazır UBL kullanmadan önce hedef ortamınızda İDİS UBL girişinin desteklendiğini teyit edin; destek bilgisi yoksa JSON veya ByXml kullanın. Veri kaynağı ve gönderim koşulları.İ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"?>
<DespatchAdvice 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:DespatchAdvice-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>IDISIRSALIYE</cbc:ProfileID>
<cbc:ID>IRS2026000000004</cbc:ID>
<cbc:CopyIndicator>false</cbc:CopyIndicator>
<cbc:UUID>11111111-2222-3333-4444-555555555554</cbc:UUID>
<cbc:IssueDate>2026-08-01</cbc:IssueDate>
<cbc:IssueTime>12:00:00</cbc:IssueTime>
<cbc:DespatchAdviceTypeCode>SEVK</cbc:DespatchAdviceTypeCode>
<cbc:LineCountNumeric>1</cbc:LineCountNumeric>
<cac:Signature>
<cbc:ID schemeID="VKN_TCKN">1234567890</cbc:ID>
<cac:SignatoryParty>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1234567890</cbc:ID>
</cac:PartyIdentification>
<cac:PostalAddress>
<cbc:StreetName>Örnek Caddesi</cbc:StreetName>
<cbc:CitySubdivisionName>Kadıköy</cbc:CitySubdivisionName>
<cbc:CityName>İstanbul</cbc:CityName>
<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_IRS2026000000004</cbc:URI>
</cac:ExternalReference>
</cac:DigitalSignatureAttachment>
</cac:Signature>
<cac:DespatchSupplierParty>
<cac:Party>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1234567890</cbc:ID>
</cac:PartyIdentification>
<cac:PartyIdentification>
<cbc:ID schemeID="SEVKIYATNO">SE-7654321</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Örnek Gönderici A.Ş.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:CitySubdivisionName>Kadıköy</cbc:CitySubdivisionName>
<cbc:CityName>İstanbul</cbc:CityName>
<cac:Country>
<cbc:IdentificationCode>TR</cbc:IdentificationCode>
<cbc:Name>Türkiye</cbc:Name>
</cac:Country>
</cac:PostalAddress>
</cac:Party>
</cac:DespatchSupplierParty>
<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:CitySubdivisionName>Çankaya</cbc:CitySubdivisionName>
<cbc:CityName>Ankara</cbc:CityName>
<cac:Country>
<cbc:IdentificationCode>TR</cbc:IdentificationCode>
<cbc:Name>Türkiye</cbc:Name>
</cac:Country>
</cac:PostalAddress>
</cac:Party>
</cac:DeliveryCustomerParty>
<cac:Shipment>
<cbc:ID />
<cac:ShipmentStage>
<cac:TransportMeans>
<cac:RoadTransport>
<cbc:LicensePlateID schemeID="YABANCIPLAKA">DE-B1234</cbc:LicensePlateID>
</cac:RoadTransport>
</cac:TransportMeans>
</cac:ShipmentStage>
<cac:Delivery>
<cac:DeliveryAddress>
<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:DeliveryAddress>
<cac:CarrierParty>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1111111111</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Örnek Lojistik A.Ş.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Taşıyıcı Caddesi</cbc:StreetName>
<cbc:BuildingNumber>5</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:CarrierParty>
<cac:Despatch>
<cbc:ID />
<cbc:ActualDespatchDate>2026-08-01</cbc:ActualDespatchDate>
<cbc:ActualDespatchTime>12:30:00</cbc:ActualDespatchTime>
</cac:Despatch>
</cac:Delivery>
<cac:TransportHandlingUnit>
<cac:TransportEquipment>
<cbc:ID schemeID="YABANCIDORSEPLAKA">BG-TRAILER-77</cbc:ID>
</cac:TransportEquipment>
</cac:TransportHandlingUnit>
</cac:Shipment>
<cac:DespatchLine>
<cbc:ID>1</cbc:ID>
<cbc:DeliveredQuantity unitCode="C62">1</cbc:DeliveredQuantity>
<cac:OrderLineReference>
<cbc:LineID>1</cbc:LineID>
<cbc:SalesOrderLineID />
</cac:OrderLineReference>
<cac:Item>
<cbc:Name>İDİS İthal Ürün</cbc:Name>
<cac:AdditionalItemIdentification>
<cbc:ID schemeID="ETIKETNO">CD7654321</cbc:ID>
</cac:AdditionalItemIdentification>
</cac:Item>
</cac:DespatchLine>
</DespatchAdvice>Araç ve Dorse Şema Varyantları
Araç ve dorse şemaları birbirinden bağımsız seçilir. Yerli araç yabancı dorseyle, yabancı araç da yerli dorseyle kullanılabilir. DriverPerson gönderildiğinde aynı ShipmentStage içinde geçerli bir araç plakası bulunmalıdır; dorse listesi ise isteğe bağlıdır ve birden fazla kayıt taşıyabilir.
| Alan | Şema | Değer biçimi | Tam örnek |
|---|---|---|---|
RoadTransport.LicensePlateId | PLAKA | 01–81 il kodu + büyük harf + rakam | Yerli araç ve dorse |
RoadTransport.LicensePlateId | YABANCIPLAKA | Büyük harf, rakam, _ veya - | Yabancı araç ve dorse |
TransportEquipment[].Id | DORSE | 01–81 il kodu + büyük harf + rakam | Yerli araç ve dorse |
TransportEquipment[].Id | DORSEPLAKA | 01–81 il kodu + büyük harf + rakam | Karma araç, şoför ve çoklu dorse |
TransportEquipment[].Id | YABANCIDORSE | Büyük harf, rakam, _ veya - | Karma araç, şoför ve çoklu dorse |
TransportEquipment[].Id | YABANCIDORSEPLAKA | Büyük harf, rakam, _ veya - | Yabancı araç ve dorse |
Karma Araç, Şoför ve Çoklu Dorse
Bu tam request, yerli araçla birlikte bir yerli ve bir yabancı dorseyi aynı sevkiyatta gösterir. Şoför bilgisi bulunduğu için PLAKA aynı ShipmentStage içinde zorunludur. İki dorse kaydı, koleksiyon desteğini ve daha önce tam request içinde gösterilmeyen DORSEPLAKA ile YABANCIDORSE kodlarını birlikte doğrular.
Endpoint: POST /api/VbtApi/AddOutgoingDespatchAdvice
Body: OutgoingDespatchAdviceRequestModel (JSON)
{
"DespatchAdviceExternalId": "ERP-IDIS-MIXED-20260801-0001",
"ProfileId": "IDISIRSALIYE",
"DocumentCurrencyCode": "TRY",
"CopyIndicator": false,
"IssueDate": "2026-08-01T13:00:00+03:00",
"DespatchAdviceTypeCode": "SEVK",
"LineCountNumeric": 1,
"ReceiverIdentifier": "urn:mail:defaultpk@alici.example",
"IsDocumentNumberIncluded": false,
"IdisSevkiyatNo": "ES-2468135",
"DespatchSupplierParty": {
"Party": {
"PartyIdentifications": [{ "SchemeId": "VKN", "Value": "1234567890" }],
"PartyName": "Örnek Gönderici A.Ş.",
"PostalAddress": { "CitySubdivisionName": "Kadıköy", "CityName": "İstanbul", "Country": { "Name": "Türkiye" } }
}
},
"DeliveryCustomerParty": {
"Party": {
"PartyIdentifications": [{ "SchemeId": "VKN", "Value": "9876543210" }],
"PartyName": "Örnek Alıcı Ltd. Şti.",
"PostalAddress": { "CitySubdivisionName": "Çankaya", "CityName": "Ankara", "Country": { "Name": "Türkiye" } }
}
},
"Shipment": {
"Id": { "SchemeId": "", "Value": "SHP-IDIS-MIXED-0001" },
"ShipmentStage": [{
"TransportMeans": { "RoadTransport": { "LicensePlateId": { "SchemeId": "PLAKA", "Value": "34XYZ987" } } },
"DriverPerson": [{ "FirstName": "Ayşe", "FamilyName": "Yılmaz", "NationalityId": "TR" }]
}],
"TransportHandlingUnit": [{
"TransportEquipment": [
{ "Id": { "SchemeId": "DORSEPLAKA", "Value": "34DRS456" } },
{ "Id": { "SchemeId": "YABANCIDORSE", "Value": "RO-TRAILER-91" } }
]
}],
"Delivery": {
"DeliveryAddress": { "CitySubdivisionName": "Çankaya", "CityName": "Ankara", "PostalZone": "06550", "Country": { "Name": "Türkiye" } },
"Despatch": { "ActualDespatchDate": "2026-08-01T13:30:00+03:00", "ActualDespatchTime": "13:30:00" }
}
},
"DespatchLine": [{
"Id": "1",
"DeliveredQuantity": { "UnitCode": "C62", "Value": 1 },
"OrderLineReference": { "LineId": "1" }, "Item": { "Name": "İDİS Kapsamındaki Ürün", "AdditionalItemIdentification": [{ "SchemeId": "ETIKETNO", "Value": "EF2468135" }] }
}]
}Endpoint: POST /api/VbtApi/AddOutgoingDespatchAdviceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingDespatchAdviceRequestModel>
<DespatchAdviceExternalId>ERP-IDIS-MIXED-20260801-0001</DespatchAdviceExternalId>
<ProfileId>IDISIRSALIYE</ProfileId>
<DocumentCurrencyCode>TRY</DocumentCurrencyCode>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-08-01T13:00:00+03:00</IssueDate>
<DespatchAdviceTypeCode>SEVK</DespatchAdviceTypeCode>
<LineCountNumeric>1</LineCountNumeric>
<DespatchSupplierParty><Party><PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>1234567890</Value></IdRequestModel></PartyIdentifications><PartyName>Örnek Gönderici A.Ş.</PartyName><PostalAddress><CitySubdivisionName>Kadıköy</CitySubdivisionName><CityName>İstanbul</CityName><Country><Name>Türkiye</Name></Country></PostalAddress></Party></DespatchSupplierParty>
<DeliveryCustomerParty><Party><PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>9876543210</Value></IdRequestModel></PartyIdentifications><PartyName>Örnek Alıcı Ltd. Şti.</PartyName><PostalAddress><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><Country><Name>Türkiye</Name></Country></PostalAddress></Party></DeliveryCustomerParty>
<Shipment>
<Id><SchemeId /><Value>SHP-IDIS-MIXED-0001</Value></Id>
<ShipmentStage><TransportMeans><RoadTransport><LicensePlateId><SchemeId>PLAKA</SchemeId><Value>34XYZ987</Value></LicensePlateId></RoadTransport></TransportMeans><DriverPerson><FirstName>Ayşe</FirstName><FamilyName>Yılmaz</FamilyName><NationalityId>TR</NationalityId></DriverPerson></ShipmentStage>
<Delivery><DeliveryAddress><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></DeliveryAddress><Despatch><ActualDespatchDate>2026-08-01T13:30:00+03:00</ActualDespatchDate><ActualDespatchTime>13:30:00</ActualDespatchTime></Despatch></Delivery>
<TransportHandlingUnit><TransportHandlingUnitRequestModel><TransportEquipment><TransportEquipmentRequestModel><Id><SchemeId>DORSEPLAKA</SchemeId><Value>34DRS456</Value></Id></TransportEquipmentRequestModel><TransportEquipmentRequestModel><Id><SchemeId>YABANCIDORSE</SchemeId><Value>RO-TRAILER-91</Value></Id></TransportEquipmentRequestModel></TransportEquipment></TransportHandlingUnitRequestModel></TransportHandlingUnit>
</Shipment>
<DespatchLine><DespatchLineRequestModel><Id>1</Id><DeliveredQuantity><UnitCode>C62</UnitCode><Value>1</Value></DeliveredQuantity><OrderLineReference><LineId>1</LineId></OrderLineReference><Item><Name>İDİS Kapsamındaki Ürün</Name><AdditionalItemIdentification><IdRequestModel><SchemeId>ETIKETNO</SchemeId><Value>EF2468135</Value></IdRequestModel></AdditionalItemIdentification></Item></DespatchLineRequestModel></DespatchLine>
<ReceiverIdentifier>urn:mail:defaultpk@alici.example</ReceiverIdentifier>
<IsOocumentNumberIncluded>false</IsOocumentNumberIncluded>
<IdisSevkiyatNo>ES-2468135</IdisSevkiyatNo>
</OutgoingDespatchAdviceRequestModel>Endpoint: POST /api/VbtApi/AddOutgoingDespatchAdviceByUbl
Body: DespatchAdviceUblRequestModel (JSON); aşağıdaki UBL, FileBytes içeriğidir.
DespatchSupplierParty altında schemeID="SEVKIYATNO" ile gerçek sevkiyat numarası bulunmalıdır. Hazır UBL kullanmadan önce hedef ortamınızda İDİS UBL girişinin desteklendiğini teyit edin; destek bilgisi yoksa JSON veya ByXml kullanın. Veri kaynağı ve gönderim koşulları.İ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"?>
<DespatchAdvice 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:DespatchAdvice-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>IDISIRSALIYE</cbc:ProfileID>
<cbc:ID>IRS2026000000005</cbc:ID>
<cbc:CopyIndicator>false</cbc:CopyIndicator>
<cbc:UUID>11111111-2222-3333-4444-555555555555</cbc:UUID>
<cbc:IssueDate>2026-08-01</cbc:IssueDate>
<cbc:IssueTime>13:00:00</cbc:IssueTime>
<cbc:DespatchAdviceTypeCode>SEVK</cbc:DespatchAdviceTypeCode>
<cbc:LineCountNumeric>1</cbc:LineCountNumeric>
<cac:Signature>
<cbc:ID schemeID="VKN_TCKN">1234567890</cbc:ID>
<cac:SignatoryParty>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1234567890</cbc:ID>
</cac:PartyIdentification>
<cac:PostalAddress>
<cbc:StreetName>Örnek Caddesi</cbc:StreetName>
<cbc:CitySubdivisionName>Kadıköy</cbc:CitySubdivisionName>
<cbc:CityName>İstanbul</cbc:CityName>
<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_IRS2026000000005</cbc:URI>
</cac:ExternalReference>
</cac:DigitalSignatureAttachment>
</cac:Signature>
<cac:DespatchSupplierParty>
<cac:Party>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1234567890</cbc:ID>
</cac:PartyIdentification>
<cac:PartyIdentification>
<cbc:ID schemeID="SEVKIYATNO">ES-2468135</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Örnek Gönderici A.Ş.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:CitySubdivisionName>Kadıköy</cbc:CitySubdivisionName>
<cbc:CityName>İstanbul</cbc:CityName>
<cac:Country>
<cbc:IdentificationCode>TR</cbc:IdentificationCode>
<cbc:Name>Türkiye</cbc:Name>
</cac:Country>
</cac:PostalAddress>
</cac:Party>
</cac:DespatchSupplierParty>
<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:CitySubdivisionName>Çankaya</cbc:CitySubdivisionName>
<cbc:CityName>Ankara</cbc:CityName>
<cac:Country>
<cbc:IdentificationCode>TR</cbc:IdentificationCode>
<cbc:Name>Türkiye</cbc:Name>
</cac:Country>
</cac:PostalAddress>
</cac:Party>
</cac:DeliveryCustomerParty>
<cac:Shipment>
<cbc:ID />
<cac:ShipmentStage>
<cac:TransportMeans>
<cac:RoadTransport>
<cbc:LicensePlateID schemeID="PLAKA">34XYZ987</cbc:LicensePlateID>
</cac:RoadTransport>
</cac:TransportMeans>
<cac:DriverPerson>
<cbc:FirstName>Ayşe</cbc:FirstName>
<cbc:FamilyName>Yılmaz</cbc:FamilyName>
<cbc:NationalityID>TR</cbc:NationalityID>
</cac:DriverPerson>
</cac:ShipmentStage>
<cac:Delivery>
<cac:DeliveryAddress>
<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:DeliveryAddress>
<cac:Despatch>
<cbc:ID />
<cbc:ActualDespatchDate>2026-08-01</cbc:ActualDespatchDate>
<cbc:ActualDespatchTime>13:30:00</cbc:ActualDespatchTime>
</cac:Despatch>
</cac:Delivery>
<cac:TransportHandlingUnit>
<cac:TransportEquipment>
<cbc:ID schemeID="DORSEPLAKA">34DRS456</cbc:ID>
</cac:TransportEquipment>
<cac:TransportEquipment>
<cbc:ID schemeID="YABANCIDORSE">RO-TRAILER-91</cbc:ID>
</cac:TransportEquipment>
</cac:TransportHandlingUnit>
</cac:Shipment>
<cac:DespatchLine>
<cbc:ID>1</cbc:ID>
<cbc:DeliveredQuantity unitCode="C62">1</cbc:DeliveredQuantity>
<cac:OrderLineReference>
<cbc:LineID>1</cbc:LineID>
<cbc:SalesOrderLineID />
</cac:OrderLineReference>
<cac:Item>
<cbc:Name>İDİS Kapsamındaki Ürün</cbc:Name>
<cac:AdditionalItemIdentification>
<cbc:ID schemeID="ETIKETNO">EF2468135</cbc:ID>
</cac:AdditionalItemIdentification>
</cac:Item>
</cac:DespatchLine>
</DespatchAdvice>Hazır UBL Request'i
Kendi UBL dosyanızı üretiyorsanız XML'i UTF-8 byte dizisine çevirip JSON içinde Base64 olarak gönderin. IsZipped=true olduğunda FileBytes ZIP dosyasının, false olduğunda XML dosyasının Base64 karşılığıdır. IsSigned=true yalnızca içerik gerçekten imzalıysa kullanılmalıdır.
Endpoint: POST /api/VbtApi/AddOutgoingDespatchAdviceByUbl
Body: DespatchAdviceUblRequestModel (JSON içinde Base64 UBL)
{
"DespatchAdviceExternalId": "ERP-UBL-20260801-0001",
"ReceiverIdentifier": "urn:mail:defaultpk@alici.example",
"FileBytes": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjxEZXNwYXRjaEFkdmljZSB4bWxuczpjYWM9InVybjpvYXNpczpuYW1lczpzcGVjaWZpY2F0aW9uOnVibDpzY2hlbWE6eHNkOkNvbW1vbkFnZ3JlZ2F0ZUNvbXBvbmVudHMtMiIgeG1sbnM6Y2JjPSJ1cm46b2FzaXM6bmFtZXM6c3BlY2lmaWNhdGlvbjp1Ymw6c2NoZW1hOnhzZDpDb21tb25CYXNpY0NvbXBvbmVudHMtMiIgeG1sbnM6ZXh0PSJ1cm46b2FzaXM6bmFtZXM6c3BlY2lmaWNhdGlvbjp1Ymw6c2NoZW1hOnhzZDpDb21tb25FeHRlbnNpb25Db21wb25lbnRzLTIiIHhtbG5zPSJ1cm46b2FzaXM6bmFtZXM6c3BlY2lmaWNhdGlvbjp1Ymw6c2NoZW1hOnhzZDpEZXNwYXRjaEFkdmljZS0yIj4NCiAgPGV4dDpVQkxFeHRlbnNpb25zPg0KICAgIDxleHQ6VUJMRXh0ZW5zaW9uPg0KICAgICAgPGV4dDpFeHRlbnNpb25Db250ZW50IC8+DQogICAgPC9leHQ6VUJMRXh0ZW5zaW9uPg0KICA8L2V4dDpVQkxFeHRlbnNpb25zPg0KICA8Y2JjOlVCTFZlcnNpb25JRD4yLjE8L2NiYzpVQkxWZXJzaW9uSUQ+DQogIDxjYmM6Q3VzdG9taXphdGlvbklEPlRSMS4yLjE8L2NiYzpDdXN0b21pemF0aW9uSUQ+DQogIDxjYmM6UHJvZmlsZUlEPlRFTUVMSVJTQUxJWUU8L2NiYzpQcm9maWxlSUQ+DQogIDxjYmM6SUQ+SVJTMjAyNjAwMDAwMDAwMTwvY2JjOklEPg0KICA8Y2JjOkNvcHlJbmRpY2F0b3I+ZmFsc2U8L2NiYzpDb3B5SW5kaWNhdG9yPg0KICA8Y2JjOlVVSUQ+MTExMTExMTEtMjIyMi0zMzMzLTQ0NDQtNTU1NTU1NTU1NTUxPC9jYmM6VVVJRD4NCiAgPGNiYzpJc3N1ZURhdGU+MjAyNi0wOC0wMTwvY2JjOklzc3VlRGF0ZT4NCiAgPGNiYzpJc3N1ZVRpbWU+MDk6MDA6MDA8L2NiYzpJc3N1ZVRpbWU+DQogIDxjYmM6RGVzcGF0Y2hBZHZpY2VUeXBlQ29kZT5TRVZLPC9jYmM6RGVzcGF0Y2hBZHZpY2VUeXBlQ29kZT4NCiAgPGNiYzpOb3RlPlNpcGFyacWfIFNPLTIwMjYtMTA0MiBzZXZraXlhdMSxZMSxci48L2NiYzpOb3RlPg0KICA8Y2JjOkxpbmVDb3VudE51bWVyaWM+MTwvY2JjOkxpbmVDb3VudE51bWVyaWM+DQogIDxjYWM6U2lnbmF0dXJlPg0KICAgIDxjYmM6SUQgc2NoZW1lSUQ9IlZLTl9UQ0tOIj4xMjM0NTY3ODkwPC9jYmM6SUQ+DQogICAgPGNhYzpTaWduYXRvcnlQYXJ0eT4NCiAgICAgIDxjYWM6UGFydHlJZGVudGlmaWNhdGlvbj4NCiAgICAgICAgPGNiYzpJRCBzY2hlbWVJRD0iVktOIj4xMjM0NTY3ODkwPC9jYmM6SUQ+DQogICAgICA8L2NhYzpQYXJ0eUlkZW50aWZpY2F0aW9uPg0KICAgICAgPGNhYzpQb3N0YWxBZGRyZXNzPg0KICAgICAgICA8Y2JjOlN0cmVldE5hbWU+w5ZybmVrIENhZGRlc2k8L2NiYzpTdHJlZXROYW1lPg0KICAgICAgICA8Y2JjOkNpdHlTdWJkaXZpc2lvbk5hbWU+S2FkxLFrw7Z5PC9jYmM6Q2l0eVN1YmRpdmlzaW9uTmFtZT4NCiAgICAgICAgPGNiYzpDaXR5TmFtZT7EsHN0YW5idWw8L2NiYzpDaXR5TmFtZT4NCiAgICAgICAgPGNhYzpDb3VudHJ5Pg0KICAgICAgICAgIDxjYmM6SWRlbnRpZmljYXRpb25Db2RlPlRSPC9jYmM6SWRlbnRpZmljYXRpb25Db2RlPg0KICAgICAgICAgIDxjYmM6TmFtZT5Uw7xya2l5ZTwvY2JjOk5hbWU+DQogICAgICAgIDwvY2FjOkNvdW50cnk+DQogICAgICA8L2NhYzpQb3N0YWxBZGRyZXNzPg0KICAgIDwvY2FjOlNpZ25hdG9yeVBhcnR5Pg0KICAgIDxjYWM6RGlnaXRhbFNpZ25hdHVyZUF0dGFjaG1lbnQ+DQogICAgICA8Y2FjOkV4dGVybmFsUmVmZXJlbmNlPg0KICAgICAgICA8Y2JjOlVSST4jU2lnbmF0dXJlX0lSUzIwMjYwMDAwMDAwMDE8L2NiYzpVUkk+DQogICAgICA8L2NhYzpFeHRlcm5hbFJlZmVyZW5jZT4NCiAgICA8L2NhYzpEaWdpdGFsU2lnbmF0dXJlQXR0YWNobWVudD4NCiAgPC9jYWM6U2lnbmF0dXJlPg0KICA8Y2FjOkRlc3BhdGNoU3VwcGxpZXJQYXJ0eT4NCiAgICA8Y2FjOlBhcnR5Pg0KICAgICAgPGNhYzpQYXJ0eUlkZW50aWZpY2F0aW9uPg0KICAgICAgICA8Y2JjOklEIHNjaGVtZUlEPSJWS04iPjEyMzQ1Njc4OTA8L2NiYzpJRD4NCiAgICAgIDwvY2FjOlBhcnR5SWRlbnRpZmljYXRpb24+DQogICAgICA8Y2FjOlBhcnR5TmFtZT4NCiAgICAgICAgPGNiYzpOYW1lPsOWcm5layBHw7ZuZGVyaWNpIEEuxZ4uPC9jYmM6TmFtZT4NCiAgICAgIDwvY2FjOlBhcnR5TmFtZT4NCiAgICAgIDxjYWM6UG9zdGFsQWRkcmVzcz4NCiAgICAgICAgPGNiYzpTdHJlZXROYW1lPsOWcm5layBDYWRkZXNpPC9jYmM6U3RyZWV0TmFtZT4NCiAgICAgICAgPGNiYzpCdWlsZGluZ051bWJlcj4xMDwvY2JjOkJ1aWxkaW5nTnVtYmVyPg0KICAgICAgICA8Y2JjOkNpdHlTdWJkaXZpc2lvbk5hbWU+S2FkxLFrw7Z5PC9jYmM6Q2l0eVN1YmRpdmlzaW9uTmFtZT4NCiAgICAgICAgPGNiYzpDaXR5TmFtZT7EsHN0YW5idWw8L2NiYzpDaXR5TmFtZT4NCiAgICAgICAgPGNiYzpQb3N0YWxab25lPjM0NzEwPC9jYmM6UG9zdGFsWm9uZT4NCiAgICAgICAgPGNhYzpDb3VudHJ5Pg0KICAgICAgICAgIDxjYmM6SWRlbnRpZmljYXRpb25Db2RlPlRSPC9jYmM6SWRlbnRpZmljYXRpb25Db2RlPg0KICAgICAgICAgIDxjYmM6TmFtZT5Uw7xya2l5ZTwvY2JjOk5hbWU+DQogICAgICAgIDwvY2FjOkNvdW50cnk+DQogICAgICA8L2NhYzpQb3N0YWxBZGRyZXNzPg0KICAgIDwvY2FjOlBhcnR5Pg0KICA8L2NhYzpEZXNwYXRjaFN1cHBsaWVyUGFydHk+DQogIDxjYWM6RGVsaXZlcnlDdXN0b21lclBhcnR5Pg0KICAgIDxjYWM6UGFydHk+DQogICAgICA8Y2FjOlBhcnR5SWRlbnRpZmljYXRpb24+DQogICAgICAgIDxjYmM6SUQgc2NoZW1lSUQ9IlZLTiI+OTg3NjU0MzIxMDwvY2JjOklEPg0KICAgICAgPC9jYWM6UGFydHlJZGVudGlmaWNhdGlvbj4NCiAgICAgIDxjYWM6UGFydHlOYW1lPg0KICAgICAgICA8Y2JjOk5hbWU+w5ZybmVrIEFsxLFjxLEgTHRkLiDFnnRpLjwvY2JjOk5hbWU+DQogICAgICA8L2NhYzpQYXJ0eU5hbWU+DQogICAgICA8Y2FjOlBvc3RhbEFkZHJlc3M+DQogICAgICAgIDxjYmM6U3RyZWV0TmFtZT5UZXNsaW0gU29rYWs8L2NiYzpTdHJlZXROYW1lPg0KICAgICAgICA8Y2JjOkJ1aWxkaW5nTnVtYmVyPjI1PC9jYmM6QnVpbGRpbmdOdW1iZXI+DQogICAgICAgIDxjYmM6Q2l0eVN1YmRpdmlzaW9uTmFtZT7Dh2Fua2F5YTwvY2JjOkNpdHlTdWJkaXZpc2lvbk5hbWU+DQogICAgICAgIDxjYmM6Q2l0eU5hbWU+QW5rYXJhPC9jYmM6Q2l0eU5hbWU+DQogICAgICAgIDxjYmM6UG9zdGFsWm9uZT4wNjU1MDwvY2JjOlBvc3RhbFpvbmU+DQogICAgICAgIDxjYWM6Q291bnRyeT4NCiAgICAgICAgICA8Y2JjOklkZW50aWZpY2F0aW9uQ29kZT5UUjwvY2JjOklkZW50aWZpY2F0aW9uQ29kZT4NCiAgICAgICAgICA8Y2JjOk5hbWU+VMO8cmtpeWU8L2NiYzpOYW1lPg0KICAgICAgICA8L2NhYzpDb3VudHJ5Pg0KICAgICAgPC9jYWM6UG9zdGFsQWRkcmVzcz4NCiAgICA8L2NhYzpQYXJ0eT4NCiAgPC9jYWM6RGVsaXZlcnlDdXN0b21lclBhcnR5Pg0KICA8Y2FjOlNoaXBtZW50Pg0KICAgIDxjYmM6SUQgLz4NCiAgICA8Y2FjOkRlbGl2ZXJ5Pg0KICAgICAgPGNhYzpEZWxpdmVyeUFkZHJlc3M+DQogICAgICAgIDxjYmM6U3RyZWV0TmFtZT5UZXNsaW0gU29rYWs8L2NiYzpTdHJlZXROYW1lPg0KICAgICAgICA8Y2JjOkJ1aWxkaW5nTnVtYmVyPjI1PC9jYmM6QnVpbGRpbmdOdW1iZXI+DQogICAgICAgIDxjYmM6Q2l0eVN1YmRpdmlzaW9uTmFtZT7Dh2Fua2F5YTwvY2JjOkNpdHlTdWJkaXZpc2lvbk5hbWU+DQogICAgICAgIDxjYmM6Q2l0eU5hbWU+QW5rYXJhPC9jYmM6Q2l0eU5hbWU+DQogICAgICAgIDxjYmM6UG9zdGFsWm9uZT4wNjU1MDwvY2JjOlBvc3RhbFpvbmU+DQogICAgICAgIDxjYWM6Q291bnRyeT4NCiAgICAgICAgICA8Y2JjOklkZW50aWZpY2F0aW9uQ29kZT5UUjwvY2JjOklkZW50aWZpY2F0aW9uQ29kZT4NCiAgICAgICAgICA8Y2JjOk5hbWU+VMO8cmtpeWU8L2NiYzpOYW1lPg0KICAgICAgICA8L2NhYzpDb3VudHJ5Pg0KICAgICAgPC9jYWM6RGVsaXZlcnlBZGRyZXNzPg0KICAgICAgPGNhYzpDYXJyaWVyUGFydHk+DQogICAgICAgIDxjYWM6UGFydHlJZGVudGlmaWNhdGlvbj4NCiAgICAgICAgICA8Y2JjOklEIHNjaGVtZUlEPSJWS04iPjExMTExMTExMTE8L2NiYzpJRD4NCiAgICAgICAgPC9jYWM6UGFydHlJZGVudGlmaWNhdGlvbj4NCiAgICAgICAgPGNhYzpQYXJ0eU5hbWU+DQogICAgICAgICAgPGNiYzpOYW1lPsOWcm5layBMb2ppc3RpayBBLsWeLjwvY2JjOk5hbWU+DQogICAgICAgIDwvY2FjOlBhcnR5TmFtZT4NCiAgICAgICAgPGNhYzpQb3N0YWxBZGRyZXNzPg0KICAgICAgICAgIDxjYmM6U3RyZWV0TmFtZT5UYcWfxLF5xLFjxLEgQ2FkZGVzaTwvY2JjOlN0cmVldE5hbWU+DQogICAgICAgICAgPGNiYzpCdWlsZGluZ051bWJlcj41PC9jYmM6QnVpbGRpbmdOdW1iZXI+DQogICAgICAgICAgPGNiYzpDaXR5U3ViZGl2aXNpb25OYW1lPsOHYW5rYXlhPC9jYmM6Q2l0eVN1YmRpdmlzaW9uTmFtZT4NCiAgICAgICAgICA8Y2JjOkNpdHlOYW1lPkFua2FyYTwvY2JjOkNpdHlOYW1lPg0KICAgICAgICAgIDxjYmM6UG9zdGFsWm9uZT4wNjU1MDwvY2JjOlBvc3RhbFpvbmU+DQogICAgICAgICAgPGNhYzpDb3VudHJ5Pg0KICAgICAgICAgICAgPGNiYzpJZGVudGlmaWNhdGlvbkNvZGU+VFI8L2NiYzpJZGVudGlmaWNhdGlvbkNvZGU+DQogICAgICAgICAgICA8Y2JjOk5hbWU+VMO8cmtpeWU8L2NiYzpOYW1lPg0KICAgICAgICAgIDwvY2FjOkNvdW50cnk+DQogICAgICAgIDwvY2FjOlBvc3RhbEFkZHJlc3M+DQogICAgICA8L2NhYzpDYXJyaWVyUGFydHk+DQogICAgICA8Y2FjOkRlc3BhdGNoPg0KICAgICAgICA8Y2JjOklEIC8+DQogICAgICAgIDxjYmM6QWN0dWFsRGVzcGF0Y2hEYXRlPjIwMjYtMDgtMDE8L2NiYzpBY3R1YWxEZXNwYXRjaERhdGU+DQogICAgICAgIDxjYmM6QWN0dWFsRGVzcGF0Y2hUaW1lPjA5OjMwOjAwPC9jYmM6QWN0dWFsRGVzcGF0Y2hUaW1lPg0KICAgICAgICA8Y2FjOkRlc3BhdGNoQWRkcmVzcz4NCiAgICAgICAgICA8Y2JjOlN0cmVldE5hbWU+w4fEsWvEscWfIERlcG9zdSBDYWRkZXNpPC9jYmM6U3RyZWV0TmFtZT4NCiAgICAgICAgICA8Y2JjOkJ1aWxkaW5nTnVtYmVyPjE8L2NiYzpCdWlsZGluZ051bWJlcj4NCiAgICAgICAgICA8Y2JjOkNpdHlTdWJkaXZpc2lvbk5hbWU+VHV6bGE8L2NiYzpDaXR5U3ViZGl2aXNpb25OYW1lPg0KICAgICAgICAgIDxjYmM6Q2l0eU5hbWU+xLBzdGFuYnVsPC9jYmM6Q2l0eU5hbWU+DQogICAgICAgICAgPGNiYzpQb3N0YWxab25lPjM0OTQwPC9jYmM6UG9zdGFsWm9uZT4NCiAgICAgICAgICA8Y2FjOkNvdW50cnk+DQogICAgICAgICAgICA8Y2JjOklkZW50aWZpY2F0aW9uQ29kZT5UUjwvY2JjOklkZW50aWZpY2F0aW9uQ29kZT4NCiAgICAgICAgICAgIDxjYmM6TmFtZT5Uw7xya2l5ZTwvY2JjOk5hbWU+DQogICAgICAgICAgPC9jYWM6Q291bnRyeT4NCiAgICAgICAgPC9jYWM6RGVzcGF0Y2hBZGRyZXNzPg0KICAgICAgPC9jYWM6RGVzcGF0Y2g+DQogICAgPC9jYWM6RGVsaXZlcnk+DQogIDwvY2FjOlNoaXBtZW50Pg0KICA8Y2FjOkRlc3BhdGNoTGluZT4NCiAgICA8Y2JjOklEPjE8L2NiYzpJRD4NCiAgICA8Y2JjOkRlbGl2ZXJlZFF1YW50aXR5IHVuaXRDb2RlPSJDNjIiPjEwPC9jYmM6RGVsaXZlcmVkUXVhbnRpdHk+DQogICAgPGNhYzpPcmRlckxpbmVSZWZlcmVuY2U+DQogICAgICA8Y2JjOkxpbmVJRD4xPC9jYmM6TGluZUlEPg0KICAgICAgPGNiYzpTYWxlc09yZGVyTGluZUlEIC8+DQogICAgPC9jYWM6T3JkZXJMaW5lUmVmZXJlbmNlPg0KICAgIDxjYWM6SXRlbT4NCiAgICAgIDxjYmM6TmFtZT7DlnJuZWsgw5xyw7xuPC9jYmM6TmFtZT4NCiAgICAgIDxjYWM6U2VsbGVyc0l0ZW1JZGVudGlmaWNhdGlvbj4NCiAgICAgICAgPGNiYzpJRD5TS1UtMTAwMTwvY2JjOklEPg0KICAgICAgPC9jYWM6U2VsbGVyc0l0ZW1JZGVudGlmaWNhdGlvbj4NCiAgICA8L2NhYzpJdGVtPg0KICA8L2NhYzpEZXNwYXRjaExpbmU+DQo8L0Rlc3BhdGNoQWR2aWNlPg==",
"IsZipped": false,
"IsSigned": false,
"MailTo": "operasyon@example.com",
"FirmBranchCode": "MERKEZ"
}
FileBytes, tam bir UTF-8 DespatchAdvice XML'in Base64 karşılığıdır. Dış referans, ETTN, belge numarası, taraf kimlikleri, posta kutusu etiketi ve tarihleri test hesabınızın verileriyle birlikte değiştirin; ardından önce UBL önizleme endpointini çağırın.Oluşturma, Güncelleme ve Önizleme
JSON ve platform XML’i belge alanlarını taşır; UBL sekmesi tam UBL içeriğini gösterir; bu içerik JSON taşıma modelinin FileBytes alanında Base64 olarak gönderilir. Aşağıdaki gövdeler aynı temel sevk örneğini kullanır. Güncellemede ETTN, belge numarası ve dış referansı daha önce dönen gerçek belge kimlikleriyle eşleştirin; mevcut belge durumu güncellemeye izin vermelidir.
| İşlem | JSON | Platform XML | UBL |
|---|---|---|---|
| Oluşturma | AddOutgoingDespatchAdvice | AddOutgoingDespatchAdviceByXml | AddOutgoingDespatchAdviceByUbl |
| Güncelleme | UpdateOutgoingDespatchAdvice | UpdateOutgoingDespatchAdviceByXml | UpdateOutgoingDespatchAdviceByUbl |
| Önizleme | OutgoingDespatchAdvicePreview | OutgoingDespatchAdvicePreviewByXml | OutgoingDespatchAdviceUblPreview |
Tam Güncelleme Request’i
Endpoint: POST /api/VbtApi/UpdateOutgoingDespatchAdvice
Body: OutgoingDespatchAdviceRequestModel (JSON)
{
"DespatchAdviceExternalId": "ERP-IRS-20260801-0001",
"UUId": "11111111-2222-3333-4444-555555555551",
"DespatchAdviceNumber": "IRS2026000000001",
"ProfileId": "TEMELIRSALIYE",
"DocumentCurrencyCode": "TRY",
"CopyIndicator": false,
"IssueDate": "2026-08-01T09:00:00+03:00",
"DespatchAdviceTypeCode": "SEVK",
"Note": ["Sipariş SO-2026-1042 sevkiyatıdır."],
"LineCountNumeric": 1,
"ReceiverIdentifier": "urn:mail:defaultpk@alici.example",
"IsDocumentNumberIncluded": false,
"DespatchSupplierParty": {
"Party": {
"PartyIdentifications": [{ "SchemeId": "VKN", "Value": "1234567890" }],
"PartyName": "Örnek Gönderici A.Ş.",
"PostalAddress": {
"StreetName": "Örnek Caddesi",
"BuildingNumber": "10",
"CitySubdivisionName": "Kadıköy",
"CityName": "İstanbul",
"PostalZone": "34710",
"Country": { "Name": "Türkiye" }
}
}
},
"DeliveryCustomerParty": {
"Party": {
"PartyIdentifications": [{ "SchemeId": "VKN", "Value": "9876543210" }],
"PartyName": "Örnek Alıcı Ltd. Şti.",
"PostalAddress": {
"StreetName": "Teslim Sokak",
"BuildingNumber": "25",
"CitySubdivisionName": "Çankaya",
"CityName": "Ankara",
"PostalZone": "06550",
"Country": { "Name": "Türkiye" }
}
}
},
"Shipment": {
"Id": { "SchemeId": "", "Value": "SHP-20260801-0001" },
"Delivery": {
"DeliveryAddress": {
"StreetName": "Teslim Sokak",
"BuildingNumber": "25",
"CitySubdivisionName": "Çankaya",
"CityName": "Ankara",
"PostalZone": "06550",
"Country": { "Name": "Türkiye" }
},
"CarrierParty": {
"PartyIdentifications": [{ "SchemeId": "VKN", "Value": "1111111111" }],
"PartyName": "Örnek Lojistik A.Ş.", "PostalAddress": { "StreetName": "Taşıyıcı Caddesi", "BuildingNumber": "5", "CitySubdivisionName": "Çankaya", "CityName": "Ankara", "PostalZone": "06550", "Country": { "Name": "Türkiye" } }
},
"Despatch": {
"ActualDespatchDate": "2026-08-01T09:30:00+03:00",
"ActualDespatchTime": "09:30:00",
"DespatchAddress": {
"StreetName": "Çıkış Deposu Caddesi",
"BuildingNumber": "1",
"CitySubdivisionName": "Tuzla",
"CityName": "İstanbul",
"PostalZone": "34940",
"Country": { "Name": "Türkiye" }
}
}
}
},
"DespatchLine": [
{
"Id": "1",
"DeliveredQuantity": { "UnitCode": "C62", "Value": 10 },
"OrderLineReference": { "LineId": "1" },
"Item": { "Name": "Örnek Ürün", "SellersItemIdentification": "SKU-1001" }
}
]
}Endpoint: POST /api/VbtApi/UpdateOutgoingDespatchAdviceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingDespatchAdviceRequestModel>
<UUId>11111111-2222-3333-4444-555555555551</UUId>
<DespatchAdviceNumber>IRS2026000000001</DespatchAdviceNumber>
<DespatchAdviceExternalId>ERP-IRS-20260801-0001</DespatchAdviceExternalId>
<ProfileId>TEMELIRSALIYE</ProfileId>
<DocumentCurrencyCode>TRY</DocumentCurrencyCode>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-08-01T09:00:00+03:00</IssueDate>
<DespatchAdviceTypeCode>SEVK</DespatchAdviceTypeCode>
<Note><string>Sipariş SO-2026-1042 sevkiyatıdır.</string></Note>
<LineCountNumeric>1</LineCountNumeric>
<DespatchSupplierParty><Party>
<PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>1234567890</Value></IdRequestModel></PartyIdentifications>
<PartyName>Örnek Gönderici A.Ş.</PartyName>
<PostalAddress><StreetName>Örnek Caddesi</StreetName><BuildingNumber>10</BuildingNumber><CitySubdivisionName>Kadıköy</CitySubdivisionName><CityName>İstanbul</CityName><PostalZone>34710</PostalZone><Country><Name>Türkiye</Name></Country></PostalAddress>
</Party></DespatchSupplierParty>
<DeliveryCustomerParty><Party>
<PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>9876543210</Value></IdRequestModel></PartyIdentifications>
<PartyName>Örnek Alıcı Ltd. Şti.</PartyName>
<PostalAddress><StreetName>Teslim Sokak</StreetName><BuildingNumber>25</BuildingNumber><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></PostalAddress>
</Party></DeliveryCustomerParty>
<Shipment>
<Id><SchemeId /><Value>SHP-20260801-0001</Value></Id>
<Delivery>
<DeliveryAddress><StreetName>Teslim Sokak</StreetName><BuildingNumber>25</BuildingNumber><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></DeliveryAddress>
<CarrierParty><PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>1111111111</Value></IdRequestModel></PartyIdentifications><PartyName>Örnek Lojistik A.Ş.</PartyName><PostalAddress><StreetName>Taşıyıcı Caddesi</StreetName><BuildingNumber>5</BuildingNumber><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></PostalAddress></CarrierParty>
<Despatch><ActualDespatchDate>2026-08-01T09:30:00+03:00</ActualDespatchDate><ActualDespatchTime>09:30:00</ActualDespatchTime><DespatchAddress><StreetName>Çıkış Deposu Caddesi</StreetName><BuildingNumber>1</BuildingNumber><CitySubdivisionName>Tuzla</CitySubdivisionName><CityName>İstanbul</CityName><PostalZone>34940</PostalZone><Country><Name>Türkiye</Name></Country></DespatchAddress></Despatch>
</Delivery>
</Shipment>
<DespatchLine><DespatchLineRequestModel><Id>1</Id><DeliveredQuantity><UnitCode>C62</UnitCode><Value>10</Value></DeliveredQuantity><OrderLineReference><LineId>1</LineId></OrderLineReference><Item><Name>Örnek Ürün</Name><SellersItemIdentification>SKU-1001</SellersItemIdentification></Item></DespatchLineRequestModel></DespatchLine>
<ReceiverIdentifier>urn:mail:defaultpk@alici.example</ReceiverIdentifier>
<IsOocumentNumberIncluded>false</IsOocumentNumberIncluded>
</OutgoingDespatchAdviceRequestModel>Endpoint: POST /api/VbtApi/UpdateOutgoingDespatchAdviceByUbl
Body: DespatchAdviceUblRequestModel (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"?>
<DespatchAdvice 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:DespatchAdvice-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>IRS2026000000001</cbc:ID>
<cbc:CopyIndicator>false</cbc:CopyIndicator>
<cbc:UUID>11111111-2222-3333-4444-555555555551</cbc:UUID>
<cbc:IssueDate>2026-08-01</cbc:IssueDate>
<cbc:IssueTime>09:00:00</cbc:IssueTime>
<cbc:DespatchAdviceTypeCode>SEVK</cbc:DespatchAdviceTypeCode>
<cbc:Note>Sipariş SO-2026-1042 sevkiyatıdır.</cbc:Note>
<cbc:LineCountNumeric>1</cbc:LineCountNumeric>
<cac:Signature>
<cbc:ID schemeID="VKN_TCKN">1234567890</cbc:ID>
<cac:SignatoryParty>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1234567890</cbc:ID>
</cac:PartyIdentification>
<cac:PostalAddress>
<cbc:StreetName>Örnek Caddesi</cbc:StreetName>
<cbc:CitySubdivisionName>Kadıköy</cbc:CitySubdivisionName>
<cbc:CityName>İstanbul</cbc:CityName>
<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_IRS2026000000001</cbc:URI>
</cac:ExternalReference>
</cac:DigitalSignatureAttachment>
</cac:Signature>
<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: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:Shipment>
<cbc:ID />
<cac:Delivery>
<cac:DeliveryAddress>
<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:DeliveryAddress>
<cac:CarrierParty>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1111111111</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Örnek Lojistik A.Ş.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Taşıyıcı Caddesi</cbc:StreetName>
<cbc:BuildingNumber>5</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:CarrierParty>
<cac:Despatch>
<cbc:ID />
<cbc:ActualDespatchDate>2026-08-01</cbc:ActualDespatchDate>
<cbc:ActualDespatchTime>09:30:00</cbc:ActualDespatchTime>
<cac:DespatchAddress>
<cbc:StreetName>Çıkış Deposu Caddesi</cbc:StreetName>
<cbc:BuildingNumber>1</cbc:BuildingNumber>
<cbc:CitySubdivisionName>Tuzla</cbc:CitySubdivisionName>
<cbc:CityName>İstanbul</cbc:CityName>
<cbc:PostalZone>34940</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>TR</cbc:IdentificationCode>
<cbc:Name>Türkiye</cbc:Name>
</cac:Country>
</cac:DespatchAddress>
</cac:Despatch>
</cac:Delivery>
</cac:Shipment>
<cac:DespatchLine>
<cbc:ID>1</cbc:ID>
<cbc:DeliveredQuantity unitCode="C62">10</cbc:DeliveredQuantity>
<cac:OrderLineReference>
<cbc:LineID>1</cbc:LineID>
<cbc:SalesOrderLineID />
</cac:OrderLineReference>
<cac:Item>
<cbc:Name>Örnek Ürün</cbc:Name>
<cac:SellersItemIdentification>
<cbc:ID>SKU-1001</cbc:ID>
</cac:SellersItemIdentification>
</cac:Item>
</cac:DespatchLine>
</DespatchAdvice>Tam Önizleme Request’i
Endpoint: POST /api/VbtApi/OutgoingDespatchAdvicePreview
Body: OutgoingDespatchAdviceRequestModel (JSON)
{
"DespatchAdviceExternalId": "ERP-IRS-20260801-0001",
"UUId": "11111111-2222-3333-4444-555555555551",
"DespatchAdviceNumber": "IRS2026000000001",
"ProfileId": "TEMELIRSALIYE",
"DocumentCurrencyCode": "TRY",
"CopyIndicator": false,
"IssueDate": "2026-08-01T09:00:00+03:00",
"DespatchAdviceTypeCode": "SEVK",
"Note": ["Sipariş SO-2026-1042 sevkiyatıdır."],
"LineCountNumeric": 1,
"ReceiverIdentifier": "urn:mail:defaultpk@alici.example",
"IsDocumentNumberIncluded": false,
"DespatchSupplierParty": {
"Party": {
"PartyIdentifications": [{ "SchemeId": "VKN", "Value": "1234567890" }],
"PartyName": "Örnek Gönderici A.Ş.",
"PostalAddress": {
"StreetName": "Örnek Caddesi",
"BuildingNumber": "10",
"CitySubdivisionName": "Kadıköy",
"CityName": "İstanbul",
"PostalZone": "34710",
"Country": { "Name": "Türkiye" }
}
}
},
"DeliveryCustomerParty": {
"Party": {
"PartyIdentifications": [{ "SchemeId": "VKN", "Value": "9876543210" }],
"PartyName": "Örnek Alıcı Ltd. Şti.",
"PostalAddress": {
"StreetName": "Teslim Sokak",
"BuildingNumber": "25",
"CitySubdivisionName": "Çankaya",
"CityName": "Ankara",
"PostalZone": "06550",
"Country": { "Name": "Türkiye" }
}
}
},
"Shipment": {
"Id": { "SchemeId": "", "Value": "SHP-20260801-0001" },
"Delivery": {
"DeliveryAddress": {
"StreetName": "Teslim Sokak",
"BuildingNumber": "25",
"CitySubdivisionName": "Çankaya",
"CityName": "Ankara",
"PostalZone": "06550",
"Country": { "Name": "Türkiye" }
},
"CarrierParty": {
"PartyIdentifications": [{ "SchemeId": "VKN", "Value": "1111111111" }],
"PartyName": "Örnek Lojistik A.Ş.", "PostalAddress": { "StreetName": "Taşıyıcı Caddesi", "BuildingNumber": "5", "CitySubdivisionName": "Çankaya", "CityName": "Ankara", "PostalZone": "06550", "Country": { "Name": "Türkiye" } }
},
"Despatch": {
"ActualDespatchDate": "2026-08-01T09:30:00+03:00",
"ActualDespatchTime": "09:30:00",
"DespatchAddress": {
"StreetName": "Çıkış Deposu Caddesi",
"BuildingNumber": "1",
"CitySubdivisionName": "Tuzla",
"CityName": "İstanbul",
"PostalZone": "34940",
"Country": { "Name": "Türkiye" }
}
}
}
},
"DespatchLine": [
{
"Id": "1",
"DeliveredQuantity": { "UnitCode": "C62", "Value": 10 },
"OrderLineReference": { "LineId": "1" },
"Item": { "Name": "Örnek Ürün", "SellersItemIdentification": "SKU-1001" }
}
]
}Endpoint: POST /api/VbtApi/OutgoingDespatchAdvicePreviewByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingDespatchAdviceRequestModel>
<UUId>11111111-2222-3333-4444-555555555551</UUId>
<DespatchAdviceNumber>IRS2026000000001</DespatchAdviceNumber>
<DespatchAdviceExternalId>ERP-IRS-20260801-0001</DespatchAdviceExternalId>
<ProfileId>TEMELIRSALIYE</ProfileId>
<DocumentCurrencyCode>TRY</DocumentCurrencyCode>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-08-01T09:00:00+03:00</IssueDate>
<DespatchAdviceTypeCode>SEVK</DespatchAdviceTypeCode>
<Note><string>Sipariş SO-2026-1042 sevkiyatıdır.</string></Note>
<LineCountNumeric>1</LineCountNumeric>
<DespatchSupplierParty><Party>
<PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>1234567890</Value></IdRequestModel></PartyIdentifications>
<PartyName>Örnek Gönderici A.Ş.</PartyName>
<PostalAddress><StreetName>Örnek Caddesi</StreetName><BuildingNumber>10</BuildingNumber><CitySubdivisionName>Kadıköy</CitySubdivisionName><CityName>İstanbul</CityName><PostalZone>34710</PostalZone><Country><Name>Türkiye</Name></Country></PostalAddress>
</Party></DespatchSupplierParty>
<DeliveryCustomerParty><Party>
<PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>9876543210</Value></IdRequestModel></PartyIdentifications>
<PartyName>Örnek Alıcı Ltd. Şti.</PartyName>
<PostalAddress><StreetName>Teslim Sokak</StreetName><BuildingNumber>25</BuildingNumber><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></PostalAddress>
</Party></DeliveryCustomerParty>
<Shipment>
<Id><SchemeId /><Value>SHP-20260801-0001</Value></Id>
<Delivery>
<DeliveryAddress><StreetName>Teslim Sokak</StreetName><BuildingNumber>25</BuildingNumber><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></DeliveryAddress>
<CarrierParty><PartyIdentifications><IdRequestModel><SchemeId>VKN</SchemeId><Value>1111111111</Value></IdRequestModel></PartyIdentifications><PartyName>Örnek Lojistik A.Ş.</PartyName><PostalAddress><StreetName>Taşıyıcı Caddesi</StreetName><BuildingNumber>5</BuildingNumber><CitySubdivisionName>Çankaya</CitySubdivisionName><CityName>Ankara</CityName><PostalZone>06550</PostalZone><Country><Name>Türkiye</Name></Country></PostalAddress></CarrierParty>
<Despatch><ActualDespatchDate>2026-08-01T09:30:00+03:00</ActualDespatchDate><ActualDespatchTime>09:30:00</ActualDespatchTime><DespatchAddress><StreetName>Çıkış Deposu Caddesi</StreetName><BuildingNumber>1</BuildingNumber><CitySubdivisionName>Tuzla</CitySubdivisionName><CityName>İstanbul</CityName><PostalZone>34940</PostalZone><Country><Name>Türkiye</Name></Country></DespatchAddress></Despatch>
</Delivery>
</Shipment>
<DespatchLine><DespatchLineRequestModel><Id>1</Id><DeliveredQuantity><UnitCode>C62</UnitCode><Value>10</Value></DeliveredQuantity><OrderLineReference><LineId>1</LineId></OrderLineReference><Item><Name>Örnek Ürün</Name><SellersItemIdentification>SKU-1001</SellersItemIdentification></Item></DespatchLineRequestModel></DespatchLine>
<ReceiverIdentifier>urn:mail:defaultpk@alici.example</ReceiverIdentifier>
<IsOocumentNumberIncluded>false</IsOocumentNumberIncluded>
</OutgoingDespatchAdviceRequestModel>Endpoint: POST /api/VbtApi/OutgoingDespatchAdviceUblPreview
Body: DespatchAdviceUblRequestModel (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"?>
<DespatchAdvice 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:DespatchAdvice-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>IRS2026000000001</cbc:ID>
<cbc:CopyIndicator>false</cbc:CopyIndicator>
<cbc:UUID>11111111-2222-3333-4444-555555555551</cbc:UUID>
<cbc:IssueDate>2026-08-01</cbc:IssueDate>
<cbc:IssueTime>09:00:00</cbc:IssueTime>
<cbc:DespatchAdviceTypeCode>SEVK</cbc:DespatchAdviceTypeCode>
<cbc:Note>Sipariş SO-2026-1042 sevkiyatıdır.</cbc:Note>
<cbc:LineCountNumeric>1</cbc:LineCountNumeric>
<cac:Signature>
<cbc:ID schemeID="VKN_TCKN">1234567890</cbc:ID>
<cac:SignatoryParty>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1234567890</cbc:ID>
</cac:PartyIdentification>
<cac:PostalAddress>
<cbc:StreetName>Örnek Caddesi</cbc:StreetName>
<cbc:CitySubdivisionName>Kadıköy</cbc:CitySubdivisionName>
<cbc:CityName>İstanbul</cbc:CityName>
<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_IRS2026000000001</cbc:URI>
</cac:ExternalReference>
</cac:DigitalSignatureAttachment>
</cac:Signature>
<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: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:Shipment>
<cbc:ID />
<cac:Delivery>
<cac:DeliveryAddress>
<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:DeliveryAddress>
<cac:CarrierParty>
<cac:PartyIdentification>
<cbc:ID schemeID="VKN">1111111111</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Örnek Lojistik A.Ş.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Taşıyıcı Caddesi</cbc:StreetName>
<cbc:BuildingNumber>5</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:CarrierParty>
<cac:Despatch>
<cbc:ID />
<cbc:ActualDespatchDate>2026-08-01</cbc:ActualDespatchDate>
<cbc:ActualDespatchTime>09:30:00</cbc:ActualDespatchTime>
<cac:DespatchAddress>
<cbc:StreetName>Çıkış Deposu Caddesi</cbc:StreetName>
<cbc:BuildingNumber>1</cbc:BuildingNumber>
<cbc:CitySubdivisionName>Tuzla</cbc:CitySubdivisionName>
<cbc:CityName>İstanbul</cbc:CityName>
<cbc:PostalZone>34940</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>TR</cbc:IdentificationCode>
<cbc:Name>Türkiye</cbc:Name>
</cac:Country>
</cac:DespatchAddress>
</cac:Despatch>
</cac:Delivery>
</cac:Shipment>
<cac:DespatchLine>
<cbc:ID>1</cbc:ID>
<cbc:DeliveredQuantity unitCode="C62">10</cbc:DeliveredQuantity>
<cac:OrderLineReference>
<cbc:LineID>1</cbc:LineID>
<cbc:SalesOrderLineID />
</cac:OrderLineReference>
<cac:Item>
<cbc:Name>Örnek Ürün</cbc:Name>
<cac:SellersItemIdentification>
<cbc:ID>SKU-1001</cbc:ID>
</cac:SellersItemIdentification>
</cac:Item>
</cac:DespatchLine>
</DespatchAdvice>İDİS Verisi ve Gönderim Koşulları
IdisSevkiyatNo ve ürün etiketleri entegratörün gerçek İDİS sevkiyat/etiket kaynağından alınmalıdır; bu API akışı dış İDİS sisteminden otomatik numara sorgulamaz. ES-1234567, SE-7654321 ve örnek ETIKETNO değerleri yalnız biçimi gösterir; doğrulanmış gerçek sevkiyat veya etiket numarası değildir. Araç/dorse kimliği de kendi kaynağından alınır; şema seçimiyle birlikte korunur.
JSON ve ByXml isteklerinde DespatchSupplierParty gönderilmediğinde gönderici bilgileri kayıtlı firma bilgilerinden tamamlanır. Sevkiyat numarası kök IdisSevkiyatNo alanından göndericinin SEVKIYATNO kimliğine aktarılır. Hazır UBL’de numara DespatchSupplierParty altında aynı kimlikle taşınır; API tarafından yeni bir sevkiyat numarası üretilmez.
| Bilgi | JSON / platform XML | UBL karşılığı | Giriş davranışı ve sürüm koşulu |
|---|---|---|---|
| Sevkiyat numarası | IdisSevkiyatNo | DespatchSupplierParty.Party.PartyIdentification.ID[schemeID=SEVKIYATNO] | JSON/XML’de kök alanda, hazır UBL’de belirtilen taraf kimliğinde taşınır. Hedef ortam İDİS UBL girişini desteklemelidir. |
| Ürün etiketi | DespatchLine[].Item.AdditionalItemIdentification[] | DespatchLine.Item.AdditionalItemIdentification.ID[schemeID=ETIKETNO] | Her kalemde gerçek ürün etiketi ve doğru biçim gereklidir. |
ByXml kullanın ve sevkiyat numarasını kök IdisSevkiyatNo alanında gönderin. UBL’nin şema ve şematrona uygun olması, kullanılan endpointin İDİS desteği veya elektronik imzanın geçerliliği yerine geçmez.DespatchAdvice ve ReceiptAdvice içindeki elemanlar, alt bileşenleriyle birlikte ilgili GİB UBL-TR XSD’sindeki xs:sequence sırasına uymalıdır. Aynı alanların farklı sırada bulunması XSD doğrulamasını bozabilir. JSON alan sırası bu XML sırasını belirlemez; oluşturulan UBL’yi XSD ve şematronla doğrulayın. İmzalı XML’i sıralamak veya yeniden serileştirmek yerine orijinal byte’larını taşıyın.İmzalı ve İmzasız UBL
| İşlem | İmzasız içerik | İmzalı içerik / sınır |
|---|---|---|
AddOutgoingDespatchAdviceByUbl | IsSigned=false; platform imza kuyruğuna alır. | IsSigned=true yalnız gerçek elektronik imzalı dosya içindir. İmza doğrulanır; başarısız imza reddedilir. Doğrulanan dosya yeniden imza kuyruğuna alınmaz. |
UpdateOutgoingDespatchAdviceByUbl | IsSigned=false; güncellemeden sonra imza sürecine alınır. | Güncellemede IsSigned=false ile imzasız UBL gönderin. Bu işlemi orijinal elektronik imzayı koruyan bir yükleme yöntemi olarak kullanmayın. |
OutgoingDespatchAdviceUblPreview | UBL parse edilir, modele çevrilir ve önizleme için yeniden üretilir. | Önizleme sonucu imzanın kriptografik doğrulandığını veya orijinal imzanın korunduğunu kanıtlamaz. |
AddOutgoingReceiptAdviceByUbl | Yanıt modele çevrilir; standart yanıt oluşturma/imzalama süreci kullanılır. | Bu akış IsSigned değerini imzalı dosyayı aynen kabul etmek için kullanmaz; orijinal imzayı koruyan yükleme yolu olarak değerlendirmeyin. |
İmzalı dosyada kimlik, tarih, etiket, sevkiyat numarası veya byte dizisi değişirse imza yeniden üretilmelidir. Önce gerçek iş verilerini tamamlayın, sonra imzalayın; imzalı XML’i model üzerinden yeniden serileştirmeyin. IsZipped=true için FileBytes XML’in değil ZIP dosyasının orijinal byte’larının Base64 karşılığıdır.
UBL dosyasının orijinal byte’larını Base64 olarak taşıyın. Aşağıdaki örnek imzasız oluşturma içindir; dosyayı imzalamaz veya API’ye göndermez. Gerçek imzalı dosya yalnız imzalı oluşturma koşulları sağlandığında IsSigned=true ile gönderilir. ZIP kullanılıyorsa ZIP dosyasının byte’ları okunur ve IsZipped=true seçilir.
using System;
using System.IO;
using Newtonsoft.Json;
var request = new
{
FileBytes = Convert.ToBase64String(File.ReadAllBytes("irsaliye.xml")),
IsSigned = false,
IsZipped = false,
DespatchAdviceExternalId = "ERP-IRS-20260801-0001",
ReceiverIdentifier = "urn:mail:defaultpk@alici.example"
};
string jsonBody = JsonConvert.SerializeObject(request);
Operasyon Request'leri
Güncelleme ve önizleme işlemleri yukarıdaki tam belge gövdelerini kullanır. JSON için UpdateOutgoingDespatchAdvice / OutgoingDespatchAdvicePreview, XML için bunların ByXml son ekli endpointleri çağrılır. Aşağıdaki her işlemde endpoint seçimi ayrıca gösterilir.
Silme
Endpoint: POST /api/VbtApi/DeleteOutgoingDespatchAdvice
Body: OutgoingDespatchAdviceDeleteRequestModel (JSON)
{
"DespatchAdviceExternalId": "ERP-IRS-20260801-0001",
"Ettn": null,
"DespatchAdviceNumber": null
}Endpoint: POST /api/VbtApi/DeleteOutgoingDespatchAdviceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingDespatchAdviceDeleteRequestModel>
<DespatchAdviceExternalId>ERP-IRS-20260801-0001</DespatchAdviceExternalId>
</OutgoingDespatchAdviceDeleteRequestModel>Durum sorgusu
Endpoint: POST /api/VbtApi/GetOutgoingDespatchAdvicesStatus
Body: OutgoingDespatchAdviceSummaryStatusRequestModel (JSON). Bu çağrının ByXml karşılığı bulunmadığı için endpoint seçimi gösterilmez.
{
"EttnList": [
"11111111-2222-3333-4444-555555555555"
]
}
GİB'e gönderim
Endpoint: POST /api/VbtApi/SendOutgoingDespatchAdviceToGib
Body: OutgoingDespatchAdviceSendToGibRequestModel (JSON)
{
"DespatchAdviceExternalId": "ERP-IRS-20260801-0001",
"Ettn": "11111111-2222-3333-4444-555555555555"
}Endpoint: POST /api/VbtApi/SendOutgoingDespatchAdviceToGibByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingDespatchAdviceSendToGibRequestModel>
<DespatchAdviceExternalId>ERP-IRS-20260801-0001</DespatchAdviceExternalId>
<Ettn>11111111-2222-3333-4444-555555555555</Ettn>
</OutgoingDespatchAdviceSendToGibRequestModel>Fiili sevk tarihi
Endpoint: POST /api/VbtApi/UpdateOutgoingActualDespatchDate
Body: OutgoingActualDespatchDateUpdateRequestModel (JSON)
{
"Ettn": "11111111-2222-3333-4444-555555555555",
"ActualDespatchDate": "2026-08-01T09:30:00+03:00"
}Endpoint: POST /api/VbtApi/UpdateOutgoingActualDespatchDateByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingActualDespatchDateUpdateRequestModel>
<Ettn>11111111-2222-3333-4444-555555555555</Ettn>
<ActualDespatchDate>2026-08-01T09:30:00+03:00</ActualDespatchDate>
</OutgoingActualDespatchDateUpdateRequestModel>PDF çıktısı
Endpoint: POST /api/VbtApi/GetOutgoingDespatchAdvicePdf
Body: DespatchAdvicePdfRequestModel (JSON)
{
"DespatchAdviceEttns": [
"11111111-2222-3333-4444-555555555555"
]
}Endpoint: POST /api/VbtApi/GetOutgoingDespatchAdvicePdfByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<DespatchAdvicePdfRequestModel>
<DespatchAdviceEttns><string>11111111-2222-3333-4444-555555555555</string></DespatchAdviceEttns>
</DespatchAdvicePdfRequestModel>