e-Belge: doğrudan entegrasyon mu, özel entegratör mü?

e-Fatura, e-Arşiv, e-İrsaliye ve e-Gider Pusulası’nı kendi sistemine bağlayacak bir kurumun önünde iki yol var: uygulamayı doğrudan kendi bilgi işlem sistemi üzerinden kullanmak ya da bir özel entegratör üzerinden. Soru çoğu zaman teknik yeterlilik sorusu gibi konuşulur; oysa iki yöntemi ayıran şey, sorumluluğun nerede durduğudur.

Bu yazı iki modeli o eksende karşılaştırıyor: mali mühür ve zaman damgası kimin sertifikasıyla atılıyor, muhafaza kimde kalıyor, 7 gün 24 saat çalışır durumda tutma ve paket sürümlerini izleme yükü kimin ekibinde. Aşağıdaki bütün maddeler 509 sıra numaralı Vergi Usul Kanunu Genel Tebliği ile Gelir İdaresi Başkanlığı’nın yayımladığı teknik kılavuzlarda yazdığı hâliyle aktarılıyor.

Belge ailesi ve her belgenin bağlandığı sistem

Dört belge tek bir kanala bağlanmıyor. Tebliğin V.8 bölümü ayrımı doğrudan kuruyor: e-Fatura ve e-İrsaliye gibi iletimini Başkanlığın yaptığı e-Belgeler bir tarafta, bunların dışında kalan ve e-Belge Raporu yoluyla Başkanlık sistemine aktarılan belgeler diğer tarafta. e-Arşiv Fatura uygulaması tanımlar bölümünde belgenin oluşturulmasını, muhafazasını, ibrazını ve raporlanmasını kapsayan uygulama olarak tanımlanıyor — yani iletim değil, raporlama hattı.

e-Gider Pusulası bu tabloya kendi başına bir hat açarak girmiyor. Tebliğin IV.6.2 bölümü uygulamaya dâhil olmak isteyen mükellefin önce e-Fatura uygulamasına dâhil olmasını arıyor; IV.6.1 ise belgenin yeni bir belge türü olmadığını, kâğıt ortamdaki gider pusulası ile aynı hukuki niteliklere sahip olduğunu yazıyor. Mevcut hattın üzerine biniyor.

Yararlanma yöntemleri tebliğin V.1 bölümünde üç başlıkta tanımlı: GİB Portal, özel entegratör ve doğrudan entegrasyon. Portal yöntemi belirli ölçekteki kullanım için tanımlı ve bu yazının dışında kalıyor; karşılaştırma son ikisi arasında. Bundan sonraki bölümlerin hepsi tek bir soruyu izliyor — hangi ödev kimin üzerinde kalıyor.

Doğrudan entegrasyon: başvuru koşulları ve üstlenilen işletim

Tebliğin V.1.3 bölümü kapıyı şöyle tanımlıyor: bilgi işlem sistemleri yeterli olan mükelleflerin, gerekli entegrasyonu sağlamaları koşuluyla e-Belge uygulamalarını doğrudan kendilerine ait bilgi işlem sistemleri aracılığıyla kullanmaları mümkün. Başvurusu uygun bulunanlara test kullanıcısı ve yetki tanımları e-posta ile iletiliyor ve entegrasyon çalışmalarının başvuru tarihinden itibaren en geç bir yıl içinde tamamlanması gerekiyor. Bu bir hedef değil, tebliğin verdiği tavan süredir.

Sürecin adımları Entegrasyon Kılavuzu’nda sıralı: başvurudan sonra Bilgi İşlem Sistem Raporu ile Test Tanım Formu dolduruluyor, Test Tanım Formu test ortamına bağlanacak sunucu ve istemci IP adresleri ile web servis uç noktalarını bildiriyor. Test hesapları Başkanlık tarafından tanımlanıp e-posta ile iletiliyor, testler e-Fatura Test Planı’na göre yürüyor, adımları tamamlayanların test hesapları kapatılıp Canlı Tanım Formu dolduruluyor.

