SOAP WS · E-Fatura WS (EInvoiceWS)

Taslak Fatura Yükleme (LoadInvoice)

SOAPLoadInvoiceRequest

FATURA Entegrasyon Platformu üzerinden 1 yada daha fazla faturayı E-Fatura sistemine yükler.
Eğer fatura numarası atanmışsa (16 hane ise) şema ve şematron kontrolünden geçirilir. Fatura numarası atanmamışsa şema ve şematron kontrolü yapılmaz.
Aynı faturanın tekrar yüklenmesine müsade edilir. Farklı kayıt oluşturulmaz. Oluşan kayıt yeni içerik ile güncellenir.

Ad	Tip	Zorunlu	Aciklama
`REQUEST_HEADER`	`object`	Evet	Her webservis isteğinde gönderilmesi beklen ortak elemandır
└ `SESSION_ID`	`text`	Evet	Kimlik doğrulama servisi (AuthenticationWS) oturum açma metodundan (Login) alına oturum/token/session bilgisi.
└ `CLIENT_TXN_ID`	`text`	Hayir	İ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`	Hayir	Metodu çağıran uygulamanın adı. Örnek: AppName-v1.4.67
└ `COMPRESSED`	`select`	Hayir	İç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.
`INVOICE`	`object`	Evet	Gönderilecek fatura bilgileri. Bir istek ile çoklu fatura gönderimi yapmak için INVOICE elemanı çoklanmalıdır.
└ `CONTENT`	`base64`	Evet	Faturanın Base64Binary tipinde XML veya Ziplenmiş içeriği.

Webservis işlem başarılı olduğunda response objesi içerisinde REQUEST_RETURN tipinde sonuç dönülecektir.

Servisten dönen hata sonuç nesnesi şu şekildedir:

Parametre	Tip	Açıklama
REQUEST_RETURN	ComplexType	İşlem sonucunu içeren başarılı sonuç objesi
INT_TXN_ID	String	Sunucuda işlemin gerçekleştirildiği transaction IDsi. Bu ID istemci tarafında kaydedilerek oluşabilecek hatalarda referans olarak destek ekibine iletilebilir.
RETURN_CODE	String	Başarılı işlemlerde `0` değeri döner. Başarısız olduğunda bu eleman dönülmez.
INVOICE_ID	String	Fatura numarası e-arşiv platformunda atanmışsa atanan fatura numarası dönülür.

Webservis metodunda hata oluşması durumunda response objesi içerisinde ERROR_TYPE tipinde sonuç dönülecektir.

Servisten dönen hata sonuç nesnesi şu şekildedir:

Parametre	Tip	Açıklama
ERROR_TYPE	ComplexType	İşlem sonucunu içeren başarısız/hatalı sonuç objesi
INTL_TXN_ID	String	Sunucuda işlemin gerçekleştirildiği transaction IDsi. Bu ID istemci tarafında kaydedilerek oluşabilecek hatalarda referans olarak destek ekibine iletilebilir.
ERROR_CODE	String	Hata kodu. Hata kod detayları için ilgili servisteki hata kod listesini inceleyebilirsiniz.
ERROR_SHORT_DESC	String	Hatanın kısa açıklaması.

Hata 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İ}