Sipariş geldi, ürün hazırlandı, sıra faturaya geldi: biri muhasebe programını açıyor, müşteri bilgilerini yeniden yazıyor, faturayı kesip entegratör portalına yüklüyor, sonra müşteriye gönderiyor. Günde birkaç fatura için bu kabul edilebilir; yüzlerce olduğunda hem zaman hem hata kaynağıdır. e-Fatura entegrasyonu, sipariş ve satış verisinden faturanın otomatik üretilmesini, e-Fatura ya da e-Arşiv olarak iletilmesini ve sonucun sisteminize geri yazılmasını sağlayan bağlantıdır.
Bu rehberde e-Fatura entegrasyonunun ne olduğunu, e-Fatura, e-Arşiv ve e-İrsaliye farkını, entegrasyonun adım adım nasıl çalıştığını, özel entegratör ile GİB portalı arasındaki farkı, hangi verilerin taşındığını, fatura durumları ve hata yönetimini, iptal ve iade akışını, entegratör seçerken sorulacak soruları ve altı adımlık kurulumu anlatıyoruz. Yazı mali ya da hukuki danışmanlık değildir; mevzuat ayrıntıları için Gelir İdaresi Başkanlığı (GİB) ve mali müşavirinize başvurun. Örnek rakamlar temsilîdir.
e-Fatura Entegrasyonu Nedir?
e-Fatura entegrasyonu, sizin yazılımınızla (ERP, e-ticaret altyapısı, muhasebe ya da özel sisteminizle) e-belge hizmeti veren özel entegratörün sistemi arasında faturanın otomatik üretilip gönderilmesini sağlayan yazılım bağlantısıdır. Sisteminiz fatura verisini hazırlar, entegratör faturayı standart biçime çevirip GİB üzerinden alıcıya iletir ve fatura durumunu size geri bildirir.
Entegrasyon olmadığında fatura ayrı bir portalda elle düzenlenir. Entegrasyonla ise satış ya da sipariş verisi doğrudan faturaya dönüşür; müşteri adı, vergi numarası, ürün, KDV ve tutar ikinci kez yazılmaz.
Okumanızı öneririz: Muhasebe yazılımı: cari, e-Fatura, kasa ve banka tek sistemde
e-Fatura, e-Arşiv ve e-İrsaliye Arasındaki Fark Nedir?
Üçü de elektronik belgedir, ancak kullanıldıkları alıcı ve işlem farklıdır. Hangisini kesmeniz gerektiği alıcının durumuna göre belirlenir ve entegrasyon bu ayrımı otomatik yapabilmelidir.
| Belge | Ne için kullanılır? | Alıcı kim? |
|---|---|---|
| e-Fatura | Satış faturası; GİB sistemi üzerinden alıcıya iletilir | e-Fatura sistemine kayıtlı işletmeler |
| e-Arşiv Fatura | Satış faturası; elektronik ortamda düzenlenir ve arşivlenir, alıcıya e-posta ya da bağlantıyla ulaşır | e-Fatura sistemine kayıtlı olmayan alıcılar ve son tüketiciler |
| e-İrsaliye | Mal sevkiyatına eşlik eden elektronik sevk irsaliyesi | Sevk edilen mal için ilgili taraflar |
Hangi işletmelerin e-Fatura ya da e-Arşiv'e geçmek zorunda olduğunu, sınırları ve istisnaları mevzuat belirler ve zaman zaman değişir; bu bilgiyi GİB'den ve mali müşavirinizden alın. İyi kurulmuş bir entegrasyon, alıcının e-Fatura mükellefi olup olmadığını sorgular ve faturayı doğru türde keser.
e-Fatura Entegrasyonu Nasıl Çalışır?
Altı adımda çalışır: sipariş ya da satış kaydı oluşur, sistem fatura verisini hazırlar, alıcının türü sorgulanır, fatura standart biçimde üretilip entegratöre gönderilir, entegratör GİB üzerinden iletir ve durum sisteminize geri yazılır.
- Satış kaydı: Pazaryeri, web sitesi ya da ERP'deki sipariş onaylanır ve fatura tetiklenir.
- Fatura verisi: Alıcı bilgisi, ürün satırları, KDV oranları ve toplamlar sistemden toplanır.
- Alıcı sorgusu: Alıcının e-Fatura mükellefi olup olmadığına göre e-Fatura ya da e-Arşiv seçilir.
- Üretim ve gönderim: Fatura standart XML biçiminde üretilir, her faturaya benzersiz bir kimlik (ETTN) verilir ve entegratöre iletilir.
- İletim: Entegratör faturayı GİB sistemi üzerinden alıcıya ulaştırır; e-Arşiv'de alıcıya bağlantı ya da e-posta gider.
- Durum geri yazımı: Faturanın gönderildi, iletildi ya da hata aldı bilgisi sisteminize döner ve fatura kaydında görünür.
Özel Entegratör mü, GİB Portalı mı, Kendi Entegrasyonunuz mu?
Üç yol vardır. Az sayıda faturada portal yeterli olabilir; fatura hacmi ve sistem sayısı arttıkça entegratör API'si üzerinden kendi yazılımınızla bağlantı kurmak en sürdürülebilir yoldur.
| Yol | Nasıl çalışır? | Ne zaman uygun? |
|---|---|---|
| GİB portalı | Faturalar GİB'in sunduğu ücretsiz arayüzde elle düzenlenir | Çok az sayıda fatura; sistem entegrasyonu gerekmeyen küçük işletmeler |
| Özel entegratörün paneli | Faturalar entegratörün kendi panelinde ya da toplu yükleme ile oluşturulur | Orta hacim; fatura verisi başka sistemlerden gelmiyor |
| Entegratör API'si ile entegrasyon | Sizin yazılımınız faturayı API üzerinden entegratöre gönderir, durumu geri alır | Yüksek hacim; sipariş, ERP ve muhasebeyle aynı akışta ilerlemesi gereken işletmeler |
Özel entegratörler, GİB'den izin almış ve e-belge hizmeti sunan kuruluşlardır. Yetkili entegratörlerin güncel listesi GİB'in resmi sayfasında yer alır; seçim yaparken yalnızca bu listedeki kuruluşlarla çalışın.
e-Fatura Entegrasyonu Hangi Verileri Taşır?
Fatura, alıcı, ürün satırı, vergi ve toplam olmak üzere dört veri grubundan oluşur. Sorunların çoğu bu verilerin eşleştirilmesinden çıkar; bu yüzden alanlar proje başında tek tek tanımlanır.
| Veri grubu | Taşınan alanlar | Sık görülen sorun |
|---|---|---|
| Alıcı | Unvan ya da ad-soyad, vergi kimlik ya da T.C. kimlik numarası, vergi dairesi, adres | Hatalı ya da eksik numara nedeniyle faturanın reddedilmesi |
| Ürün satırı | Ürün adı, miktar, birim kodu, birim fiyat, iskonto | Sistemdeki "adet" ile fatura birim kodunun uyuşmaması |
| Vergi | KDV oranı ve tutarı, istisna ya da muafiyet nedeni | İstisna nedeninin eksik girilmesi |
| Toplam ve ödeme | Matrah, KDV, genel toplam, para birimi, döviz kuru | Kuruş yuvarlaması ve döviz kuru farkından doğan toplam farkları |
İade ve iptal faturalarında ayrıca orijinal faturaya referans gerekir. Bu referansı saklamak için sisteminizde fatura numarası, ETTN ve sipariş numarası birbirine bağlı tutulmalıdır.
Fatura Durumları ve Hatalar Nasıl Yönetilir?
Her faturanın bir durumu vardır ve entegrasyon bu durumu görünür kılar. Hatalı faturanın fark edilmeden günlerce bekletilmesi, entegrasyonun en büyük riskidir.
| Durum | Anlamı | Yapılacak |
|---|---|---|
| Hazırlandı | Fatura sistemde üretildi, henüz gönderilmedi | Gönderim kuyruğunu izleyin |
| Gönderildi | Entegratöre iletildi | Sonucu bekleyin; süre aşılırsa uyarı verin |
| İletildi | Alıcıya ulaştı | İşlem tamam; kaydı kapatın |
| Hata | Doğrulamada reddedildi (örneğin hatalı numara) | Hata listesine düşer; sorumlu düzeltip yeniden gönderir |
İyi bir entegrasyon göndermeden önce ön kontrol yapar: numara biçimi, zorunlu alanlar ve vergi kodları doğrulanır. Örnek: 1.000 faturanın 968'i ilk denemede başarıyla iletildiyse ilk deneme başarı oranı 968 ÷ 1.000 = %96,8 olur; kalan 32 fatura hata listesinde bekler. Bu oranı haftalık izlemek, veri kalitesindeki sorunları erken gösterir.
Aynı fatura iki kez kesilmesin
Ağ kesintisinde cevabı alınamayan bir gönderim yeniden denendiğinde aynı fatura iki kez oluşabilir. Bunu önlemek için her fatura benzersiz bir kimlikle işaretlenir ve daha önce gönderilmiş bir kimlik ikinci kez işlenmez. Bu özellik (teknik adıyla idempotency), entegratöre sorulması gereken konulardan biridir.
Okumanızı öneririz: API entegrasyonu nedir? Sistemleri birbirine bağlama rehberi
İptal, İade ve Düzeltme Nasıl Yapılır?
Gönderilmiş bir faturayı sisteminizden silerek geri alamazsınız; iptal, iade ve düzeltme mevzuattaki kurallara göre ayrı belgeler ve işlemlerle yapılır. Hangi durumda hangi yolun izleneceğini mali müşavirinizle netleştirin.
Entegrasyon tarafında önemli olan, bu işlemlerin sisteminizdeki karşılığıdır: iade faturası orijinal faturaya bağlanır, stok ve cari kayıtlar birlikte düzelir, pazaryerinden gelen iade talebi ilgili fatura işlemini tetikler. Bu bağlantılar kurulmadığında stok, cari ve fatura birbirinden ayrışır.
e-Fatura Pazaryeri, E-ticaret ve ERP ile Nasıl Birlikte Çalışır?
Satış hangi kanaldan gelirse gelsin fatura aynı yerden üretilir; böylece tek bir fatura akışı, tek bir numara düzeni ve tek bir kayıt oluşur. Pazaryeri siparişi geldiğinde ERP ya da e-ticaret sisteminiz faturayı keser, pazaryerinin istediği biçimde yükler ve muhasebe kaydını atar.
- Sipariş → fatura: Onaylanan sipariş faturayı kendiliğinden tetikler; elle tetiklemeye gerek kalmaz.
- Fatura → pazaryeri: Pazaryerlerinin istediği fatura bilgisi ya da dosyası, sipariş durumuyla birlikte iletilir.
- Fatura → muhasebe: Fatura cari hareket ve muhasebe fişi olarak kayda geçer.
- İade → fatura: İade onaylandığında ilgili iade faturası ya da düzeltme süreci başlar.
Okumanızı öneririz: Pazaryeri entegrasyonu nedir? Ürün, stok ve siparişi tek yerden yönetme rehberi
e-Fatura Entegratörü Seçerken Hangi Sorular Sorulur?
Entegratör, faturalarınızın ulaştığı kapıdır; seçerken yalnızca fiyata değil işler ters gittiğinde ne olacağına bakın.
- GİB onaylı mı? Yetkili entegratör listesinde yer alıyor mu?
- API sunuyor mu ve belgeleri açık mı? Test ortamı var mı?
- Hangi belge türlerini destekliyor? e-Fatura, e-Arşiv, e-İrsaliye ve ihtiyacınız olan diğerleri.
- Fiyatlandırma nasıl? Kontör, paket ya da abonelik; hacim arttığında maliyet nasıl değişiyor?
- Hata mesajları anlaşılır mı? Reddedilen faturanın nedeni açıkça dönüyor mu?
- Arşiv ve saklama: Faturalar ne kadar süre, nerede ve hangi erişimle saklanıyor? Saklama süreleri mevzuata bağlıdır; mali müşavirinize danışın.
- Destek nasıl? Fatura kesilemediği bir günde ulaşabileceğiniz bir kanal var mı?
- Geçiş kolay mı? Entegratör değiştirmek isterseniz arşivinizi alabilir ve sistemlerinizi kolayca yeni bağlantıya taşıyabilir misiniz?
e-Fatura Entegrasyonu Nasıl Kurulur? Altı Adımda Plan
Sağlıklı kurulum, kodla değil veri haritasıyla başlar: hangi sistemden hangi alan faturaya gidecek, önce bu netleşir.
- Entegratör seçimi: Yukarıdaki sorularla yetkili bir entegratör seçilir, API erişimi ve test hesabı alınır.
- Veri haritası: Alıcı, ürün satırı, vergi ve toplam alanlarının kaynak sistemleri ve eşleşmeleri tanımlanır.
- Kurallar: e-Fatura ile e-Arşiv ayrımı, iade ve iptal akışı, numaralandırma ve istisna nedenleri yazılır.
- Geliştirme: Üretim, gönderim, durum takibi, hata kuyruğu ve yeniden deneme yapıları kurulur.
- Test: Entegratörün test ortamında standart, iade, iskontolu, dövizli ve hatalı veriyle denemeler yapılır; çıktı mali müşavirinize gösterilir.
- İzleme: Canlıya geçince ilk deneme başarı oranı, hata listesi ve bekleyen faturalar izlenir.
e-Fatura Entegrasyonunda Güvenlik ve Kayıt Nasıl Sağlanır?
Fatura, kişisel ve ticari veri içerir; entegratör anahtarları ve fatura verisi korunmalıdır. Entegratör kimlik bilgileri kaynak kodun içinde değil şifreli ayar alanlarında tutulur, bağlantı HTTPS üzerinden yapılır ve faturaya erişim rol bazlı yetkilendirilir. Kimin hangi faturayı ne zaman oluşturduğu kayıt altına alınır; olağan dışı hareketler uyarı üretir. Müşteri verisinin işlenmesi KVKK yükümlülüklerine uygun olmalıdır.
Okumanızı öneririz: Ön Muhasebe Programı Nasıl Seçilir? Karşılaştırma, Puanlama ve Maliyet Rehberi
Okumanızı öneririz: Kargo Entegrasyonu Nedir, Nasıl Yapılır? E-ticaret İçin Gönderi, Etiket ve Takip Rehberi
Okumanızı öneririz: Satın alma yönetim sistemi nedir? Süreç, onay matrisi, teklif puanı ve üçlü eşleştirme rehberi
Okumanızı öneririz: API güvenliği nasıl sağlanır? Kimlik, yetki, token ve hız sınırı rehberi
Okumanızı öneririz: Cari Hesap Takibi Nasıl Yapılır?
İnovabil ile e-Fatura Entegrasyonu
İnovabil olarak e-Fatura'yı yalnızca bir gönderim bağlantısı olarak değil, sipariş, stok, cari ve muhasebe ile aynı akışın parçası olarak tasarlıyoruz. Projeye veri haritası ve fatura kurallarıyla başlıyor, entegrasyonu hata kuyruğu, yeniden deneme, kayıt ve izleme ile kuruyoruz.
Bulut ön muhasebe ürünümüz NetKasam'da cari, stok, kasa, banka ve e-Fatura süreçlerinde edindiğimiz birikim, özel ERP ve e-ticaret projelerimize doğrudan yansıyor. Faprika'da ve özel e-ticaret projelerinde ödeme, kargo, e-Fatura ve pazaryeri bağlantıları kurduk. Sistemlerinizi ve faturayı nerede elle kestiğinizi birkaç cümleyle anlatın, size özel bir entegrasyon yol haritası hazırlayalım.
Okumanızı öneririz: Entegrasyon ve API geliştirme hizmetimiz
Sık Sorulan Sorular
e-Fatura entegrasyonu nedir, kısaca ne işe yarar?
e-Fatura entegrasyonu, yazılımınızla özel entegratörün sistemi arasında faturanın otomatik üretilip gönderilmesini ve durumunun geri alınmasını sağlar. Sipariş ya da satış verisi ikinci kez yazılmadan faturaya dönüşür.
e-Fatura ile e-Arşiv fatura arasındaki fark nedir?
e-Fatura, e-Fatura sistemine kayıtlı işletmelere GİB üzerinden iletilir; e-Arşiv ise sisteme kayıtlı olmayan alıcılara ve son tüketicilere düzenlenir. Hangisinin kesileceği alıcının durumuna göre belirlenir ve iyi bir entegrasyon bu ayrımı otomatik yapar.
Özel entegratör zorunlu mu?
e-Fatura ve e-Arşiv'i GİB portalından elle düzenlemek mümkündür; ancak yüksek hacimde ve sistemlerle birlikte çalışan bir akış için çoğu işletme yetkili bir özel entegratörün API'si üzerinden entegrasyon kurar. Kendi durumunuza uygun yolu mali müşavirinizle netleştirin.
Hatalı kesilen fatura nasıl düzeltilir?
Gönderilmiş bir fatura silinerek geri alınmaz; iptal, iade ve düzeltme mevzuattaki kurallara göre ayrı belgelerle yapılır. Hangi durumda hangi yolun izleneceğini mali müşavirinizle belirleyin; entegrasyon tarafında bu işlemler orijinal faturaya bağlanır.
e-Fatura entegrasyonu ne kadar sürede kurulur?
Süre bağlanacak sistem sayısına, veri kalitesine ve kuralların karmaşıklığına bağlıdır. Entegratörün test ortamı ve veri haritası hazırsa tek bir sistemle entegrasyon kısa sürede teste gelir; mali müşavir onayı ve canlıya geçiş ayrıca planlanır.