getServiceByIdOrRegistrationNo

Genel Bilgi

Özellik	Değer
Endpoint Adı	getServiceByIdOrRegistrationNo
SOAPAction	urn:WebticariService#getServiceByIdOrRegistrationNo
Açıklama	Araç servisi kaydını ID numarası veya kayıt (iş emri) numarasına göre getirir. Tek bir servis kaydının tüm detaylarını sorgulamak için 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	Koşullu	Servis kaydının veritabanı ID'si. registrationNo ile birlikte en az biri gönderilmeli
registrationNo	xsd:string	Koşullu	Servis kayıt/iş emri numarası. id ile birlikte en az biri gönderilmeli

---

Yanıt Parametreleri

Parametre	Tip	Açıklama
return	xsd:string	Servis kaydı detaylarını içeren XML string veya hata mesajı

---

Yanıt Örneği

<servis>
  <sv_id>42</sv_id>
  <sv_plaka>34ABC123</sv_plaka>
  <sv_marka>TOYOTA</sv_marka>
  <sv_model>COROLLA</sv_model>
  <sv_musteri_kod>C001</sv_musteri_kod>
  <sv_giris_tarihi>2024-01-15</sv_giris_tarihi>
  <sv_cikis_tarihi>2024-01-16</sv_cikis_tarihi>
  <islemler>
    <islem>
      <is_aciklama>YAĞ DEĞİŞİMİ</is_aciklama>
      <is_tutar>250.00</is_tutar>
    </islem>
    <islem>
      <is_aciklama>FİLTRE DEĞİŞİMİ</is_aciklama>
      <is_tutar>100.00</is_tutar>
    </islem>
  </islemler>
  <sv_toplam>350.00</sv_toplam>
  <sv_durum>1</sv_durum>
</servis>

---

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:getServiceByIdOrRegistrationNo>
      <token>abc123tokendeğeri</token>
      <id>42</id>
      <registrationNo></registrationNo>
    </tns:getServiceByIdOrRegistrationNo>
  </soapenv:Body>
</soapenv:Envelope>

---

Notlar

• Token gereklidir.
• id veya registrationNo (= ser_bno) parametrelerinden yalnızca biri gönderilmesi yeterlidir.
• Her ikisi birden gönderilirse ser_no=$id OR ser_bno='$registrationNo' koşuluyla arama yapılır.
• Başarılıysa exportDataXML iki kez çağrılır: servis başlık bilgisi + servisislem (bakım sözleşmesi dahil) alanları.
• Yanıt: <response><service><table>...</table></service><transactions><table>...</table></transactions></response>