createEBookPatent
Genel Bilgi
| Özellik |
Değer |
| Endpoint Adı |
createEBookPatent |
| SOAPAction |
urn:WebticariService#createEBookPatent |
| Açıklama |
E-Defter için berat (patent) dosyası oluşturur. GİB'e gönderilmeden önce berat oluşturma adımında kullanılı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 |
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 |
Oluşturulan berat dosyasına ait bilgiler veya hata mesajı |
Örnek SOAP İstek
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tns="urn:WebticariService">
<soapenv:Header/>
<soapenv:Body>
<tns:createEBookPatent>
<token>abc123tokendeğeri</token>
<id>1001</id>
<defterTuru>YD</defterTuru>
<donem>2024-01</donem>
</tns:createEBookPatent>
</soapenv:Body>
</soapenv:Envelope>
E-Defter Akışı
1. getEBookXBRL → XBRL verisini al
2. [İmzalama] → Harici imzalama işlemi
3. setEbookXBRLWith... → İmzalı veriyi gönder
4. createEBookPatent → Berat oluştur
5. [GİB'e gönderim] → Berat GİB'e gönderilir
6. setEbookXBRLWith → GİB onay beratını kaydet
GIBConfirmation
Notlar
eDefter::eDefterBeratOlustur($id, $defterTuru) fonksiyonunu çağırır.
- Berat oluşturma işlemi defter imzalandıktan (
setEbookXBRLWithSignature) sonra yapılı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.