Gelen Fatura

Gelen Fatura Sorumlulukları

Gelen faturayı tekilleştirme, ERP'ye alma, uygulama yanıtı, güvenli tekrar ve mutabakat sorumlulukları.

Sorumluluk Sınırı

Gelen fatura tarafında platform GİB'den alınan belgeyi sorguya açar ve uygulama yanıtını iletir; entegratör belgeyi tekilleştirir, ERP'ye işler, profile göre karar gerekip gerekmediğini belirler ve nihai sonucu yerel kayıtla mutabık kılar.

Aşama	Entegratör	Platform	Başarı kanıtı
Belgeyi alma	Listeyi filtreli/sayfalı çeker ve her ETTN'yi tekilleştirir.	GİB'den alınan belgeyi liste, detay ve çıktı endpointlerine açar.	Aynı ETTN için tek ERP kaydı vardır.
Profil kararı	Belgenin manuel kabul/red gerektirip gerektirmediğini kontrol eder.	Profilin gözlenebilir kullanıcı durumunu döner.	Otomatik profile gereksiz yanıt gönderilmez.
Uygulama yanıtı	Karar verilebilen durumda kabul veya red gönderir ve sonucu izler.	Yanıtı oluşturur, imzalar ve GİB/gönderici tarafına iletir.	Nihai durum `Approved` veya `Rejected` olur.
ERP mutabakatı	Yerel transaction tamamlandıktan sonra işleme bayrağını günceller.	ERP işleme durumunu belgeyle birlikte saklar.	Platform ve ERP aynı ETTN üzerinde uzlaşır.

Belge Alma ve Tekilleştirme

Kontrol	Entegratör sorumluluğu	Platform davranışı
Artımlı liste	Tarih, durum ve sayfalama filtresini kalıcı checkpoint ile yönetin.	Eşleşen gelen faturaları özet veya ayrıntılı modelle döner.
Tekil anahtar	ETTN için veritabanı seviyesinde tekillik uygulayın.	Aynı belge sonraki liste çağrılarında yeniden dönebilir.
Elektronik asıl	UBL/XML'i fatura numarası ve ETTN ile ilişkilendirin.	XML/UBL paketi ve gerekli görsel çıktıları sağlar.
Okundu bilgisi	Kullanıcı görünümünü açma ile ERP'ye işleme kararını karıştırmayın.	Görüntüleme ve ERP işleme durumlarını ayrı alanlarda tutar.

Kabul/Red Kararı

Ön koşul	Entegratör kontrolü	Uygun değilse
Profil	Belgenin uygulama yanıtı bekleyen profillerden biri olduğunu doğrulayın.	Manuel yanıt göndermeyin.
Mevcut durum	`WaitingForApproveOrReject` veya önceki yanıtı hatayla sonuçlanmış durum olmalı.	Güncel durumu yeniden sorgulayın.
Karar	Yalnızca `ForwardForApprove` veya `ForwardForReject` gönderin.	Geçersiz karar request'i oluşturmayın.
Cevap penceresi	Platformun uyguladığı sekiz günlük cevap penceresini dikkate alın.	Süre sonrasında yeni kararın reddedilebileceğini işleyin.
ERP kısıtı	Red öncesinde firmanın ERP'ye işlenmiş belge kuralını kontrol edin.	Yerel kayıt düzeltilmeden red göndermeyin.

ERP İşleme ve Mutabakat

IsErpProcessed=true, faturanın yalnızca indirildiğini değil, yerel kayıt transaction'ının başarıyla tamamlandığını ifade etmelidir.

ETTN'yi ayır

Yeni ve daha önce işlenmiş belgeyi belirle.

Aslı sakla

UBL/XML ile ERP kaydını ilişkilendir.

Transaction'ı bitir

Yerel vergi, stok ve muhasebe kayıtlarını tamamla.

İşaretle

Başarıdan sonra ERP işleme durumunu güncelle.

Mutabık kal

Durum ve uygulama yanıtını periyodik doğrula.

Hata ve Güvenli Tekrar

Olay	Risk	Güvenli davranış
Liste çağrısı tekrarlandı	Mükerrer ERP kaydı	ETTN tekilliğini kontrol ederek mevcut kaydı güncelleyin.
Kabul/red cevabı alınamadı	Aynı veya ters kararın tekrarlanması	Önce `GetIncomingInvoicesStatus` ile güncel sonucu sorgulayın.
Yanıt iletim hatası	Belgenin yanlış terminal durumda kapatılması	Hata açıklamasını ve teknik durumu birlikte değerlendirin.
ERP transaction'ı yarıda kaldı	Belgenin işlenmiş görünmesi	İşleme bayrağını false tutup yerel işlemi güvenli biçimde yeniden başlatın.

İptal ve İtiraz Sorumluluğu

İşlem	Entegratörün sorumluluğu	Platformun davranışı
İptal	ETTN'yi ve profilin `TEMELFATURA` veya `ILAC_TIBBICIHAZ` olduğunu doğrular.	Desteklenmeyen profil veya bulunamayan belgeyi hata ile reddeder.
İtiraz	İtiraz belgesi, tarihi, numarası, türü ve açıklamasını eksiksiz gönderir.	İtiraz kaydını faturanın durumuna yansıtır.
Red	Yanıt bekleyen belge için uygulama yanıtı kanalını kullanır.	Kabul/red sonucunu gönderici tarafına iletir.

Canlıya Geçiş Kontrolü

Kapsam	Kabul kanıtı	Başarısızlık halinde
Artımlı alma	Sayfalama ve checkpoint ile yeni belgeler kayıpsız alındı.	Checkpoint ilerletilmez.
Tekilleştirme	Aynı ETTN tekrar geldiğinde ikinci ERP kaydı oluşmadı.	Yerel tekillik kuralı düzeltilir.
Belge çıktıları	UBL/XML aslı ve kullanıcı görünümü doğru amaçla saklandı.	Arşiv tamamlandı sayılmaz.
Profil davranışı	Otomatik ve yanıt bekleyen profil örnekleri ayrı işlendi.	Yanıt entegrasyonu üretime açılmaz.
Kabul/red	Başarılı, hatalı ve timeout senaryolarında kör tekrar oluşmadı.	Durum sorgusu zorunlu hale getirilir.
ERP mutabakatı	İşleme bayrağı yalnızca tamamlanan transaction sonrasında güncellendi.	Belge işlenmemiş durumda tutulur.