Ağ tarafında koşullar yazılı. Kılavuzun 4.2 bölümü entegre olacak birimlerin uygulamaya statik IP’leri üzerinden tanımlanacağını ve statik IP’nin Türkiye’ye ait IP aralığında olacağını söylüyor. Ortak IP üzerinden bağlanmak isteyen grup şirketlerinin talepleri, ortaklık bağlarını gösteren belgelerle başvuru hâlinde Başkanlıkça değerlendiriliyor.

Asıl yük bundan sonra başlıyor. Gönderici birim ve posta kutusu rollerini kurumun kendisi işletiyor. Kılavuzun 3.1 ve 3.2 bölümleri, giden ve gelen mesajların takip edilebilmesi için sistemin her an — 7x24 — çalışır durumda olmasını ve birimin aynı zamanda iş sürekliliğini sağlamasını arıyor. Aynı bölümler her adımda loglama yapılmasını zorunlu tutuyor.

Kılavuzun dipnotunda tek cümlelik ama belirleyici bir ifade var: Merkez imza doğrulaması yapmamaktadır, imza doğrulamasının gönderici birim tarafından yapılması gerekmektedir. Aynı ifade posta kutusu için de yazılı. İşletim yükünün nereye düştüğünü en açık gösteren yer burasıdır.

Özel entegratör modeli: devredilen işletim, sözleşmeyle çizilen sınır

Tebliğ özel entegratörü, elektronik belgelerin oluşturulması, imzalanması ve iletilmesi hususlarında mükelleflere hizmet verme konusunda teknik yeterliğe sahip ve test ile değerlendirme süreçleri sonunda Başkanlıktan izin alabilen entegrasyon kuruluşu olarak tanımlıyor. V.1.2 bölümü hizmet kapsamını sayıyor: e-Belge ve e-Belge Raporu oluşturma, mali mühürle onaylama, zaman damgası kullanma ve oluşturulan belgeleri alıcıya, raporları Başkanlığa elektronik ortamda iletme.

Entegratörün kendi üzerine aldığı yükümlülükler Özel Entegrasyon Kılavuzu’nda ayrıntılı. Bilgi güvenliği için TÜRKAK’ta akredite kurumlardan alınan TS ISO IEC 27001, iş sürekliliği için ISO 22301, bilgi teknolojileri hizmet yönetimi için TS ISO IEC 20000 belgeleri aranıyor. Sistem yönetim süreçlerinin ITIL uyumlu olması ve sistemin ITIL sertifikasına sahip personel tarafından yönetilmesi isteniyor. Mali mühür sertifikasının uygunluğu için TÜBİTAK-BİLGEM Kamu Sertifikasyon Merkezinden Mali Mühür Uyum Değerlendirme Raporu alınıyor. Sistemin, elektronik fatura trafiğinde 7 gün 24 saat iş sürekliliğini sağlayabilecek yapıda kurulması ve bu yöntemin Bilgi İşlem Sistem raporunda yıllık ortalama fatura ve kullanıcı sayısı, eş zamanlı kapasite ve yük testi verileriyle açıklanması gerekiyor.

Sınırın nerede çizildiği önemli. Mevzuat, özel entegratörün müşterisine sunacağı arayüzün biçimini tanımlamıyor; tanımlı olan, özel entegratör ile Başkanlık arasındaki bağlantı modelinin web servis olmasıdır. Müşteriye dönük arayüz sözleşme ve teknik dokümantasyon konusu. Kılavuzun 2.2 bölümü bunu bir cümleyle bağlıyor: özel entegratör ile yapılan sözleşmede kullanıcı hesabı ile yapılabilecek işlemler açıkça belirtilerek taahhüt edilecektir. Sorumluluk sınırının yazılı olarak çizildiği tek yer burasıdır.

Geçişkenlik kuralları da tanımlı. Uygulama birden fazla özel entegratörden hizmet alınarak kullanılabiliyor; ancak özel entegratör vasıtasıyla fatura alıp gönderenler GİB portal hizmetinden ve entegrasyon yönteminden aynı anda yararlanamıyor. Daha önce entegrasyon izni almış bir mükellef entegratöre geçerken Başkanlığa yazı ile bilgi vermek ve entegrasyon hesabının kapatılmasını talep etmekle yükümlü. Özel entegrasyon test süreci ise çalışmalara başlanmasından itibaren bir yıl içinde tamamlanıyor.

Mali mühür, zaman damgası ve muhafaza ödevi

