Ana içeriğe geç

importStockXML

Genel Bilgi

Özellik Değer
Endpoint Adı importStockXML
SOAPAction urn:WebticariService#importStockXML
Açıklama Stok kartlarını XML formatında sisteme içe aktarmak için kullanılır. Yeni stok kartı oluşturma ve mevcut stok kartı güncelleme işlemlerini kapsar.
Kimlik Doğrulama Gerektirir Evet (token)

stok XML Alanları (Stok/Ürün)

Alan Tip Zorunlu Açıklama
ur_kod string Evet Ürün kodu
ur_adi string Evet Ürün adı
ur_tipi string Hayır Ürün tipi: TM, SN, MU, SK, GS, GD, HZ, MH, HA, YM, MA, LP, TK, SD, VR, VRD
bi_birim string Hayır Birincil birim (tbbirimtur.br_adi)
ur_kdv decimal Hayır Alış KDV oranı (tbkdv.kd_oran)
ur_satiskdv decimal Hayır Satış KDV oranı
bi_alisfiyat decimal Hayır Alış fiyatı
bi_maaliyet decimal Hayır Maliyet fiyatı
bi_satisfiyat1 decimal Hayır Satış fiyatı 1
bi_satisfiyat2 decimal Hayır Satış fiyatı 2
bi_satisfiyat3 decimal Hayır Satış fiyatı 3
bi_satisfiyat4 decimal Hayır Satış fiyatı 4
bi_satisfiyat5 decimal Hayır Satış fiyatı 5
bi_satisfiyat6 decimal Hayır Satış fiyatı 6
bi_satisfiyat7 decimal Hayır Satış fiyatı 7
bi_satisfiyat8 decimal Hayır Satış fiyatı 8
bi_satisfiyat9 decimal Hayır Satış fiyatı 9
bi_satisfiyat10 decimal Hayır Satış fiyatı 10
bi_satisfiyat1doviz string Hayır Satış fiyatı 1 döviz kodu
bi_satisfiyat2doviz string Hayır Satış fiyatı 2 döviz kodu
bi_satisfiyat3doviz string Hayır Satış fiyatı 3 döviz kodu
bi_satisfiyat4doviz string Hayır Satış fiyatı 4 döviz kodu
bi_satisfiyat5doviz string Hayır Satış fiyatı 5 döviz kodu
bi_satisfiyat6doviz string Hayır Satış fiyatı 6 döviz kodu
bi_satisfiyat7doviz string Hayır Satış fiyatı 7 döviz kodu
bi_satisfiyat8doviz string Hayır Satış fiyatı 8 döviz kodu
bi_satisfiyat9doviz string Hayır Satış fiyatı 9 döviz kodu
bi_satisfiyat10doviz string Hayır Satış fiyatı 10 döviz kodu
bi_kullfiyat string Hayır Kullanılacak fiyat tipi (varsayılan: FİYAT1)
bi_barkod string Hayır Barkod
bi_barkodtur string Hayır Barkod türü
bi_en decimal Hayır En ölçüsü
bi_boy decimal Hayır Boy ölçüsü
bi_yukseklik decimal Hayır Yükseklik ölçüsü
bi_hacim decimal Hayır Hacim
bi_agirlik decimal Hayır Ağırlık
bi_raf1 string Hayır Raf 1
bi_raf2 string Hayır Raf 2
bi_raf3 string Hayır Raf 3
bi_stokminimum decimal Hayır Minimum stok miktarı
bi_stokoptimum decimal Hayır Optimum stok miktarı
bi_stokmaksimum decimal Hayır Maksimum stok miktarı
ur_aciklama string Hayır Açıklama
ur_grup string\|integer Hayır Ürün grubu adı veya ID (tbgrup)
ur_marka string Hayır Marka
ur_model string Hayır Model
ur_doviz string Hayır Para birimi (varsayılan: sistem para birimi)
ur_var1 string Hayır Serbest alan 1 (mükerrer kontrolü için kullanılabilir)
ur_var2 string Hayır Serbest alan 2
ur_var3 string Hayır Serbest alan 3
ur_mense string\|integer Hayır Menşe ülke adı veya ID
ur_sube integer Hayır Şube numarası
update string Hayır TRUE gönderilirse mevcut stok güncellenir
ur_no integer Hayır Güncellenecek stok ID (update=TRUE ile birlikte)
ur_muadilkod string Hayır Muadil ürün kodu
ur_adi2 string Hayır 2. ürün adı
ur_altgrup string Hayır Alt grup
ur_firma string Hayır Firma
ur_otv decimal Hayır ÖTV oranı
ur_oiv decimal Hayır OİV oranı
ur_serinokaydet boolean Hayır Seri no kaydet (E/H)
ur_resim string Hayır Resim 1
ur_resim2 string Hayır Resim 2
ur_resim3 string Hayır Resim 3
ur_resim4 string Hayır Resim 4
ur_depo integer Hayır Varsayılan depo
ur_ozellik string Hayır Özellik
ur_garantisure integer Hayır Garanti süresi (ay)
ur_minsatiskari decimal Hayır Minimum satış kârı (%)
ur_prim decimal Hayır Prim oranı
ur_opsiyon date Hayır Opsiyon tarihi
ur_sipsaat_baslama string Hayır Sipariş başlama saati
ur_sipsaat_bitis string Hayır Sipariş bitiş saati
ur_ozelkod string Hayır Özel kod 1
ur_ozelkod2 string Hayır Özel kod 2
ur_ozelkod3 string Hayır Özel kod 3
ur_ozelkod4 string Hayır Özel kod 4
ur_ozelkod5 string Hayır Özel kod 5
ur_ozelkod6 string Hayır Özel kod 6

