Ana içeriğe geç

importPurchaseOrderXML

Genel Bilgi

Özellik Değer
Endpoint Adı importPurchaseOrderXML
SOAPAction urn:WebticariService#importPurchaseOrderXML
Açıklama Alış 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 Alış 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ı (mükerrer <duplicates> bölümü döndürülmez):

<transactions>
  <transferreds>
    <transaction>
      <server_id>SUNUCU_SIPARIS_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. Her gönderim yeni bir alış sipariş kaydı oluşturur.

Parametre Yapıları

siparis — Alış Siparişi

Alan Tip Zorunlu Açıklama
sipal_tarih date Evet Sipariş tarihi
sipal_seribelgeno string Evet Seri belge numarası
sipal_belgeno string Evet Belge numarası
sipal_carino integer Evet Cari hesap numarası
cr_kod string Hayır Cari hesap kodu (carino yerine kullanılabilir)
sipal_var string Hayır Ek alan 1
sipal_var1 string Hayır Ek alan 2
sipal_var2 string Hayır Ek alan 3
sipal_personel integer Hayır Personel numarası
sipal_sube integer Hayır Şube numarası
sepet liste Evet Sipariş kalemleri → bkz. sepet > kalem
sipal_kur decimal Hayır Döviz kuru
sipal_doviz string Hayır Para birimi
sipal_carisube integer Hayır Cari şube numarası
sipal_ozelkod string Hayır Özel kod 1
sipal_ozelkod2 string Hayır Özel kod 2
sipal_ozelkod3 string Hayır Özel kod 3
sipal_altiskonto decimal Hayır Alt iskonto oranı
sipal_tevkifat decimal Hayır Tevkifat oranı
sipal_opsiyon date Hayır Opsiyon tarihi
sipal_belgeturu string Hayır Belge türü (varsayılan: ALIŞ SİPARİŞİ)
sipal_odeme integer Hayır Ödeme şekli ID
sipal_aciklama string Hayır Açıklama
sipal_aciklama1 string Hayır Açıklama 2
sipal_aciklama2 string Hayır Açıklama 3
sipal_aciklama3 string Hayır Açıklama 4
sipal_aciklama4 string Hayır Açıklama 5
sipal_muhonay string Hayır Muhasebe onay durumu
sipal_sevkiyat date Hayır Sevkiyat tarihi
sipal_satici integer Hayır Satıcı cari numarası
sipal_yazdirma string Hayır Yazdırma seçeneği
sipal_var3 string Hayır Ek alan 4
sipal_var4 string Hayır Ek alan 5
sipal_var5 string Hayır Ek alan 6

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

Alan Tip Zorunlu Açıklama
sipalsp_urunno integer Hayır Ürün numarası — ur_kod ile de aranabilir
ur_kod string Hayır Alternatif: stok kodu ile stok arama (sipalsp_urunno yerine)
sipalsp_urunkod string Hayır Ürün kodu
sipalsp_urunadi string Hayır Ürün adı
sipalsp_adet decimal Evet Miktar/adet
sipalsp_birim string Hayır Birim
sipalsp_fiyat decimal Evet Birim fiyat
sipalsp_iskonto decimal Hayır İskonto oranı
sipalsp_tutar decimal Hayır Toplam tutar
sipalsp_kdv decimal Hayır KDV oranı
sipalsp_maliyet decimal Hayır Maliyet
sipalsp_otv decimal Hayır ÖTV oranı
sipalsp_oiv decimal Hayır OİV oranı
sipalsp_iskonto2 decimal Hayır İskonto 2 oranı
sipalsp_iskonto3 decimal Hayır İskonto 3 oranı
sipalsp_iskonto4 decimal Hayır İskonto 4 oranı
sipalsp_carpan decimal Hayır Birim çarpanı
sipalsp_urunkur decimal Hayır Ürün döviz kuru
sipalsp_fiyatkdvdahil boolean Hayır E ise fiyat KDV dahildir
sipalsp_depo integer Hayır Depo numarası
sipalsp_aciklama string Hayır Kalem açıklaması
sipalsp_satici integer Hayır Satıcı
sipalsp_opsiyon date Hayır Opsiyon tarihi
sipalsp_siparisno integer Hayır Bağlı sipariş numarası
sipalsp_proje string Hayır Proje kodu
sipalsp_masrafmerkezi string Hayır Masraf merkezi
sipalsp_giristar date Hayır Giriş tarihi
sipalsp_cikistar date Hayır Çıkış tarihi
sipalsp_belgetar date Hayır Belge tarihi
sipalsp_var string Hayır Serbest alan 1
sipalsp_var2 string Hayır Serbest alan 2
sipalsp_var3 string Hayır Serbest alan 3
sipalsp_var4 string Hayır Serbest alan 4
sipalsp_var5 string Hayır Serbest alan 5
sipalsp_var6 string Hayır Serbest alan 6
sipalsp_iade boolean Hayır İade kalemi mi
sipalsp_depozitosira integer Hayır Depozito sıra numarası
sipalsp_koli string Hayır Koli bilgisi
sipalsp_temrintarihi date Hayır Termin tarihi

XML Yapısı (siparis parametresi)

<siparisler>
  <siparis>
    <sipal_tarih>2024-06-01</sipal_tarih>
    <sipal_seribelgeno>AS</sipal_seribelgeno>
    <sipal_belgeno>000001</sipal_belgeno>
    <sipal_carino>15</sipal_carino>    <!-- Tedarikçi cari ID -->
    <sipal_personel>5</sipal_personel>
    <sipal_sube>1</sipal_sube>
    <sipal_var1>TEDARIKCI_SIPARIS_NO</sipal_var1>
    <sepet>
      <kalem>
        <sipalsp_urunno>456</sipalsp_urunno>
        <sipalsp_adet>50</sipalsp_adet>
        <sipalsp_fiyat>80.00</sipalsp_fiyat>
        <sipalsp_birim>ADET</sipalsp_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:importPurchaseOrderXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <siparis><![CDATA[
        <siparisler>
          <siparis>
            <sipal_tarih>2024-06-01</sipal_tarih>
            <sipal_seribelgeno>AS</sipal_seribelgeno>
            <sipal_belgeno>000001</sipal_belgeno>
            <sipal_carino>15</sipal_carino>
            <sipal_personel>5</sipal_personel>
            <sipal_var1>TEDARIKCI_SIPARIS_7001</sipal_var1>
            <sepet>
              <kalem>
                <sipalsp_urunno>456</sipalsp_urunno>
                <sipalsp_adet>50</sipalsp_adet>
                <sipalsp_fiyat>80.00</sipalsp_fiyat>
                <sipalsp_birim>ADET</sipalsp_birim>
              </kalem>
            </sepet>
          </siparis>
        </siparisler>
      ]]></siparis>
    </tns:importPurchaseOrderXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • Alış siparişi tedarikçiye verilen siparisi temsil eder.
  • Siparis başarıyla kaydedilince convertPurchaseOrderToReceipt veya convertPurchaseOrderToInvoice ile irsaliye ya da faturaya dönüştürülebilir.
  • Dış sistem sipariş numarasını sipal_var1–sipal_var5 alanlarında saklamak için kullanılabilir.
  • Token geçersizse yanıt Invalid Token string'i döner.

Kontrol Alanları

Alan Adı Tip Açıklama
update boolean TRUE ise mevcut alış siparişini günceller