Tebliğin V.9 bölümü mali mührü, veri bütünlüğünün, kaynağın ve içeriğin garanti altına alınması ile gerekli durumlarda gizliliğin sağlanması amacıyla oluşturulan ve Başkanlık adına TÜBİTAK-UEKAE tarafından hazırlanan elektronik sertifika altyapısı olarak tanımlıyor. Nitelikli elektronik sertifika ise 5070 sayılı Elektronik İmza Kanununun 9 uncu maddesinde tanımlanan ve yalnızca gerçek kişi mükelleflerce kullanılabilen sertifika.

Esas kural aynı bölümde: mükelleflerin e-Belgelerini kendi mali mühür sertifikaları ile onaylamaları veya nitelikli elektronik sertifikaları ile imzalamaları esastır. Özel entegratörler vasıtasıyla kullananlar için düzenlenecek e-Belgelerin entegratörün mali mühür sertifikası ile onaylanmasına Başkanlıkça izin verilebiliyor. Devir kendiliğinden olmuyor: V.1.2 bölümü, entegratör sistemi üzerinden hizmet alan mükelleflerin entegratörün mali mührünün ve zaman damgasının kullanılmasını talep edebileceğini yazıyor.

Zaman damgası, bir elektronik verinin üretildiği, değiştirildiği, gönderildiği, alındığı ve kaydedildiği zamanın tespiti amacıyla elektronik sertifika hizmet sağlayıcısı tarafından doğrulanan kayıt olarak tanımlı. Nerede zorunlu olduğu da yazılı: e-Belge Raporu elektronik sertifika ile zaman damgalı olarak imzalanıp Başkanlık sistemine aktarılıyor, e-Arşiv raporları ise XAdES-A standardı kullanılarak mali mühür veya elektronik imza ile ve zaman damgasıyla imzalanıp gönderiliyor. e-Arşiv raporları 1/1/2019 tarihinden itibaren günlük dönemler hâlinde ve en geç izleyen günün sonuna kadar iletiliyor.

Bu bölümün taşıyıcı cümlesi tebliğde üç ayrı yerde tekrarlanıyor. V.1.2: mükellefin e-Belge gönderip alma işlemini özel entegrasyon izni alan mükelleflere ait bilgi işlem sistemi vasıtasıyla gerçekleştirmesi, muhafaza ve ibraz ödevlerini ortadan kaldırmaz. V.8: erişim ve raporlama gereklerinin yerine getirilmiş olması, mükellefin muhafaza ve ibraz ödevlerini ortadan kaldırmaz. VI: başka mükelleflerden, Başkanlıktan izin alan saklamacı kuruluşlar dâhil, elektronik saklama hizmetinin alınması asli sorumluluğu ortadan kaldırmaz. Hangi yol seçilirse seçilsin bu ödev yerinde kalıyor.

Veri yerelliği koşulu da iki yerde yazılı. V.1.2, e-Belge gönderip alma işleminde kullanılan bilgi işlem sistemi yazılım ve donanım altyapısının Türkiye Cumhuriyeti sınırları içerisinde ve Türkiye Cumhuriyeti kanunlarının geçerli olduğu yerlerde bulunmasını zorunlu tutuyor. VI ise aynı koşulu muhafaza için tekrarlıyor ve bir açıklık bırakıyor: bu zorunluluk yurt dışında ikincil bir arşivleme yapılmasına engel teşkil etmez. Muhafazanın kapsamı da dar değil — arşivlenen belgelerin doğruluğuna, bütünlüğüne ve değişmezliğine ilişkin her türlü elektronik kayıt ve veri, veri tabanı dosyası, saklama ortamı ile doğrulama ve görüntüleme araçlarının tümü. Aynı bölüm, elektronik imzanın ve mali mührün kontrolü ancak elektronik ortamda yapılabildiği için belgenin düzenleyicisi tarafından kâğıda basılarak saklanmasının söz konusu olmadığını da yazıyor.

Paket güncellemeleri ve yürürlük takvimini izlemek

e-Belge tarafında kılavuzlar ve paketler sabit durmuyor; duyuru akışı kendi temposunu taşıyor. Duyuru tarihi ile devreye alma tarihi arasındaki aralık da sabit değil, her duyuru kendi tarihini bildiriyor.

