e-Fatura ve e-Arşiv Entegrasyonu: Türkiye'de Yazılımlara Nasıl Eklenir?
Yazılımınıza e-Fatura ve e-Arşiv entegrasyonu nasıl eklenir? GİB API ve özel entegratörler üzerinden 2026 teknik rehberi.
⚡ TL;DR — Hızlı Özet
Türkiye'de e-Fatura ve e-Arşiv entegrasyonu için iki yol var: GİB'in doğrudan portal API'si (ücretsiz ama sınırlı) veya özel entegratör (Paraşüt, Faturex, EDM vb.) üzerinden REST API. Kendi yazılımınıza entegre etmek için özel entegratör API'si çok daha pratiktir.
e-Fatura Zorunluluğu: Türkiye'de Çerçeve
Türkiye'de e-Fatura ve e-Arşiv fatura zorunluluğu giderek genişliyor. Gelir İdaresi Başkanlığı (GİB), belirli ciro eşiklerinin üzerindeki mükellefleri her yıl kapsamına alıyor. 2026 itibarıyla yıllık cirosu 4 milyon TL üzerinde olan işletmeler e-Fatura kullanmak zorunda; e-Arşiv kapsamı ise çok daha geniş.
e-Fatura vs. e-Arşiv Fatura: Fark
| Özellik | e-Fatura | e-Arşiv Fatura |
|---|---|---|
| Kime | e-Fatura mükellefi olan kurumlara | e-Fatura mükellef olmayanlara ve bireysel tüketicilere |
| Format | UBL-TR XML + GİB imzası | PDF (içinde XML) + e-imza |
| İletim | GİB altyapısı üzerinden | E-posta, portal veya entegratör |
| Arşiv zorunluluğu | 10 yıl (mükellef ve GİB) | 10 yıl (mükellef) |
Entegrasyon Yöntemleri
Yöntem 1: GİB Portalı (Ücretsiz, Manuel)
efatura.gov.tr üzerinden fatura kesme ve listeleme yapılabilir. Düşük hacimli işletmeler için uygundur ama API yoktur; yazılım entegrasyonuna imkan vermez.
Yöntem 2: Özel Entegratör API'si (En Çok Tercih Edilen)
GİB'den yetki almış özel entegratörler (Paraşüt, Faturex, EDM, Papara, eBelge vb.) REST API sunar. Yazılımınız bu API'yi çağırarak fatura oluşturur, imzalar ve iletir.
Özel entegratör REST API ile tipik akış:
- Fatura verisini JSON/XML formatında API'ye POST edersiniz
- Entegratör UBL-TR XML oluşturur, imzalar ve GİB'e iletir
- Durum (onaylandı/reddedildi) webhook veya polling ile alınır
- PDF fatura indirilir veya müşteriye e-posta gönderilir
Yöntem 3: GİB Entegratör (Doğrudan API)
Yüksek hacimli (günde 1000+ fatura) işletmeler için GİB'e doğrudan bağlanan entegratör geliştirilir. Teknik yetkinlik gerektirir ve GİB sertifikasyonu gerekir.
Geliştirme Tahmini Süre ve Maliyet
| Entegrasyon Tipi | Süre | Maliyet (tahmini) |
|---|---|---|
| Özel entegratör API (basit) | 3-7 gün | 15.000-40.000 TL |
| ERP + e-Fatura entegrasyonu | 2-4 hafta | 40.000-120.000 TL |
| Tam GİB entegratör | 2-4 ay | 200.000+ TL |
Desteklenen Belge Türleri
- e-Fatura (e-Invoice)
- e-Arşiv Fatura
- e-İrsaliye (e-Despatch)
- e-Müstahsil Makbuzu
- e-SMM (Serbest Meslek Makbuzu)
- e-Bilet
e-Fatura entegrasyon geliştirme için ORCA teknik ekibiyle görüşün.
İlgili Yazılar
Özel Yazılım Geliştirme Maliyetleri 2026: Yatırım Getirisi (ROI) Nasıl Hesaplanır?
Bir yazılım projesinin maliyeti neye göre belirlenir? 2026 yılı özel yazılım fiyat aralıkları, gizli maliyetler ve yatırımınızın geri dönüş süresini (ROI) nasıl hesaplayacağınızı keşfedin.
Devamını Oku →Dijital Dönüşüm: Şirketinizi Geleceğe Nasıl Hazırlarsınız?
Eski yazılımlarınız işinizi yavaşlatıyor mu? Mevcut operasyonları durdurmadan modern teknolojilere geçişin yollarını öğrenin.
Devamını Oku →ERP & CRM Yazılımı: İşletmenize Özel Kurumsal Yönetim Sistemleri
ERP ve CRM yazılımları ile iş süreçlerinizi dijitalleştirin, verimliliği artırın ve maliyetleri düşürün. SAP, Oracle gibi hazır paketlere alternatif özel çözümler.
Devamını Oku →