Ana içeriğe geç

setEbookXBRLWithGIBConfirmation

Genel Bilgi

Özellik Değer
Endpoint Adı setEbookXBRLWithGIBConfirmation
SOAPAction urn:WebticariService#setEbookXBRLWithGIBConfirmation
Açıklama GİB tarafından onaylanmış e-defter berat dosyasını sisteme kaydeder. E-Defter sürecinin son adımıdır.
Kimlik Doğrulama Gerektirir Evet (token)

İstek Parametreleri

Parametre Tip Zorunlu Açıklama
token xsd:string Evet login endpoint'inden alınan oturum token'ı
id xsd:string Evet E-Defter kaydının ID'si
filename xsd:string Evet GİB berat dosyasının adı
data xsd:base64Binary Evet GİB onay berat dosyasının binary içeriği (Base64 kodlanmış)
defterTuru xsd:string Evet Defter türü: YD veya DD
donem xsd:string Hayır Dönem bilgisi (örn. 2024-01); boş bırakılırsa aktif dönem kullanılır

Yanıt Parametreleri

Parametre Tip Açıklama
return xsd:string İşlem sonucu

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:setEbookXBRLWithGIBConfirmation>
      <token>abc123tokendeğeri</token>
      <id>1001</id>
      <filename>YD_2024_01_berat.xml</filename>
      <data><!-- Base64 kodlanmış GİB berat dosyası --></data>
      <defterTuru>YD</defterTuru>
      <donem>2024-01</donem>
    </tns:setEbookXBRLWithGIBConfirmation>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • data parametresi GİB'den alınan berat dosyasının ZIP + binary verisidir; SOAP istemcisi xsd:base64Binary olarak gönderir.
  • ZIP içindeki berat XML (filename parametresiyle eşleştirilen) eDefter::eDefterOnayAl() ile işlenir.
  • Berat başarıyla kaydedilirse e-defter süreci tamamlanmış sayılır.
  • Yanıt yapısı setEbookXBRLWithSignature ile aynıdır (bkz. o endpoint'in belgeleri).
  • Token geçersizse Invalid Token döner.