• 09.12.2025 duyurusu: Yatırım Teşvik teknik kılavuzu, e-Fatura Paketi, e-Arşiv Fatura Paketi, UBL-TR Kod Listeleri Kılavuzu ve UBL-TR 1.2.1 Paketi güncellendi; güncellemeler 22.12.2025 itibarıyla devreye alındı.
• 09.01.2026 duyurusu: İDİS teknik kılavuzundaki geliştirmeler için süre 02.02.2026’ya uzatıldı ve aynı dört varlık yeniden güncellendi; devreye alma 02.02.2026.
• 16.03.2026 duyurusu: özel entegratör sistemleri üzerinden düzenlenen belgeler için sicil ve faaliyet kodu kontrolleri 1 Nisan 2026 itibarıyla başladı; devreye alma 1.4.2026.
• 27.07.2026 duyurusu: e-Fatura Paketi, e-Arşiv Fatura Paketi ve UBL-TR Kod Listeleri Kılavuzu güncellendi; güncellemeler 14.09.2026 tarihi itibarıyla devreye alınacak.

İki gözlem buradan çıkıyor. Birincisi, izlenecek tek bir dosya yok: aynı duyuruda e-Fatura Paketi, e-Arşiv Fatura Paketi, kod listeleri kılavuzu ve UBL-TR paketi çoğu zaman birlikte anılıyor. İkincisi, takvim değişebiliyor — 27.03.2026’da sicil ve faaliyet kodu karşılığı KDV oran kontrolünün ertelenmesi ayrı bir duyuruyla bildirildi. Kılavuz sürümleri de aynı akışta ilerliyor: 22.05.2026’da e-Arşiv Başvuru Kılavuzu ile e-Müstahsil Makbuzu Teknik Kılavuzu güncellendi ve e-Gider Pusulası Paketi yayımlandı, 29.06.2026’da Özel Entegrasyon Kılavuzu v1.14 oldu.

Sorumluluk şöyle bölünüyor: doğrudan entegrasyonda bu akışı izleyip kendi hattına uygulamak kurumun kendi ekibinin işi. Özel entegratör yönteminde entegratörün sistemi bu güncellemeleri taşıyor — ama kurumun ERP tarafında karşılığı olan alanlar yine kendi geliştirme kuyruğunda kalıyor.

Kod listesi değişikliklerinin ERP alan eşlemesine yansıması

Bir kod listesi güncellemesinin ERP tarafındaki karşılığı somut. 16.03.2026 duyurusu, yansıtma faturaları ve demirbaş satış faturaları gibi faaliyet koduna karşılık gelen KDV oranı ile fatura düzenlenemeyen durumlar için yeni bir kod ekledi.

555 — KDV Oran Kontrolüne Tabi Olmayan Satışlar

Bu kod ERP’de bir satış tipinin karşılığı olarak eşlenmediğinde belge ilgili kontrolden geçemiyor. İkinci örnek 12.01.2026 duyurusunda: YATIRIMTESVIK senaryosu altında ISTISNA fatura tipinde ve e-Arşiv tarafında EARSIVFATURA senaryosu altında YTBISTISNA fatura tipinde düzenlenen faturalarda Vazgeçilen KDV Tutarı yazılıyor. Duyuru alanın davranışını da tanımlıyor: yalnızca XML üzerinden gösteriliyor, fatura satır ve dip toplamlarında hesaplamaya dâhil olmuyor, fatura görselinde görünmüyor — ve bu senaryo ile fatura tipi için XSLT dosyalarının güncellenmesi gerekiyor.

XSLT’nin neden ERP’nin işi olduğu Entegrasyon Kılavuzu’nun 4.3 bölümünde yazılı: XML dosyaları içinde görüntüleme amacıyla kullanılacak XSLT tanımı mutlaka bulunmalıdır ve XSLT ile fatura XML’i arasında içerik farklılığı olması durumunda XML’deki bilgiler esas alınır. Aynı bölüm veri tarafını da tanımlıyor — format XML, doğruluk kontrolü XSD şemalarıyla yapılıyor, karakter kodlaması UTF-8, imzalamada en az XAdES-BES standardı ve enveloped tekniği kullanılıyor, imzalı XML zarf hâline getirilirken ZIP ile sıkıştırılıyor.

