setEbookXBRLWithSignatureZip

Genel Bilgi

Özellik	Değer
Endpoint Adı	setEbookXBRLWithSignatureZip
SOAPAction	urn:WebticariService#setEbookXBRLWithSignatureZip
Açıklama	İmzalanmış e-defter XBRL verisini ZIP sıkıştırılmış formatta sisteme gönderir. Büyük defter dosyaları için setEbookXBRLWithSignature uç noktasının ZIP destekli alternatifidir.
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
data	xsd:base64Binary	Evet	ZIP sıkıştırılmış imzalı XBRL verisi (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:setEbookXBRLWithSignatureZip>
      <token>abc123tokendeğeri</token>
      <id>1001</id>
      <data><!-- ZIP sıkıştırılmış imzalı XBRL verisinin Base64 kodlanmış hali --></data>
      <defterTuru>YD</defterTuru>
      <donem>2024-01</donem>
    </tns:setEbookXBRLWithSignatureZip>
  </soapenv:Body>
</soapenv:Envelope>

---

Notlar

• data parametresi ZIP dosyasının binary verisidir; SOAP istemcisi xsd:base64Binary olarak gönderir.
• ZIP içindeki ilk dosya (index 0) XBRL XML olarak işlenir; açılamayan veya okunamayan ZIP'lerde hata yanıtı döner.
• setEbookXBRLWithSignature ile aynı işlemi yapar; tek fark veriyi ZIP formatında alır.
• Hata durumunda rollback otomatik çalıştırılır.
• Yanıt yapısı setEbookXBRLWithSignature ile aynıdır (bkz. o endpoint'in belgeleri).
• Token geçersizse Invalid Token döner.