e-Fatura ve e-Arşiv Entegrasyonu: Kimler Zorunlu, Nasıl Bağlanır?

Zorunluluk kimin için başlıyor?#

e-Fatura zorunluluğunun çerçevesini 509 Sıra No.lu Vergi Usul Kanunu Genel Tebliği çizer. Gelir İdaresi Başkanlığı bu tebliği yıllar içinde birkaç kez değiştirdi. Yön hep aynıydı: eşik aşağı indi, kapsama giren sektör sayısı arttı. Tebliğin ilk halinde brüt satış hasılatı eşiği 5 milyon TL seviyesindeydi ve sonraki değişikliklerle daha aşağı çekildi. Bu rakama bakıp karar vermeyin. Eşikler tebliğle güncellenir ve bir önceki hesap döneminin hasılatına göre işler; güncel değeri mali müşavirinizle birlikte GİB’in yayımladığı son tebliğden doğrulayın.

Ciro tek ölçüt değil. Hasılatınız eşiğin çok altında olsa bile faaliyet alanınız sizi doğrudan kapsama alabilir, üstelik tek bir satış kanalı bunun için yeterli olabilir. Aşağıdaki tablo tebliğin tanımladığı ana grupları özetler; her satır için güncel koşulu tebliğ metninden okumanız gerekir.

Buradan çıkan ilk tavsiye şu: ayda on beş fatura kesiyorsanız ve hiçbir gruba girmiyorsanız, şu an entegrasyon projesi başlatmayın. Kâğıt fatura hâlâ geçerlidir. Zorunluluk kapınıza dayandığında iki ay içinde kurulabilecek bir işe bugünden bütçe ayırmak, erken harcanmış paradır.

e-Fatura ile e-Arşiv arasındaki fark#

İkisi de elektronik faturadır ve ikisinin de hukuki değeri kâğıt faturayla aynıdır. Fark alıcıdadır, formatta değil.

e-Fatura kullanıcısı olan bir işletme, kayıtlı olmayan müşterilerine kestiği faturalar için e-Arşiv kullanmak zorundadır. Yani ikisi alternatif değil, tamamlayıcıdır. Yazılım tarafında bu ayrımı kullanıcıya sordurmayın. Doğru kurulmuş bir sistem, vergi numarasını GİB’in kayıtlı kullanıcı listesine karşı sorgular ve belge tipini kendisi seçer. Bu listeyi günde bir kez çekip önbelleğe almak yeterlidir; her fatura için canlı sorgu atmak gereksiz yüktür.

Üç bağlanma yöntemi#

GİB üç yol tanımlar ve aralarındaki fark maliyetten çok, faturanın hangi ekrandan kesileceğidir.

Maliyet aralıkları 2026 entegratör liste fiyatlarından derlenmiştir ve belge adedi, kullanıcı sayısı ile ek modüllere göre değişir. Kontör mantığını baştan anlayın: çoğu entegratör yıllık paket satar, paket bitince ek kontör alınır ve kullanılmayan kontör bir sonraki yıla devretmez.

Net görüşümüz şu: 2026’da KOBİ’lerin neredeyse tamamı için doğru cevap özel entegratördür. GİB portalı fatura sayısı arttığı anda operasyonel bir kamburdur, doğrudan entegrasyon ise mali mühür yönetimi, şema doğrulama ve GİB tarafındaki değişiklikleri takip etme yükünü size yıkar. Bir entegratöre yılda yirmi bin lira ödemek, bu yükü tek başına üstlenmekten hemen her zaman ucuzdur.

Kendi yazılımınızdan entegrasyon nasıl kurulur?#

Özel entegratör üzerinden kendi ERP veya sipariş yönetim sisteminizden fatura kesmek istiyorsanız, iş şu adımlardan geçer. Süre, entegratörün dokümantasyon kalitesine göre iki haftadan iki aya kadar uzayabilir.

1. Mali mühür veya e-imza temini. Tüzel kişiler için mali mühür, şahıs şirketleri için nitelikli elektronik sertifika gerekir. Başvuru ve teslim süresi genellikle bir iki haftadır; projeyi buradan başlatın.
2. Entegratör seçimi ve test ortamı. Entegratör size test kullanıcısı açar. Canlıya geçmeden önce her senaryoyu test ortamında çalıştırmanız gerekir; bu adımı atlayan ekip ilk gün reddedilen faturalarla uğraşır.
3. Belge modelinin çıkarılması. Fatura başlığı, kalemler, vergiler, iskonto, tevkifat, istisna kodu ve para birimi alanları kendi veritabanınızdan UBL-TR alanlarına eşlenir. En çok vakit alan adım budur.
4. Senaryo ve tip seçimi. Temel mi ticari mi, satış mı iade mi, tevkifat var mı, ihracat mı? Bu kararlar koda gömülmemeli, sipariş verisinden türetilmelidir.
5. Alıcı sorgusu ve numaralandırma. Vergi numarası GİB kayıtlı kullanıcı listesine sorulur, belge tipi buna göre seçilir ve seri numarası tek bir yerden, çakışmaya izin vermeyen bir sayaçtan üretilir.
6. Gönderim, durum takibi ve arşiv. Fatura gönderildikten sonra durumu sorgulanır, zarf reddi ve uygulama yanıtları işlenir, XML ile görsel çıktı en az on yıl saklanacak biçimde arşivlenir.
7. Hata kuyruğu ve uyarı. Başarısız gönderimler sessizce kaybolmamalı; bir kuyruğa düşmeli, tekrar denenmeli ve sorumluya bildirim gitmelidir.