Kod listeleri zaman içinde büyüyen referans veri kümeleri. Kod Listeleri Kılavuzu’nun sürüm tablosu bunu gösteriyor: 1.6 sürümüyle (05.08.2015) IHRACKAYITLI fatura tipi ve ilgili kod listesi, 1.7 sürümüyle (25.08.2015) ÖTV İstisna Kodları Listesi eklenmiş; kılavuz bugün 1.27 sürümünde. Pratik sonuç şu: kod listesi ERP’de sabit metin olarak gömüldüğünde her güncelleme elle dokunma gerektiriyor, ayrı bir eşleme tablosu olarak tutulduğunda güncelleme bir veri işine dönüşüyor. Bu ayrım her iki yöntemde de kurumun kendi tarafında kalıyor.

Belge yaşam döngüsünü ERP içinde izlenebilir tutmak

Yaşam döngüsü belgenin gönderilmesiyle bitmiyor. Uygulama yanıtı ve e-İrsaliye Yanıtı ayrı olaylar ve ERP’de belgeye bağlandıklarında durum bilgisi ancak bütün hâline geliyor. Süreler de kılavuzda tanımlı: gönderici birim, fatura yollandıktan sekiz gün sonra gelen uygulama yanıtlarını kabul etmemeli; bir fatura için birden fazla uygulama yanıtı geldiğinde ilki kabul edilmeli. Posta kutusu ise uygulama yanıtını faturayı aldıktan sonra sekiz gün içerisinde göndermeli. İrsaliye tarafında aynı desen yedi gün üzerinden işliyor ve irsaliye yanıtı göndermek isteğe bağlı.

İş tarafındaki karşılığı tebliğin IV.3.4 bölümünde. Alıcı e-İrsaliye Yanıtı ile kısmi kabul bildirebiliyor; kabul dışında kalan bildirimin ise malın fiili sevkinden önce yapılması gerekiyor. Fiili sevkten sonra gönderilen bu yanıtlar sonuç doğurmuyor ve yeni bir e-İrsaliye düzenleniyor. Bu, ERP’nin sevkiyat durumu ile belge durumunu aynı yerde tutmasını gerektiriyor. Aynı bölüm muhafazanın ilişkisel olduğunu da yazıyor: izin alan mükellefler oluşturdukları e-İrsaliyeleri ve e-İrsaliye Yanıtlarını birbirleriyle ilişkili şekilde muhafaza ve ibraz etmekle yükümlü.

Bildirim ucu da sisteme bağlanıyor. 526 sıra numaralı tebliğle eklenen V.10 bölümü, Türk Ticaret Kanununun 18 inci maddesinin üçüncü fıkrası uyarınca noter aracılığıyla, taahhütlü mektupla, telgrafla veya güvenli elektronik imza kullanılarak KEP ile yapılan bildirimler ile e-Belge iptal işlemlerinin 1/5/2021 tarihinden itibaren elektronik ortamda Başkanlık bilgi işlem sistemine bildirilmesini zorunlu tutuyor.

Olağan dışı hâller için de yazılı bir ödev var: elektronik kayıtların işlem görememesi hâlinde durumun üç iş günü içinde Başkanlığa bildirilmesi ve bu kayıtların nasıl tamamlanacağına ilişkin ayrıntılı bir plan sunulması gerekiyor. Uygulamaları kendi sistemi üzerinden kullananlar için VIII bölümünde ek bir madde daha var: bilgi işlem sistemini oluşturan yazılım, donanım, dosya ve dokümantasyon, denetim elemanlarının erişimini engelleyecek bir sözleşme veya lisansa konu edilemiyor. Yazılım tedarik sözleşmesi yazılırken bakılacak yer burası.

Kararı üç eksene indirmek

İki yöntem arasındaki seçim üç eksende toplanıyor ve üçü de doğrulanabilir maddelere bağlanıyor.

