getSalesOrderListXML

Genel Bilgi

Özellik	Değer
Endpoint Adı	getSalesOrderListXML
SOAPAction	urn:WebticariService#getSalesOrderListXML
Açıklama	Satış sipariş listesini XML formatında döner. Sayfalama desteği ile büyük veri kümelerinde kullanılabilir.
Kimlik Doğrulama Gerektirir	Evet (token)

---

İstek Parametreleri

Parametre	Tip	Zorunlu	Açıklama
token	xsd:string	Evet	login endpoint'inden alınan oturum token'ı
customerId	xsd:int	Hayır	Belirli bir cariye ait siparişleri filtrele. 0 = tümü
limit	xsd:int	Hayır	Sayfa başına kayıt sayısı
offset	xsd:int	Hayır	Atlanacak kayıt sayısı (sayfalama için)

---

Yanıt Parametreleri

Parametre	Tip	Açıklama
return	xsd:string	Satış siparişlerini içeren XML listesi

---

Yanıt XML Yapısı

<data>
  <pagination>
    <total>150</total>
  </pagination>
  <orders>
    <order>
      <sipsat_id>999</sipsat_id>
      <sipsat_tarih>2024-01-15</sipsat_tarih>
      <sipsat_belgeno>SIP2024001</sipsat_belgeno>
      <cr_kod>MUS001</cr_kod>
      <cr_adi>Örnek Müşteri A.Ş.</cr_adi>
      <!-- ... diğer sipariş başlık alanları ... -->
      <items>
        <item>
          <sipsat_urno>42</sipsat_urno>
          <ur_adi>Örnek Ürün</ur_adi>
          <sipsat_miktar>5.00</sipsat_miktar>
          <sipsat_fiyat>150.00</sipsat_fiyat>
          <!-- ... diğer sipariş satır alanları ... -->
        </item>
      </items>
    </order>
  </orders>
</data>

Alan	Açıklama
total	Toplam kayıt sayısı (sayfalama bağımsız)
orders	Sipariş listesi; her sipariş içinde <items> ile satırlar

---

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:getSalesOrderListXML>
      <token>abc123tokendeğeri</token>
      <customerId>0</customerId>
      <limit>50</limit>
      <offset>0</offset>
    </tns:getSalesOrderListXML>
  </soapenv:Body>
</soapenv:Envelope>

---

Hata Durumları

Durum	Açıklama
Invalid Token	Token geçersiz veya süresi dolmuş (30 dakika)

---

Notlar

• limit maksimum 100 ile sınırlıdır; daha büyük değer gönderilse de 100 olarak uygulanır. Varsayılan: 50.
• offset varsayılanı 0'dır (ilk sayfa).
• customerId = 0 veya boş bırakılırsa tüm carilerin siparişleri döner.
• Yalnızca sipsat_var4 = 'bayi' olan siparişler listelenir (bayi siparislerini filtreler).
• Her sipariş header'a ek olarak <items> içinde satır kalemleri döner.
• Toplam kayıt sayısı <total> alanında döner (SQL_CALC_FOUND_ROWS kullanılır).