Ana içeriğe geç

importPurchaseReceiptXML

Genel Bilgi

Özellik Değer
Endpoint Adı importPurchaseReceiptXML
SOAPAction urn:WebticariService#importPurchaseReceiptXML
Açıklama Alış irsaliyelerini 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'ı
alis xsd:string Evet Alış irsaliyesi 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_IRSALIYE_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

Aşağıdaki alanların kombinasyonuna göre mükerrer kontrolü yapılır: - iral_seribelgeno + iral_belgeno + iral_tarih - cr_kod (cari kodu) - iral_var, iral_var1, iral_var2

Parametre Yapıları

alis — Alış İrsaliyesi

Alan Tip Zorunlu Açıklama
iral_tarih date Evet İrsaliye tarihi
iral_seribelgeno string Evet Seri belge numarası
iral_belgeno string Evet Belge numarası
iral_carino integer Evet Cari hesap numarası
cr_kod string Hayır Cari hesap kodu (carino yerine kullanılabilir)
iral_var string Hayır Ek alan 1
iral_var1 string Hayır Ek alan 2
iral_var2 string Hayır Ek alan 3
iral_personel integer Hayır Personel numarası
iral_sube integer Hayır Şube numarası
iral_belgeturu string Hayır Belge türü
sepet liste Evet İrsaliye kalemleri → bkz. sepet > kalem
iral_kur decimal Hayır Döviz kuru
iral_doviz string Hayır Para birimi
iral_carisube integer Hayır Cari şube numarası
iral_ozelkod string Hayır Özel kod 1
iral_ozelkod2 string Hayır Özel kod 2
iral_ozelkod3 string Hayır Özel kod 3
iral_altiskonto decimal Hayır Alt iskonto oranı
iral_tevkifat decimal Hayır Tevkifat oranı
iral_opsiyon date Hayır Opsiyon tarihi
iral_odeme integer Hayır Ödeme şekli ID
iral_aciklama string Hayır Açıklama
iral_aciklama1 string Hayır Açıklama 2
iral_aciklama2 string Hayır Açıklama 3
iral_aciklama3 string Hayır Açıklama 4
iral_aciklama4 string Hayır Açıklama 5
iral_muhonay string Hayır Muhasebe onay durumu
iral_sevkiyat date Hayır Sevkiyat tarihi
iral_satici integer Hayır Satıcı cari numarası
iral_masrafmerkezi string Hayır Masraf merkezi
iral_yazdirma string Hayır Yazdırma seçeneği
iral_var3 string Hayır Ek alan 4
iral_var4 string Hayır Ek alan 5
iral_var5 string Hayır Ek alan 6
iral_eirsaliye boolean Hayır e-İrsaliye mi (E/H)

sepet > kalem — İrsaliye Kalemi (tekrarlı liste)

Alan Tip Zorunlu Açıklama
iralsp_urunno integer Hayır Ürün numarası — ur_kod ile de aranabilir
ur_kod string Hayır Alternatif: stok kodu ile stok arama (iralsp_urunno yerine)
iralsp_urunkod string Hayır Ürün kodu
iralsp_urunadi string Hayır Ürün adı
iralsp_adet decimal Evet Miktar/adet
iralsp_birim string Hayır Birim
iralsp_fiyat decimal Evet Birim fiyat
iralsp_iskonto decimal Hayır İskonto oranı
iralsp_tutar decimal Hayır Toplam tutar
iralsp_kdv decimal Hayır KDV oranı
iralsp_maliyet decimal Hayır Maliyet
iralsp_otv decimal Hayır ÖTV oranı
iralsp_oiv decimal Hayır OİV oranı
iralsp_iskonto2 decimal Hayır İskonto 2 oranı
iralsp_iskonto3 decimal Hayır İskonto 3 oranı
iralsp_iskonto4 decimal Hayır İskonto 4 oranı
iralsp_carpan decimal Hayır Birim çarpanı
iralsp_urunkur decimal Hayır Ürün döviz kuru
iralsp_fiyatkdvdahil boolean Hayır E ise fiyat KDV dahildir
iralsp_depo integer Hayır Depo numarası
iralsp_aciklama string Hayır Kalem açıklaması
iralsp_satici integer Hayır Satıcı
iralsp_opsiyon date Hayır Opsiyon tarihi
iralsp_siparisno integer Hayır Bağlı sipariş numarası
iralsp_proje string Hayır Proje kodu
iralsp_masrafmerkezi string Hayır Masraf merkezi
iralsp_giristar date Hayır Giriş tarihi
iralsp_cikistar date Hayır Çıkış tarihi
iralsp_belgetar date Hayır Belge tarihi
iralsp_var string Hayır Serbest alan 1
iralsp_var2 string Hayır Serbest alan 2
iralsp_var3 string Hayır Serbest alan 3
iralsp_var4 string Hayır Serbest alan 4
iralsp_var5 string Hayır Serbest alan 5
iralsp_var6 string Hayır Serbest alan 6
iralsp_iade boolean Hayır İade kalemi mi
iralsp_iptal integer Hayır İptal kalemi (1=iptal)
iralsp_gecisid integer Hayır Dönüştürülen kaynak belge ID'si
iralsp_gecisyer string Hayır Dönüştürülen kaynak belge türü
iralsp_depozitosira integer Hayır Depozito sıra numarası
iralsp_temrintarihi date Hayır Termin tarihi

XML Yapısı (alis parametresi)

<irsaliyeler>
  <irsaliye>
    <iral_tarih>2024-06-01</iral_tarih>
    <iral_seribelgeno>AI</iral_seribelgeno>
    <iral_belgeno>000001</iral_belgeno>
    <iral_carino>15</iral_carino>            <!-- Tedarikçi cari ID -->
    <iral_personel>5</iral_personel>
    <iral_sube>1</iral_sube>
    <iral_var1>TEDARIKCI_IRSALIYE_NO</iral_var1>
    <sepet>
      <kalem>
        <iralsp_urunno>456</iralsp_urunno>  <!-- Ürün ID -->
        <iralsp_adet>100</iralsp_adet>
        <iralsp_birim>KG</iralsp_birim>
      </kalem>
    </sepet>
  </irsaliye>
</irsaliyeler>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importPurchaseReceiptXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <alis><![CDATA[
        <irsaliyeler>
          <irsaliye>
            <iral_tarih>2024-06-01</iral_tarih>
            <iral_seribelgeno>AI</iral_seribelgeno>
            <iral_belgeno>000001</iral_belgeno>
            <iral_carino>15</iral_carino>
            <iral_personel>5</iral_personel>
            <iral_var1>TEDARIKCI_IRSALIYE_9001</iral_var1>
            <sepet>
              <kalem>
                <iralsp_urunno>456</iralsp_urunno>
                <iralsp_adet>100</iralsp_adet>
                <iralsp_birim>KG</iralsp_birim>
              </kalem>
            </sepet>
          </irsaliye>
        </irsaliyeler>
      ]]></alis>
    </tns:importPurchaseReceiptXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • Alış irsaliyesi tedarikçiden gelen malın girişini belgeler; stok giriş hareketi otomatik oluşturulur.
  • Tedarikçinin sistemdeki cari kaydı mevcut olmalıdır.
  • Dış sistem irsaliye numarasını iral_var1–iral_var4 alanlarında saklamak mükerrer tespiti için kullanışlıdır.
  • Token geçersizse yanıt Invalid Token string'i döner.

Kontrol Alanları

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