digerbirim Alt Elemanı (digerbirimler içinde)

Alan Tip Zorunlu Açıklama
bi_birim string Evet Birim adı (tbbirimtur.br_adi)
bi_carpan decimal Evet Çarpan katsayısı
bi_alisfiyat decimal Hayır Bu birim için alış fiyatı
bi_satisfiyat1 decimal Hayır Bu birim için satış fiyatı
bi_satisfiyat2 decimal Hayır Satış fiyatı 2
bi_satisfiyat3 decimal Hayır Satış fiyatı 3
bi_satisfiyat4 decimal Hayır Satış fiyatı 4
bi_satisfiyat5 decimal Hayır Satış fiyatı 5
bi_satisfiyat6 decimal Hayır Satış fiyatı 6
bi_satisfiyat7 decimal Hayır Satış fiyatı 7
bi_satisfiyat8 decimal Hayır Satış fiyatı 8
bi_satisfiyat9 decimal Hayır Satış fiyatı 9
bi_satisfiyat10 decimal Hayır Satış fiyatı 10
bi_satisfiyat1doviz string Hayır Satış fiyatı 1 döviz kodu
bi_satisfiyat2doviz string Hayır Satış fiyatı 2 döviz kodu
bi_satisfiyat3doviz string Hayır Satış fiyatı 3 döviz kodu
bi_satisfiyat4doviz string Hayır Satış fiyatı 4 döviz kodu
bi_satisfiyat5doviz string Hayır Satış fiyatı 5 döviz kodu
bi_satisfiyat6doviz string Hayır Satış fiyatı 6 döviz kodu
bi_satisfiyat7doviz string Hayır Satış fiyatı 7 döviz kodu
bi_satisfiyat8doviz string Hayır Satış fiyatı 8 döviz kodu
bi_satisfiyat9doviz string Hayır Satış fiyatı 9 döviz kodu
bi_satisfiyat10doviz string Hayır Satış fiyatı 10 döviz kodu
bi_maaliyet decimal Hayır Maliyet fiyatı
bi_kullfiyat string Hayır Kullanılacak fiyat tipi (varsayılan: FİYAT1)
bi_barkodtur string Hayır Barkod türü
bi_en decimal Hayır En (ölçü)
bi_boy decimal Hayır Boy (ölçü)
bi_yukseklik decimal Hayır Yükseklik (ölçü)
bi_hacim decimal Hayır Hacim
bi_agirlik decimal Hayır Ağırlık
bi_raf1 string Hayır Raf 1
bi_raf2 string Hayır Raf 2
bi_raf3 string Hayır Raf 3
bi_stokminimum decimal Hayır Minimum stok miktarı
bi_stokoptimum decimal Hayır Optimum stok miktarı
bi_stokmaksimum decimal Hayır Maksimum stok miktarı
---

