SOAP WS · Bulut e-Defter WS (ELedgerService)

e-Defter Oluşturma (CreateLedger)

SOAPCreateLedger

Yeni bulut e-Defter oluşturma talebi başlatır. Yevmiye verisi dosya olarak (örn. CSV) Base64 kodlanıp USER_FILE alanında gönderilir. Başarılı olursa oluşturulan sürecin UID değeri döner; bu değer diğer metotlarda (GetLedgerXml, ViewLedger, SendToGibLedger, CancelLedger) defter kimliği olarak kullanılır.

Kurallar:

SESSION_ID, USER_FILE, FILE_NAME, PERIOD, START_DATE, END_DATE, FILE_TYPE ve IS_AUTOMATED_PROCESS alanları zorunludur.
PERIOD YYYYMM formatındadır (örn. 202601).
START_DATE / END_DATE defterin dönem aralığıdır ve yyyy-MM-dd formatında gönderilir (örn. 2026-01-01). Saat bilgisi dikkate alınmaz.
FILE_TYPE yüklenen dosyanın tipidir (örn. csv); FILE_NAME uzantısıyla uyumlu olmalıdır (örn. 202601.csv).
USER_FILE geçerli Base64 olmalıdır; aksi halde Geçersiz Base64 formatı! hatası döner.

CSV dosya kolonları (; ile ayrılmış): detailref;entryref;linenumber;linenumbercounter;accmainid;accmainiddesc;accsubid;accsubdesc;amount;debitcreditcode;postingdate;documenttype;doctypedesc;documentnumber;documentreference;entrynumbercounter;documentdate;paymentmethod;detailcomment;erpno;divisionno;enteredby;entereddate;entrynumber;entrycomment

Yanıt alanları:

Alan	Açıklama
`Content`	İşlem sonucu mesajı (`e-Defter Oluşturma Başarılı`).
`UID`	Oluşturulan sürecin/defterin kimliği.

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

Ad	Tip	Zorunlu	Aciklama
`SESSION_ID`	`text`	Evet	Kimlik doğrulama servisi (AuthenticationWS) Login metodundan alınan oturum bilgisi. Tüm metotlarda zorunludur.
`USER_FILE`	`base64`	Evet	Yüklenecek defter dosyası (örn. CSV), Base64 kodlanmış içerik.
`FILE_NAME`	`text`	Evet	Yüklenen dosyanın adı (uzantısı ile). Örn: 202601.csv
`PERIOD`	`text`	Evet	Defter dönemi, YYYYMM formatında. Örn: 202601
`START_DATE`	`date`	Evet	Defter başlangıç tarihi (yyyy-MM-dd).
`END_DATE`	`date`	Evet	Defter bitiş tarihi (yyyy-MM-dd).
`FILE_TYPE`	`text`	Evet	Yüklenen dosyanın tipi. Örn: csv
`IS_AUTOMATED_PROCESS`	`boolean`	Evet	Otomatik süreç mi? true / false.
`BRANCH_CODE`	`text`	Hayir	Şube kodu. (Opsiyonel)
`DATE_CHECKPOINTS`	`text`	Hayir	Tarih kontrol noktaları. (Opsiyonel)

Ornek Yanit (XML)

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:CreateLedgerResponse xmlns:ns2="http://ws.efatura.izibiz.com/">
         <CreateLedger>
            <Content>e-Defter Oluşturma Başarılı</Content>
            <UID>9f0c2a51-7d3e-4a10-9c11-2b7e5d8f4a63</UID>
         </CreateLedger>
      </ns2:CreateLedgerResponse>
   </S:Body>
</S:Envelope>

Hata Yaniti (Fault)

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:CreateLedgerResponse xmlns:ns2="http://ws.efatura.izibiz.com/">
         <CreateLedger>
            <ERROR>
               <CODE>-1</CODE>
               <MESSAGE>Geçersiz Base64 formatı!</MESSAGE>
            </ERROR>
         </CreateLedger>
      </ns2:CreateLedgerResponse>
   </S:Body>
</S:Envelope>