Ana içeriğe geç

importSalesOfferXML

Genel Bilgi

Özellik Değer
Endpoint Adı importSalesOfferXML
SOAPAction urn:WebticariService#importSalesOfferXML
Açıklama Satış tekliflerini 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'ı
teklif xsd:string Evet Satış teklif 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ı (mükerre <duplicates> bölümü döndürülmez):

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

Önemli: Bu endpoint mükerrer kontrol yapmaz. Her gönderim yeni bir teklif kaydı oluşturur.

Parametre Yapıları

teklif — Satış Teklifi

Alan Tip Zorunlu Açıklama
tk_tarih date Evet Teklif tarihi
tk_seribelgeno string Evet Seri belge numarası
tk_belgeno string Evet Belge numarası
tk_carino integer Evet Cari hesap numarası
cr_kod string Hayır Cari hesap kodu (carino yerine kullanılabilir)
tk_var string Hayır Ek alan 1
tk_var1 string Hayır Ek alan 2
tk_var2 string Hayır Ek alan 3
tk_personel integer Hayır Personel numarası
tk_sube integer Hayır Şube numarası
sepet liste Evet Teklif kalemleri → bkz. sepet > kalem
tk_kur decimal Hayır Döviz kuru
tk_doviz string Hayır Para birimi (varsayılan: sistem para birimi)
tk_carisube integer Hayır Cari şube numarası
tk_ozelkod string Hayır Özel kod 1
tk_ozelkod2 string Hayır Özel kod 2
tk_ozelkod3 string Hayır Özel kod 3
tk_altiskonto decimal Hayır Alt iskonto oranı
tk_opsiyon date Hayır Opsiyon tarihi
tk_belgeturu string Hayır Belge türü (varsayılan: SATIŞ TEKLİFİ)
tk_odeme integer Hayır Ödeme şekli ID
tk_aciklama string Hayır Açıklama
tk_aciklama1 string Hayır Açıklama 2
tk_aciklama2 string Hayır Açıklama 3
tk_aciklama3 string Hayır Açıklama 4
tk_aciklama4 string Hayır Açıklama 5
tk_muhonay string Hayır Muhasebe onay durumu
tk_sevkiyat date Hayır Sevkiyat tarihi
tk_satici integer Hayır Satıcı cari numarası
tk_yazdirma string Hayır Yazdırma seçeneği
tk_var3 string Hayır Ek alan 4
tk_var4 string Hayır Ek alan 5
tk_var5 string Hayır Ek alan 6

sepet > kalem — Teklif Kalemi (tekrarlı liste)

Alan Tip Zorunlu Açıklama
tss_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 (tss_urunno yerine)
ur_kod string Hayır Alternatif: stok kodu ile stok arama (tss_urunno yerine)
tss_urunkod string Hayır Ürün kodu
tss_urunadi string Hayır Ürün adı
tss_adet decimal Evet Miktar/adet
tss_birim string Hayır Birim
tss_fiyat decimal Evet Birim fiyat
tss_iskonto decimal Hayır İskonto oranı
tss_tutar decimal Hayır Toplam tutar
tss_kdv decimal Hayır KDV oranı
tss_maliyet decimal Hayır Maliyet
tss_otv decimal Hayır ÖTV oranı
tss_oiv decimal Hayır OİV oranı
tss_iskonto2 decimal Hayır İskonto 2 oranı
tss_iskonto3 decimal Hayır İskonto 3 oranı
tss_iskonto4 decimal Hayır İskonto 4 oranı
tss_carpan decimal Hayır Birim çarpanı
tss_urunkur decimal Hayır Ürün döviz kuru
tss_fiyatkdvdahil boolean Hayır E ise fiyat KDV dahildir
tss_depo integer Hayır Depo numarası
tss_aciklama string Hayır Kalem açıklaması
tss_satici integer Hayır Satıcı
tss_opsiyon date Hayır Opsiyon tarihi
tss_siparisno integer Hayır Bağlı sipariş numarası
tss_proje string Hayır Proje kodu
tss_masrafmerkezi string Hayır Masraf merkezi
tss_giristar date Hayır Giriş tarihi
tss_cikistar date Hayır Çıkış tarihi
tss_belgetar date Hayır Belge tarihi
tss_var string Hayır Serbest alan 1
tss_var2 string Hayır Serbest alan 2
tss_var3 string Hayır Serbest alan 3
tss_var4 string Hayır Serbest alan 4
tss_var5 string Hayır Serbest alan 5
tss_var6 string Hayır Serbest alan 6
tss_iade boolean Hayır İade kalemi mi
tss_depozitosira integer Hayır Depozito sıra numarası
tss_koli string Hayır Koli bilgisi
tss_temrintarihi date Hayır Termin tarihi

XML Yapısı

<teklifler>
  <teklif>
    <tk_tarih>2024-06-01</tk_tarih>
    <tk_seribelgeno>T</tk_seribelgeno>
    <tk_belgeno>000001</tk_belgeno>
    <tk_carino>42</tk_carino>               <!-- Müşteri ID -->
    <tk_personel>5</tk_personel>
    <tk_sube>1</tk_sube>
    <tk_aciklama>Teklif açıklaması</tk_aciklama>
    <sepet>
      <kalem>
        <tss_urunno>123</tss_urunno>
        <tss_adet>10</tss_adet>
        <tss_fiyat>100.00</tss_fiyat>
        <tss_kdv>18</tss_kdv>
        <tss_iskonto>0</tss_iskonto>
      </kalem>
    </sepet>
  </teklif>
</teklifler>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importSalesOfferXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <teklif><![CDATA[
        <teklifler>
          <teklif>
            <tk_tarih>2024-06-01</tk_tarih>
            <tk_seribelgeno>T</tk_seribelgeno>
            <tk_belgeno>000001</tk_belgeno>
            <tk_carino>42</tk_carino>
            <tk_personel>5</tk_personel>
            <sepet>
              <kalem>
                <tss_urunno>123</tss_urunno>
                <tss_adet>10</tss_adet>
                <tss_fiyat>100.00</tss_fiyat>
                <tss_kdv>18</tss_kdv>
              </kalem>
            </sepet>
          </teklif>
        </teklifler>
      ]]></teklif>
    </tns:importSalesOfferXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • Teklif kaydedildiğinde satisTeklif() fonksiyonu çağrılır.
  • Bu endpoint mükerrer kontrol yapmaz; aynı verinin tekrar gönderilmesi yeni bir teklif oluşturur.
  • Oluşturulan teklif, ekranda incelenerek sipariş veya faturaya dönüştürülebilir.
  • Token geçersizse yanıt Invalid Token string'i döner.

Kontrol Alanları

Alan Adı Tip Açıklama
update boolean TRUE ise mevcut teklifi günceller