Ana içeriğe geç

importSalesOrderXML

Genel Bilgi

Özellik Değer
Endpoint Adı importSalesOrderXML
SOAPAction urn:WebticariService#importSalesOrderXML
Açıklama Satış siparişlerini 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'ı
siparis xsd:string Evet Satış sipariş 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_SIPARIS_ID</server_id>
    </transaction>
  </transferreds>
  <transposeds>
    <transaction>
      <errorno>-1</errorno>
      <errormessage>Hata açıklaması</errormessage>
    </transaction>
  </transposeds>
  <duplicates>
    <transaction>
    </transaction>
  </duplicates>
</transactions>

Mükerrer Kayıt Tespiti

Sistem aşağıdaki alanların kombinasyonuna göre mükerrer kontrolü yapar: - sipsat_tarih, sipsat_seribelgeno, sipsat_belgeno - cr_kod (cari kodu) - sipsat_var, sipsat_var1, sipsat_var2 - sipsat_personel, sipsat_sube

Eşleşen bir sipariş bulunduunda kayıt <duplicates> bölümünde döner.

İstisna: sipsat_belgeturu='SATIŞ REZERVASYONU' olan siparişler için mükerrer kontrolü atılır.

Otomatik İrsaliyeye Dönüştme

sipsat_otoirsaliye=1 gönderildiğinde sipariş başarıyla kaydedilir kaydilmez otomatik olarak irsaliyeye (satış teslimatına) dönüştürülr. Bu durumda yanıtta yine sipariş ID'si döner.

Parametre Yapıları

siparis — Satış Siparişi

Alan Tip Zorunlu Açıklama
sipsat_tarih date Evet Sipariş tarihi
sipsat_seribelgeno string Evet Seri belge numarası
sipsat_belgeno string Evet Belge numarası
sipsat_carino integer Evet Cari hesap numarası
cr_kod string Hayır Cari hesap kodu (carino yerine kullanılabilir)
sipsat_var string Hayır Ek alan 1
sipsat_var1 string Hayır Ek alan 2
sipsat_var2 string Hayır Ek alan 3
sipsat_personel integer Hayır Personel numarası
sipsat_sube integer Hayır Şube numarası
sipsat_belgeturu string Hayır Belge türü
sipsat_otoirsaliye boolean Hayır Otomatik irsaliye oluşturulsun mu
sepet liste Evet Sipariş kalemleri → bkz. sepet > kalem
odemeler liste Hayır Ödeme bilgileri → bkz. odemeler > odeme
sipsat_kur decimal Hayır Döviz kuru
sipsat_doviz string Hayır Para birimi
sipsat_carisube integer Hayır Cari şube numarası
sipsat_ozelkod string Hayır Özel kod 1
sipsat_ozelkod2 string Hayır Özel kod 2
sipsat_ozelkod3 string Hayır Özel kod 3
sipsat_altiskonto decimal Hayır Alt iskonto oranı
sipsat_opsiyon date Hayır Opsiyon tarihi
sipsat_odeme integer\|string Hayır Ödeme şekli ID veya adı
sipsat_aciklama string Hayır Açıklama
sipsat_aciklama1 string Hayır Açıklama 2
sipsat_aciklama2 string Hayır Açıklama 3
sipsat_aciklama3 string Hayır Açıklama 4
sipsat_aciklama4 string Hayır Açıklama 5
sipsat_muhonay string Hayır Muhasebe onay durumu
sipsat_sevkiyat date Hayır Sevkiyat tarihi
sipsat_satici integer Hayır Satıcı cari numarası
sipsat_yazdirma string Hayır Yazdırma seçeneği
sipsat_aliscari integer Hayır Alış cari numarası
sipsat_aliscarikod string Hayır Alış cari kodu (sipsat_aliscari yerine kullanılabilir)
sipsat_aliscarisube integer Hayır Alış cari şube numarası
sipsat_alisdoviz string Hayır Alış döviz cinsi
sipsat_aliskur decimal Hayır Alış döviz kuru
sipsat_satiscari integer Hayır Satış cari numarası
sipsat_satiscarikod string Hayır Satış cari kodu (sipsat_satiscari yerine kullanılabilir)
sipsat_satiscarisube integer Hayır Satış cari şube numarası
sipsat_satisdoviz string Hayır Satış döviz cinsi
sipsat_satiskur decimal Hayır Satış döviz kuru
sipsat_var3 string Hayır Ek alan 4
sipsat_var4 string Hayır Ek alan 5
sipsat_var5 string Hayır Ek alan 6
sipsat_cagriid integer Hayır Çağrı merkezi kaydı ID

sepet > kalem — Sipariş Kalemi (tekrarlı liste)