Bu akış pratikte bir API entegrasyonu projesidir ve pazar yeri ya da kargo bağlantılarıyla aynı mimariye oturur. Siparişten faturaya giden zincirin tamamını tek yerden yönetmek istiyorsanız, e-fatura katmanını kurumsal yazılım tarafındaki sipariş modülüne bağlamak, e-ticaret paneline bağlamaktan daha sağlıklıdır. Teklif ve sözleşme tarafı ayrı bir CRM üzerinde duruyorsa, kabul edilen teklifin sipariş numarasıyla faturaya taşınması gerekir.

Sahada en sık görülen hatalar#

• İptal ve itiraz süresini kaçırmak. e-Arşiv faturalarının iptali GİB’in iptal/itiraz bildirim portalı üzerinden, sınırlı bir süre içinde bildirilir. Süre geçtikten sonra iş, iade faturası ve muhasebe düzeltmesiyle çözülür. Yazılımınıza “bu fatura için iptal penceresi kapanıyor” uyarısı koyun.
• Senaryoyu yanlış seçmek. Temel fatura reddedilemez. Alıcının itiraz edebilmesi gereken B2B ilişkilerde ticari senaryo kullanılmalıdır; herkese temel fatura kesen bir yazılım, iade süreçlerini kilitler.
• Birim kodunu uydurmak. UBL-TR birim kodları standarttır. “Adet” yerine serbest metin yazan entegrasyon, şema doğrulamasından geçmez ya da alıcının sisteminde anlamsız görünür. Kendi ürün kartınızdaki birimi standart koda eşleyen bir tablo tutun.
• Numaratörü iki yerden çalıştırmak. Hem e-ticaret paneli hem ERP fatura kesiyorsa seri numarası er geç çakışır. Numara üretimi tek bir servisten yapılmalıdır.
• Vergi ve iskonto yuvarlamasını farklı yapmak. Kendi sisteminizde kalem bazında, faturada toplam bazında yuvarlarsanız kuruş farkları oluşur ve faturalar reddedilir.
• Arşivi entegratöre emanet etmek. Sözleşme bittiğinde belgelerinizi hangi formatta alacağınızı baştan sorun ve XML’leri kendi tarafınızda da saklayın.

Somut bir örnek: pazar yerinden günde 200 sipariş alan bir müşterimizde fatura kesimi e-ticaret panelinden yapılıyordu, iadeler ise ERP’den işleniyordu. İki sistem aynı seriyi kullandığı için bir ay boyunca mükerrer numaralı belgeler üretildi. Düzeltme, kesilen faturaların elle taranmasını ve iade faturalarıyla kapatılmasını gerektirdi. Yazılım hatası değildi; mimari karar hatasıydı.

e-İrsaliye ve e-Defterle ilişkisi#

e-Fatura, e-belge ailesinin tek üyesi değil. e-İrsaliye sevkiyatın belgesidir ve mal fiziksel olarak yola çıkmadan önce düzenlenir; e-Defter ise yevmiye ve kebir defterlerinin elektronik hâlidir. Üçü ayrı eşiklere ve ayrı başvurulara tabidir. Genel eğilim şudur: e-Fatura kullanıcısı olmak diğerleri için çoğu zaman ön şarttır, ama e-Fatura’ya geçmek otomatik olarak e-İrsaliye zorunluluğu doğurmaz.

Yazılım planlaması açısından önemli olan nokta, bu üç belgenin aynı veriyi paylaşmasıdır. Sevkiyat kaydı e-İrsaliye’yi, aynı sipariş e-Fatura’yı, muhasebe fişi ise e-Defter’i besler. Üçünü ayrı ayrı elle besleyen bir yapı kurarsanız, veri üç yerde birbirini tutmaz. Depo ekibi irsaliyeyi sahadan kesecekse, bu akışa bir mobil uygulama katmanı da eklenir.

İkinci “yaptırmayın” tavsiyemiz burada: e-İrsaliye kapsamında değilseniz ve sevkiyatlarınız günde beş kalemi geçmiyorsa, e-Fatura projesine e-İrsaliye modülünü şimdiden eklemeyin. Kullanılmayan modülün bakımını yıllarca ödersiniz.

Karar kuralı#

Önce kapsamda olup olmadığınızı mali müşavirinizle netleştirin, sonra fatura adedinize bakın. Ayda 40 faturanın altındaysanız GİB portalıyla başlayın ve entegrasyona para harcamayın. Bu sayının üzerindeyseniz ya da faturayı kendi yazılımınızdan kesmeniz gerekiyorsa, bir özel entegratör seçin ve entegrasyonu ERP tarafına kurun. Doğrudan entegrasyonu ancak günlük belge sayınız binleri buluyorsa ve bakımını üstlenecek bir ekibiniz varsa değerlendirin.

Bu yazı genel bilgilendirme amaçlıdır ve hukuki ya da mali tavsiye niteliği taşımaz. Eşikler, süreler ve kapsam GİB tebliğleriyle değişir; kendi durumunuz için mali müşavirinize danışın ve güncel metni GİB kaynaklarından doğrulayın. Diğer hizmetlerimiz ve sık gelen sorular için SSS sayfasına, mevcut sisteminize uygun entegrasyon senaryosunu konuşmak için iletişim sayfasına bakabilirsiniz. Web tarafındaki bütçe kalemlerini planlıyorsanız web sitesi fiyatları yazısı başlangıç noktası olur.