API Teknik

QNB eFinans Özel Entegratör hizmetlerinden web servis seviyesinde faydalanmak isteyen müşterilerimiz ve çözüm ortaklarımız için, eFinans web servis teknik dokümantasyonu oluşturulmuştur.

Bulut ortam hizmetini kullanan müşterilerimiz e-belgelerini eFinans web servis vasıtasıyla alıcılarına gönderebilir ya da özel entegratör hesaplarına gelmiş e-belgelerini aynı web servisler vasıtasıyla görüntüleyebilirler.

e-Fatura ve e-İrsaliye uygulamalarının web servis adresleri ortaktır. Diğer e-belge uygulamalarının her birine ait farklı web servis adresleri vardır.

Tüm servislerin ortak özelliği olarak, servislerde iki farklı kimlik doğrulama yöntemi kullanılabilir:

1. SOAP Header

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://service.connector.uut.cs.com.tr/">

<soapenv:Header>

<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">

<wsse:UsernameToken>

<wsse:Username>username</wsse:Username>

<wsse:Password>password</wsse:Password>

</wsse:UsernameToken>

</wsse:Security>

</soapenv:Header>

<soapenv:Body>

...

</soapenv:Body>

</soapenv:Envelope>

2. Cookie

Cookie yöntemi tercih edilirse, Tüm servisler için ortak olan kullanıcı kimlik doğrulama servisi içerisindeki “wsLogin” metodu kullanılmalı ve oluşturulan cookie, konnektör servisinde kullanılmalıdır.

Her iki yöntem de, eFinans portal hesabında tanımlı olan kullanıcı kodu ve şifresi kullanılır.

Servisler, GİB’in standart UBL formatı haricinde, eFinans müşterilerine özel olarak oluşturulan custom XML (CS-XML) formatını da kabul etmektedir. e-Defter için XBRL formatına ek olarak eFinans’a özel csv uzantılı e-Defter veri formatı desteklenmektedir.

Dokümantasyon içerisinde web servislerin içerikleri, örnek kullanımları, e-belge formatları ve kural dosyaları, örnek kodlar ve açıklama metinleri bulunmaktadır.

Tüm sorularınızı proje@destek.qnbefinans.com adresine iletebilirsiniz.

e-Fatura & e-İrsaliye dokümanını indirmek için tıklayın.
e-Arşiv dokümanını indirmek için tıklayın.
e-Defter dokümanını indirmek için tıklayın.
e-SMM & e-MM dokümanını indirmek için tıklayın.
e-Adisyon dokümanını indirmek için tıklayın.