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

Dönem ile Defter Görüntüleme (ViewLedgerByPeriod)

SOAPViewLedgerByPeriod

Defterin HTML görüntüsünü UID yerine dönem bilgisiyle döner.

Kurallar:

  • PERIOD YYYYMM formatında olmalıdır (örn. 202601); ay 01–12 aralığında olmalıdır. Format hatalıysa istek arka uca gitmeden Dönem YYYYMM formatında olmalıdır! (Örn: 202501) hatası döner.
  • BRANCH_CODE boş bırakılırsa 1, PART_NO boş bırakılırsa 0 kullanılır.

Yanıt: HTML içeriği Content alanında döner.

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.

Parametreler

AdTipZorunluAciklama
SESSION_ID text Evet Kimlik doğrulama servisi (AuthenticationWS) Login metodundan alınan oturum bilgisi. Tüm metotlarda zorunludur.
PERIOD text Evet Dönem, YYYYMM formatında (ay 01–12).
TYPE text Evet Defter tipi.
VIEW_TYPE text Evet Görüntüleme tipi.
BRANCH_CODE text Hayir Şube kodu. Boş bırakılırsa 1 kullanılır.
PART_NO text Hayir Parça numarası. Boş bırakılırsa 0 kullanılır.

Ornek Yanit (XML)

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:ViewLedgerByPeriodResponse xmlns:ns2="http://ws.efatura.izibiz.com/">
         <ViewLedgerByPeriod>
            <Content>&lt;html&gt;...&lt;/html&gt;</Content>
         </ViewLedgerByPeriod>
      </ns2:ViewLedgerByPeriodResponse>
   </S:Body>
</S:Envelope>

Hata Yaniti (Fault)

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:ViewLedgerByPeriodResponse xmlns:ns2="http://ws.efatura.izibiz.com/">
         <ViewLedgerByPeriod>
            <ERROR>
               <CODE>-1</CODE>
               <MESSAGE>Dönem YYYYMM formatında olmalıdır! (Örn: 202501)</MESSAGE>
            </ERROR>
         </ViewLedgerByPeriod>
      </ns2:ViewLedgerByPeriodResponse>
   </S:Body>
</S:Envelope>