• Ekip kapasitesi: doğrudan entegrasyonda sistemi 7x24 çalışır durumda tutmak, her adımda loglamak ve imza doğrulamasını kendi tarafında yapmak kurumun kendi ekibinde. Entegrasyon çalışmaları için tebliğin verdiği tavan süre bir yıl.
• Denetim beklentisi: özel entegratör tarafında bilgi sistemleri denetimi tanımlı ve dönemsel — ilk denetim tarihini takip eden iki yılda bir yapılıyor, bağımsız denetim raporları rapor tarihinden itibaren en fazla iki yıl geçerli, görüş yazısı ve rapor eki en geç on beş gün içinde Başkanlığa gönderiliyor ve aynı denetçiden sıralı en fazla iki kez üst üste hizmet alınabiliyor. Doğrudan entegrasyonda ise Başkanlık ilave bilgi isteyebiliyor ve bilgi işlem sisteminde yerinde inceleme yapabiliyor ya da yaptırabiliyor.
• Belge hacmi ve karma kullanım: birden fazla özel entegratörden hizmet alınabiliyor, ancak entegratör vasıtasıyla alıp gönderenler aynı anda portal ve entegrasyon yönteminden yararlanamıyor. Yöntem seçimi geri dönülebilir, ama bir anda tekil.

Her iki yolda da değişmeyen üç şey var: muhafaza ve ibraz asli sorumluluğu kurumda kalıyor, altyapı ve muhafaza için Türkiye sınırları içinde bulunma koşulu duruyor, mali mühür devri kendiliğinden gerçekleşmiyor — talep ediliyor ve sözleşmede yazılı hâle geliyor.

Kapanışta dört soru kalıyor. Hangi belge hangi kanala bağlanıyor? Mühür ve zaman damgası kimin sertifikasıyla atılıyor? Muhafaza hangi ortamda ve hangi sınırlar içinde yapılıyor? Paket ve kod listesi güncellemelerini kim izleyip kim uyguluyor? Bu dördü yazılı olarak cevaplanabiliyorsa yöntem seçimi kendiliğinden çıkar.

Bu yazı mevzuat ve kılavuz metinlerini anıldığı hâliyle aktarır; hukuki görüş içermez. Kılavuz sürümleri ve yürürlük tarihleri değiştiği için, planlamadan önce ebelge.gib.gov.tr üzerindeki güncel duyuru ve kılavuz sürümüne bakılmalıdır.

Kaynaklar

• 509 Sıra No’lu Vergi Usul Kanunu Genel Tebliği, güncel şekli — Gelir İdaresi Başkanlığı (yararlanma yöntemleri V.1, özel entegratör V.1.2, doğrudan entegrasyon V.1.3-V.1.4, mali mühür V.9, muhafaza ve ibraz VI)
• 526 Sıra No’lu Vergi Usul Kanunu Genel Tebliği — Resmî Gazete, 09/02/2021, sayı 31390 (509’a eklenen V.10: bildirim ve iptal işlemlerinin elektronik ortamda bildirilmesi)
• e-Fatura Uygulaması Entegrasyon Kılavuzu, Versiyon 1.10, Haziran 2018 — GİB (BİS Raporu ve test süreci, statik IP koşulu, 7x24 işletim ve loglama, imza doğrulaması, XSLT ve XML kuralları, uygulama yanıtı süreleri)
• e-Fatura Uygulaması Özel Entegrasyon Kılavuzu, Versiyon 1.14, Haziran 2026 — GİB (sertifikasyon ve ITIL koşulları, Mali Mühür Uyum Değerlendirme Raporu, iş sürekliliği, sözleşmede taahhüt, geçiş kuralları)
• e-Belge Özel Entegratörleri Bilgi Sistemleri Denetimi Kılavuzu, Versiyon 1.0, Kasım 2019 — GİB (denetim dönemi, rapor geçerlilik süresi, on beş günlük ibraz süresi, denetçi sıralılığı)
• e-Arşiv Uygulaması Kılavuzu, Versiyon 1.18, Ağustos 2025 — GİB (raporların XAdES-A ile imzalanması, günlük raporlama dönemi)
• UBL-TR Kod Listeleri Kılavuzu, Versiyon 1.27 — GİB (sürüm tablosu ve kod listelerinin zaman içindeki eklenmesi)
• GİB e-Belge Duyuruları — ebelge.gib.gov.tr (09.12.2025, 09.01.2026, 12.01.2026, 16.03.2026, 27.03.2026, 22.05.2026, 29.06.2026 ve 27.07.2026 tarihli duyurular)