e-Belge entegrasyonu görünüşte basit bir API çağrısı. Gerçekte ise dış servise bağımlı, yasal sonuçları olan ve geri alınamayan bir işlem. Mimari bunu dikkate almalı.
01. Senkron Çağrı Yapmayın
Fatura kaydetme ekranı entegratörün cevabını beklememeli. Belge önce kendi veritabanınıza yazılmalı, gönderim kuyruğa alınmalı. Aksi halde entegratördeki bir yavaşlama tüm satış ekranını kilitliyor.
02. Kuyruk ve Yeniden Deneme
Gönderim işi kuyruk üzerinden yürütülmeli, başarısız denemeler artan aralıklarla tekrarlanmalı. Sonsuz döngüye girmemesi için deneme sayısı sınırlı olmalı ve sınır aşıldığında insan uyarılmalı.
03. Çift Gönderim Koruması
Ağ kesintisinde istek gitmiş ama cevap dönmemiş olabilir. Her belge için tekil bir referans üretip entegratöre göndermek, aynı faturanın iki kez kesilmesini engelliyor. Bu koruma olmadan mükerrer belge kaçınılmaz.
04. Durum Takibi
Belgenin taslak, gönderildi, GİB'e ulaştı, kabul edildi, reddedildi durumları ERP'de görünür olmalı. Kullanıcı "faturam ne oldu" sorusunu entegratör paneline girmeden yanıtlayabilmeli.
05. Mutabakat İşi
Günlük olarak entegratördeki belge listesi ile ERP'deki liste karşılaştırılmalı. Aradaki fark küçükken fark edilir; ay sonunda fark edilirse kapanışı geciktirir.
06. Loglama
Gönderilen ve alınan ham veri, en az yasal saklama süresi boyunca tutulmalı. Bir uyuşmazlıkta kimin ne gönderdiğini kanıtlayan tek şey bu kayıtlar oluyor.