e-İrsaliye

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
ProfileIdcbc:ProfileIDTEMELIRSALIYE veya IDISIRSALIYE.
DespatchAdviceNumbercbc:IDBelge numarası entegratörce sağlanıyorsa kullanılır.
UUIdcbc:UUIDETTN.
CopyIndicatorcbc:CopyIndicatorAsıl için false.
IssueDatecbc:IssueDateDüzenleme tarihi.
DespatchAdviceTypeCodecbc:DespatchAdviceTypeCodeSEVK veya MATBUDAN.
Note[]cbc:NoteHer eleman ayrı Note.
LineCountNumericcbc:LineCountNumericKalem sayısıyla uyumlu olmalıdır.

Taraflar ve Referanslar

JSON / XML model alanıUBL karşılığıNot
OrderReference[]cac:OrderReferenceSipariş üst referansları.
AdditionalDocumentReference[]cac:AdditionalDocumentReferenceMATBUDAN için dayanak belge burada taşınır.
DespatchSupplierPartycac:DespatchSupplierPartyGönderici taraf.
DeliveryCustomerPartycac:DeliveryCustomerPartyTeslim alan taraf.
BuyerCustomerPartycac:BuyerCustomerPartyVarsa satın alan taraf.
SellerSupplierPartycac:SellerSupplierPartyVarsa sağlayan taraf.
OriginatorCustomerPartycac:OriginatorCustomerPartyVarsa sevki başlatan taraf.
IdisSevkiyatNocac:DespatchSupplierParty/cac:Party/cac:PartyIdentification/cbc:ID
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.Idcac:Shipment/cbc:IDRequest doğrulamasında zorunludur; UBL gönderi kimliği düğümü platform tarafından oluşturulur.
Shipment.Delivery.DeliveryAddresscac:Shipment/cac:Delivery/cac:DeliveryAddressTeslim adresi; posta kodu doğrulanır.
Shipment.Delivery.CarrierPartycac:Shipment/cac:Delivery/cac:CarrierPartyTaşıyıcı firma dalı. Gönderildiğinde PostalAddress ve içindeki Country nesnesi bulunmalıdır.
Shipment.Delivery.Despatch.ActualDespatchDatecac:Shipment/cac:Delivery/cac:Despatch/cbc:ActualDespatchDateFiili sevk tarihi.
Shipment.Delivery.Despatch.ActualDespatchTimecac:Shipment/cac:Delivery/cac:Despatch/cbc:ActualDespatchTimeFiili sevk saati.
Shipment.ShipmentStage[].DriverPerson[]cac:Shipment/cac:ShipmentStage/cac:DriverPersonSürücü dalı; ad, soyad ve kimlik bilgisi gerekir.
Shipment.ShipmentStage[].TransportMeans.RoadTransport.LicensePlateIdcac:RoadTransport/cbc:LicensePlateIDAraç için yalnız PLAKA veya YABANCIPLAKA şeması kullanılır.
Shipment.TransportHandlingUnit[].TransportEquipment[].Idcac:TransportHandlingUnit/cac:TransportEquipment/cbc:IDDorse 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[].Idcac:DespatchLine/cbc:IDBelge içinde tekil satır kimliği.
DespatchLine[].DeliveredQuantitycac:DespatchLine/cbc:DeliveredQuantityDeğer ve unitCode.
DespatchLine[].OutstandingQuantitycac:DespatchLine/cbc:OutstandingQuantitySonradan gönderilecek miktar.
DespatchLine[].OutstandingReason[]cac:DespatchLine/cbc:OutstandingReasonEksik sevk gerekçesi.
DespatchLine[].OversupplyQuantitycac:DespatchLine/cbc:OversupplyQuantityFazla sevk miktarı.
DespatchLine[].OrderLineReferencecac:DespatchLine/cac:OrderLineReferenceHer kalemde zorunludur; LineId boş olamaz.
DespatchLine[].Itemcac:DespatchLine/cac:ItemÜrün adı ve tanımlayıcıları.
DespatchLine[].Item.AdditionalItemIdentification[]cac:DespatchLine/cac:Item/cac:AdditionalItemIdentification/cbc:IDİ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ı.