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ş bulunduğunda 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üştürme

sipsat_otoirsaliye=1 gönderildiğinde sipariş başarıyla kaydedilir kaydedilmez otomatik olarak irsaliyeye (satış teslimatına) dönüştürülür. 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)

Ortak Alanlar

Alan Tip Zorunlu Açıklama
odemeTipi string Evet Ödeme tipi: Nakit, ParaUstu, Kredi
tutar decimal Evet Ödeme tutarı
birim string Hayır Para birimi (örn. TL, USD)
kur decimal Hayır Döviz kuru (varsayılan: 1)
kasa integer Hayır Kasa numarası

odemeTipi = "Nakit" ek alanları

Alan Tip Zorunlu Açıklama
kapali boolean Hayır true ise tutar, kur ve birim sipariş cari bilgisinden otomatik alınır

odemeTipi = "Kredi" ek alanları

Alan Tip Zorunlu Açıklama
posid integer Hayır Sanal POS ID
planid integer Hayır Kredi kartı taksit planı ID
taksit integer Hayır Taksit sayısı (planid yoksa doğrudan kullanılır)
izahat string Hayır Hareket açıklaması (varsayılan: Satış Kredi Kartı Tahsilat)
kartsahibi string Hayır Kart sahibinin adı
banka integer Hayır Banka numarası

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>
    <odemeler>
      <!-- Nakit ödeme örneği -->
      <odeme>
        <odemeTipi>Nakit</odemeTipi>
        <tutar>500.00</tutar>
        <birim>TL</birim>
        <kur>1</kur>
      </odeme>
      <!-- Kredi kartı ödeme örneği -->
      <odeme>
        <odemeTipi>Kredi</odemeTipi>
        <tutar>500.00</tutar>
        <birim>TL</birim>
        <kur>1</kur>
        <posid>3</posid>
        <planid>7</planid>
        <taksit>3</taksit>
        <izahat>Web Kredi Kartı Tahsilat</izahat>
        <kartsahibi>AD SOYAD</kartsahibi>
      </odeme>
    </odemeler>
  </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