GİB e-Belge ekosistemi — bileşenler
Gelir İdaresi Başkanlığı (GİB) e-Belge ekosistemi: e-Fatura (mükellefler arası B2B), e-Arşiv Fatura (B2B + B2C), e-İrsaliye (sevk irsaliyesi), e-Serbest Meslek Makbuzu (e-SMM), e-Müstahsil Makbuzu, e-Defter (yevmiye + büyük defter) ve e-Bilet. 509 Sıra No.lu VUK Genel Tebliği ana çerçevedir. Her belge tipi ayrı XML şeması ve ayrı zorunluluk eşiği taşır.
UBL-TR 2.1 — XML şema temeli
UBL (Universal Business Language) OASIS tarafından geliştirilen iş belgeleri için açık XML standardıdır. Türkiye GİB; UBL 2.1'in 'TR Kılavuzu' (UBL-TR) versiyonunu mükellef belgelerinin standardı olarak benimsemiştir. Belge dosyası UTF-8 kodlu, namespace tabanlı, ‘Invoice', ‘DespatchAdvice', ‘CreditNote' kök öğeleri içerir. Validasyon GİB'in yayımladığı XSD (XML Schema Definition) + Schematron kuralları ile yapılır — şema dışı element kabul edilmez.
Dijital imza — XAdES-BES + Mali Mühür
Belgenin yasal geçerliliği XAdES-BES (XML Advanced Electronic Signatures — Basic Electronic Signature) imzasından gelir. Tüzel kişiler 'Mali Mühür' (Kamu Sertifikasyon Merkezi/TÜBİTAK üretimi nitelikli elektronik mühür sertifikası) ile, gerçek kişiler ise nitelikli elektronik sertifika ile imzalar. Sertifikalar PKCS#11 token (USB) veya HSM (Hardware Security Module) üzerinde tutulur. İmza algoritması RSA-SHA256, sertifika doğrulaması CRL/OCSP üzerinden — denetimde imza zinciri zorunlu kontrolüdür.
Entegratör vs Portal vs Özel Entegrasyon
GİB üç entegrasyon yolu sunar: (1) GİB Portalı — küçük hacimli mükellefler için ücretsiz web arayüzü, manuel veya minimum API. (2) Özel Entegratör — GİB tarafından lisanslanmış özel firmalar (Logo, Mikro, Foriba, ISIS, Uyumsoft vb.) tüm imza + arşiv + iletim sorumluluğunu üstlenir. (3) Özel Entegrasyon — mükellefin doğrudan GİB sistemleriyle entegre olması; teknik gereksinim ağır (SOAP/WSGW, gönderim limitleri, BER/CER, 5 yıl arşiv). Aylık 100+ belgede özel entegratör, 1000+ belgede özel entegrasyon ROI açısından mantıklıdır.
2026 zorunluluk eşikleri
509 Sıra No.lu VUK Tebliği ve takip eden değişiklikler: 2025 hesap dönemi cirosu 3 milyon TL'yi aşan firmalar 2026 Temmuz itibarıyla e-Fatura mükellefi olmak zorunda. e-Arşiv zorunluluğu 5 milyon TL e-ticaret cirosu üzerinde. e-İrsaliye 10 milyon TL ve üzeri firmalar. e-Defter zorunluluğu e-Fatura mükellefleriyle eşleştirildi. Sektörel zorunluluklar (akaryakıt, ihracat, EYP) bağımsız uygulanır — eşik altında olsa bile sektör mükellefi otomatik e-Belge kullanır.
E-Defter ve Berat dosyası
1 Sıra No.lu Elektronik Defter Genel Tebliği: yevmiye defteri ve büyük defter aylık olarak XBRL-GL (eXtensible Business Reporting Language — Global Ledger) formatında hazırlanır. Defter dosyası mali mühür ile imzalanır, özet (Berat) dosyası GİB'e yüklenir (gerçek defter mükellefte saklanır — 10 yıl). Yükleme süresi: ilgili ayı izleyen 3. ayın sonu (Ocak defteri için 30 Nisan). Geç yükleme idari para cezasına tabidir (VUK Mük. 355).
Hakediş süreciyle entegrasyon
Hakediş onay zinciri tamamlandığında (şantiye şefi → kontrol mühendisi → mali işler → genel müdür), tutar netleştiğinde otomatik e-Fatura tetiklenmesi denetim açıklarını kapatır. Bkz. hakediş süreç rehberi. Manuel veri girişi: (a) hakedişte 100.000 TL onay ama faturada 100.500 TL — KDV stopaj uyuşmazlığı, (b) hakediş onaylı ama fatura kesilmemiş — gelir tahakkuk farkı, (c) iki kez fatura. KontrolJet HakedişJet ürünü onay imzası tamamlandığında entegratöre webhook gönderir; UBL-TR 2.1 XML üretilir, mali mühürle imzalanır, GİB'e iletilir, müşteriye PDF görüntüleme gönderilir. Toplam süre 30–60 saniye.
Denetim ve VUK 359
Vergi Usul Kanunu Madde 359 (sahte belge düzenleme + kullanma) kapsamında 3–5 yıl hapis öngörülür. Elektronik belge döneminde tipik 'sahte e-fatura' senaryosu: gerçek mükelleften alınmış e-Fatura UBL'sinin gider olarak kullanılması ama mal/hizmet teslim alınmamış. Sistem tarafında: (a) e-Fatura GİB sisteminde anlık görünür (alıcı/satıcı tarafından inkar edilemez), (b) hakediş onay zinciri ile fatura tutarı eşleşmeli, (c) ödeme banka transferi ile belgelenmeli. KontrolJet ekosisteminde bu 3 katman birbirine bağlanır.
API ve teknik gereksinimler
Özel entegrasyon için minimum teknik altyapı: SOAP/REST gateway (GİB WSGW), TLS 1.2+ karşılıklı sertifika doğrulama (mTLS), HSM veya PKCS#11 token, UBL-TR XSD validasyon kütüphanesi, XAdES-BES imza kütüphanesi (Apache Santuario, eSIG.NET), arşivleme katmanı (5 yıl + 10 yıl defter), gönderim takip kuyruğu (retry + idempotency). Gönderim limitleri: tek paket en fazla 200 belge, günlük 100.000 belge. Bunlardan biri eksikse özel entegratör yolu seçilmelidir.
Özet çıkarımlar
- GİB e-Belge XML şeması UBL-TR 2.1 + XAdES-BES dijital imza + Mali Mühür sertifikası üzerine kurulur.
- 2026 e-Fatura eşiği 3 milyon TL ciroya düştü; sektörel zorunluluklar eşikten bağımsız.
- 3 entegrasyon modeli: GİB Portalı (manuel), Özel Entegratör (lisanslı 3. taraf), Özel Entegrasyon (doğrudan).
- E-Defter Berat dosyası ay+3 sonu GİB'e yüklenir; gerçek defter mükellefte 10 yıl saklanır.
- Hakediş onay zinciri ↔ otomatik e-Fatura kesimi denetimde VUK 359 risklerini azaltır.
Sıkça Sorulan Sorular
AI ve arama motorlarının doğrudan çekebileceği soru-cevap bloğu.
- E-Fatura ve e-Arşiv arasındaki teknik fark nedir?
- İkisi de UBL-TR 2.1 ve XAdES-BES imza kullanır; e-Fatura sadece kayıtlı mükellefler arasında (B2B) GİB sistemi üzerinden iletilir, e-Arşiv ise mükellef olmayan (B2C) ya da kayıt dışı alıcılar için kullanılır ve mükellefin sistemine arşivlenir. Karar mekanizması: alıcı GİB e-Fatura mükellefiyse e-Fatura, değilse e-Arşiv.
- Mali Mühür sertifikası nereden ve nasıl alınır?
- Mali Mühür Kamu Sertifikasyon Merkezi (KamuSM, TÜBİTAK) tarafından üretilir. Başvuru GİB e-Belge portalı üzerinden online yapılır, sertifika USB token (PKCS#11) veya HSM olarak teslim edilir. Süre 2–4 haftadır, 3 yıl geçerlidir, yenileme aynı yoldan yapılır.
- Hakediş yazılımı doğrudan GİB ile entegre olmalı mı yoksa entegratör mü kullanmalı?
- Aylık 100 belge altı mükellefler için özel entegratör yolu daha hızlı ve maliyet etkin. KontrolJet HakedişJet özel entegratörlerin webhook API'leri ile çalışır — onay tamamlanır tamamlanmaz UBL-TR XML üretip entegratöre POST eder, böylece mükellefin kendi GİB altyapısını kurması gerekmez.
- E-Fatura ile fiziksel fatura aynı anda kesilebilir mi?
- Hayır. 509 Sıra No.lu VUK Tebliği gereğince e-Fatura mükellefi olan firma aynı işlem için kağıt fatura düzenleyemez. İstisna: e-Fatura sisteminin teknik nedenle kesintide olması — bu durumda GİB'e 1 iş günü içinde olağanüstü durum bildirimi yapılır.
- Bir e-Fatura yanlış kesilirse nasıl iptal edilir?
- İptal/iade için iki yol: (1) e-Fatura sistemi üzerinden ‘İtiraz' (8 gün içinde alıcı reddedebilir), (2) Karşıt belge (Credit Note — iade faturası) kesimi. Düzenleyici bizzat e-Faturayı silemez — denetim izi (audit trail) zorunludur.
Kaynakça
Bu yazı aşağıdaki uluslararası kaynaklardan sentezlenip Türkiye mevzuat bağlamına uyarlanmıştır. Doğrudan çeviri yapılmamıştır.
- 509 Sıra No.lu Vergi Usul Kanunu Genel Tebliği. T.C. Hazine ve Maliye Bakanlığı — Gelir İdaresi Başkanlığı. https://www.gib.gov.tr/node/144097 (erişim: 2026-05-13)
- e-Fatura Uygulaması — Teknik Kılavuz UBL-TR 2.1. Gelir İdaresi Başkanlığı — e-Belge. https://ebelge.gib.gov.tr/efaturamevzuat.html (erişim: 2026-05-13)
- Universal Business Language Version 2.1. OASIS Standards Consortium. https://docs.oasis-open.org/ubl/os-UBL-2.1/UBL-2.1.html (erişim: 2026-05-13)
- ETSI EN 319 132-1 — XAdES Digital Signatures. European Telecommunications Standards Institute. https://www.etsi.org/deliver/etsi_en/319100_319199/31913201/ (erişim: 2026-05-13)
- 1 Sıra No.lu Elektronik Defter Genel Tebliği. Gelir İdaresi Başkanlığı. https://www.gib.gov.tr/node/87 (erişim: 2026-05-13)
- Kamu Sertifikasyon Merkezi — Mali Mühür. TÜBİTAK BİLGEM Kamu SM. https://kamusm.bilgem.tubitak.gov.tr/ (erişim: 2026-05-13)
- XBRL Global Ledger Taxonomy Framework. XBRL International. https://www.xbrl.org/the-standard/what/gl/ (erişim: 2026-05-13)