Referans
Teknik Referans
Profil, belge tipi, durum, hata kodu ve doğrulama kuralları.
Profil ve Belge Tipleri
| Profil | Sayısal değer | İzin verilen belge tipi | Ek kural |
|---|---|---|---|
TEMELIRSALIYE | 1 | SEVK | Standart sevk sözleşmesi. |
MATBUDAN | 2 | MATBUDAN | Dayanak belge referansı zorunlu. |
IDISIRSALIYE | 3 | SEVK | SEVKIYATNO ve kalem bazında ETIKETNO. |
Giden Kullanıcı Durumları
| Değer | Kod | Anlam | Terminal mi? |
|---|---|---|---|
WaitingToSend | 1 | Gönderim bekliyor. | Hayır |
Sending | 2 | Gönderim sürüyor. | Hayır |
Sent | 3 | Gönderildi; yanıt beklenebilir. | Hayır |
SendingFailed | 4 | Gönderim tamamlanamadı. | Hayır; kontrollü tekrar gerekir |
WaitingForApproval | 5 | Alıcı kararı bekleniyor. | Hayır |
Rejected | 6 | Reddedildi. | Evet |
Approved | 7 | Kabul edildi. | Evet |
PartiallyApproved | 8 | Kısmi kabul edildi. | Evet |
Gelen Yanıt Durumları
| Değer | Kod | Anlam |
|---|---|---|
ReceiptNotStarted | 3 | Yanıt süreci başlamadı. |
WaitingForReceipt | 5 | Karar/yanıt bekliyor. |
Approving | 6 | Kabul yanıtı gönderiliyor. |
PartiallyApproving | 7 | Kısmi kabul yanıtı gönderiliyor. |
Rejecting | 8 | Red yanıtı gönderiliyor. |
ReceiptSentForApproveWithError | 11 | Kabul yanıtı gönderiminde hata var. |
ReceiptSentForPartiallyApproveWithError | 12 | Kısmi kabul yanıtı gönderiminde hata var. |
ReceiptSentForRejectWithError | 13 | Red yanıtı gönderiminde hata var. |
Approved | 14 | Kabul yanıtı tamamlandı. |
Rejected | 15 | Red yanıtı tamamlandı. |
PartiallyApproved | 16 | Kısmi kabul yanıtı tamamlandı. |
Önemli Alan Kuralları
| Alan | Kural | Gözlenebilir hata kodu |
|---|---|---|
DespatchAdviceExternalId | Zorunlu ve ERP iş olayı için tekil. | DSP0012, DSP0061 |
ProfileId | Desteklenen üç değerden biri. | Eksikse SCM0002, geçersizse SCM0001 |
DespatchAdviceTypeCode | Zorunlu ve izin verilen değerlerden biri. | Eksikse SCM0002, geçersizse SCM0001 |
Shipment.Id | Gönderi kimliği zorunludur. | SCM0002 |
Shipment.Delivery.Despatch | Fiili sevk tarihi ve saati iş olayını yansıtmalıdır. | Eksik zorunlu alan için SCM0002 |
ReceiverIdentifier | Alıcının VKN/TCKN değeriyle eşleşen güncel GİB posta kutusu etiketi olmalıdır. | COM0030 |
| Taşıyıcı/sürücü | Taşıyıcı taraf veya sürücü listesinden en az biri; sürücüde ad, soyad ve TCKN. | Alan yolunu içeren doğrulama mesajı; kod alanı boş olabilir |
DespatchLine[].Id | Sayısal ve belge içinde tekil. | SCM0004, SCM0011 |
DeliveredQuantity | Değer ve geçerli birim kodu. | SCM0002 veya SCM0001 |
MATBUDAN referansı | Id ve IssueDate içeren en az bir kayıt. | Kuralı açıklayan doğrulama mesajı; kod alanı boş olabilir |
IDISIRSALIYE alanları | IdisSevkiyatNo ile her kalemde ETIKETNO bulunmalıdır. | SCHEME |
| İrsaliye yanıtı süresi | Eksik teslim veya red yanıtı fiili sevkten başlayan yedi günlük pencere içinde, izin verilen kullanıcı durumunda üretilir. | DSP0115 veya DSP0116 |
Hata Kodunu Okuma
| Kod biçimi | Kapsam | Entegratör davranışı |
|---|---|---|
DSPxxxx | e-İrsaliye kayıt, gönderim, durum ve yanıt işlemleri. | Kodu aşağıdaki işlem tablosuyla eşleştirin. |
RCPxxxx | İrsaliye yanıtı görsel, PDF ve UBL çıktıları. | İstenen çıktı türünü ve belge kimliğini kontrol edin. |
COMxxxx | Belge türleri arasında ortak kullanılan mükellef ve posta kutusu kontrolleri. | COM0030 için alıcı VKN/TCKN ile posta kutusu etiketini birlikte doğrulayın. |
SCMxxxx | UBL alan zorunluluğu, değer kümesi ve biçim denetimleri. | ErrorMessage içindeki alan yolunu düzelterek isteği yenileyin. |
SCHEME | İDİS gibi profile özgü içerik kuralları. | Mesajdaki profil alanını ve değer desenini düzeltin. |
| Boş kod | Bazı GİB iş kuralları alan yolunu yalnız mesajda bildirir. | Kod boş olsa da ErrorMessage değerini hata olarak işleyin. |
DSP Hata ve Sonuç Kodları
Aktif e-İrsaliye akışında gözlenebilen ve entegratörün doğrudan aksiyon alabileceği kodlar işlem ailesine göre gruplanmıştır.
| Kod | Anlam | Entegratör aksiyonu |
|---|---|---|
DSP0001 | İrsaliyenin UBL/XML dönüşümü tamamlanamadı. | İstek alanlarını ve üretilen UBL içeriğini kontrol edin. |
DSP0007 / DSP0064 | İrsaliye bulunamadı. | ETTN, dış referans veya kayıt kimliğini doğrulayın. |
DSP0009 / DSP0010 | Silme veya güncelleme başarısız. | Belgenin güncel durumunu alın; işlem uygunluğunu kontrol edin. |
DSP0012 | Dış referans eksik. | DespatchAdviceExternalId değerini ERP iş olayı için tekil olarak gönderin. |
DSP0020 | Entegratörün sağlaması gereken belge numarası eksik. | Numara üretim seçimini ve DespatchAdviceNumber değerini birlikte kontrol edin. |
DSP0024 / DSP0087 | Belge durumu istenen işlem için uygun değil. | Güncel durumu sorgulayın; izin verilen sonraki işlemi seçin. |
COM0017 | Belge gönderim işlemi sürerken silme veya yeniden gönderme istendi. | Yeni işlem üretmeden güncel durumu sorgulayın; aktif gönderim sonuçlanınca karar verin. |
DSP0036 | Giden irsaliye kaydı oluşturulamadı. | Aynı dış referansla sorgulama yapmadan yeni kayıt üretmeyin. |
DSP0060 / DSP0061 | Belge numarası veya dış referans daha önce kullanılmış. | Mevcut belgeyi sorgulayın; tekrar oluşturmaktan kaçının. |
DSP0063 | Belge numarası sıra kuralına uymuyor. | Numara üretim kaynağını ve seri/yıl sırasını düzeltin. |
DSP0094 | ETTN listesi boş. | PDF/XML/durum işlemine en az bir ETTN gönderin. |
DSP0101 | İmzalanmamış belge GİB'e gönderilemez. | Durum gönderime hazır olana kadar bekleyin. |
DSP0108 | Hazır UBL ayrıştırılamadı. | XML encoding, namespace ve UBL kök yapısını doğrulayın. |
DSP0112 | İrsaliye arşiv paketi güncellenemedi. | Belge durumunu değiştirmeden çıktı işlemini yeniden deneyin. |
DSP0115 / DSP0116 | İrsaliye yanıtı için izin verilen süre aşılmış. | Yeni yanıt üretmeyin; operasyon sürecini hata sonucuyla kapatın. |
İrsaliye Yanıtı Çıktı Kodları
| Kod | Anlam |
|---|---|
RCP0001 | Yanıt UBL/XML arşiv çıktısı hazırlandı. |
RCP0003 | Yanıt PDF çıktısı üretildi. |
RCP0005 | Yanıt görseli alındı. |
RCP0006 | Yanıt XML dönüşümü başarısız. |
RCP0007 | Yanıt arşiv dosyası güncellenemedi. |
RCP0008 | İrsaliye yanıtı bulunamadı. |
RCP0009 | Yanıt UBL içeriği ayrıştırılamadı. |