Türkiye'de e-dönüşüm uygulamaları her yıl daha fazla işletmeyi kapsıyor. Artık asıl soru "e-faturaya geçmeli miyim?" değil, "faturayı kendi iş yazılımımdan nasıl sorunsuz keserim?" haline geldi. Bu yazıda e-Fatura ve e-Arşiv'in temel farklarını ve bir stok, satış veya servis programını bu sistemlere bağlarken dikkat edilmesi gereken teknik noktaları ele alıyoruz.
Önemli not: Geçiş zorunlulukları, ciro sınırları ve tarihler Gelir İdaresi Başkanlığı (GİB) tebliğleriyle belirlenir ve sık güncellenir. Kendi yükümlülüğünüzü mutlaka GİB'in güncel duyuruları ve mali müşaviriniz ile doğrulayın. Bu yazı mali veya hukuki danışmanlık değildir.
e-Fatura ve e-Arşiv farkı
- e-Fatura: İki e-Fatura mükellefi arasında düzenlenen elektronik faturadır. Fatura, GİB sistemi üzerinden alıcının sistemine elektronik olarak iletilir.
- e-Arşiv Fatura: Alıcı e-Fatura mükellefi değilse (örneğin bireysel müşteri veya e-Fatura'ya kayıtlı olmayan firma) düzenlenen elektronik faturadır. Alıcıya e-posta veya çıktı olarak iletilebilir.
Yani aynı işletme, müşterisinin durumuna göre bazı satışlarında e-Fatura, bazılarında e-Arşiv düzenler. Yazılımınızın bu ayrımı otomatik yapması gerekir.
Güncel çerçeveye kısa bakış
Genel kural olarak belirli bir brüt satış hasılatı sınırını aşan mükellefler (bu sınır 2022 ve sonrası için 3 milyon TL olarak uygulanıyor) ve e-ticaret gibi bazı sektörlerde faaliyet gösterenler e-Fatura'ya geçmekle yükümlüdür. Ayrıca son düzenlemelerle, e-Fatura kapsamında olmayan mükelleflerin düzenlediği faturaların da e-Arşiv olarak düzenlenmesi yönünde kapsam genişletilmiştir; bazı mükellef grupları için geçiş tarihleri ertelenmiştir. Ayrıntılar sık değiştiğinden güncel durumu mutlaka resmi kaynaktan kontrol edin.
Entegrasyon seçenekleri
1. GİB portalı
Faturaların GİB'in web arayüzünden elle düzenlenmesidir. Ücretsizdir ancak düşük hacimli işletmeler için uygundur; kendi yazılımınızla otomatik bağlantı kurmaz.
2. Özel entegratör
GİB tarafından yetkilendirilmiş özel entegratör firmaları, faturaları sizin adınıza sisteme iletir ve saklar. Çoğu entegratör web servis / API sunar. Kendi yazılımınızdan fatura kesmek için en yaygın yol budur.
3. Doğrudan entegrasyon
Kendi bilgi işlem sistemini GİB'e doğrudan bağlamak; yüksek hacimli ve teknik altyapısı güçlü kurumlar içindir, ciddi teknik ve idari gereksinimleri vardır.
Kendi yazılımınızı bağlarken teknik kontrol listesi
Mükellef sorgulama
Fatura keserken alıcının e-Fatura mükellefi olup olmadığı sorgulanmalı ve fatura türü buna göre seçilmelidir. Sorgu sonuçlarını kısa süreli önbelleğe almak performansı artırır.
UBL-TR formatı
e-Belgeler UBL-TR adı verilen XML standardına dayanır. Entegratör API'leri bu formatı çoğu zaman sizin yerinize üretir; yine de vergi oranları, istisna kodları ve birim kodlarının doğru eşlenmesi yazılımınızın sorumluluğundadır.
Numara ve tekrar gönderim kontrolü
Ağ hatası nedeniyle aynı faturanın iki kez gönderilmesi ciddi bir sorundur. Her fatura için benzersiz bir kimlik (örneğin ETTN/UUID) üretip gönderim durumunu kaydedin. Bu yaklaşım, ödeme entegrasyonlarındaki idempotency mantığıyla aynıdır.
Durum takibi
Gönderilen faturanın kabul, ret veya hata durumlarını takip edin. Özellikle ticari faturalarda alıcının yanıtı önemlidir. Durum değişikliklerini bir arka plan görevi ile düzenli sorgulamak veya entegratör destekliyorsa webhook kullanmak gerekir.
İptal ve iade süreçleri
İade faturası ve iptal kuralları mevzuata tabidir. Yazılımınız bu senaryoları kullanıcıya doğru seçeneklerle sunmalıdır.
Güvenlik
Entegratör API anahtarlarını kaynak koduna yazmayın; güvenli yapılandırma veya gizli anahtar yönetimi kullanın. Fatura verileri kişisel veri içerebileceğinden erişim yetkilerini sınırlayın.
Loglama ve yedek
Gönderilen her isteği ve alınan her yanıtı kayıt altına alın. Sorun çıktığında entegratör destek ekibiyle konuşurken bu kayıtlar hayat kurtarır.
Sık sorulan sorular
Hangi entegratörü seçmeliyim?
API dokümantasyonunun kalitesi, test ortamı sunup sunmadığı, destek hızı ve fiyatlandırma modeli önemli kriterlerdir. Muhasebe tarafıyla uyum için mali müşavirinizin görüşünü de alın.
Mevcut stok programıma e-fatura eklenebilir mi?
Programın veritabanına ve koduna erişim varsa çoğu durumda eklenebilir. Ürün, cari ve vergi bilgilerinin eksiksiz tutulması ön koşuldur.
Sonuç
e-Fatura ve e-Arşiv entegrasyonu, doğru kurgulandığında faturayı ayrı bir iş olmaktan çıkarıp satışın doğal bir adımına dönüştürür. Mevzuatı güncel takip edip teknik tarafta tekrar gönderim, durum takibi ve güvenlik konularına özen göstermek gerekir. Yazılımınıza e-dönüşüm entegrasyonu için teklif isteyebilirsiniz.