Alan Tip Zorunlu Açıklama
sipsatsp_urunno integer Hayır Ürün numarası — bi_barkod veya ur_kod ile de aranabilir
bi_barkod string Hayır Alternatif: barkod ile stok arama (sipsatsp_urunno yerine)
ur_kod string Hayır Alternatif: stok kodu ile stok arama (sipsatsp_urunno yerine)
sipsatsp_urunkod string Hayır Ürün kodu
sipsatsp_urunadi string Hayır Ürün adı
sipsatsp_adet decimal Evet Miktar/adet
sipsatsp_birim string Hayır Birim
sipsatsp_fiyat decimal Evet Birim fiyat
sipsatsp_iskonto decimal Hayır İskonto oranı
sipsatsp_tutar decimal Hayır Toplam tutar
sipsatsp_kdv decimal Hayır KDV oranı
sipsatsp_maliyet decimal Hayır Maliyet
sipsatsp_otv decimal Hayır ÖTV oranı
sipsatsp_oiv decimal Hayır OİV oranı
sipsatsp_iskonto2 decimal Hayır İskonto 2 oranı
sipsatsp_iskonto3 decimal Hayır İskonto 3 oranı
sipsatsp_iskonto4 decimal Hayır İskonto 4 oranı
sipsatsp_carpan decimal Hayır Birim çarpanı
sipsatsp_urunkur decimal Hayır Ürün döviz kuru
sipsatsp_fiyatkdvdahil boolean Hayır E ise fiyat KDV dahildir
sipsatsp_depo integer Hayır Depo numarası
sipsatsp_aciklama string Hayır Kalem açıklaması
sipsatsp_satici integer Hayır Satıcı
sipsatsp_opsiyon date Hayır Opsiyon tarihi
sipsatsp_siparisno integer Hayır Bağlı sipariş numarası
sipsatsp_proje string Hayır Proje kodu
sipsatsp_masrafmerkezi string Hayır Masraf merkezi
sipsatsp_giristar date Hayır Giriş tarihi
sipsatsp_cikistar date Hayır Çıkış tarihi
sipsatsp_belgetar date Hayır Belge tarihi
sipsatsp_var string Hayır Serbest alan 1
sipsatsp_var2 string Hayır Serbest alan 2
sipsatsp_var3 string Hayır Serbest alan 3
sipsatsp_var4 string Hayır Serbest alan 4
sipsatsp_var5 string Hayır Serbest alan 5
sipsatsp_var6 string Hayır Serbest alan 6
sipsatsp_iade boolean Hayır İade kalemi mi
sipsatsp_depozitosira integer Hayır Depozito sıra numarası
sipsatsp_tedarikci integer Hayır Tedarikçi cari numarası
sipsatsp_koli string Hayır Koli bilgisi
sipsatsp_temrintarihi date Hayır Termin tarihi
sipsatsp_komisyon decimal Hayır Komisyon oranı
sipsatsp_iptal integer Hayır İptal kalemi (1=iptal)

odemeler > odeme — Ödeme Satırı (tekrarlı liste)

Alan Tip Zorunlu Açıklama
od_tip string Evet Ödeme tipi
od_tutar decimal Evet Ödeme tutarı
od_tarih date Hayır Ödeme tarihi

XML Yapısı (siparis parametresi)

<siparisler>
  <siparis>
    <sipsat_tarih>2024-06-01</sipsat_tarih>
    <sipsat_seribelgeno>S</sipsat_seribelgeno>
    <sipsat_belgeno>000001</sipsat_belgeno>
    <sipsat_carino>42</sipsat_carino>     <!-- Sunucudaki cari ID -->
    <sipsat_personel>5</sipsat_personel>
    <sipsat_sube>1</sipsat_sube>
    <sipsat_otoirsaliye>0</sipsat_otoirsaliye>  <!-- 1=otomatik irsaliyeye çevir -->
    <sipsat_var1>DIS_SISTEM_SIPARIS_NO</sipsat_var1>
    <sepet>
      <kalem>
        <sipsatsp_urunno>123</sipsatsp_urunno>
        <sipsatsp_adet>5</sipsatsp_adet>
        <sipsatsp_fiyat>100.00</sipsatsp_fiyat>
        <sipsatsp_birim>ADET</sipsatsp_birim>
      </kalem>
    </sepet>
  </siparis>
</siparisler>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importSalesOrderXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <siparis><![CDATA[
        <siparisler>
          <siparis>
            <sipsat_tarih>2024-06-01</sipsat_tarih>
            <sipsat_seribelgeno>S</sipsat_seribelgeno>
            <sipsat_belgeno>000123</sipsat_belgeno>
            <sipsat_carino>42</sipsat_carino>
            <sipsat_personel>5</sipsat_personel>
            <sipsat_var1>WEBSHOP_ORDER_456</sipsat_var1>
            <sepet>
              <kalem>
                <sipsatsp_urunno>123</sipsatsp_urunno>
                <sipsatsp_adet>5</sipsatsp_adet>
                <sipsatsp_fiyat>100.00</sipsatsp_fiyat>
                <sipsatsp_birim>ADET</sipsatsp_birim>
              </kalem>
            </sepet>
          </siparis>
        </siparisler>
      ]]></siparis>
    </tns:importSalesOrderXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • Sipariş başarıyla kaydedilince convertSalesOrderToReceipt veya convertSalesOrderToInvoice ile irsaliye ya da faturaya dönüştürülebilir.
  • Dış sistem sipariş numarasını sipsat_var1–sipsat_var5 alanlarında saklamak mükerrer tespiti için kullanışlıdır.
  • sipsat_otoirsaliye=1 kullanıldığında ek bir convert çağrısına gerek yoktur.
  • Token geçersizse yanıt Invalid Token string'i döner.

Kontrol Alanları

Alan Adı Tip Açıklama
sipsat_otoirsaliye boolean 1 ise kayıt sonrası otomatik irsaliyeye dönüştürülür