Teknik Temel
GİB Referansı
GİB e-İrsaliye paketi, UBL-TR belge yapıları, resmi kılavuzlar ve teknik gereksinimler.
GİB Paketi
e-İrsaliye paketi iki belge tipini kapsar: sevki bildiren DespatchAdvice ve teslim sonucunu bildiren ReceiptAdvice. Paket sürümü değiştiğinde XSD, şematron, profil kuralları ve özel kılavuzlar birlikte değerlendirilmelidir.
Kullanım Yöntemi
VBT API'de giden irsaliye, alan bazlı JSON request'iyle veya entegratörün hazırladığı UBL dosyasıyla oluşturulabilir. Gelen irsaliye API'den okunur; teslim kararı gerekiyorsa asıl irsaliyeye bağlı ayrı bir ReceiptAdvice üretilir. JSON akışında UBL platform tarafından oluşturulur; hazır UBL akışında dosyanın tüm teknik doğruluğu entegratör tarafından sağlanır.
Teknik Gereksinimler
| Konu | Gereksinim | Entegrasyon kontrolü |
|---|---|---|
| Taraf kimliği | Gönderici ve alıcı VKN/TCKN bilgileri ile posta kutusu etiketi aynı mükellefi göstermelidir. | ReceiverIdentifier ile alıcı tarafını birlikte doğrulayın. |
| Adres | Gönderici ve alıcı posta adreslerinde ülke bilgisi bulunmalıdır. | PostalAddress.Country kümesini her iki tarafta gönderin. |
| Sevk zamanı | Düzenleme tarihi ile fiili sevk tarihi ve saati ayrı alanlardır. | IssueDate ve Shipment.Delivery.Despatch değerlerini iş olayıyla eşleştirin. |
| Gönderi ve taşıma | Shipment, gönderi kimliği ve taşıma bilgileri bulunmalıdır. | Taşıyıcı taraf veya sürücü/araç dalından geçerli olanı doldurun. |
| Kalemler | Her satırın kimliği, miktarı ve mal bilgisi bulunmalıdır. | LineCountNumeric ile DespatchLine sayısını eşleştirin. |
| Doğrulama | Model kontrolü, XSD ve şematron birbirinden ayrı geçiş kapılarıdır. | Önizleme sonucundaki tüm hata katmanlarını giderin. |
UBL Belge Standardı
Platformun ürettiği giden irsaliye ve irsaliye yanıtında aşağıdaki teknik kimlikler kullanılır. Hazır UBL dosyası da aynı değerleri taşımalıdır.
| Alan | DespatchAdvice | ReceiptAdvice |
|---|---|---|
UBLVersionID | 2.1 | 2.1 |
CustomizationID | TR1.2.1 | TR1.2.1 |
ProfileID | TEMELIRSALIYE, MATBUDAN veya IDISIRSALIYE | TEMELIRSALIYE |
| Belge tipi | DespatchAdviceTypeCode | ReceiptAdviceTypeCode=SEVK |
FileBytes alanına Base64 olarak gönderilir. IsZipped ve IsSigned değerleri gerçek dosya biçimiyle uyuşmalıdır. Önce OutgoingDespatchAdviceUblPreview, kayıt için AddOutgoingDespatchAdviceByUbl kullanın.Taraf Kimlikleri
| Taraf | UBL konumu | Gerekli bilgiler |
|---|---|---|
| Gönderici | cac:DespatchSupplierParty/cac:Party | VKN/TCKN, unvan/ad ve ülke içeren posta adresi |
| Alıcı | cac:DeliveryCustomerParty/cac:Party | VKN/TCKN, unvan/ad ve ülke içeren posta adresi |
| Taşıyıcı | cac:Shipment/cac:Delivery/cac:CarrierParty | Taşıyıcı kullanılıyorsa kimlik ve ad |
| Sürücü | cac:ShipmentStage/cac:DriverPerson | Sürücü kullanılıyorsa ad, soyad ve TCKN |
Profil ve Özel Senaryo Kuralları
| Kapsam | Ek kural | UBL/API karşılığı |
|---|---|---|
MATBUDAN | Matbu dayanak numarası ve tarihi bulunmalıdır. | AdditionalDocumentReference |
IDISIRSALIYE | Sevkiyat numarası SE- + 7 rakam; her kalemde etiket numarası 2 harf + 7 rakamdır. | SEVKIYATNO ve ETIKETNO |
| HKS | HKS kapsamındaki her kalemde 19 karakterli künye numarası bulunmalıdır. | AdditionalItemIdentification/ID[@schemeID='KUNYENO'] |
| İhracat | Türkiye'de mukim olmayan alıcı için kılavuzdaki kimlik ve GİB sanal alıcı yönlendirmesi uygulanır. | Gerektiğinde VKN=2222222222 |
| Çok aşamalı taşıma | Aynı sevkiyatın farklı ulaşım türleri ayrı güzergâhlar halinde belirtilir. | Shipment altında Delivery çoklanır. |
İrsaliye Yanıtı ve Yedi Günlük Süre
Alıcı, fiili sevk tarihinden itibaren yedi gün içinde kabul, kısmi kabul veya red yanıtı verebilir. Tam teslimde yanıt zorunlu değildir; yedi gün içinde yanıt verilmezse malların tamamının teslim alındığı kabul edilir. Eksik teslim varsa fiili miktarın zamanında kısmi kabul yanıtıyla bildirilmesi gerekir; platform süresi geçen yeni yanıtı kabul etmez.
Resmi Kaynaklar
Canlıya geçişte aşağıdaki bağlantıların güncel sürümleri ve GİB duyuruları yeniden kontrol edilmelidir.
| Kaynak | Kapsam |
|---|---|
| e-İrsaliye Uygulama Kılavuzu | Belge düzeni, yanıt süresi ve özel sevkiyat senaryoları |
| GİB e-Belge ana sayfası | Güncel paket ve duyurular |
| UBL-TR 1.2.1 Paketi | XSD ve şematron dosyaları |
| İDİS Teknik Kılavuzu | IDISIRSALIYE, SEVKIYATNO ve ETIKETNO |
| Karekod veya Barkod Standardı | Görsel üzerindeki karekod içeriği |