Giden İrsaliye
Giden İrsaliye Sorumlulukları
Belge hazırlama, güvenli gönderim, fiili sevk, durum takibi ve mutabakat sorumlulukları.
Sorumluluk Sınırı
Entegratör iş olayının doğru ve tekil verisini sağlar; platform bu veriyi doğrular, UBL'ye dönüştürür, imzalar, GİB'e iletir ve gözlenebilir durumu sunar. GİB veya alıcı sonucu gelmeden ERP kaydı tamamlanmış sayılmamalıdır.
| Aşama | Entegratör | Platform | Kontrol kanıtı |
|---|---|---|---|
| Hazırlık | Profil, taraf, sevk zamanı, taşıma ve kalem verisini iş olayından üretir. | Model ve içerik kurallarını doğrular. | Önizleme sonucu / hata listesi |
| Tekilleştirme | DespatchAdviceExternalId değerini tekil ve kalıcı tutar. | Aynı dış referans veya numara tekrarını reddeder. | Dış referans + ETTN kaydı |
| UBL ve imza | JSON sözleşmesini eksiksiz gönderir ya da geçerli UBL sağlar. | JSON'u UBL'ye dönüştürür; şema/şematron ve imza sürecini yürütür. | Belge oluşturma cevabı |
| Gönderim | Oluşturma ve gönderim davranışını seçilen endpoint sırasına göre yönetir. | Belgeyi GİB kanalına iletir, hata ve ilerleme durumunu kaydeder. | Durum endpointi |
| Karşı taraf sonucu | Kabul, kısmi kabul veya red sonucunu ERP'de işler. | İrsaliye yanıtını alır ve giden belge durumuna yansıtır. | Güncel kullanıcı durumu |
| Mutabakat | Belge numarası, ETTN, dış referans ve ERP anahtarını birlikte saklar. | Liste, detay, UBL, PDF ve geçmiş çıktılarını sunar. | Periyodik karşılaştırma |
Güvenli Tekrar İlkesi
- Timeout sonrasında aynı iş olayı için yeni dış referans üretmeyin.
- Önce
DespatchAdviceExternalId, ETTN veya belge numarasıyla sorgulayın. - Kayıt bulunduysa mevcut belgenin durumunu izleyin.
- Kayıt yoksa aynı dış referansla kontrollü tekrar uygulayın.
Fiili Sevk ve Sonradan Güncelleme
Fiili sevk zamanı oluşturma anından farklı olabilir. İlk request'te doğru zaman biliniyorsa doğrudan gönderin; desteklenen durumda sonradan UpdateOutgoingActualDespatchDate ile ETTN bazında güncelleyin. Güncelleme cevabı sonrası belge durumunu yeniden kontrol edin.
Canlı Operasyon Kontrol Listesi
| Kontrol | Beklenen |
|---|---|
| Kimlik korelasyonu | Dış referans, ETTN ve belge numarası birlikte saklanır. |
| Oluşturma sonucu | Nihai teslim sayılmaz; durum ayrıca izlenir. |
| Terminal olmayan durum | Kontrollü aralıklarla yeniden sorgulanır. |
| Gönderim hatası | Yeni belge üretilmeden önce mevcut kayıt aranır. |
| Alıcı yanıtı | ERP'de ayrı bir iş sonucu olarak işlenir. |
| Arşiv | UBL/PDF, belge kimlikleriyle ilişkilendirilir. |