e-Fatura & e-Arşiv Entegrasyonu (Mükellef İşletme Yazılımlarına)

Bu entegrasyon, kendi iş yazılımını, ERP sistemini veya özel geliştirilmiş sipariş/muhasebe uygulamasını kullanan ve her gün onlarca ya da yüzlerce fatura kesen e-Fatura ve e-Arşiv mükellefi işletmeler için tasarlanmıştır.

Özellikle şu profillerdeki işletmeler bu entegrasyondan en yüksek verimi alır:

• Toptan ticaret ve distribütörler: Günlük yüzlerce satış faturası kesen, her birini ayrı ayrı portala girmek yerine tek akışla göndermek isteyen firmalar.
• Üretim ve imalat işletmeleri: Sevk irsaliyesi ve fatura süreçlerini ERP'ye entegre etmek, irsaliye-fatura eşleştirmesini otomatikleştirmek isteyen fabrikalar.
• Yazılım aboneliği ve hizmet firmaları: Aylık yüzlerce abonelik faturasını otomatik kesmek isteyen SaaS ve dijital hizmet şirketleri.
• Perakende zincirleri: POS verilerini merkezi bir sistemden e-Arşiv faturaya dönüştürmek isteyen çok şubeli işletmeler.
• SMMM ve YMM ofisleri: Birden fazla mükellefi adına e-fatura süreçlerini tek panelden yönetmek, her mükellefte ayrı portal şifresiyle uğraşmamak isteyen mali müşavirlik büroları.

Kısacası, fatura hacmi büyüdükçe manuel portala girişin getirdiği iş yükü ve hata riski katlanarak artar. Bu entegrasyon, o yükü tamamen kaldırır; muhasebe departmanınız veri girişi yerine analiz ve kontrol işine odaklanır.

GİB yetkili entegratör üzerinden kurulduğu için yasal uyumluluk garantilidir; işletmeniz hangi entegratörle sözleşme yapmışsa o altyapıyla çalışır, ekstra maliyet doğmaz.

Türkiye'de e-Fatura ve e-Arşiv zorunluluğu kapsamı her geçen dönem genişliyor. Ancak çoğu işletme bu zorunluluğu GİB portalına manuel fatura girişi yaparak ya da muhasebe yazılımından CSV dışa aktarıp yeniden yükleme yaparak karşılıyor. Bu yöntem kısa vadede "işe yarıyor" gibi görünse de aslında ciddi riskler barındırır.

Yaygın Sorunlar

• Satış ekibi faturayı kendi sistemine girer, muhasebe ayrıca portaldan girer: çift veri girişi, çift hata riski.
• Toplu XML/CSV aktarımlarında format hatası yaşanır, faturalar reddedilir; düzeltme için tekrar işlem gerekir.
• e-Arşiv faturaları farklı klasörlerde, farklı sürücülerde dağınık biçimde saklanır; vergi incelemesinde belge bulmak saatler alır.
• İptal ve itiraz süreçleri (GİB yanıt kodları) takip edilmez; alıcıya ulaşmayan faturalar fark edilmez.

Manuel Süreç ile Entegre Sistem Karşılaştırması

Bu tablo, e-fatura entegrasyonunun neden bir lüks değil, belirli bir fatura hacminin üzerindeki her işletme için operasyonel zorunluluk olduğunu açıkça ortaya koyuyor. 40.000 TL başlangıç yatırımı, ayda 200 faturanın üzerinde kesen bir işletmede birkaç ayda kendini amorti eder.

Entegrasyon süreci, mevcut sisteminizi kırmadan ve iş akışınızı bozmadan ilerleyecek şekilde tasarlanmıştır. Her adım belgelidir ve onayınız alınmadan bir sonraki aşamaya geçilmez.

Geliştirme Adımları

