Ana içeriğe geç

exportServiceXML

Genel Bilgi

Özellik Değer
Endpoint Adı exportServiceXML
SOAPAction urn:WebticariService#exportServiceXML
Açıklama Sistemdeki araç servisi kayıtlarını XML formatında dışa aktarır. Servis iş emirleri ve bakım geçmişi bu endpoint ile sorgulanabilir.
Kimlik Doğrulama Gerektirir Evet (token)

İstek Parametreleri

Parametre Tip Zorunlu Açıklama
token xsd:string Evet login endpoint'inden alınan oturum token'ı
crno xsd:integer Evet Servis kayıtları sorgulanacak carinin numarası (cr_no)
filter xsd:array Hayır Ek filtre parametrelerini içeren dizi

filter Dizisi Alanları

Alan Açıklama
order Sıralama alanı (varsayılan: ser_kayittarih DESC)
sube Dolu gönderilirse aktif şube (ser_carisube) ile filtreler
olcut Belge numarası veya form numarası ile tam eşleşme filtresi

Yanıt XML Yapısı

<table>
  <rows>
    <row>
      <ser_no>101</ser_no>
      <ser_crno>501</ser_crno>
      <ser_bno>B2024001</ser_bno>
      <ser_formno>F2024001</ser_formno>
      <ser_durum>1</ser_durum>
      <ser_urno>42</ser_urno>
      <ur_adi>Örnek Cihaz</ur_adi>
      <teslimtarih>15.01.2024 09:30</teslimtarih>
      <formtarih>14.01.2024 14:00</formtarih>
      <kayittarih>14.01.2024 13:45</kayittarih>
      <!-- ... diğer servis alanları ... -->
    </row>
  </rows>
</table>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:exportServiceXML>
      <token>abc123tokendeğeri</token>
      <crno>501</crno>
    </tns:exportServiceXML>
  </soapenv:Body>
</soapenv:Envelope>

Hata Durumları

Durum Açıklama
Invalid Token Token geçersiz veya süresi dolmuş (30 dakika)
Boş yanıt Belirtilen cariye ait servis kaydı yoksa <rows> boş gelir

Notlar

  • servis{donem} tablosunu sorgulayıp tburun, servisislemyeri, tbcarisube tablolarını JOIN'ler.
  • Tarih alanları (teslimtarih, formtarih, kayittarih) dd.mm.yyyy HH:ii formatında döner.
  • Varsayılan sıralama ser_kayittarih DESC (en son kayıtlar önce); filter['order'] ile değiştirilebilir.
  • filter parametresi gönderilmezse tüm servis kayıtları döner.