Ana içeriğe geç

exportCustomerXML

Genel Bilgi

Özellik Değer
Endpoint Adı exportCustomerXML
SOAPAction urn:WebticariService#exportCustomerXML
Açıklama Cari kartlarını filtre ve limit parametrelerine göre XML formatında dışa aktarı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'ı
field xsd:string Hayır Filtrelemek istenen alan adı
condition xsd:string Hayır Filtreleme koşulu / değeri
limit xsd:string Hayır Döndürülecek kayıt sayısı limiti

Yanıt Parametreleri

Parametre Tip Açıklama
return xsd:string Cari kart bilgilerini içeren XML verisi

Yanıt XML Yapısı

Yanıt exportDataXML ile aynı biçimde döner:

<table>
  <rows>
    <row>
      <cr_no>101</cr_no>
      <cr_kod>MUS001</cr_kod>
      <cr_adi>Örnek Müşteri A.Ş.</cr_adi>
      <cr_vkntc>1234567890</cr_vkntc>
      <cr_adres>İstanbul</cr_adres>
      <!-- ... diğer cari alanları ... -->
      <cb_borc>1500.00</cb_borc>
      <cb_alacak>500.00</cb_alacak>
    </row>
  </rows>
</table>

Hata durumunda: 

<table><error><sql>...</sql><mysqlerror>...</mysqlerror><mysqlerrno>N</mysqlerrno></error></table>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:exportCustomerXML>
      <token>abc123tokendeğeri</token>
      <field>*</field>
      <condition>cr_vkntc='1234567890'</condition>
      <limit>10</limit>
    </tns:exportCustomerXML>
  </soapenv:Body>
</soapenv:Envelope>

Hata Durumları

Durum Açıklama
Invalid Token Token geçersiz veya süresi dolmuş (30 dakika)
SQL hatası <table><error> bloğu içinde hata detayı döner

Notlar

  • field parametresi SELECT sütun listesi, condition ise WHERE koşuludur; * ve 1 varsayılandır.
  • condition boş gönderilirse 1 (tüm kayıtlar) kullanılır.
  • limit boş bırakılırsa tüm aktif (cr_durum='A') cariler döner; büyük veri setlerinde limit kullanılması önerilir.
  • Bakiye alanları (cb_borc, cb_alacak): birden fazla şube varsa ve kullanıcının izni yoksa şube bakiyesi (cb_yer='SUBE') döner; tek şubede veya şube bazlı bakiye izninde genel bakiye (cb_yer='GENEL') döner.
  • Yalnızca cr_durum='A' (aktif) cariler döner.
  • Kullanıcının şube yetkisi otomatik olarak filtreye eklenir (izin 510).
  • Bu endpoint exportDataXML üzerine inşa edilmiştir; SQL sorgusunu doğrudan göndermek için exportDataXML kullanılabilir.