E-Fatura API Entegrasyonu: Paraşüt, Nilvera, Uyumsoft
Özet
E-fatura API entegrasyonu, e-ticaret sitenizi veya sipariş sisteminizi kullandığınız özel entegratörün (Paraşüt, Nilvera, Uyumsoft vb.) API'sine bağlayıp faturayı otomatik kesmektir. GİB'e doğrudan entegrasyon ayrı izin ve test süreci gerektirdiği için işletmelerin çoğu entegratör API'si kullanır. Doğru akış: siparişte alıcının vergi numarasıyla e-Fatura mükellefi olup olmadığı sorgulanır; mükellefse e-Fatura, değilse e-Arşiv kesilir; fatura oluşturulur, resmileştirilir ve PDF/bağlantı müşteriye iletilir. Paraşüt API'sinde (v4, OAuth) önce satış faturası oluşturulup sonra e-Fatura/e-Arşiv olarak resmileştirilir ve bu işlem asenkron takip edilir; Nilvera REST API'si API anahtarıyla çalışır.
E-Fatura API Entegrasyonu Nasıl Yapılır?
- 1
Entegratörünüzden API erişimi alın
Paraşüt, Nilvera, Uyumsoft veya kullandığınız entegratörden API/web servis erişimi ve varsa test ortamı bilgilerini isteyin.
- 2
Fatura verisini eşleştirin
Sitedeki ürün, KDV oranı, indirim ve kargo alanlarını entegratörün fatura kalemleriyle eşleştirin.
- 3
Mükellef kontrolünü kurun
Siparişte alıcının vergi numarasıyla e-Fatura mükellefi olup olmadığını sorgulayın ve belge türünü buna göre seçin.
- 4
Faturayı oluşturup gönderin
Faturayı oluşturun, e-Fatura veya e-Arşiv olarak resmileştirin/gönderin, durumunu takip edin ve PDF'i müşteriye iletin.
- 5
Test edip canlıya geçin
Bireysel ve kurumsal alıcı, iade ve hatalı veri senaryolarını test ortamında deneyin; ardından canlı erişime geçin.
E-Fatura API'si Nedir, GİB'e Doğrudan mı Bağlanılır?
E-faturayı GİB sistemine doğrudan bağlanarak göndermek mümkündür ama başvuru, test planı ve canlı tanım süreci gerektirir; bu yol genellikle büyük ve kendi yazılımını yöneten şirketler içindir. İşletmelerin çoğu bir özel entegratör kullanır ve sitesini o entegratörün API'sine bağlar. Entegratör faturayı GİB formatına (UBL-TR) çevirip iletir; siz yalnızca fatura verisini doğru göndermekle uğraşırsınız.
Paraşüt API ile E-Fatura ve E-Arşiv
Paraşüt'ün REST tabanlı API'si (v4) OAuth ile kimlik doğrular ve JSON:API biçiminde çalışır. Fatura akışı iki adımlıdır: önce müşteri ve satış faturası oluşturulur, ardından bu fatura e-Fatura veya e-Arşiv olarak resmileştirilir. Resmileştirme anında tamamlanmaz; dönen iş (job) takip edilir ve tamamlandığında belge ve PDF bağlantısı okunur.
- Müşteri kaydı (vergi/TC kimlik numarası ile)
- Satış faturası oluşturma (ürün, KDV oranı, kargo kalemi)
- Alıcının e-Fatura mükellefi olup olmadığının sorgulanması
- e-Fatura veya e-Arşiv olarak resmileştirme ve işin tamamlanmasını bekleme
- Belge PDF'inin müşteriye iletilmesi ve siparişe bağlanması
Nilvera API
Nilvera, REST tabanlı API'sini API anahtarıyla kullanıma açar; e-Fatura, e-Arşiv ve e-İrsaliye gibi belge türleri ayrı modüllerdir. Anahtar yalnızca sunucu tarafında (ortam değişkeninde) tutulmalı, tarayıcıya hiçbir zaman gönderilmemelidir. Giden fatura, taslak ve durum sorgusu işlemleri aynı API üzerinden yapılır.
Uyumsoft ve Diğer Entegratörler
Uyumsoft ve diğer özel entegratörler de e-fatura ve e-arşiv için web servis veya API erişimi sağlar. Teknik yapı (SOAP/REST), kimlik doğrulama ve test ortamı entegratöre göre değişir; erişim ve güncel doküman entegratörün destek ekibinden alınır. Akış her entegratörde aynıdır: mükellef kontrolü, doğru belge türü, gönderim, durum takibi.
Doğru Entegrasyon Akışı
Entegratör hangisi olursa olsun, hatasız bir otomatik faturalama aynı kurallara dayanır. En sık yapılan hata, aynı sipariş için iki fatura kesilmesi ve alıcı türünün yanlış seçilmesidir.
- Sipariş başına tek fatura: tekrar denemede yeni fatura değil, mevcut kayıt kullanılır
- Alıcı e-Fatura mükellefi mi? Önce sorgula, sonra türü seç
- Ürün, KDV oranı, indirim ve kargo kalemlerinin faturaya birebir aktarılması
- Resmileştirme/gönderim durumunun takibi; başarısız olanların yeniden denenmesi
- İade siparişlerinde iade faturası akışı
Sık Sorulan Sorular
Paraşüt API ücretsiz mi?
API erişimi Paraşüt aboneliğinizin kapsamına ve paketinize bağlıdır; erişim koşullarını Paraşüt'ten teyit edin. Entegrasyonun geliştirilmesi ayrı bir iştir.
E-Fatura mı e-Arşiv mi kesilecek, nasıl anlaşılır?
Alıcı e-Fatura mükellefi bir işletmeyse e-Fatura, bireysel müşteri veya mükellef olmayan bir alıcıysa e-Arşiv kesilir. Entegrasyon, alıcının vergi numarasıyla mükellef sorgusu yapıp türü otomatik seçecek şekilde kurulur.
Entegratörümü değiştirmem gerekir mi?
Hayır. API sunan bir entegratör kullanıyorsanız mevcut hesabınızla entegrasyon yapılır. Entegratörünüz API sunmuyorsa önce bunu netleştirmek gerekir.
WooCommerce için hazır eklenti yeterli mi?
Bazı entegratörlerin WooCommerce eklentisi vardır ve standart akış için yeterli olabilir. Özel sipariş sistemi, pazaryeri siparişlerinin de faturalanması veya özel kurallar (kampanya, paket ürün) varsa API entegrasyonu daha uygundur.
Solman Digital
Bu rehber, gerçekleştirilen projelerden derlenen doğrudan deneyime dayanmaktadır. Konuya ilişkin sorularınız için doğrudan uzman erişimi sunuyoruz.
E-fatura entegrasyonu: sabit kapsam, ₺6.900'den
Ücretsiz Araçlar
Rakamları Kendiniz Hesaplayın
Entegrasyon veya geliştirme kararı vermeden önce SolmanAI'nin ücretsiz hesaplama araçlarıyla mevcut durumunuzu analiz edebilirsiniz.