SOAP WS · E-Fatura WS (EInvoiceWS)

Fatura Gönderme (SendInvoice)

SOAPSendInvoiceRequest

Tekli veya çoklu fatura gönderimini destekler.
Bu işlemden sonra gönderilen faturaların durumları GetInvoiceStatus servisi ile kontrol edilmelidir.
Faturanın durumu GIB’de hatalı olduğu zaman bu servis ile faturayı aynı fatura numarası ve aynı ETTN ile tekrar gönderilebilir.
Fatura yüklenirken fatura şema ve şematron kontrolü ve tekillik kontrolünden geçirilir. Fatura XML içerisinde hata varsa sisteme yüklenmez. Fatura XML içerisinde ki sorun düzeltilerek tekrar gönderilmelidir.

Parameters

Name	Type	Required	Description
`REQUEST_HEADER`	`object`	Yes	Her webservis isteğinde gönderilmesi beklen ortak elemandır
└ `SESSION_ID`	`text`	Yes	Kimlik doğrulama servisi (AuthenticationWS) oturum açma metodundan (Login) alına oturum/token/session bilgisi.
└ `CLIENT_TXN_ID`	`text`	No	İstemci uygulama tarafından işlem için üretilen işlem bilgisi (transaction id) varsa istek esnasında gönderilip, sonuçta alabileceğiniz bir değerdir. request/response eşleşmesi yapmak için kullanılabilir.
└ `APPLICATION_NAME`	`text`	Yes	Metodu çağıran uygulamanın adı. Örnek: AppName-v1.4.67
└ `COMPRESSED`	`select`	Yes	İçerikte taşınan bilginin ZIP formatında sıkıştırılmış mı gönderildiği/talep edildiği bilgisi. Belge gönderim ve belge okuma servislerinde gönderilen değere göre işlem yapılmaktadır.
`SENDER`	`object`	No	Faturayı gönderen tarafın VKN/TCKNsi. VKN/TCKN vkn attribute içerisine, gönderici birim (GB) etiketini alias attribute eklenmelidir. Eğer eleman gönderilmezse oturum açılan kullanıcının bağlı olduğu hesapta ki VKN ve gönderici birim etiketi kullanılacaktır. Sender elemanı gönderilmesini tavsiye ederiz.
`RECEIVER`	`object`	No	Faturanın alıcı tarafının VKN/TCKNsi. VKN/TCKN vkn attribute içerisine, posta kutusu (PK) etiketini alias attribute içerisine eklenmelidir. Eğer eleman gönderilmezse fatura içerisinde ki alıcı taraf (AccountingCustomerParty) içerisinde ki VKN/TCKN ve o VKN/TCKN için tanımlanmış herhangi bir PK etiketi kullanılacaktır. Receiver elemanı gönderilmesini tavsiye ederiz. Özellikle alıcı tarafından posta kutusu tercihi talep edilmişse bu eleman kullanılmalıdır.
`XSLT_NAME`	`text`	No	Faturaya eklenecek şablon adı. Fatura içerisinde şablon gönderilmediği durumlarda portalda tanımlanmış bir şablonu faturaya eklemek için kullanılır. Şablonun adını yazınız. Özel desteklenen değerler: DEFAULT: GIB şablonuna firma logo eklenerek gönderilir. CUSTOMER_DEFAULT: Müşteri tarafından portala yüklenmiş şablonlarda varsayılan olarak işaretlenen şablon eklenir.
`SERI_PREFIX`	`text`	No	Faturaya numara ataması sistem tarafından yapılması için kullanılır. Numara atanacak seri ön eki portalda tanımlı olması gerekir. Maksimum 3 hane büyük harf kullanılmalıdır.
`DISABLE_DATE_CONTROL`	`select`	No	Fatura yüklenirken yapılan geriye dönük belge yükleme kontrolünü yüklenen fatura için devre dışı bırakır.
`INVOICE`	`object`	Yes	Gönderilecek fatura bilgileri. Bir istek ile çoklu fatura gönderimi yapmak için INVOICE elemanı çoklanmalıdır.
└ `CONTENT`	`base64`	Yes	Faturanın Base64Binary tipinde XML veya Ziplenmiş içeriği.
`ECOMMERCE_UPLOAD`	`object`	No	Pazaryerinde yapılan satışlar için düzenlenen faturaların pazaryerlerine yüklenmesi için kullanılır. Eğer XML içerisine eklemek istemiyorsanız bu alanı kullanarak gönderim yapabilirsiniz. Eğer UBL Fatura içersine nasıl eklendiğini öğrenmek için fatura senaryolarını inceleyiniz.
└ `ECOMMERCE_ID`	`select`	No	Pazaryeri adı yazılır. HEPSIBURADA , N11 ve TRENDYOL desteklenmektedir.
└ `ECOMMERCE_PACKAGE_ID`	`text`	No	Faturanın düzenlendiği sipariş numarası yazılır.

Sample Response (XML)

<?xml version='1.0' encoding='UTF-8'?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Body>
    <SendInvoiceResponse xmlns="http://schemas.i2i.com/ei/wsdl">
      <REQUEST_RETURN xmlns="">
        <INTL_TXN_ID>65699137</INTL_TXN_ID>
        <RETURN_CODE>0</RETURN_CODE>
      </REQUEST_RETURN>
      <INVOICE_ID xmlns="">UGR2026000000320</INVOICE_ID>
    </SendInvoiceResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Fault Response

Hata Kodları
 Kodu | Açıklama
   -1 | Beklenmedik bir hata oluştu. Lütfen daha sonra tekrar deneyiniz.
10001 | Sistemde Beklenmedik Bir Hata Oluştu: {HATA SEBEBİ}
10002 | Oturum oluşturulamadı
10003 | Belge Şematron Kontrolünden Geçemedi: {HATA SEBEBİ}
10004 | Geçersiz oturum. Lütfen tekrar oturum oluşturunuz ve tekrar deneyiniz
10005 |	Hesabınızın {ÜRÜN ADI} ürün aktif degildir
10006 |	Yetkiniz bulunmamaktadır
10007 |	İstek ZİP bir dosya içermelidir
10008 |	Belirtilen kriterlere uygun kayıt bulunamamıştır
10009 | Gönderilen belge daha önce gönderilmiş bir belge ile eşleşmektedir. ID: ve UUID:
10010 | Bir istek boyutu maksimum 5MB veya 100 adet belge içerebilir
10011 |Tekrarlanan işlem: kayıt sistemde mevcuttur
10012 |	Kullanıcı aktif degil {kullanıcı adı}
10013 | Gönderilen istek geçersizdir. Hata sebebi {0}
10014 | Geçersiz İmza
10015 | Servis desteklenmemektedir. Servis adı
10016 | Müşteri sistemde aktif degildir.
10017 | Gönderilen belge daha önce gönderilmiş bir belge ile eşleşmektedir. ID: ve UUID:
10018 | Yetkisiz erişim tespit edildi! {HATA SEBEBİ}