Gelen İrsaliye

Gelen İrsaliye Sorumlulukları

Gelen belgeyi tekilleştirme, ERP'ye alma, karar üretme, güvenli tekrar ve mutabakat sorumlulukları.

Uçtan Uca Sorumluluklar

Aşama	Entegratör	Platform	Tekilleştirme anahtarı
Alma	Listeyi kontrollü sayfalama ve zaman aralığıyla sorgular.	GİB'den alınan belgeyi liste ve detay API'lerinde sunar.	Gelen irsaliye ETTN'si
İçerik	Taraf, sevk, taşıma ve kalemleri ERP modeline dönüştürür.	UBL alanlarını API response modeline map eder; UBL/PDF çıktısını sunar.	ETTN + belge numarası
ERP	Kayıt başarılı olduktan sonra işleme durumunu günceller.	`IsErpProcessed` ve işlem dalını saklar.	ETTN + ERP kayıt anahtarı
Teslim kararı	Gerçek teslim miktarlarıyla kabul, kısmi kabul veya red gövdesi kurar.	Yanıtı doğrular, UBL `ReceiptAdvice` üretir ve gönderir.	Asıl irsaliye kimliği + yanıt ETTN'si
Yasal süre	Fiili sevk tarihinden başlayan yedi günlük karar penceresini ve teslim sonucunu izler.	Süresi geçen yeni yanıt request'ini reddeder; kalan gün bilgisini gelen belge görünümünde sunar.	Asıl irsaliye ETTN'si + süre sonu
Mutabakat	Başarısız/terminal olmayan kayıtları yeniden sorgular.	Yanıt durumunu, geçmişi ve çıktıları sunar.	Belge ve yanıt kimlikleri

Listele: Tarih aralığı, durum ve IsErpProcessed filtresiyle aday kayıtları alın.
Tekilleştir: ETTN daha önce ERP'ye işlendi mi kontrol edin.
Detayı al: API modelini veya UBL çıktısını indirin; satır ilişkilerini koruyun.
ERP'ye yaz: Yerel işlem tamamlanmadan işlenmiş bayrağı göndermeyin.
Karar ver: Gerçek teslim sonucuna göre gerekliyse irsaliye yanıtı üretin.
İzle: Yanıtın teknik ve kullanıcı durumunu terminal sonuca kadar takip edin.

Hata	Yapılacak işlem
Listeleme timeout'u	Aynı filtre ve sayfalama anahtarlarıyla tekrar okuyun; ETTN bazında tekilleştirin.
ERP yazma hatası	`IsErpProcessed=true` göndermeyin; yerel işlem geri alındıktan sonra tekrar deneyin.
Yanıt gönderme timeout'u	Yeni yanıt dış referansı üretmeden önce gelen irsaliye durumu ve mevcut yanıt çıktısını sorgulayın.
Durum uygun değil	Belgenin güncel kullanıcı durumunu alın; yalnız izin verilen bekleme/hata durumlarında tekrar gönderin.

Kontrol	Beklenen
Tekilleştirme	ETTN benzersiz ERP anahtarı olarak saklanır.
Sayfalama	Kayıpsız ve tekrar çalıştırılabilir.
ERP işareti	Yalnız yerel işlem tamamlandıktan sonra güncellenir.
Satır ilişkisi	Asıl irsaliye satır kimlikleri yanıta taşınır.
Yanıt süresi	Eksik teslim veya red kararı yedi gün dolmadan gönderilir; ERP işareti süre kontrolünün yerine geçmez.
Yanıt timeout'u	Yeni yanıt oluşturmadan önce mevcut durum sorgulanır.