SOAP WS

Bulut e-Defter WS (ELedgerService)

SOAPhttps://efaturatest.izibiz.com.tr/EIWSOIBProxy/ELedgerService?wsdl

Namespace: http://ws.efatura.izibiz.com/

Operasyonlar

SOAPe-Defter Oluşturma (CreateLedger) SOAPDeftere Dosya Ekleme (AddFileLedger) SOAPDefter Listeleme (GetLedgers) SOAPDefter Dosyalarını Listeleme (GetLedgerFile) SOAPDefter XML İçeriği (GetLedgerXml) SOAPDefter Görüntüleme (ViewLedger) SOAPDönem ile Defter Görüntüleme (ViewLedgerByPeriod) SOAPYevmiye Maddesi Sorgulama (GetLedgerEntry) SOAPGİB'e Gönderme (SendToGibLedger) SOAPDefter İptal (CancelLedger)

Bulut e-Defter işlemlerinin (defter oluşturma, listeleme, görüntüleme, GİB'e gönderme, iptal) SOAP üzerinden yapılmasını sağlayan proxy servisidir. Servis, gelen istekleri iZibiz e-Defter REST API'sine yönlendirir.

Başlık	Değer
Endpoint	`https://efaturatest.izibiz.com.tr/EIWSOIBProxy/ELedgerService`
WSDL	`https://efaturatest.izibiz.com.tr/EIWSOIBProxy/ELedgerService?wsdl`
Hedef Namespace	`http://ws.efatura.izibiz.com/`
SOAP Sürümü	SOAP 1.1
Binding	Document / Literal (wrapped)
Kimlik Doğrulama	Her istekte `SESSION_ID` parametresi

Genel kurallar:

SESSION_ID tüm metotlarda zorunludur; AuthenticationWS Login metodundan alınır.
İstek gövdesindeki alt elemanlar namespace'siz (unqualified) gönderilir; yalnızca operasyon elemanı (ws:CreateLedger vb.) namespace'lidir.
Hatalar SOAP Fault olarak dönmez. Hata durumunda normal yanıt döner ve ERROR bloğu dolu gelir. Her yanıtta önce ERROR bloğu kontrol edilmelidir.
Dosya alanları (USER_FILE) base64Binary tipindedir; dosya içeriği Base64 kodlanarak gönderilir.
Boş gönderilen opsiyonel alanlar arka uca iletilmez.
TYPE, FILE_TYPE, VIEW_TYPE ve STATUS alanlarının geçerli değerleri arka uç (e-Defter REST API) tarafından belirlenir.

Yanıt yapısı (ELEDGER_RESPONSE): Tüm metotlar aynı yapıyı döner; metoda göre yalnızca ilgili alanlar dolu gelir: ELEDGER (liste), ELEDGER_FILE (liste), Content, PAGEABLE, UID, ERROR.

ERROR alanları:

Alan	Açıklama
`CODE`	Hata kodu. `-1` proxy/validasyon kaynaklı hatayı, diğer değerler arka uç hata kodunu ifade eder.
`MESSAGE`	Hata mesajı.
`DETAIL`	Detay bilgisi.
`GROUP`	Hata grubu.
`TYPE` / `TITLE` / `TRACE_ID`	Arka uçtan dönen hata tipi, başlığı ve iz (trace) kimliği.

Sık karşılaşılan proxy hataları (CODE = -1):

Mesaj	Sebep
`SessionId zorunlu alandır, boş olamaz!`	`SESSION_ID` boş gönderildi.
`UUID zorunlu alandır, boş olamaz!`	`UID` boş gönderildi.
`Period zorunlu alandır, boş olamaz!`	`PERIOD` boş gönderildi.
`Dönem YYYYMM formatında olmalıdır! (Örn: 202501)`	`ViewLedgerByPeriod` dönem formatı hatalı.
`Tür zorunlu alandır, boş olamaz!`	`TYPE` boş gönderildi.
`Görüntüleme tipi zorunlu alandır, boş olamaz!`	`VIEW_TYPE` boş gönderildi.
`ENTRY_NUMBER zorunlu alandır, boş olamaz!`	`ENTRY_NUMBER` boş gönderildi.
`Servis boş yanıt döndü.`	Arka uç kayıt döndürmedi (listeleme metotlarında sonuç boş).
`Geçersiz Base64 formatı!`	`USER_FILE` içeriği çözümlenemedi.
`Sistemsel bir hata oluştu`	Beklenmeyen sistem hatası.