İstek Parametreleri

Parametre Tip Zorunlu Açıklama
token xsd:string Evet login endpoint'inden alınan oturum token'ı
stocks xsd:string Evet Aktarılacak stok kartlarını içeren XML verisi

Yanıt Parametreleri

Parametre Tip Açıklama
return xsd:string İşlem sonucu. Başarı/hata detaylarını XML veya düz metin olarak içerir.

Yanıt Yapısı

Bu endpoint standart import yanıt formatını döner:

<transactions>
  <transferreds>
    <transaction>
      <server_id>Sunucuda oluşturulan stok ID</server_id>
    </transaction>
  </transferreds>
  <transposeds>
    <transaction>
      <errorno>-1</errorno>
      <errormessage>Hata açıklaması</errormessage>
    </transaction>
  </transposeds>
  <duplicates>
    <transaction>
    </transaction>
  </duplicates>
</transactions>
Bölüm Açıklama
transferreds Başarıyla oluşturulan/güncellenen kayıtlar ve sunucu ID'leri
transposeds Başarısız kayıtlar — errorno ve errormessage içerir
duplicates Sistemde zaten mevcut olan (mükerrer) kayıtlar — tekrar eklenmez

Mükerrer Kayıt Tespiti

Sistem, her stok kaydını işlemeden önce var1, var2, var3, var4 alanlarına göre mükerrer kontrolü yapar. Eşleşme bulunması durumunda kayıt <duplicates> bölümünde döner.

XML Yapısı (stocks parametresi)

Her stok kartı için gönderilmesi gereken temel alanlar:

<stoklar>
  <stok>
    <ur_kod>STOK001</ur_kod>
    <ur_adi>Ürün Adı</ur_adi>
    <ur_tipi>TM</ur_tipi>
    <!-- TM, SN, MU, SK, GS, GD, HZ, MH, HA, YM, MA, LP, TK, SD, VR, VRD -->
    <bi_birim>ADET</bi_birim>
    <ur_kdv>18</ur_kdv>
    <ur_var1>DIS_SISTEM_ID_1</ur_var1>
    <ur_var2>DIS_SISTEM_ID_2</ur_var2>
  </stok>
</stoklar>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importStockXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <stocks><![CDATA[
        <stoklar>
          <stok>
            <ur_kod>STOK001</ur_kod>
            <ur_adi>Laptop Çantası</ur_adi>
            <ur_tipi>TM</ur_tipi>
            <bi_birim>ADET</bi_birim>
            <ur_var1>ERP_ID_1001</ur_var1>
          </stok>
        </stoklar>
      ]]></stocks>
    </tns:importStockXML>
  </soapenv:Body>
</soapenv:Envelope>

Örnek Yanıt

<transactions>
  <transferreds>
    <transaction>
      <server_id>4523</server_id>
    </transaction>
  </transferreds>
  <transposeds/>
  <duplicates/>
</transactions>

Notlar

  • Dış sistemle entegrasyonda ur_var1–ur_var3 alanlarını dış sistem ID'si için kullanabilirsiniz.
  • Birden fazla stok kartı tek istekte gönderilebilir; sistem her birini ayrı ayrı işler.
  • Token geçersizse tüm yanıt Invalid Token string'i döner.

Kontrol Alanları

Alan Adı Tip Açıklama
update boolean TRUE ise mevcut stoğu günceller (ur_no veya ur_kod ile)
oto_kod boolean TRUE ise ur_kod boşsa otomatik atanır