E-fatura entegrasyonu nedir, kendi yazılımınızı Gelir İdaresi'ne nasıl bağlarsınız?
E-fatura entegrasyonu, kendi muhasebe, ERP veya e-ticaret yazılımınızın faturayı elektronik biçimde üretip Gelir İdaresi Başkanlığı'nın (GİB) belirlediği standartla göndermesi ve gelen faturaları almasıdır. Bunu üç yoldan biriyle yaparsınız: GİB'in ücretsiz portalı, yazılımınızı doğrudan GİB sistemine bağlayan doğrudan entegrasyon ya da GİB'den izin almış bir özel entegratör. Yazılımınızı bağlamak istiyorsanız genellikle ikinci veya üçüncü yol gündeme gelir.
Önce temel bilgi. GİB'in eBelge sitesine göre e-fatura, 213 sayılı Vergi Usul Kanunu'nda faturada bulunması gereken bilgileri taşıyan, kâğıt faturayla aynı niteliklere sahip elektronik bir belgedir. Satıcıdan alıcıya iletim merkezi bir platform (GİB) üzerinden yapılır ve veri biçimi olarak XML tabanlı UBL-TR standardı kullanılır. E-fatura uygulamasına kayıtlı mükellefler birbirlerine sattıkları mal ve hizmetler için faturayı e-fatura olarak göndermek ve almak zorundadır. Kayıtlı olmayan alıcıya ise kâğıt fatura ya da, e-Arşiv uygulamasına dahilseniz, e-Arşiv fatura düzenlenir.
Yani entegrasyon tek bir iş değil, iki ayrı karardır: hangi belge türü (e-fatura, e-Arşiv, e-irsaliye) ve hangi bağlantı yolu. Hangi uygulamaya girmeniz gerektiğini mali müşavirinizle ve GİB'in güncel geçiş takvimiyle birlikte netleştirin; kapsam tebliğlerle değişebilir.
E-fatura, e-Arşiv ve e-irsaliye arasındaki fark nedir, hangi yol hangisine uyar?
Üçü de GİB'in eBelge uygulamalarıdır ama farklı belgeleri ve farklı alıcıları kapsar. Aşağıdaki tablo, belge türlerini ve bağlantı yollarını entegrasyon açısından karşılaştırır. Yazılımınızın hangilerini üreteceğini baştan bilmeniz geliştirme kapsamını belirler.
| Seçenek | Ne için kullanılır? | Entegrasyonda dikkat |
|---|---|---|
| e-Fatura | Kayıtlı mükelleften kayıtlı mükellefe fatura | Alıcının kayıtlı olup olmadığı sorgulanır |
| e-Arşiv Fatura | Kayıtlı olmayan alıcıya elektronik fatura | Ayrı kılavuz ve iletim kuralları var |
| e-İrsaliye | Sevk irsaliyesinin elektronik hali | Yalnızca tebliğle kapsama giren gruplar |
| GİB portalı | Ücretsiz web uygulaması, elle fatura | Yazılım bağlantısı değil, dosya yükleme |
| Özel entegratör | İzinli kuruluşun sistemi üzerinden gönderim | Yazılımınız entegratörün servisine bağlanır |
| Doğrudan entegrasyon | Kendi sisteminiz GİB'e bağlanır | 7/24 kesintisiz bağlantı gerekir |
E-Arşiv'in kapsamı e-Arşiv uygulaması sayfasında anlatılıyor: izin alan mükellef, e-fatura kayıtlı alıcılara e-fatura, kayıtlı olmayanlara ve vergi mükellefi olmayanlara e-Arşiv fatura düzenler; e-Arşiv fatura alıcının talebine göre kâğıt veya elektronik ortamda iletilir. E-irsaliye ise belirli sektör ve mükellef gruplarına tebliğle zorunlu tutulmuştur. Sizin için geçerli olup olmadığını GİB'in uygulamalara geçiş takvimi tablosundan kontrol edin.
Portal, doğrudan entegrasyon ve özel entegratör: hangisi size uyar?
GİB üç yararlanma yöntemi tanımlıyor ve her birinin kime göre olduğunu açıkça söylüyor.
- Portal: GİB'in ücretsiz sunduğu web uygulaması. e-Fatura Portalı, entegrasyon için yeterli altyapısı olmayan kullanıcılar içindir. Faturayı portalda elle oluşturabilir veya kendi sisteminizde GİB'in belirlediği biçimde hazırlayıp portala yükleyebilirsiniz. Yazılımınızla anlık bağlantı sunmaz.
- Doğrudan entegrasyon: Bilgi işlem sisteminin entegrasyonu yöntemi, kendi sistemini GİB sistemine bağlayıp 7/24 kesintisiz bağlantı sağlayabilen mükellefler için geliştirilmiştir. Elektronik başvurudan ve TÜBİTAK - KamuSM'nin mali mühür sertifikasını teslim etmesinden sonra BİS raporu ve test tanım formu gönderilir.
- Özel entegratör: Özel entegrasyon, faturalama ihtiyaçları farklı olan veya çok sayıda fatura düzenleyen, kendi altyapısı yetersiz mükellefler içindir. GİB'den izin almış bir kurumun sistemi üzerinden fatura alıp gönderirsiniz. İzinli kurumların listesi eBelge sitesinde yayınlanır; sözleşmeden önce firmanın o listede olduğunu kontrol edin.
Pratik kural: faturalarınız ERP'de ya da kendi yazılımınızda üretiliyorsa ve elle portal kullanmak sürdürülebilir değilse, çoğu işletme özel entegratörün servisine bağlanır. Doğrudan entegrasyon, bağlantının sürekliliğini ve sertifika yönetimini kendinizin üstlenmesi demektir.
Yazılımınızı e-faturaya bağlarken hangi adımlar izlenir?
Hangi yolu seçerseniz seçin, teknik iş benzer parçalardan oluşur. Doğrudan entegrasyonda GİB'in kılavuzlarını, özel entegratörde entegratörün API belgesini esas alırsınız. GİB'in mevzuat ve teknik mimari sayfasında entegrasyon kılavuzu, zarf ve sistem yanıtı şemaları, UBL-TR kılavuzları ve paketi yer alır.
- Kapsamı yazın. Hangi belgeler (e-fatura, e-Arşiv, e-irsaliye), hangi kaynaklar (ERP, e-ticaret sitesi, abonelik sistemi) ve ayda yaklaşık kaç belge olduğunu belirleyin.
- Yolu seçin. Portal, özel entegratör veya doğrudan entegrasyon. Karar için aşağıdaki soruları kullanın.
- Başvuru ve sertifika. Doğrudan yolda elektronik başvuru ve mali mühür sertifikası gerekir. Özel entegratörde başvuru adımlarını sözleşmeden önce entegratöre sorun.
- Veri eşlemesi. Faturanızdaki alanları UBL-TR alanlarına eşleyin: taraf bilgileri, vergi kimlikleri, kalemler, KDV oranları, istisna kodları, para birimi. Eşleme tablosu hata ayıklamanın ana belgesi olur.
- Alıcı sorgusu. Fatura kesmeden önce alıcının e-fatura kayıtlı kullanıcı olup olmadığına bakıp belge türünü ona göre seçin. GİB kayıtlı kullanıcı listelerini yayınlar.
- Test ortamı. Gerçek faturaya geçmeden önce test uçlarında deneyin. GİB'in e-Fatura Test Portalı var; entegratörlerin de kendi test ortamları olur.
- Durum takibi. Gönderilen her faturanın durumunu (kabul, red, hata) yazılımınıza geri alıp kullanıcıya gösterin.
- Saklama. Düzenlenen ve alınan faturaların saklama süresini ve yöntemini mali müşavirinizle netleştirin.
Entegratör ya da doğrudan bağlantı seçerken hangi soruları sormalısınız?
Seçimi yalnızca fiyat tablosu değil, şu sorular yönlendirmeli. Teklifleri aynı kapsam üzerinden isteyin, çünkü kalem ve ölçü her firmada farklı kurgulanır.
- Firma GİB'in yayınladığı özel entegratör listesinde mi?
- API belgesi açık mı ve hangi biçimleri (UBL-TR XML, JSON) kabul ediyor?
- Test ortamı var mı, gerçek faturadan önce denenebiliyor mu?
- Hata kodları ve red nedenleri API yanıtında anlaşılır biçimde dönüyor mu?
- Gelen faturalar yazılımınıza otomatik aktarılabiliyor mu?
- Sözleşme biterse arşivdeki faturaları dışa aktarabiliyor musunuz?
- Başka bir entegratöre geçerken yazılımınızda ne kadar değişiklik gerekir?
Son iki soru çoğu zaman unutulur. Entegratöre özel alanları yazılımın her yerine dağıtırsanız ileride firma değiştirmek yeni bir proje olur. Entegratör çağrılarını tek bir modülde toplamak bu riski küçültür.
Örnek: kendi sipariş yazılımı olan bir distribütör nasıl ilerler?
Örneğin ayda yaklaşık 1.200 fatura kesen, kendi sipariş yazılımını kullanan varsayımsal bir distribütör düşünün. Müşterilerinin bir kısmı e-fatura kayıtlı, kalanı küçük esnaf ve bireysel alıcı. Portalı elle kullanmak her fatura için veriyi yeniden girmek demektir; ayda 1.200 belgede bu hem yavaş hem hataya açıktır.
Firma özel entegratör yolunu seçer. Sipariş yazılımı onaylanan siparişi UBL-TR alanlarına dönüştürüp entegratörün servisine gönderir. Alıcı kayıtlıysa e-fatura, değilse e-Arşiv fatura düzenlenir. Her belgenin durumu yazılıma geri döner. Hatalı vergi kimlik numarasıyla reddedilen belgeler bir hata kuyruğunda toplanır; muhasebe çalışanı düzeltip yeniden gönderir.
İlk hafta kapsam ve eşleme tablosuna gider. Ardından test ortamında yaklaşık 50 örnek belge denenir: normal satış, iade, farklı KDV oranları, istisnalı satış, yabancı para birimi. Gerçek faturaya geçişin ilk gününde belgeler elle kontrol edilir. Bu sayılar yalnızca hesap mantığını göstermek içindir; sizin süreniz kaynak sisteme ve belge çeşidine göre değişir.
E-fatura entegrasyonunda en sık yapılan hatalar nelerdir?
- Alıcı türünü kontrol etmemek. E-fatura kayıtlı alıcıya e-fatura göndermek zorunludur; belge türünü alıcı sorgusuna göre seçin.
- Hata durumlarını tasarlamamak. Reddedilen veya yanıt vermeyen belge için kuyruk, yeniden deneme ve uyarı yoksa fatura sessizce kaybolabilir.
- Aynı faturayı iki kez göndermek. Ağ hatasında yeniden deneme yapıyorsanız her belgenin benzersiz kimliğini saklayın ve çift gönderimi engelleyin.
- Vergi alanlarını varsayılan bırakmak. KDV oranı ve istisna durumları kalem bazında doğru dönmelidir; bunları mali müşavirinizle birlikte test edin.
- Sertifika sahipsiz kalmak. Mali mühür sertifikasının süresi ve şifresi kimsenin sorumluluğunda değilse bağlantı bir sabah kesilebilir.
- Entegratöre bağımlı kod yazmak. Entegratör çağrılarını ayrı bir katmana koymazsanız firma değiştirmek pahalı olur.
Hatson Tech bu konuda nasıl yardımcı oluyor?
Hatson Tech, mevcut muhasebe, ERP veya e-ticaret yazılımınızı e-fatura ve e-Arşiv akışına bağlayan özel yazılım geliştirme hizmeti verir: kapsamın çıkarılması, eşleme tablosu, entegratör bağlantısı, hata kuyruğu ve durum ekranları. İlk görüşme ve keşif ücretsizdir. Sabit fiyat yayınlamıyoruz, çünkü maliyet belge çeşidine ve kaynak sistemlere göre değişir. Vergi yükümlülüğünüz konusunda mali müşavirinizin görüşü esastır; biz teknik tarafı kurarız.
Eski bir sistemi yenilemeyi düşünüyorsanız uygulama modernizasyonu karar rehberimize, gelen faturalar gibi belgeleri otomatik işlemek istiyorsanız belge işleme otomasyonu yazımıza bakabilirsiniz.