Referans
Sıkça Sorulan Sorular
Profil seçimi, giden ve gelen irsaliye, irsaliye yanıtı, durum takibi, UBL/JSON ve operasyon hakkında sık sorulan sorular.
Konuyu hızlıca bulmak için önce aşağıdaki kanonik bölüme gidin; bu sayfadaki yanıtlar karar özetidir.
| Konu | Kaynak bölüm |
|---|---|
| Profil, özel sevkiyat ve taslak/onay kararı | Giden İrsaliye Senaryoları |
| Giden belge durumları ve alıcı sonucu | Giden İrsaliye Akışı |
| Gelen belge, ERP ve yedi günlük yanıt süresi | Gelen İrsaliye Akışı |
| Endpoint önkoşulları ve sonuçları | Giden ve gelen Entegratör API |
| Kopyalanabilir request gövdeleri | Giden request ve gelen işlem örnekleri |
| UBL sürümü, şema, özel GİB kuralları | GİB Referansı |
| Durum ve hata kodları | Teknik Referans |
Kullanım ve Operasyon
e-İrsaliye ile irsaliye yanıtı aynı belge midir?
Hayır. Sevk belgesi UBL DespatchAdvice, kabul/kısmi kabul/red yanıtı UBL ReceiptAdvice yapısındadır. İki yönün yaşam döngüsü başlangıç sayfasında birlikte özetlenir.
Hangi profili seçmeliyim?
Standart elektronik sevkte TEMELIRSALIYE, matbu dayanağın elektronik aktarımında MATBUDAN, İDİS kapsamındaki sevkte IDISIRSALIYE kullanın. Profil ve belge tipi eşleşmelerini karar tablosundan doğrulayın.
Belge oluşturulunca GİB'e ulaşmış olur mu?
Hayır. Oluşturma sonucu ETTN ve kayıt bilgisini verir; gönderim ve alıcı sonucunu durum endpointinden ayrıca izlemelisiniz.
Fiili sevk tarihi ile düzenleme tarihi aynı olmak zorunda mı?
Hayır. IssueDate belge düzenleme zamanıdır; fiili sevk zamanı Shipment.Delivery.Despatch altında ayrı tutulur.
MATBUDAN profili ne zaman kullanılır?
Sevk matbu belgeyle başlamış ve bu dayanak elektronik sisteme aktarılıyorsa kullanılır. Dayanak numarası ve tarihi AdditionalDocumentReference içinde gönderilir.
İDİS sevkiyatında hangi ek bilgiler gerekir?
IdisSevkiyatNo alanı SE- ve 7 rakam içermeli; her kalemde ETIKETNO şemalı 2 harf + 7 rakamlık değer bulunmalıdır.
Taşıyıcı firma yoksa irsaliye oluşturabilir miyim?
Evet; bu durumda taşıma aşamasında sürücü bilgilerini eksiksiz gönderin. Belge taşıyıcı taraf veya sürücü bilgilerinden en az birini içermelidir.
Gelen irsaliyeyi ERP'ye almak kabul anlamına gelir mi?
Hayır. ERP işleme bayrağı yerel aktarımı gösterir; kabul, kısmi kabul veya red ayrı bir irsaliye yanıtıdır.
Kısmi kabul nasıl temsil edilir?
Yanıt satırında teslim alınan miktar ile eksik, reddedilen veya fazla miktar gerçek teslim sonucuna göre ayrı alanlarda gönderilir. Yedi günlük karar penceresini yanıt akışıyla birlikte değerlendirin.
Yanıt vermeden belgeyi arşivleyebilir miyim?
Arşiv işareti portal görünümüdür ve resmi yanıt durumunu değiştirmez. Yanıt gerektiren iş olayını ayrıca tamamlayın.
PDF ile UBL arasında hangisi resmi içeriktir?
Entegrasyon ve veri doğrulama kaynağı UBL XML'dir. PDF/görsel okunabilir sunumdur; ERP mapping'i UBL/API alanlarından yapılmalıdır.
Alıcı reddederse giden belgede ne görürüm?
Giden kullanıcı durumu Rejected olur. Red gerekçesi ve satır miktarlarını ilişkili irsaliye yanıtından alın.
Teknik Entegrasyon
Timeout sonrasında aynı request'i yeniden gönderebilir miyim?
Önce dış referans veya ETTN ile mevcut kaydı sorgulayın. Kayıt varsa yeni kimlik üretmeyin; mevcut belgenin durumunu izleyin.
JSON mu hazır UBL mi göndermeliyim?
Alan bazlı entegrasyonda AddOutgoingDespatchAdvice; kendi UBL üretiminiz varsa AddOutgoingDespatchAdviceByUbl kullanın. Hazır UBL de şema/şematron kurallarına uymalıdır; model ve Base64 örneği request sayfasındadır.
Kaydetmeden doğrulama yapabilir miyim?
Evet. JSON için OutgoingDespatchAdvicePreview, hazır UBL için OutgoingDespatchAdviceUblPreview kullanın. Önkoşul ve sonraki adımlar kritik işlem tablosunda açıklanır.
Alıcı etiketi nereden gelir?
ReceiverIdentifier alıcının GİB posta kutusu etiketidir. VKN/TCKN ile aynı mükellefe ait güncel etiketi kullanın.
Belge numarasını platform üretebilir mi?
Evet. IsDocumentNumberIncluded=false ile numara üretimini platforma bırakabilirsiniz; dış referans yine ERP'de tekil olmalıdır.
Giden durumları toplu nasıl sorgularım?
GetOutgoingDespatchAdvicesStatus endpointine EttnList gönderin. Boş liste DSP0094 hatasına yol açar.
Listeleme sayfasında en fazla kaç kayıt isteyebilirim?
SearchRequestModel içindeki Take değeri en fazla 100'dür. Büyük aralıkları Skip/Take ile sayfalayın.
Gelen belgeyi nasıl tekilleştirmeliyim?
ETTN'yi ana teknik anahtar olarak saklayın; belge numarası ve zarf kimliğini mutabakat alanları olarak yanında tutun.
İrsaliye yanıtında ProfileId ve ReceiptAdviceTypeCode göndermeli miyim?
Platform, yanıtın ProfileId değerini TEMELIRSALIYE, ReceiptAdviceTypeCode değerini SEVK olarak uygular. Entegratörün asıl sorumluluğu doğru irsaliye referansı, satır bağlantısı ve teslim miktarlarıdır.
Kabul, kısmi kabul ve red ayrı endpointler mi?
Hayır. Üç karar da AddOutgoingReceiptAdvice ile, satır miktarları ve gerekçelerin farklılaştırıldığı ReceiptAdviceRequestModel üzerinden gönderilir.
Yanıt satırını asıl satıra nasıl bağlarım?
ReceiptLine[].DespatchLineReference.LineId alanına asıl DespatchLine.Id değerini yazın.
Yanıt gönderiminde hata alırsam yeni yanıt oluşturmalı mıyım?
Hayır. Gelen irsaliyenin güncel yanıt durumunu sorgulayın; karar türüne ait hata durumundaysa mevcut yanıtı güvenli tekrar akışında ilerletin.
ERP işleme bayrağını ne zaman güncellemeliyim?
Yerel ERP işlemi başarıyla ve kalıcı olarak tamamlandıktan sonra güncelleyin. Daha önce işaretlemek veri kaybı ve kaydın yeniden alınamaması riskini oluşturur.
Portal okundu veya arşiv durumu GİB sonucunu değiştirir mi?
Hayır. Bunlar kullanıcı arayüzü işaretleridir; resmi belge ve yanıt durumlarından ayrı tutulur.
İDİS sevkiyat numarasını UBL tarafına ayrıca eklemeli miyim?
JSON akışında IdisSevkiyatNo gönderilir; platform bunu gönderici tarafındaki SEVKIYATNO kimliğine taşır. Hazır UBL akışında ilgili UBL alanını sizin üretmeniz gerekir.
Hangi çıktıyı arşivlemeliyim?
ETTN ve belge numarasıyla ilişkilendirilmiş UBL XML'i esas alın; iş gereksiniminize göre PDF/görseli de saklayın. İrsaliye yanıtını ayrı belge kimliğiyle bağlayın; yön bazlı çıktı endpointlerini gelen API sözleşmesinden seçin.