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.