BirFatura E-Fatura Entegrasyonu

Kategori: E-Fatura
Versiyon: 1.0.0

BirFatura eklentisi, siparişlerinizi BirFatura platformu üzerinden faturalandırmanızı sağlar. Özel entegrasyon (sipariş çekme modeli) kullanır: BirFatura, mağazanızın API'sini çağırarak onaylı siparişleri kendi paneline çeker ve fatura keser.

Çalışma Şekli

Bu entegrasyon "pull" (çekme) modeliyle çalışır. BirFatura, sizin mağazanıza bağlanır ve siparişleri oradan çeker — siz BirFatura'ya değil, BirFatura size bağlanır. Bu nedenle kurulum adımları diğer e-Fatura entegrasyonlarından farklıdır.

1. Mağaza Panelinden API Token Oluşturun

1. Sol menüden Entegrasyonlar → E-Fatura → BirFatura bölümüne gidin.
2. Ayarlar sekmesini açın.
3. Yeni Token Oluştur butonuna tıklayın. Sistem otomatik bir UUID token üretir.
4. Oluşturulan token'ı kopyalayın — BirFatura panelinde kullanacaksınız.

2. BirFatura Panelinde Mağaza Ayarlarını Yapın

1. uygulama.birfatura.com/MagazaAyarlariOzelEnt adresine gidin.
2. Mağaza Site Adresi alanına mağazanızın tam URL'sini girin.
   • Özel domain varsa: https://maganiz.com
   • Alt domain kullanıyorsanız: https://magazaadi.igkfast.com
   • Dikkat: Adresin sonuna /api eklemeyin.
3. 1. adımda kopyaladığınız token'ı API Token alanına yapıştırın.
4. BirFatura panelinde kaydedin.

3. Bağlantıyı Test Edin

Mağaza panelinize geri dönerek Bağlantı Testi butonuna tıklayın.

• Başarılı olursa: "Merchant API yanıt veriyor. BirFatura panelinde site adresi olarak bu URL kullanılmalı: …" mesajı görünür.
• Hata alırsanız aşağıdaki kontrolleri yapın.

Sık Karşılaşılan Sorunlar

"API HTML sayfa döndürdü" hatası:
BirFatura panelinde girdiğiniz site adresinin sonunda /api olmaması gerekir. Doğru format: https://magazaadi.igkfast.com

"API token oluşturup kaydedin" hatası:
Mağaza panelinizden token üretip Kaydet'e bastıktan sonra BirFatura paneline girdiğinizden emin olun.

"API token okunamadı. Token yenileyin" hatası:
Mağaza panelinde Yeni Token Oluştur ile token'ı yenileyip BirFatura paneline tekrar yapıştırın.