Ana içeriğe geç

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.