1. Keşif ve Analiz (Hafta 1–2): Mevcut yazılımınızın mimarisi, fatura akışı ve kullandığınız GİB yetkili entegratörün API dokümantasyonu incelenir. Hangi fatura tipleri (Satış, İade, İhracat, e-Arşiv) kapsama alınacağı netleştirilir.
2. Teknik Tasarım (Hafta 2–3): Entegrasyon mimarisi çizilir; hangi verilerin yazılımınızdan okunacağı, XML şemasına nasıl dönüştürüleceği ve entegratöre nasıl iletileceği belgelenir. Onayınız alınır.
3. Geliştirme — Çekirdek Entegrasyon (Hafta 3–5): Yazılımınızdan fatura verisi çekilmesi, GİB uyumlu UBL-TR XML oluşturulması, entegratör API'sine güvenli iletim ve GİB yanıt kodlarının işlenmesi geliştirilir.
4. Arşiv Modülü (Hafta 5–6): Gönderilen ve alınan faturaların 10 yıllık yasal saklama yükümlülüğüne uygun biçimde yapılandırılmış arşivde depolanması sağlanır; filtre ve dışa aktarım arayüzü eklenir.
5. Test Ortamı Doğrulaması (Hafta 6–7): GİB test ortamında gerçek senaryo testleri yapılır: başarılı gönderim, hatalı XML reddi, iptal akışı, zaman aşımı yönetimi.
6. Canlı Geçiş ve Paralel Çalışma (Hafta 7–9): Canlı ortama geçiş yapılır; ilk iki hafta eski yöntemle paralel çalışılarak sıfır kayıp garanti edilir.
7. Eğitim ve Devir (Hafta 9–10): Muhasebe ekibi ve mali müşavire kullanım eğitimi verilir; teknik dokümantasyon teslim edilir.

Kullanılan Teknoloji

Entegrasyon, GİB yetkili entegratörünüzün resmi API'si üzerinden çalışır. Hiçbir ekran kazıma (scraping) veya yetkilendirilmemiş erişim yöntemi kullanılmaz. Tüm veri iletimleri HTTPS/TLS ile şifrelenir. İmzalama işlemleri entegratörün kendi altyapısında gerçekleşir; mali mühür güvenliği tam anlamıyla korunur.

e-Fatura ve e-Arşiv süreçleri, yasal yükümlülük taşıdığından güvenlik en kritik önceliktir. Geliştirdiğimiz entegrasyon aşağıdaki güvenlik katmanlarıyla çalışır.

Veri Güvenliği

• Şifreli İletim: Yazılımınız ile entegratör arasındaki tüm fatura verisi HTTPS/TLS 1.2+ ile iletilir. Ağ üzerinde açık metin fatura verisi akmaz.
• API Kimlik Doğrulama: Entegratör API'sine erişim, işletmenize özel gizli anahtar (API key veya OAuth2 token) ile sağlanır. Bu anahtarlar veritabanında şifrelenmiş saklanır, kaynak koduna yazılmaz.
• Yetki Bazlı Erişim: Mali müşavir, muhasebe ve yönetici rolleri ayrı tanımlanır. Her kullanıcı yalnızca kendi yetkili olduğu faturalara ve raporlara erişebilir.
• Denetim Kaydı: Kimin hangi faturayı ne zaman gönderdiği, hangi GİB yanıtını aldığı log olarak saklanır. İtiraz durumunda kanıt niteliği taşır.

Yasal Uyumluluk

Entegrasyon, GİB'in yayımladığı teknik kılavuzlar ve UBL-TR şema gereksinimleri doğrultusunda geliştirilir. İmzalama işlemi doğrudan GİB yetkili entegratörünüzün altyapısında gerçekleşir; mali mühürünüz hiçbir zaman üçüncü bir sisteme aktarılmaz. 10 yıllık arşiv yükümlülüğü otomatik yönetilir; saklama süresi dolan belge yönetimi için otomatik uyarı sistemi devreye girer.

Canlıya geçiş öncesinde GİB test ortamında tam senaryo doğrulaması yapılır ve size yazılı test raporu teslim edilir.