Giden Fatura
Giden Fatura Sorumlulukları
Giden fatura hazırlama, güvenli gönderim, durum takibi, mutabakat ve iptal/itiraz sorumlulukları.
Sorumluluk Sınırı
Giden fatura entegrasyonunda entegratör doğru ve tekil request'i hazırlayıp belge kimliklerini izler; platform request'i doğrular, UBL'yi üretir, imzalama ve GİB iletimini yürütür ve gözlenebilir durumu döner.
| Aşama | Entegratör | Platform | Başarı kanıtı |
|---|---|---|---|
| Mükellef ve etiket kontrolü | Alıcı VKN/TCKN, kayıt tarihi ve gerekiyorsa alıcı etiketini doğrular. | Mükellefiyet ve etiket kurallarını request kabulünde denetler. | Alan bazlı hata olmadan önizleme alınır. |
| Belge hazırlığı | Profil, belge tipi, taraflar, satırlar, vergiler ve toplamları gönderir. | UBL/XSD, Schematron ve profile özgü kuralları uygular. | HasError=false ve belge kimlikleri döner. |
| İmzalama ve gönderim | Aynı belgeyi yeniden oluşturmadan ETTN üzerinden izler. | Belgeyi imzalar, GİB'e ve alıcıya iletir. | Durum endpointinde ilerleyen teknik/kullanıcı durumu görülür. |
| Sonuç ve ERP | Nihai sonucu yerel kayıtla eşleştirir ve mutabakatı tamamlar. | GİB/alıcı sonucunu ve belge çıktılarını sorguya açar. | ERP, arşiv ve platform aynı ETTN üzerinde uzlaşır. |
Gönderim Öncesi Veri Hazırlığı
| Veri kümesi | Entegratörün kontrolü | Platformun kontrolü |
|---|---|---|
| Alıcı | VKN/TCKN, unvan/ad-soyad, adres ve uygun kimlik şemasını hazırlayın. | Alıcının e-Fatura kaydı, kayıt tarihi ve gönderilmişse etiketi doğrulanır. |
| Gönderici | Firma kimliği ve gönderici etiketini request ile uyumlu tutun. | Gönderici tarafı yetkili firma ve kanal bilgisiyle karşılaştırılır. |
| Profil ve tip | ProfileId ile InvoiceTypeCode kombinasyonunu Giden Fatura Senaryoları sayfasına göre seçin. | İzinli kombinasyon ve profile özgü alanlar doğrulanır. |
| Kalem ve tutarlar | En az bir satır; miktar, fiyat, vergi, iskonto/artırım ve toplam dengesini kurun. | UBL kardinalitesi, vergi kodları ve parasal tutarlılık kontrol edilir. |
| Özel referanslar | İhracat, HKS, YTB, İDİS ve ilaç/tıbbi cihaz alanlarını ilgili formatta doldurun. | Profilin zorunlu şema, uzunluk ve değer kümeleri uygulanır. |
Önizleme kuralı: Üretim çağrısından önce aynı request ile önizleme alın; hata listesini kapatmadan belge oluşturmayın.
Güvenli Gönderim ve Tekilleştirme
HTTP cevabının alınamaması belgenin oluşmadığını kanıtlamaz. Entegratör InvoiceExternalId, ETTN ve fatura numarasını aynı yerel kayıtla ilişkilendirerek belirsiz sonuçları yeni belge üretmeden çözmelidir.
| Olay | Kaçınılacak davranış | Güvenli davranış |
|---|---|---|
| Oluşturma çağrısında timeout | Yeni ETTN ile hemen tekrar göndermek | Dış referans ve varsa ETTN ile mevcut kaydı sorgulayın. |
| Durum bekliyor | Gönderim endpointini tekrar çağırmak | Mevcut ETTN'yi durum endpointiyle izleyin. |
| Toplu sorgunun bir satırı hatalı | Tüm partiyi tek sonuçla kapatmak | Her ETTN'yi bağımsız değerlendirin. |
| Yerel kayıt yarıda kaldı | ERP işleme bayrağını erken güncellemek | Yerel transaction tamamlanana kadar işlenmedi durumunu koruyun. |
Durum Takibi ve Mutabakat
Kimliği sakla
ETTN, fatura no ve dış referansı eşleştir.
Durumu sorgula
Teknik ve kullanıcı durumunu birlikte al.
Hatayı ayır
Request hatası ile iletim hatasını farklı işle.
Çıktıyı sakla
UBL/XML aslı ve gerekli kullanıcı görünümünü arşivle.
ERP'yi kapat
Nihai sonucu aynı ETTN üzerinde mutabık kıl.
Durumların geçiş sırası ve güvenli hata dönüşleri Giden Fatura Akışı, endpoint sözleşmeleri Gönderim ve Durum Takibi bölümündedir.
İptal ve İtiraz Sorumluluğu
| İşlem | Entegratörün sorumluluğu | Platformun davranışı |
|---|---|---|
| İptal | Belge kimliğini ve desteklenen profili doğrulayarak CancelOutgoingInvoice çağrısını yapar. | Desteklenmeyen profil veya bulunamayan belgeyi hata koduyla reddeder. |
| İtiraz | İtiraz belgesi, tarihi, numarası, türü ve açıklamasını eksiksiz gönderir. | İtiraz bilgisini belge durumuna yansıtır. |
| Alıcı reddi | Uygulama yanıtını durum sorgusundan alıp ERP'ye aktarır. | Alıcı yanıtını Rejected sonucuna dönüştürür. |
Canlıya Geçiş Kontrolü
| Kapsam | Kabul kanıtı | Başarısızlık halinde |
|---|---|---|
| Kimlik ve mükellefiyet | Token, kayıtlı/kayıtsız VKN, kayıt tarihi ve etiket hataları test edildi. | Belge oluşturma üretime açılmaz. |
| Kullanılan profiller | Her profil için başarılı ve zorunlu alanı eksik request çalıştırıldı. | Eksik profil kapalı tutulur. |
| Tutar doğruluğu | Satır, vergi ve genel toplam UBL ile birebir dengeli. | Request istemci tarafında reddedilir. |
| Asenkron sonuç | Bekleyen, başarılı, hata ve alıcı reddi durumları işlendi. | Belge yalnız HTTP cevabıyla gönderildi sayılmaz. |
| Kesinti dayanıklılığı | Timeout ve bağlantı kesintisinde mükerrer belge oluşmadı. | Dış referans/ETTN mutabakatı zorunlu tutulur. |
| Arşiv | UBL/XML aslı ve gerekli PDF/HTML görünümü aynı ETTN ile saklandı. | ERP kaydı tamamlandı sayılmaz. |