querySerialNumberXML

Genel Bilgi

Özellik	Değer
Endpoint Adı	querySerialNumberXML
SOAPAction	urn:WebticariService#querySerialNumberXML
Açıklama	Seri numarası sorgulama işlemi yapar. Bir ürünün seri/lot numarasının sistemde kayıtlı olup olmadığını ve nerede bulunduğunu sorgular.
Kimlik Doğrulama Gerektirir	Evet (token)

---

İstek Parametreleri

Parametre	Tip	Zorunlu	Açıklama
token	xsd:string	Evet	login endpoint'inden alınan oturum token'ı
serino	xsd:string	Evet	Sorgulanacak seri numarası

---

Yanıt Parametreleri

Parametre	Tip	Açıklama
return	xsd:string	Seri numarasına ait bilgileri içeren XML yanıtı

---

Yanıt Yapısı

<hareketler>
  <hareket>
    <tarih>01.06.2024 14:32:10</tarih>
    <durum>SATIŞ</durum>
    <belgeNo>SF000123</belgeNo>          <!-- Yalnızca tbserino kaynaklı hareketlerde -->
    <garantiSuresi>18</garantiSuresi>    <!-- Yalnızca durum="SATIŞ" olan kayıtta -->
  </hareket>
</hareketler>

Yanıt Alanları

Alan	Koşul	Açıklama
<tarih>	Her zaman	Hareket tarihi (dd.mm.yyyy HH:MM:SS formatında)
<durum>	Her zaman	Hareket türü — bkz. aşağıdaki tablo
<belgeNo>	Yalnızca tbserino kaynaklı hareketlerde	Belge seri+belge no birleşimi (ALIŞ / SATIŞ / …)
<garantiSuresi>	Yalnızca durum="SATIŞ"	Kalan garanti süresi (gün olarak): ur_garantisure − geçen_gün

Olası <durum> Değerleri

Değer	Kaynak Tablo
SAYAÇ GİRİŞ	serviskonturhareket{donem}
SERVİS FORMU	servis{donem}
İŞLEM:{islem_yeri_adı}	servisislem{donem} JOIN servisislemyeri
ALIŞ	tbserino + tbserinohareket (alış faturası)
SATIŞ	tbserino + tbserinohareket (satış faturası)
ALIŞ İRSALİYE	tbserino + tbserinohareket (alış irsaliyesi)
SATIŞ İRSALİYE	tbserino + tbserinohareket (satış irsaliyesi)

---

Örnek SOAP İstek

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

---

Notlar

• Token gereklidir.
• Sorgu, UNION ile 4 farklı tablodan serino geçmişini birleştirir; kaynak tablo bilgisi <durum> alanına yansıtılır.
• <belgeNo>, tbserino kaynağı olan hareketler için ilgili fatura/irsaliye tablosundan ayrıca sorgulanarak döndürülür.
• <garantiSuresi> yalnızca SATIŞ statüsündeki hareket için eklenir; değer ur_garantisure (ay) eksi işlem üzerinden geçen gün sayısı olarak hesaplanır.
• Seri/lot numarası takibi aktif olan stok kartları için kullanılabilir.