Giden İrsaliye
Giden İrsaliye Request Modeli → UBL Mapping
JSON ve platform XML modelindeki giden irsaliye alanlarının üretilen UBL DespatchAdvice XML içindeki karşılıkları.
Mapping Kapsamı
Kısa kural: JSON endpointi ile
ByXml endpointi aynı request modeline bağlanır. Aşağıdaki alan yolları JSON property adlarını ve platform XML modelindeki element adlarını birlikte ifade eder; hazır UBL girişi bundan farklıdır.Bu tablo, OutgoingDespatchAdviceRequestModel alanlarının üretilen UBL DespatchAdvice içindeki karşılığını gösterir. Her bağımsız alan ayrı satırdadır; noktalı JSON yolu dizi elemanlarını [] ile belirtir.
Belge Başlığı
| JSON / XML model alanı | UBL karşılığı | Not |
|---|---|---|
ProfileId | cbc:ProfileID | TEMELIRSALIYE veya IDISIRSALIYE. |
DespatchAdviceNumber | cbc:ID | Belge numarası entegratörce sağlanıyorsa kullanılır. |
UUId | cbc:UUID | ETTN. |
CopyIndicator | cbc:CopyIndicator | Asıl için false. |
IssueDate | cbc:IssueDate | Düzenleme tarihi. |
DespatchAdviceTypeCode | cbc:DespatchAdviceTypeCode | SEVK veya MATBUDAN. |
Note[] | cbc:Note | Her eleman ayrı Note. |
LineCountNumeric | cbc:LineCountNumeric | Kalem sayısıyla uyumlu olmalıdır. |
Taraflar ve Referanslar
| JSON / XML model alanı | UBL karşılığı | Not |
|---|---|---|
OrderReference[] | cac:OrderReference | Sipariş üst referansları. |
AdditionalDocumentReference[] | cac:AdditionalDocumentReference | MATBUDAN için dayanak belge burada taşınır. |
DespatchSupplierParty | cac:DespatchSupplierParty | Gönderici taraf. |
DeliveryCustomerParty | cac:DeliveryCustomerParty | Teslim alan taraf. |
BuyerCustomerParty | cac:BuyerCustomerParty | Varsa satın alan taraf. |
SellerSupplierParty | cac:SellerSupplierParty | Varsa sağlayan taraf. |
OriginatorCustomerParty | cac:OriginatorCustomerParty | Varsa sevki başlatan taraf. |
IdisSevkiyatNo | cac:DespatchSupplierParty/schemeID="SEVKIYATNO" | Platform IDISIRSALIYE profilinde bu kimliği ekler. Değer SE- veya ES- + tam 7 rakamdır. |
Sevkiyat ve Taşıma
| JSON / XML model alanı | UBL karşılığı | Not |
|---|---|---|
Shipment.Id | cac:Shipment/ | Request doğrulamasında zorunludur; UBL gönderi kimliği düğümü platform tarafından oluşturulur. |
Shipment.Delivery.DeliveryAddress | cac:Shipment/ | Teslim adresi; posta kodu doğrulanır. |
Shipment.Delivery.CarrierParty | cac:Shipment/ | Taşıyıcı firma dalı. Gönderildiğinde PostalAddress ve içindeki Country nesnesi bulunmalıdır. |
Shipment.Delivery.Despatch.ActualDespatchDate | cac:Shipment/ | Fiili sevk tarihi. |
Shipment.Delivery.Despatch.ActualDespatchTime | cac:Shipment/ | Fiili sevk saati. |
Shipment.ShipmentStage[].DriverPerson[] | cac:Shipment/ | Sürücü dalı; ad, soyad ve kimlik bilgisi gerekir. |
Shipment.ShipmentStage[].TransportMeans.RoadTransport.LicensePlateId | cac:RoadTransport/cbc:LicensePlateID | Araç için yalnız PLAKA veya YABANCIPLAKA şeması kullanılır. |
Shipment.TransportHandlingUnit[].TransportEquipment[].Id | cac:TransportHandlingUnit/cac:TransportEquipment/cbc:ID | Dorse için DORSE, DORSEPLAKA, YABANCIDORSE veya YABANCIDORSEPLAKA kullanılır; alan isteğe bağlıdır. |
Kalemler
| JSON / XML model alanı | UBL karşılığı | Not |
|---|---|---|
DespatchLine[].Id | cac:DespatchLine/ | Belge içinde tekil satır kimliği. |
DespatchLine[].DeliveredQuantity | cac:DespatchLine/ | Değer ve unitCode. |
DespatchLine[].OutstandingQuantity | cac:DespatchLine/ | Sonradan gönderilecek miktar. |
DespatchLine[].OutstandingReason[] | cac:DespatchLine/ | Eksik sevk gerekçesi. |
DespatchLine[].OversupplyQuantity | cac:DespatchLine/ | Fazla sevk miktarı. |
DespatchLine[].OrderLineReference | cac:DespatchLine/ | Her kalemde zorunludur; LineId boş olamaz. |
DespatchLine[].Item | cac:DespatchLine/ | Ürün adı ve tanımlayıcıları. |
DespatchLine[].Item.AdditionalItemIdentification[] | cac:DespatchLine/ | İDİS'te schemeID="ETIKETNO". |
Ayrıntı ve güncelleme çevrimi: Araç plakası ayrıntı yanıtında
RoadTransport.LicensePlateId, her dorse kimliği ise kendi TransportEquipment[].Id nesnesi içinde SchemeId ve Value alanlarıyla döner. Güncelleme isteği hazırlanırken bu iki alan birlikte korunmalıdır. İsteğe bağlı dorse Id değeri gönderilmemişse ayrıntı dönüşümünde yapay bir SchemeId veya Value üretilmez. Platform Alanları
DespatchAdviceExternalId, ReceiverIdentifier, LocationCode, FirmBranchCode, DatePosted, MailTo, XsltFileName, Barcode, PutDespatchAdviceNumberIntoQrCode ve PdfOrientation API/operasyon sözleşmesidir. Bunların tümü aynı adla UBL kök elemanı oluşturmaz; belge üretimi, yönlendirme veya görsel çıktı davranışını belirler.
İDİS alanları: JSON/platform XML’de sevkiyat numarasını kök
IdisSevkiyatNo alanında, UBL’de DespatchSupplierParty altında SEVKIYATNO kimliğinde taşıyın. Hazır UBL için hedef ortamın İDİS UBL girişini desteklemesi gerekir; destek teyit edilmediyse JSON veya ByXml kullanın. Veri kaynağı ve gönderim koşulları.