Satıcı faturası servisleri için WSDL adresi: https://api.n11.com/ws/SellerInvoiceService.wsdl
Çalıştığınız bir fatura servisinden elde ettiğiniz link şeklindeki faturalarınızı ilgili siparişe kaydedebilirsiniz.
- Fatura linkiniz ve sipariş numarası ile bu kayıt işlemini gerçekleştirebilirsiniz.
- Her 2 alana da giriş yapmak zorunludur.
- Aynı sipariş için sadece aktif olarak 1 adet fatura linki kaydedebilirsiniz.
- Tekrar yapacağınız yüklemelerde, önceki yüklemiş olduğunuz kayıt silinerek en sonuncusu aktif yapılır.
- Yapacağınız fatura linki kayıtlarında aşağıdaki kurallara tabii olacaksınız:
- “url” alanı için beklenen standartları sağlamalısınız.
- Linkteki dosya uzantısı sadece pdf, png veya jpeg olmalı.
- Http protokolünü güvenli şekilde içermeli: HTTPS
- Link uzunluğu 2048 karakteri geçemez.
- Genel url standartlarına uygun olmalıdır.
- “orderNumber” alanına, satıcısı olarak bulunduğunuz bir sipariş numarası girmelisiniz.
- “url” alanı için beklenen standartları sağlamalısınız.
- invoiceDateTime ve invoiceNumber alanları e-İhracat siparişleri için zorunlu olup, yurt içi siparişlerde opsiyoneldir.
- invoiceNumber alanında değer doğrulama bulunmaktadır;
- İlk üç hane; alfanümerik olmalıdır (Harf veya rakam).
- Dört, beş, altı ve yedinci hane; bir yıla eşit ve 2020 – 2099 aralığında olmalıdır.
- Sekizinci haneden itibaren (Son dokuz hane) nümerik olmalı.
Önemli Fatura linklerinde yaratılan özel karakterler XML parametrelerini bozmaktadır. Linklerde sıklıkla kullanılan & değerini "&" iletilmesi durumda sorun olmayacaktır.
| Parametre | Parametre Değer | Açıklama |
| Auth.appKey | API Key | |
| Auth.appSecret | API Secret | |
| url | Fatura Linki | |
| orderNumber | Sipariş Numarası | |
| invoiceDateTime | Timestamp (milliseconds) ve GMT +3 olarak gönderilmelidir. | Fatura Tarihi |
| invoiceNumber | ([3 digit(alphanumeric)][13 digit(numeric)]) | Fatura Numarası |
| Parametre (Cevap) | Açıklama |
| result.status | İşlem sonucu durum bilgisini gösterir. “success” ya da “failure” durum bilgilerini döner. |
| url | Kaydedilen Fatura Linki |
| orderNumber | Fatura Kaydedilen Sipariş Numarası |
| invoiceDateTime | Fatura Tarihi |
| invoiceNumber | Fatura Numarası |
Örnek Request (Yurtiçi)
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sch="http://www.n11.com/ws/schemas">
<soapenv:Header/>
<soapenv:Body>
<sch:SaveLinkSellerInvoiceRequest>
<auth>
<appKey>***</appKey>
<appSecret>***</appSecret>
</auth>
<url>https://extfatura.faturaentegratoru.com/324523-34523-52345-3453246.pdf</url>
<orderNumber>202665912318</orderNumber>
</sch:SaveLinkSellerInvoiceRequest>
</soapenv:Body>
</soapenv:Envelope>Örnek Response (Yurtiçi)
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns3:SaveLinkSellerInvoiceResponse xmlns:ns3="http://www.n11.com/ws/schemas">
<result>
<status>success</status>
</result>
<url>https://extfatura.faturaentegratoru.com/324523-34523-52345-3453246.pdf</url>
<orderNumber>202665912318</orderNumber>
</ns3:SaveLinkSellerInvoiceResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>Örnek Request (e-İhracat)
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sch="http://www.n11.com/ws/schemas">
<soapenv:Header/>
<soapenv:Body>
<sch:SaveLinkSellerInvoiceRequest>
<auth>
<appKey>***</appKey>
<appSecret>***</appSecret>
</auth>
<url>https://extfatura.faturaentegratoru.com/324523-34523-52345-3453245.pdf</url>
<orderNumber>202665912317</orderNumber>
<invoiceNumber>N112026000000001</invoiceNumber>
<invoiceDateTime>1780903800000</invoiceDateTime>
</sch:SaveLinkSellerInvoiceRequest>
</soapenv:Body>
</soapenv:Envelope>Örnek Response (e-İhracat)
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns3:SaveLinkSellerInvoiceResponse xmlns:ns3="http://www.n11.com/ws/schemas">
<result>
<status>success</status>
</result>
<url>https://extfatura.faturaentegratoru.com/324523-34523-52345-3453245.pdf</url>
<orderNumber>202665912317</orderNumber>
<invoiceDateTime>1780903800000</invoiceDateTime>
<invoiceNumber>N112026000000001</invoiceNumber>
</ns3:SaveLinkSellerInvoiceResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>