GİB e-Fatura ve Ön Muhasebe API Entegrasyonu

Doğrudan entegrasyon belge başına kontör maliyetini ortadan kaldırır ve tam kontrol verir; karşılığında mali mühür, zaman damgası, arşivleme ve 7/24 sistem sürekliliği sizin sorumluluğunuzdadır. Entegratör API'si bu yükü devralır, kurulum hızlanır; bedeli abonelik veya kontördür. Aylık binlerce belge kesen ve teknik ekibi olan kurumlar doğrudan modeli, diğer çoğu işletme entegratörü tercih eder.

GİB Portal düşük hacim için tasarlanmıştır: belgeler elle girilir, aylık fatura sınırı vardır ve API sunmadığı için yazılımınızla konuşamaz. Ayda birkaç yüz belgeye yaklaştığınızda, birden fazla satış kanalınız oluştuğunda veya fatura girişine ayrılan personel saati belirginleştiğinde API entegrasyonu kendini hızla amorti etmeye başlar.

e-Fatura, alıcısı da e-Fatura mükellefi olan firmalara kesilir ve GİB sistemi üzerinden karşı tarafın gelen kutusuna düşer; ticari senaryoda alıcı belgeyi kabul veya red edebilir. e-Arşiv, mükellef olmayan kişi ve kurumlara kesilir, GİB'e raporlanır ve müşteriye e-posta ya da bağlantıyla iletilir. Doğru kurulmuş entegrasyon, alıcının mükellefiyetine göre belge tipini otomatik seçer.

Girilen vergi veya TC kimlik numarasının geçerliliğini, unvanı ve tarafın e-Fatura mükellefi olup olmadığını anlık doğrular. Böylece yanlış unvanla belge kesilmez, mükellefe yanlışlıkla e-Arşiv gönderilmez. Sorgunun cari kayıt ve fatura ekranına gömülmesi, reddedilen faturaların en yaygın nedenini kaynağında ortadan kaldırır.

Logo (Tiger, GO), Mikro, Netsis, Paraşüt ve Zirve başta olmak üzere açık API'si veya web servisi bulunan programlarla çalışılabilir. Bağlantı; programın REST API'si, nesne katmanı veya veritabanı entegrasyonu üzerinden kurulur. API'si olmayan eski sürümlerde dosya tabanlı aktarım gibi alternatifler değerlendirilir; yöntem, kullandığınız sürüme göre seçilir.

Kapsama bağlıdır. Tek senaryolu, entegratör üzerinden çalışan bir bağlantı testleriyle birlikte genellikle birkaç haftada canlıya alınır; e-İrsaliye, iade akışları ve çoklu şirket içeren projeler 2-3 aya uzayabilir. Edge Bilişim projelerinde takvimin en az esneyen kalemi test dönemidir: tüm senaryolar sandbox ortamında doğrulanmadan canlıya geçilmez, çünkü canlıda düzeltilen her hata mali belgeye dokunur.

Evet. Pazaryerlerinin API'lerinden siparişler düzenli aralıklarla çekilir; müşteri ve tutar bilgisiyle e-Arşiv veya e-Fatura otomatik kesilir, istenirse belge pazaryerine ve müşteriye iletilir. İptal ve iade senaryoları da akışa dahil edilir. Böylece kanal başına ayrı fatura operasyonu yürütmek yerine tüm satışlar tek altyapıdan belgelenir.

Evet. ERP'de satış veya sevkiyat gerçekleştiğinde fatura ERP verisinden beslenerek otomatik üretilir; CRM'de kazanılan fırsat da aynı tetikleyici rolünü üstlenebilir. Kurumsal tarafta SAP entegrasyonu ayrı bir uzmanlık alanıdır; servis katmanı üzerinden fatura akışı SAP ile çift yönlü bağlanabilir. Önemli olan tüm belgelerin tek veri kaynağından beslenmesi ve durum bilgisinin kaynağa geri yazılmasıdır.

Evet. Sevk emri oluştuğunda e-İrsaliye otomatik düzenlenip GİB'e iletilir; araç, şoför ve sevk bilgileri belgeye işlenir, irsaliye ile fatura birbirine bağlanır. Sevkiyat verisini depodaki barkod okuyucu ve kantar gibi cihazlardan otomatik toplamak isterseniz donanım API entegrasyonu rehberimiz bu katmanı ayrıntılı anlatıyor.

Her fatura için benzersiz bir referans (idempotency anahtarı) kullanılır; aynı sipariş için gönderim ikinci kez tetiklense bile sistem bunu tanır ve yeni belge oluşturmaz. Ağ kesintisi, çift tıklama veya tekrar çalışan bir otomasyon görevi mükerrer faturaya yol açamaz. Bu kontrol, gönderim kuyruğunun ilk adımı olarak çalışır.

Kaybolmaz. Gönderilemeyen belgeler kuyruğa yazılır, bağlantı geri geldiğinde artan aralıklarla otomatik yeniden denenir; kalıcı hata alan belgeler nedeniyle birlikte yetkiliye bildirilir. Kesinti süresince oluşan satışlar da sırayla işlendiği için akış kaldığı yerden devam eder. Kritik olan, bu kuyruk mimarisinin baştan tasarlanmış olmasıdır.

e-Arşiv faturaları yasal süresi içinde iptal edilip GİB'e raporlanabilir. e-Fatura'da ticari senaryoda alıcı belgeyi reddedebilir; temel senaryoda düzeltme, iade faturasıyla yapılır. Entegrasyon bu akışların hepsini destekleyecek şekilde kurulur ve her işlemi kayıt altına alır; hangi yolun uygulanacağını mali müşavirinizle teyit etmek gerekir.

Dört başlığa bakın: GİB'in yetkili özel entegratör listesinde olması; API dokümantasyonunun ve sandbox ortamının kalitesi (geliştirme süresini doğrudan etkiler); kesintisiz çalışma taahhüdü ve destek hızı; kontör/abonelik fiyat modeli ile sözleşmedeki veri devri şartları. Fiyat kadar, ayrılmak istediğinizde belge arşivinizin size nasıl teslim edileceği de önemlidir.

Doğru mimaride bozulmaz. Fatura mantığı ile entegratöre özgü API çağrıları ayrı katmanlarda tutulursa, entegratör değişikliğinde yalnızca ince bir bağlantı katmanı yeniden yazılır; senaryolar, kuyruk ve raporlama aynen kalır. Geçişte eski entegratördeki belge arşivinin devri sözleşmeye göre önceden planlanmalıdır.

Evet ve bu adım pazarlık konusu değildir. Tüm senaryolar — e-Fatura, e-Arşiv, iade, iptal, hata yanıtları — önce GİB veya entegratörün test ortamında uçtan uca denenir. Edge Bilişim bu aşamada gerçek verinize benzeyen örnek belgelerle şema kontrollerini ve red senaryolarını bilerek tetikler; canlıya yalnızca tamamı doğrulanmış akış alınır.

Dört değişken belirler: kapsanan belge tipleri (e-Fatura, e-Arşiv, e-İrsaliye, iade), bağlanan sistem sayısı (satış kanalları, ön muhasebe, ERP), çoklu şirket/şube ihtiyacı ve mevcut yazılımınızın API'ye ne kadar hazır olduğu. Geliştirme bedeli tek seferliktir; entegratör kontörü ise belge başına işleyen ayrı bir operasyon gideridir. Sağlıklı teklif ancak kapsam netleştikten sonra verilebilir; tek fiyat listesi yanıltıcı olur.