Gelen Fatura

Gelen Fatura Senaryoları

Gelen faturada otomatik sonuç, kabul/red uygulama yanıtı, ERP aktarımı, iptal ve itiraz senaryoları.

Senaryo Kapsamı

Gelen e-Fatura entegrasyonu, GİB üzerinden firmaya ulaşan belgenin yerel sisteme güvenli biçimde alınmasıyla başlar. Her belge ETTN ile tekilleştirilir; profil davranışı belirlendikten sonra ERP kaydı oluşturulur ve yalnızca uygulama yanıtı bekleyen faturalar için kabul veya red kararı gönderilir.

Karar noktası	Soru	İzlenecek sayfa
Belgeyi alma	ETTN daha önce ERP'ye işlendi mi?	Bu sayfadaki ERP'ye alma senaryosu
Profil davranışı	Belge otomatik mi sonuçlanır, uygulama yanıtı mı bekler?	Profil davranış tablosu
Durum geçişi	Kabul/red yanıtı hangi teknik aşamalardan geçer?	Gelen Fatura Akışı
Sorumluluk	Entegratör ve platform hangi aşamayı üstlenir?	Gelen Fatura Sorumlulukları

Profil Davranışları

Gelen faturanın profili, manuel kabul/red çağrısı gerekip gerekmediğini belirler. Otomatik sonuçlanan profile uygulama yanıtı gönderilmez; yanıt bekleyen profile ise mevcut durum doğrulanmadan karar çağrısı yapılmaz.

Davranış	Profiller	Beklenen sonuç	Entegratör işlemi
Otomatik sonuç	`TEMELFATURA`, `KAMU`, `HKS`, `ENERJI`, `ILAC_TIBBICIHAZ`, `YATIRIMTESVIK`, `IDIS`	Belge kabul/red çağrısı beklemeden sonuçlanır.	Belgeyi ERP'ye alın; manuel uygulama yanıtı göndermeyin.
Uygulama yanıtı	`TICARIFATURA`, `YOLCUBERABERFATURA`, `IHRACAT`	`WaitingForApproveOrReject` durumunda karar bekler.	İş kararına göre kabul veya red gönderin ve nihai sonucu sorgulayın.

Otomatik Sonuçlanan Fatura

Belge otomatik sonuçlanan profillerden biriyle geldiğinde entegratörün görevi karar üretmek değil, belgeyi tekilleştirerek ERP'ye almaktır.

Adım	Uygulama	Başarı ölçütü
1	Belgeyi liste veya tekil sorguyla alın.	ETTN ve fatura numarası okunur.
2	ETTN'yi yerel tekil anahtarla karşılaştırın.	Aynı belge için ikinci ERP kaydı oluşmaz.
3	UBL/XML aslını ve gerekli görsel çıktıyı saklayın.	Elektronik asıl ile ERP kaydı ilişkilidir.
4	Yerel işlem tamamlandıktan sonra ERP durumunu güncelleyin.	`IsErpProcessed=true` yalnızca başarılı transaction sonrasında gönderilir.

Kabul Senaryosu

Yanıt bekleyen bir faturada kabul kararı, belge mevcut durumda karar alabiliyorsa gönderilir.

Kontrol	Beklenen	Sonraki adım
Profil	Uygulama yanıtı bekleyen profil	Durum kontrolüne geçin.
Mevcut durum	`WaitingForApproveOrReject` veya önceki yanıtı hatayla sonuçlanmış durum	`ForwardForApprove` kararını gönderin.
Çağrı sonucu	İstek kabul edildi	HTTP cevabıyla kapatmayın; `GetIncomingInvoicesStatus` ile nihai sonucu izleyin.
Nihai sonuç	`Approved`	ERP kaydını kabul edilmiş olarak kapatın.

Red Senaryosu

Red kararı da aynı uygulama yanıtı kanalını kullanır; fark, gönderilen karar ve nihai kullanıcı durumudur.

Kontrol	Beklenen	Sonraki adım
Karar	İş gerekçesi ve red açıklaması hazır	`ForwardForReject` kararını gönderin.
ERP kısıtı	Firma ayarı, ERP'ye işlenmiş belgenin reddine izin veriyor	Kısıt varsa yerel kaydı düzeltmeden red göndermeyin.
Cevap penceresi	Belge platformun uyguladığı cevap süresi içinde	Süreyi aşan yeni karar isteğinin reddedilebileceğini hesaba katın.
Nihai sonuç	`Rejected`	Red sonucunu ve açıklamasını ERP kaydıyla ilişkilendirin.

ERP'ye Alma ve Mutabakat

Listele

Filtreli ve sayfalı olarak yeni belgeleri al.

Tekilleştir

ETTN yerel sistemde var mı kontrol et.

Kaydet

Detay ve UBL/XML aslını aynı kayıtla ilişkilendir.

Kararı işle

Profil gerekiyorsa kabul/red sonucunu izle.

Mutabık kal

Yerel transaction tamamlanınca ERP işaretini güncelle.

Güvenli tekrar: Listeleme çağrısında aynı ETTN'nin yeniden dönmesi yeni bir fatura anlamına gelmez. Tekilleştirme kontrolü API sayfasından veya tarihinden bağımsız olarak her kayıtta uygulanmalıdır.

İptal ve İtiraz Senaryoları

İşlem	Ön koşul	Beklenen davranış
İptal	Profil `TEMELFATURA` veya `ILAC_TIBBICIHAZ`; belge ETTN ile bulunabiliyor	`CancelIncomingInvoice` kullanılır; desteklenmeyen profil hata ile reddedilir.
İtiraz	İtiraz belgesi, tarihi, numarası, türü ve açıklaması hazır	`ObjectIncomingInvoice` ile kayıt platforma yansıtılır.
Red	Belge uygulama yanıtı bekliyor	İptal/itiraz yerine kabul-red uygulama yanıtı kullanılır.

Sınır Durumları

Durum	Risk	Güvenli yaklaşım
Liste çağrısı tekrarlandı	Mükerrer ERP kaydı	ETTN tekilliğini yerel veritabanında koruyun.
Kabul/red çağrısında timeout	Aynı veya ters kararın ikinci kez gönderilmesi	Önce gelen fatura durumunu sorgulayın.
`TEMELFATURA` veya `ILAC_TIBBICIHAZ` dışındaki bir profil için doğrudan iptal istendi	`InvalidIncomingInvoiceProfileIdForCancelOperation`	Profilin desteklediği kabul/red veya itiraz sürecini kullanın.
Toplu sorguda bazı satırlar hatalı	Tüm partinin başarılı kabul edilmesi	Her ETTN sonucunu bağımsız işleyin.
UBL ile PDF farklı amaçlarda kullanılıyor	Görsel çıktının elektronik asıl sanılması	UBL/XML'i elektronik asıl, PDF/HTML'i kullanıcı görünümü olarak saklayın.