Entegrasyon ve API
E-Fatura Entegrasyonu Nasıl Yapılır?
E-fatura sisteminin temeli
Gelir İdaresi Başkanlığı (GİB) tarafından yürütülen e-fatura uygulamasında faturalar, UBL-TR adı verilen XML standardında düzenlenir ve elektronik ortamda iletilir. Alıcı e-fatura mükellefiyse fatura e-fatura olarak, değilse e-arşiv fatura olarak düzenlenir.
Entegrasyon yöntemleri
- GİB portalı: Faturaların web arayüzünden elle düzenlenmesi. Düşük hacim için uygundur, otomasyon sağlamaz.
- Özel entegratör: GİB'den izinli firmalar API sunar; yazılımınız faturayı bu API'ye gönderir. En yaygın ve pratik yöntemdir.
- Doğrudan entegrasyon: Kendi sistemini GİB'e doğrudan bağlamak; yüksek teknik ve yasal yükümlülük gerektirir, büyük ölçekli firmalar tercih eder.
Özel entegratör ile entegrasyon adımları
- Entegratör seçimi ve hesap açılışı: Test ortamı erişim bilgileri alınır.
- Veri eşleştirme: Yazılımınızdaki müşteri, ürün, vergi ve birim alanlarının UBL-TR alanlarıyla eşleştirilmesi (KDV oranları, istisna kodları, birim kodları gibi).
- Mükellef sorgulama: Alıcının e-fatura mükellefi olup olmadığının ve etiketinin (posta kutusu) sorgulanması.
- Fatura oluşturma ve gönderme: Faturanın API'ye iletilmesi, dönen ETTN (benzersiz numara) ve durum bilgisinin kaydedilmesi.
- Durum takibi: Gönderildi, alıcıya ulaştı, kabul/red (ticari faturada) durumlarının izlenmesi.
- Gelen faturalar: Tedarikçilerden gelen e-faturaların otomatik çekilmesi.
- PDF ve arşiv: Fatura görüntüsünün oluşturulması ve yasal saklama.
- Test ve canlıya geçiş.
Sık yapılan hatalar
- KDV ve istisna kodlarının yanlış eşleştirilmesi
- Alıcının mükellefiyet durumunu her faturada sorgulamamak
- Ağ hatalarında aynı faturanın iki kez gönderilmesi; işlemler tekrar edilebilir (idempotent) tasarlanmalı
- Red veya hata dönen faturaları takip etmemek
Not
E-fatura mevzuatı ve teknik kılavuzlar zaman zaman güncellenir. Yükümlülükleriniz için mali müşavirinize danışmanızı öneririz.
Sonuç
E-fatura entegrasyonu, faturalama sürecini hatasız ve otomatik hale getirir. entegrasyon ve API geliştirme hizmetimizi inceleyebilir veya ücretsiz keşif görüşmesi talep edebilirsiniz.