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 Eklenti Mağazası sayfasına gidin ve BirFatura E-Fatura kartındaki Eklentiyi Yapılandır butonuna tıklayın.
  2. Bağlantı Ayarları sekmesini açın.
  3. Token oluştur / yenile butonuna tıklayın. Sistem otomatik bir UUID token üretir.
  4. Oluşturulan token'ı kopyalama butonuyla kopyalayın — BirFatura panelinde kullanacaksınız.

⚠️ Token yalnızca oluşturulduğu anda tam olarak gösterilir. Sayfadan ayrılmadan kopyalayın.

BirFatura Bağlantı Ayarları
BirFatura Bağlantı Ayarları

İsteğe Bağlı: Başlangıç Tarihi

Eski siparişleri aktarma başlangıç tarihi alanına bir tarih girerseniz BirFatura yalnızca o tarihten sonraki siparişleri çeker. Boş bırakırsanız tüm uygun siparişler sunulur.

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.

    💡 Bu adresi tahmin etmenize gerek yok. Mağaza panelindeki Mağaza site adresi (BirFatura paneline girin) alanında hazır olarak durur; yanındaki kopyalama butonuyla alıp yapıştırın.

    Dikkat: Adresin sonuna /api eklemeyin.

    1. adımda kopyaladığınız token'ı API Token alanına yapıştırın.

  4. BirFatura panelinde kaydedin.

📸 BirFatura paneli Mağaza Ayarları sayfası, site adresi ve token alanları doldurulmuş

3. Bağlantıyı Test Edin

Mağaza panelinize geri dönerek Bağlantıyı Test Et 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.
📸 BirFatura bağlantı testi başarılı toast bildirimi

Sık Karşılaşılan Sorunlar

"API HTML sayfa döndürdü" hatası: BirFatura panelinde girdiğiniz site adresinin sonunda /api olmaması gerekir. Panel üzerindeki Mağaza site adresi alanını kopyalayıp kullanırsanız bu hatayla karşılaşmazsınız.

"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 Token oluştur / yenile ile token'ı yenileyip BirFatura paneline tekrar yapıştırın.