Ana içeriğe geç

Webticari SOAP Docs

importServiceXML

importServiceXML

Genel Bilgi

Özellik	Değer
Endpoint Adı	`importServiceXML`
SOAPAction	`urn:WebticariService#importServiceXML`
Açıklama	Araç servisi kayıtlarını XML formatında sisteme aktarır. Servis iş emirleri, bakım kayıtları ve arıza bilgilerini günceller veya ekler.
Kimlik Doğrulama Gerektirir	Evet (token)

`servis` XML Alanları (Servis Kaydı)

Alan	Tip	Zorunlu	Açıklama
`ser_formno`	`string`	Evet	Servis form numarası
`ser_crno`	`integer`	Hayır	Cari hesap numarası (cr_kod yerine kullanılabilir)
`cr_kod`	`string`	Hayır	Cari hesap kodu (ser_crno yerine kullanılabilir)
`cs_kod`	`string`	Hayır	Cari şube kodu
`ser_adres`	`string`	Hayır	Servis adresi
`ser_urno`	`integer`	Hayır	Ürün numarası (ur_kod yerine kullanılabilir)
`ur_kod`	`string`	Hayır	Ürün kodu (ser_urno yerine kullanılabilir)
`ser_tur`	`string`	Hayır	Servis türü (varsayılan: `Garantili Ürün`)
`ser_sube`	`integer`	Hayır	Şube numarası
`ser_formtarih`	`date`	Hayır	Form tarihi
`ser_teslimtarih`	`date`	Hayır	Teslim tarihi
`ser_oncelik`	`string`	Hayır	Öncelik (varsayılan: `NORMAL`)
`ser_kayittarih`	`date`	Hayır	Kayıt tarihi
`ser_issaat`	`date`	Hayır	İş başlangıç saati
`ser_bno`	`string`	Hayır	Belge numarası
`ser_yetkili`	`integer`	Hayır	Yetkili personel numarası
`ser_teknisyen`	`integer`	Hayır	Teknisyen personel numarası
`ser_firmayetkili`	`integer`	Hayır	Firma yetkili personel numarası
`ser_durum`	`integer`	Hayır	Durum kodu (varsayılan: 1)
`ser_serino`	`string`	Hayır	Seri numarası
`ser_aciklama`	`string`	Hayır	Servis açıklaması / arıza tanımı
`makinaPark`	`string`	Hayır	Makina park bilgisi
---

İstek Parametreleri

Parametre	Tip	Zorunlu	Açıklama
`token`	`xsd:string`	Evet	`login` endpoint'inden alınan oturum token'ı
`xml`	`xsd:string`	Evet	İçe aktarılacak servis kaydı, XML formatında

Yanıt Parametreleri

Parametre	Tip	Açıklama
`return`	`xsd:string`	İşlem sonucu (başarı/hata mesajı)

Yanıt Yapısı

Standart import yanıt formatı (mükerrer <duplicates> bölümü döndürülmez):

<transactions>
  <transferreds>
    <transaction>
      <server_id>SUNUCU_SERVIS_ID</server_id>
    </transaction>
  </transferreds>
  <transposeds>
    <transaction>
      <errorno>-1</errorno>
      <errormessage>Hata açıklaması</errormessage>
    </transaction>
  </transposeds>
</transactions>

XML Yapısı

<servisler>
  <servis>
    <ser_crno>42</ser_crno>           <!-- Müşteri ID -->
    <ser_urno>10</ser_urno>           <!-- Cihaz/Ürün ID -->
    <ser_serino>SRV-2024-001</ser_serino>     <!-- Servis kayıt no -->
    <ser_formtarih>2024-06-01</ser_formtarih>
    <ser_aciklama>Arıza tanımı</ser_aciklama>
    <ser_yetkili>5</ser_yetkili>      <!-- Yetkili personel ID -->
    <makinaPark>0</makinaPark>        <!-- 1=Makina park kaydı, 0=Normal servis -->
    <!-- Diğer ser_* alanları -->
  </servis>
</servisler>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importServiceXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <xml><![CDATA[
        <servisler>
          <servis>
            <ser_crno>42</ser_crno>
            <ser_urno>10</ser_urno>
            <ser_formtarih>2024-06-01</ser_formtarih>
            <ser_aciklama>Ekran kırık</ser_aciklama>
            <ser_yetkili>5</ser_yetkili>
            <makinaPark>0</makinaPark>
          </servis>
        </servisler>
      ]]></xml>
    </tns:importServiceXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

Servis kaydı istakibi::servisKaydet() fonksiyonu aracılığıyla oluşturulur.
makinaPark=1 olduğunda kayıt makina park modülüne işlenir.
ser_serino boş gönderilirse null olarak kaydedilir.
Bu endpoint mükerrer kontrol yapmaz.
Kaydedilen servis getServiceByIdOrRegistrationNo veya exportServiceXML ile sorgulanabilir.
Token geçersizse yanıt Invalid Token string'i döner.