Ana içeriğe geç

Webticari SOAP Docs

importStockTransportXML

importStockTransportXML

Genel Bilgi

Özellik	Değer
Endpoint Adı	`importStockTransportXML`
SOAPAction	`urn:WebticariService#importStockTransportXML`
Açıklama	Depolar arası stok transfer (depo hareketi) işlemlerini XML formatında sisteme içe 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'ı
`depohareket`	`xsd:string`	Evet	Depo hareketi 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>
</transactions>

Önemli: Bu endpoint mükerrer kontrolü yapmaz.

Parametre Yapıları

`depohareket` — Depo Hareketi / Stok Transferi

Alan	Tip	Zorunlu	Açıklama
`dh_tarih`	`date`	Hayır	Hareket tarihi (varsayılan: şu an)
`dh_girisdepo`	`integer`	Evet	Giriş (hedef) depo numarası
`dh_cikisdepo`	`integer`	Evet	Çıkış (kaynak) depo numarası
`dh_aciklama`	`string`	Hayır	Açıklama
`dh_belgeno`	`string`	Hayır	Belge numarası
`dh_belgeturu`	`string`	Hayır	Belge türü (varsayılan: `Depo Hareket Fişi`)
`dh_personel`	`integer`	Hayır	Personel numarası (varsayılan: oturum personeli)
`dh_kur`	`decimal`	Hayır	Kur
`dh_sube`	`integer`	Hayır	Şube numarası
`dp_kod`	`string`	Hayır	Giriş depo kodu (`dh_girisdepo` yerine kullanılabilir)
`dh_fasoncari`	`integer`	Hayır	Fason cari numarası
`dh_muhonay`	`string`	Hayır	Muhasebe onay (E/H)
`dh_fasoniscilikurno`	`integer`	Hayır	Fason işçilik ürün numarası
`dh_fasoniscilikadet`	`decimal`	Hayır	Fason işçilik adet
`dh_fasoniscilikfiyat`	`decimal`	Hayır	Fason işçilik birim fiyatı
`dh_fasoniscilikbirim`	`string`	Hayır	Fason işçilik birimi
`dh_gecisid`	`integer`	Hayır	Geçiş ID
`sepet`	liste	Evet	Transfer kalemleri → bkz. `sepet > kalem`

`sepet > kalem` — Transfer Kalemi (tekrarlı liste)

Alan	Tip	Zorunlu	Açıklama
`so_urno`	`integer`	Evet	Ürün numarası
`so_adet`	`decimal`	Hayır	Transfer miktarı (varsayılan: 1)
`so_depo`	`integer`	Evet	Çıkış depo numarası
`so_fiyatsatis`	`decimal`	Hayır	Birim fiyat (varsayılan: stok satış fiyatı)
`so_urkod`	`string`	Hayır	Ürün kodu (varsayılan: stoktan çekilir)
`so_uradi`	`string`	Hayır	Ürün adı (varsayılan: stoktan çekilir)
`bi_barkod`	`string`	Hayır	Barkod (`so_urno` yerine kullanılabilir)
`dp_kod`	`string`	Hayır	Çıkış depo kodu (`so_depo` yerine kullanılabilir)
`so_birim`	`string`	Hayır	Birim (stok araması için)
`so_urunkur`	`decimal`	Hayır	Ürün kuru (varsayılan: 1)
`so_kdv`	`decimal`	Hayır	KDV oranı (varsayılan: stoktan çekilir)
`so_onay`	`string`	Hayır	Onay durumu (E/H, varsayılan: E)
`so_serino`	`string`	Hayır	Seri numarası
`so_urunsira`	`integer`	Hayır	Ürün sıra numarası
`so_stoksira`	`integer`	Hayır	Stok sıra numarası
`so_depozitosira`	`integer`	Hayır	Depozito sıra numarası

Kontrol Alanları

Alan Adı	Tip	Açıklama
`dh_belgeturu`	`string`	`Depo Taşıma İrsaliyesi` girilirse stok hareketleri oluşturulmaz

XML Yapısı (`depohareket` parametresi)

<depohareketler>
  <depohareket>
    <dh_tarih>2024-06-01</dh_tarih>          <!-- Transfer tarihi -->
    <dh_girisdepo>2</dh_girisdepo>           <!-- Hedef (giriş) depo no -->
    <dh_cikisdepo>1</dh_cikisdepo>           <!-- Kaynak (çıkış) depo no -->
    <dh_personel>5</dh_personel>             <!-- Personel no -->
    <dh_aciklama>Depo Transferi</dh_aciklama>
    <sepet>
      <kalem>
        <so_urno>123</so_urno>               <!-- Ürün no -->
        <so_depo>1</so_depo>                 <!-- Çıkış depo no -->
        <so_adet>10</so_adet>                <!-- Transfer miktarı -->
      </kalem>
    </sepet>
  </depohareket>
</depohareketler>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importStockTransportXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <depohareket><![CDATA[
        <depohareketler>
          <depohareket>
            <dh_tarih>2024-06-01</dh_tarih>
            <dh_girisdepo>2</dh_girisdepo>
            <dh_cikisdepo>1</dh_cikisdepo>
            <dh_personel>5</dh_personel>
            <dh_aciklama>Ana depodan B deposuna transfer</dh_aciklama>
            <sepet>
              <kalem>
                <so_urno>123</so_urno>
                <so_depo>1</so_depo>
                <so_adet>10</so_adet>
              </kalem>
            </sepet>
          </depohareket>
        </depohareketler>
      ]]></depohareket>
    </tns:importStockTransportXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

Depo transfer hareketi kaynak depodan çıkış, hedef depoya giriş olarak otomatik kaydedilir.
Birden fazla depo hareketi tek istekte gönderilebilir.
Token geçersizse yanıt Invalid Token string'i döner.