QNB Finansbank e-Fatura / e-Arşiv Entegrasyonu

Kategori: E-Fatura Versiyon: 1.0.0

QNB eklentisi, QNB Finansbank eFinans SOAP servisi aracılığıyla faturalarınızın durumunu sorgulayıp siparişlerinize işler.

ℹ️ Bu entegrasyon üzerinden panelden fatura kesilemez. Faturalarınızı QNB eFinans portalinden oluşturmaya devam edersiniz; entegrasyon yalnızca fatura durumlarını mağaza paneline taşır.

Panel üzerinden fatura kesmek istiyorsanız eLogo, Paraşüt veya KolayBi entegrasyonlarından birini kullanabilirsiniz.


Desteklenen Özellikler

  • Fatura durumu sorgulama
  • Bağlantı testi

1. Ön Hazırlık — QNB eFinans'tan Bilgilerinizi Alın

QNB eFinans aboneliğinizden şu bilgileri temin edin:

  • Kullanıcı Kodu
  • Şifre
  • ERP Kodu
  • User Service WSDL adresi
  • Connector Service WSDL adresi
  • e-Arşiv WSDL adresi

⚠️ QNB üç ayrı servis adresi kullanır. User Service ve Connector Service adresleri birbirinden farklıdır; ikisini de QNB'den ayrı ayrı isteyin, aynı değeri her iki alana yazmayın.

Resmi API dokümantasyonu: qnbesolutions.com.tr/api-docs-tr-final.html

📸 QNB eFinans müşteri paneli veya QNB'den gelen bilgi e-postası, ilgili alanlar vurgulanmış

2. Eklentiyi Mağaza Panelinde Yapılandırın

  1. Sol menüden Eklenti Mağazası sayfasına gidin ve QNB E-Fatura kartındaki Eklentiyi Yapılandır butonuna tıklayın.
  2. Bağlantı Ayarları sekmesine tıklayın.
📸 QNB e-Fatura entegrasyon sayfası, Bağlantı Ayarları sekmesi
  1. Aşağıdaki alanları doldurun:
AlanAçıklama
Kullanıcı KoduQNB eFinans kullanıcı kodunuz
ŞifreQNB eFinans şifreniz
ERP KoduBelge gönderiminde kullanılan ERP kodunuz
User Service WSDLKullanıcı servisi adresi
Connector Service WSDLBağlayıcı servis adresi
e-Arşiv WSDLe-Arşiv servis adresi
Test ortamıCanlıya geçmeden önce açık tutun
  1. Kaydet butonuna tıklayın.

3. Bağlantıyı Test Edin

Bağlantıyı Test Et butonuna tıklayın. Başarılı mesajı görürseniz entegrasyon hazırdır.

📸 QNB bağlantı testi başarılı bildirimi

Hata alırsanız: "QNB e-Fatura bilgileri yapılandırılmamış. Lütfen kullanıcı kodu, şifre ve WSDL adreslerini girin." mesajı görünür.


4. Fatura Durumlarını Görüntüleme

Onaylanan Siparişler sekmesinde, faturası kesilmiş siparişlerin güncel fatura durumunu görebilirsiniz.

📸 Onaylanan Siparişler sekmesi, fatura durumu sütunu

Sık Karşılaşılan Sorunlar

WSDL bağlantı hatası: Üç WSDL adresinin de tam ve doğru alana girildiğini kontrol edin. Test ve üretim ortamları için farklı WSDL adresleri kullanılır; Test ortamı anahtarının girdiğiniz adreslerle uyumlu olduğundan emin olun.

Kimlik doğrulama hatası: Kullanıcı kodunuzun ve ERP kodunuzun eksiksiz girildiğinden emin olun; şifreyi kopyala-yapıştır ile girin.

Fatura Oluştur butonunu göremiyorum: Bu sağlayıcı için panelden fatura kesme desteklenmemektedir. Faturalarınızı QNB eFinans portalinden oluşturun.