importStockCountingXML

Genel Bilgi

Özellik	Değer
Endpoint Adı	importStockCountingXML
SOAPAction	urn:WebticariService#importStockCountingXML
Açıklama	Stok sayım fişlerini XML formatında sisteme içe aktarır. Fiziksel sayım sonuçlarını Webticari'ye aktarmak 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'ı
sayim	xsd:string	Evet	Stok sayım verilerini içeren XML — bkz. Parametre Yapıları

---

Yanıt Parametreleri

Parametre	Tip	Açıklama
return	xsd:string	İşlem sonucu

---

Yanıt Yapısı

Standart import yanıt formatı:

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

Önemli: Bu endpoint mükerrer kontrolü yapmaz. Aynı veri tekrar gönderilirse yeni bir sayım fişi oluşturulur. <duplicates> bölümü her zaman boş döner.

---

Parametre Yapıları

sayim — Stok Sayımı

Alan	Tip	Zorunlu	Açıklama
stsy_no	integer	Hayır	Mevcut sayım ID (0 veya boş = yeni sayım, >0 = güncelleme)
stsy_tarih	date	Hayır	Sayım tarihi (varsayılan: şu an)
stsy_depo	integer	Hayır	Depo numarası
stsy_personel	integer	Hayır	Personel numarası (varsayılan: oturum personeli)
stsy_raf	string	Hayır	Raf bilgisi
stsy_aciklama	string	Hayır	Açıklama
stsy_envantersifirla	string	Hayır	E=Sayımda olmayan stokları sıfırla, H=Sıfırlama — yalnızca güncelleme modunda (stsy_no > 0) etkilidir; yeni sayımda daima H kullanılır
stsy_stoktipi	string	Hayır	Stok tipi filtresi
stsy_sube	integer	Hayır	Şube numarası
sepet	liste	Evet	Sayım kalemleri → bkz. sepet > kalem

sepet > kalem — Sayım Kalemi (tekrarlı liste)

Alan	Tip	Zorunlu	Açıklama
sysp_urno	integer	Evet	Ürün numarası
sysp_saymiktar	decimal	Evet	Sayım miktarı
sysp_birim	string	Hayır	Birim
sysp_urfiyat	decimal	Hayır	Ürün fiyatı (varsayılan: stoktan çekilir)
sysp_no	integer	Hayır	Mevcut sayım sepet ID — >0 ise o kalem güncellenir

Kontrol Alanları

Alan Adı	Tip	Açıklama
stsy_no	integer	>0 ise mevcut sayım güncellenir; 0/boş ise yeni sayım oluşturulur
sysp_no	integer	>0 ise mevcut sepet kalemi güncellenir

---

XML Yapısı (sayim parametresi)

<sayimlar>
  <sayim>
    <stsy_tarih>2024-06-01</stsy_tarih>    <!-- Sayım tarihi -->
    <stsy_depo>1</stsy_depo>               <!-- Depo no -->
    <stsy_personel>5</stsy_personel>       <!-- Personel no -->
    <stsy_aciklama>Haziran Sayımı</stsy_aciklama>
    <stsy_envantersifirla>H</stsy_envantersifirla>  <!-- E=Envanter sıfırla, H=Sıfırlama -->
    <sepet>
      <kalem>
        <sysp_urno>123</sysp_urno>                 <!-- Ürün no -->
        <sysp_saymiktar>50</sysp_saymiktar>        <!-- Sayılan miktar -->
        <sysp_birim>ADET</sysp_birim>
      </kalem>
    </sepet>
  </sayim>
</sayimlar>

---

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importStockCountingXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <sayim><![CDATA[
        <sayimlar>
          <sayim>
            <stsy_tarih>2024-06-01</stsy_tarih>
            <stsy_depo>1</stsy_depo>
            <stsy_personel>5</stsy_personel>
            <stsy_aciklama>Haziran Sayımı</stsy_aciklama>
            <sepet>
              <kalem>
                <sysp_urno>123</sysp_urno>
                <sysp_saymiktar>50</sysp_saymiktar>
                <sysp_birim>ADET</sysp_birim>
              </kalem>
            </sepet>
          </sayim>
        </sayimlar>
      ]]></sayim>
    </tns:importStockCountingXML>
  </soapenv:Body>
</soapenv:Envelope>

---

Notlar

• Bu endpoint mükerrer kontrolü yapmaz; her gönderim yeni bir sayım fişi oluşturur.
• Sayım aktarmtıkında stok envanter hareketleri otomatik olarak güncellenir.
• stsy_envantersifirla=E gönderildiğinde sayımda bulunmayan ürünlerin stok miktarı sıfırlanır.
• Token geçersizse yanıt Invalid Token string'i döner.