eBookFileUpload

Genel Bilgi

Özellik	Değer
Endpoint Adı	`eBookFileUpload`
SOAPAction	`urn:WebticariService#eBookFileUpload`
Açıklama	E-Defter sürecinde harici imzalayıcı tarafından üretilen dosyaları (imzalı XBRL, berat vb.) Base64 kodlanmış veri olarak sunucuya yükler.
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	İlgili E-Defter kaydının ID'si
`fileName`	`xsd:string`	Evet	Yüklenecek dosyanın adı (uzantı dahil, örn. `defter_2024_01.xml`)
`file`	`xsd:base64Binary`	Evet	Dosya içeriği Base64 kodlanmış formatta
`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`	Yükleme sonucu (başarı/hata mesajı)

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:eBookFileUpload>
      <token>abc123tokendeğeri</token>
      <id>1001</id>
      <fileName>defter_2024_01.xml</fileName>
      <file>PD94bWwgdmVyc2lvbj0iMS4wIj8+...</file>
      <donem>2024-01</donem>
    </tns:eBookFileUpload>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

Yanıt, yazılan byte sayısını string olarak döner (orn. "4096"); hata oluşursa PHP false'u "" olarak seri hale getirir.
id parametresi defterin veritabanı ID'sini belirtir; dosya eDefter::arsivYol($id) klasörüne kaydettirilir.
fileName dosya adı; açık yol geçiren karakterler (orn. ../) güvenlik riski taşır; sunucu tarafında dogrulama yapilmaz.
Bu endpoint E-Defter arşiv dosyalarına özeldir; genel dosya yükleme için fileUpload endpoint'ini kullanın.
Token geçersizse Invalid Token döner.