Ana içeriğe geç

importPurchaseOfferXML

Genel Bilgi

Özellik Değer
Endpoint Adı importPurchaseOfferXML
SOAPAction urn:WebticariService#importPurchaseOfferXML
Açıklama Alış tekliflerini XML formatında sisteme içe aktarır. Tedarikçilerden alınan fiyat tekliflerini kaydetmek için kullanılı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 Alış 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ükerrer <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 — Alış Teklifi

Alan Tip Zorunlu Açıklama
tekal_tarih date Evet Teklif tarihi
tekal_seribelgeno string Evet Seri belge numarası
tekal_belgeno string Evet Belge numarası
tekal_carino integer Evet Cari hesap numarası
cr_kod string Hayır Cari hesap kodu (carino yerine kullanılabilir)
tekal_var string Hayır Ek alan 1
tekal_var1 string Hayır Ek alan 2
tekal_var2 string Hayır Ek alan 3
tekal_personel integer Hayır Personel numarası
tekal_sube integer Hayır Şube numarası
sepet liste Evet Teklif kalemleri → bkz. sepet > kalem
tekal_kur decimal Hayır Döviz kuru
tekal_doviz string Hayır Para birimi (varsayılan: sistem para birimi)
tekal_carisube integer Hayır Cari şube numarası
tekal_ozelkod string Hayır Özel kod 1
tekal_ozelkod2 string Hayır Özel kod 2
tekal_ozelkod3 string Hayır Özel kod 3
tekal_altiskonto decimal Hayır Alt iskonto oranı
tekal_tevkifat decimal Hayır Tevkifat oranı
tekal_opsiyon date Hayır Opsiyon tarihi
tekal_belgeturu string Hayır Belge türü (varsayılan: ALIŞ TEKLİFİ)
tekal_odeme integer Hayır Ödeme şekli ID
tekal_aciklama string Hayır Açıklama
tekal_aciklama1 string Hayır Açıklama 2
tekal_aciklama2 string Hayır Açıklama 3
tekal_aciklama3 string Hayır Açıklama 4
tekal_aciklama4 string Hayır Açıklama 5
tekal_muhonay string Hayır Muhasebe onay durumu
tekal_sevkiyat date Hayır Sevkiyat tarihi
tekal_satici integer Hayır Satıcı cari numarası
tekal_yazdirma string Hayır Yazdırma seçeneği
tekal_var3 string Hayır Ek alan 4
tekal_var4 string Hayır Ek alan 5
tekal_var5 string Hayır Ek alan 6

sepet > kalem — Teklif Kalemi (tekrarlı liste)

Alan Tip Zorunlu Açıklama
tekalsp_urunno integer Hayır Ürün numarası — ur_kod ile de aranabilir
ur_kod string Hayır Alternatif: stok kodu ile stok arama (tekalsp_urunno yerine)
tekalsp_urunkod string Hayır Ürün kodu
tekalsp_urunadi string Hayır Ürün adı
tekalsp_adet decimal Evet Miktar/adet
tekalsp_birim string Hayır Birim
tekalsp_fiyat decimal Evet Birim fiyat
tekalsp_iskonto decimal Hayır İskonto oranı
tekalsp_tutar decimal Hayır Toplam tutar
tekalsp_kdv decimal Hayır KDV oranı
tekalsp_maliyet decimal Hayır Maliyet
tekalsp_otv decimal Hayır ÖTV oranı
tekalsp_oiv decimal Hayır OİV oranı
tekalsp_iskonto2 decimal Hayır İskonto 2 oranı
tekalsp_iskonto3 decimal Hayır İskonto 3 oranı
tekalsp_iskonto4 decimal Hayır İskonto 4 oranı
tekalsp_carpan decimal Hayır Birim çarpanı
tekalsp_urunkur decimal Hayır Ürün döviz kuru
tekalsp_fiyatkdvdahil boolean Hayır E ise fiyat KDV dahildir
tekalsp_depo integer Hayır Depo numarası
tekalsp_aciklama string Hayır Kalem açıklaması
tekalsp_satici integer Hayır Satıcı
tekalsp_opsiyon date Hayır Opsiyon tarihi
tekalsp_siparisno integer Hayır Bağlı sipariş numarası
tekalsp_proje string Hayır Proje kodu
tekalsp_masrafmerkezi string Hayır Masraf merkezi
tekalsp_giristar date Hayır Giriş tarihi
tekalsp_cikistar date Hayır Çıkış tarihi
tekalsp_belgetar date Hayır Belge tarihi
tekalsp_var string Hayır Serbest alan 1
tekalsp_var2 string Hayır Serbest alan 2
tekalsp_var3 string Hayır Serbest alan 3
tekalsp_var4 string Hayır Serbest alan 4
tekalsp_var5 string Hayır Serbest alan 5
tekalsp_var6 string Hayır Serbest alan 6
tekalsp_iade boolean Hayır İade kalemi mi
tekalsp_depozitosira integer Hayır Depozito sıra numarası
tekalsp_koli string Hayır Koli bilgisi
tekalsp_temrintarihi date Hayır Termin tarihi

XML Yapısı

<teklifler>
  <teklif>
    <tekal_tarih>2024-06-01</tekal_tarih>
    <tekal_seribelgeno>AT</tekal_seribelgeno>
    <tekal_belgeno>000001</tekal_belgeno>
    <tekal_carino>15</tekal_carino>               <!-- Tedarikçi ID -->
    <tekal_personel>5</tekal_personel>
    <tekal_sube>1</tekal_sube>
    <tekal_aciklama>Teklif açıklaması</tekal_aciklama>
    <sepet>
      <kalem>
        <tekalsp_urunno>456</tekalsp_urunno>
        <tekalsp_adet>10</tekalsp_adet>
        <tekalsp_fiyat>85.00</tekalsp_fiyat>
        <tekalsp_kdv>18</tekalsp_kdv>
        <tekalsp_iskonto>0</tekalsp_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:importPurchaseOfferXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <teklif><![CDATA[
        <teklifler>
          <teklif>
            <tekal_tarih>2024-06-01</tekal_tarih>
            <tekal_seribelgeno>AT</tekal_seribelgeno>
            <tekal_belgeno>000001</tekal_belgeno>
            <tekal_carino>15</tekal_carino>
            <tekal_personel>5</tekal_personel>
            <sepet>
              <kalem>
                <tekalsp_urunno>456</tekalsp_urunno>
                <tekalsp_adet>10</tekalsp_adet>
                <tekalsp_fiyat>85.00</tekalsp_fiyat>
                <tekalsp_kdv>18</tekalsp_kdv>
              </kalem>
            </sepet>
          </teklif>
        </teklifler>
      ]]></teklif>
    </tns:importPurchaseOfferXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • Teklif kaydedildiğinde alisTeklif() 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 alış siparişine 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