İzibiz Developer Portal
SOAP WS · Bulut e-Defter WS (ELedgerService)

Defter Listeleme (GetLedgers)

SOAPGetLedgers

Defterleri filtreleyerek sayfalı biçimde listeler. Tüm filtreler opsiyoneldir.

Yanıtta ELEDGER listesi ve PAGEABLE bloğu döner. Kayıt bulunamazsa ERROR bloğu CODE = -1, MESSAGE = Servis boş yanıt döndü. ile döner.

ELEDGER alanları:

Alan Açıklama
PROCESS_ID Süreç/defter kimliği. Diğer metotlarda UID olarak kullanılır.
BRANCH_CODE Şube kodu.
PERIOD Dönem.
START_DATE / END_DATE Defter dönem aralığı.
STATUS / STATUS_DESCRIPTION Durum kodu ve açıklaması.
CANCEL_REASON İptal gerekçesi (iptal edilmişse).
LINE_NUMBER_COUNTER_START / LINE_NUMBER_COUNTER_END Yevmiye madde numarası aralığı.
CREATED_AT Oluşturulma zamanı.
FILE Deftere bağlı dosyalar (FILE_ID, TYPE, TYPE_DESCRIPTION, BOOK_NUMBER, FILE_NAME, PART_NO).

PAGEABLE alanları: PAGE (geçerli sayfa), SIZE (sayfa boyutu), TOTAL_ELEMENTS (toplam kayıt).

Hata yönetimi: 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.

Parameters

NameTypeRequiredDescription
SESSION_ID text Yes Kimlik doğrulama servisi (AuthenticationWS) Login metodundan alınan oturum bilgisi. Tüm metotlarda zorunludur.
PERIOD text No Dönem, YYYYMM.
BRANCH_CODE text No Şube kodu.
PART_NO text No Parça numarası.
START_DATE date No Başlangıç tarihi filtresi.
END_DATE date No Bitiş tarihi filtresi.
TYPE text No Defter tipi.
PAGE text No Sayfa numarası.
PAGE_SIZE text No Sayfa başına kayıt sayısı.

Sample Response (XML)

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:GetLedgersResponse xmlns:ns2="http://ws.efatura.izibiz.com/">
         <GetLedgers>
            <ELEDGER>
               <PROCESS_ID>9f0c2a51-7d3e-4a10-9c11-2b7e5d8f4a63</PROCESS_ID>
               <BRANCH_CODE>1</BRANCH_CODE>
               <PERIOD>202601</PERIOD>
               <START_DATE>2026-01-01T00:00:00+03:00</START_DATE>
               <END_DATE>2026-01-31T00:00:00+03:00</END_DATE>
               <STATUS>...</STATUS>
               <STATUS_DESCRIPTION>...</STATUS_DESCRIPTION>
               <LINE_NUMBER_COUNTER_START>1</LINE_NUMBER_COUNTER_START>
               <LINE_NUMBER_COUNTER_END>250</LINE_NUMBER_COUNTER_END>
               <CREATED_AT>2026-02-05T10:12:00+03:00</CREATED_AT>
               <FILE>
                  <FILE_ID>...</FILE_ID>
                  <TYPE>...</TYPE>
                  <TYPE_DESCRIPTION>...</TYPE_DESCRIPTION>
                  <BOOK_NUMBER>...</BOOK_NUMBER>
                  <FILE_NAME>...</FILE_NAME>
                  <PART_NO>0</PART_NO>
               </FILE>
            </ELEDGER>
            <PAGEABLE>
               <PAGE>0</PAGE>
               <SIZE>20</SIZE>
               <TOTAL_ELEMENTS>1</TOTAL_ELEMENTS>
            </PAGEABLE>
         </GetLedgers>
      </ns2:GetLedgersResponse>
   </S:Body>
</S:Envelope>

Fault Response

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:GetLedgersResponse xmlns:ns2="http://ws.efatura.izibiz.com/">
         <GetLedgers>
            <ERROR>
               <CODE>-1</CODE>
               <MESSAGE>Servis boş yanıt döndü.</MESSAGE>
            </ERROR>
         </GetLedgers>
      </ns2:GetLedgersResponse>
   </S:Body>
</S:Envelope>