Finans Fatura API

Finans Fatura API'si, e-ticaret altyapılarının ve pazaryeri yazılımlarının müşterilerine e-Fatura / e-Arşiv kesme yeteneği kazandırmasını sağlar. Siparişi bize gönderirsiniz; GİB'e giden belgeyi biz keseriz, durumunu size geri veririz.

Temel model: önce satış, sonra fatura

Entegrasyonun tamamı iki çağrıdır; fatura alıcısı ilkinin içinde taşınır.

1. Satış oluştur     POST /v1/integrations/orders
     ├─ buyer → satışın fatura alıcısı (belgeye kopyalanır)   ZORUNLU
     └─ transaction_id
        ↓
2. Faturalandır      POST /v1/invoicing/invoices/
     └─ transaction_header_id = transaction_id            ZORUNLU
        ↓
   Durumu izle       GET  /v1/integrations/{provider}/orders/status

Zincir sabittir: alıcı olmadan satış, satış olmadan fatura oluşmaz. Tek istisna iadedir — InvoiceTypeCode: "IADE" satışa bağlanmaz, bağlanırsa aynı satış iki kez sayılır.

Neden doğrudan fatura değil de önce satış?

	Doğrudan fatura	Önce satış
Mükellefin ciro raporu	siparişi görmez	görür
Stok düşümü	olmaz	olur
Fatura kesilemezse	sipariş kaybolur	satış durur, panelden düzeltilir

Fatura kesimi başarısız olabilir: kontör bitmiş olabilir, alıcının VKN'si geçersiz olabilir, GİB tarafı geçici olarak cevap vermeyebilir. Satış önce oluştuğu için bu durumda sipariş kaybolmaz — mükellef panelden eksiği tamamlayıp faturayı keser.

Faturayı hemen kesmek zorunda değilsiniz

Sadece satışları akıtıp faturalandırmayı mükellefe bırakabilirsiniz. Mükellef panelden tek tek ya da toplu faturalandırır. Bu, çoğu entegrasyon için en sorunsuz başlangıçtır.

Ortamlar

Ortam	Adres
Sandbox	https://sandbox-api.finansfatura.com
Üretim	https://api.finansfatura.com

Sandbox panel: sandbox-app.finansfatura.com

Sandbox ve üretim tamamen ayrı sistemlerdir; anahtarlar, OAuth istemcileri ve veriler birbirine taşınmaz. Geliştirmeyi sandbox'ta yapın.

Kimler kullanır

• E-ticaret altyapıları (ikas, Shopify, IdeaSoft, Ticimax benzeri) — mağaza sahibi adına siparişi iletirsiniz
• Pazaryeri / ERP yazılımları — kendi sisteminizdeki satışı e-belgeye dönüştürürsünüz
• Kendi mağazasını yazan mükellefler — kendi hesabınız için anahtar üretip doğrudan kullanırsınız

Sonraki adım

Uçtan uca ilk entegrasyonunuz için Hızlı Başlangıç'a geçin. Dövizli satış, KDV istisnası, tevkifat ya da iade gibi özel durumlar için Örnek Senaryolar her birini uçtan uca gösteriyor. Python, Node ya da PHP kullanıyorsanız istemci kütüphanelerine bakın — iki adımı da sarıyorlar. WooCommerce veya ikas mağazanız varsa hiç kod yazmadan hazır eklenti ve uygulamaları kurabilirsiniz.

Ürününüzü Finans Fatura mağazasında kendi markanızla listelemek isterseniz Partner Programı'na bakın.