Fatura API’si ile neler yapabilirim?

Sipariş ve iade hareketlerinizi göndererek e-arşiv ve e-fatura kesimini kendi yazılımınızın içinden tetikleyebilirsiniz. Belge numarası, durumu ve PDF bağlantısı yanıt içinde döndüğü için kendi panelinizde müşteriye gösterebilirsiniz.

API anahtarını nasıl alıyorum?

Finans Fatura panelinde Ayarlar → API Anahtarları bölümünden kendinize anahtar üretirsiniz. Anahtarı sunucu tarafında saklayın; tarayıcıya veya mobil uygulama paketine gömmeyin. Gerektiğinde anahtarı iptal edip yenisini üretebilirsiniz.

Aynı siparişi iki kez gönderirsem ne olur?

Yazma uçlarında Idempotency-Key başlığı zorunludur. Aynı anahtarla gönderilen tekrar istekleri yeni belge oluşturmaz, ilk isteğin sonucunu döndürür. Böylece ağ hatası sonrası yeniden denemeleriniz çift fatura üretmez.

Hangi diller için SDK var?

PHP, Node.js, Python ve .NET için hazır istemci kütüphaneleri sunuyoruz. Listede olmayan bir dil kullanıyorsanız uçları doğrudan HTTP ile çağırabilirsiniz; istek ve yanıt şemaları dokümanda yer alır.

Test ortamı var mı?

Deneme hesabınızla entegrasyonu uçtan uca test edebilirsiniz. Canlıya geçmeden önce belge akışını, hata senaryolarını ve iade yolunu test kontörleriyle doğrulamanızı öneririz.

API kullanımı ek ücretli mi?

API erişimi lisansınıza dahildir; ücretlendirme kesilen belge başına kontör üzerinden işler. Hız sınırları ve IP kısıtları hesabınıza göre tanımlanabilir.

API ile Fatura Entegrasyonu

Kendi yazılımınızı, özel e-ticaret altyapınızı veya iç sistemlerinizi Finans Fatura REST API’si ile bağlayabilirsiniz. Sipariş, iade ve fatura uçlarına istek göndererek e-arşiv ve e-fatura kesimini kendi akışınızın içine alırsınız.

Kimlik doğrulama size özel API anahtarı (X-Api-Key) ile yürür. Tüm yazma uçlarında Idempotency-Key zorunludur; aynı isteği yeniden göndermeniz çift fatura oluşturmaz.

PHP, Node.js, Python ve .NET için hazır SDK’lar mevcuttur. Hiçbirini kullanmak istemezseniz doğrudan HTTP ile de entegre olabilirsiniz.

API ile Fatura Entegrasyonu — Finans Fatura

Kurulum

3 adımda çalışır hâle gelin

1
API anahtarı üretin
Panelde Ayarlar → API Anahtarları bölümünden kendinize bir anahtar oluşturun.
2
İstek gönderin
Sipariş veya fatura verinizi ilgili uca POST edin; Idempotency-Key başlığını eklemeyi unutmayın.
3
Belge döner
Belge oluşturulur, GİB’e iletilir; yanıt içinde belge numarası ve PDF bağlantısı döner.

Kendi altyapınız için fatura API’si

Hazır bir eklenti yoksa entegrasyonu siz kurun; uçlar ve SDK’lar hazır.

Hazır SDK’lar

PHP, Node.js, Python ve .NET için istemci kütüphaneleri; istek imzalama ve hata yönetimi sizin tarafınızda iş çıkarmaz.

API anahtarı ile kimlik doğrulama

Sunucu-sunucu çağrıları X-Api-Key ile yürür. Anahtarları panelden üretir, gerektiğinde iptal edersiniz.

Idempotency koruması

Yazma uçlarında Idempotency-Key zorunludur; ağ hatası sonrası tekrar denemeleriniz çift belge oluşturmaz.

Sipariş ve iade uçları

Satış ve iade hareketlerini tek uçtan gönderirsiniz; belge türü ve kesim akışı sunucu tarafında yönetilir.

Belge yanıtı ve PDF

Yanıt içinde belge numarası, durumu ve PDF bağlantısı döner; kendi panelinizde müşteriye gösterebilirsiniz.

Her kanal aynı uçtan

Özel e-ticaret siteniz, mobil uygulamanız veya ERP’niz aynı uçları kullanır; kanal başına ayrı entegrasyon yazmazsınız.

İlgili çözümleri keşfedin

WooCommerceWordPress mağazanız için resmi eklenti.WHMCSHosting/bayilik faturalarınız otomatik kesilsin.E-FaturaGİB onaylı e-fatura kesimi E-Belge ÇözümleriTüm belge türleri

Tüm entegrasyonları görüntüle

Merak ettikleriniz

Finans Fatura hakkında en çok sorulan soruların cevapları burada. E-fatura entegrasyonu, KVKK uyumu ve banka entegrasyonları dahil tüm detaylar.

Kendi altyapınızı Finans Fatura’ya bağlayın

Entegrasyon ihtiyacınızı paylaşın; teknik ekibimiz uçları ve test planını sizinle birlikte kurgulasın.

Teklif İste Bize Ulaşın