Ana içeriğe geç

importSalesReceiptXML

Genel Bilgi

Özellik Değer
Endpoint Adı importSalesReceiptXML
SOAPAction urn:WebticariService#importSalesReceiptXML
Açıklama Satış 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'ı
satis xsd:string Evet Satış 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: - irsat_seribelgeno + irsat_belgeno + irsat_tarih - cr_kod (cari kodu) - irsat_var, irsat_var1, irsat_var2

Parametre Yapıları

satis — Satış İrsaliyesi

Alan Tip Zorunlu Açıklama
irsat_tarih date Evet İrsaliye tarihi
irsat_seribelgeno string Evet Seri belge numarası
irsat_belgeno string Evet Belge numarası
irsat_carino integer Evet Cari hesap numarası
cr_kod string Hayır Cari hesap kodu (carino yerine kullanılabilir)
irsat_var string Hayır Ek alan 1
irsat_var1 string Hayır Ek alan 2
irsat_var2 string Hayır Ek alan 3
irsat_personel integer Hayır Personel numarası
irsat_sube integer Hayır Şube numarası
irsat_belgeturu string Hayır Belge türü
sepet liste Evet İrsaliye kalemleri → bkz. sepet > kalem
odemeler liste Hayır Ödeme bilgileri → bkz. odemeler > odeme
irsat_kur decimal Hayır Döviz kuru
irsat_doviz string Hayır Para birimi
irsat_carisube integer Hayır Cari şube numarası
irsat_ozelkod string Hayır Özel kod 1
irsat_ozelkod2 string Hayır Özel kod 2
irsat_ozelkod3 string Hayır Özel kod 3
irsat_altiskonto decimal Hayır Alt iskonto oranı
irsat_opsiyon date Hayır Opsiyon tarihi
irsat_odeme integer Hayır Ödeme şekli ID
irsat_aciklama string Hayır Açıklama
irsat_aciklama1 string Hayır Açıklama 2
irsat_aciklama2 string Hayır Açıklama 3
irsat_aciklama3 string Hayır Açıklama 4
irsat_aciklama4 string Hayır Açıklama 5
irsat_muhonay string Hayır Muhasebe onay durumu
irsat_sevkiyat date Hayır Sevkiyat tarihi
irsat_satici integer Hayır Satıcı cari numarası
irsat_yazdirma string Hayır Yazdırma seçeneği
irsat_var3 string Hayır Ek alan 4
irsat_var4 string Hayır Ek alan 5
irsat_var5 string Hayır Ek alan 6
irsat_eirsaliye boolean Hayır e-İrsaliye mi (E/H)
irsat_uuid string Hayır e-İrsaliye UUID
irsat_nakliyearac string Hayır Nakliye aracı
irsat_sofor string Hayır Şoför bilgisi
irsat_tasiyici string Hayır Taşıyıcı bilgisi
irsat_gercekalici string Hayır Gerçek alıcı
irsat_gerceksatici string Hayır Gerçek satıcı

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

Alan Tip Zorunlu Açıklama
irsatsp_urunno integer Hayır Ürün numarası — ur_kod ile de aranabilir
ur_kod string Hayır Alternatif: stok kodu ile stok arama (irsatsp_urunno yerine)
irsatsp_urunkod string Hayır Ürün kodu
irsatsp_urunadi string Hayır Ürün adı
irsatsp_adet decimal Evet Miktar/adet
irsatsp_birim string Hayır Birim
irsatsp_fiyat decimal Evet Birim fiyat
irsatsp_iskonto decimal Hayır İskonto oranı
irsatsp_tutar decimal Hayır Toplam tutar
irsatsp_kdv decimal Hayır KDV oranı
irsatsp_maliyet decimal Hayır Maliyet
irsatsp_otv decimal Hayır ÖTV oranı
irsatsp_oiv decimal Hayır OİV oranı
irsatsp_iskonto2 decimal Hayır İskonto 2 oranı
irsatsp_iskonto3 decimal Hayır İskonto 3 oranı
irsatsp_iskonto4 decimal Hayır İskonto 4 oranı
irsatsp_carpan decimal Hayır Birim çarpanı
irsatsp_urunkur decimal Hayır Ürün döviz kuru
irsatsp_fiyatkdvdahil boolean Hayır E ise fiyat KDV dahildir
irsatsp_depo integer Hayır Depo numarası
irsatsp_aciklama string Hayır Kalem açıklaması
irsatsp_satici integer Hayır Satıcı
irsatsp_opsiyon date Hayır Opsiyon tarihi
irsatsp_siparisno integer Hayır Bağlı sipariş numarası
irsatsp_proje string Hayır Proje kodu
irsatsp_masrafmerkezi string Hayır Masraf merkezi
irsatsp_giristar date Hayır Giriş tarihi
irsatsp_cikistar date Hayır Çıkış tarihi
irsatsp_belgetar date Hayır Belge tarihi
irsatsp_var string Hayır Serbest alan 1
irsatsp_var2 string Hayır Serbest alan 2
irsatsp_var3 string Hayır Serbest alan 3
irsatsp_var4 string Hayır Serbest alan 4
irsatsp_var5 string Hayır Serbest alan 5
irsatsp_var6 string Hayır Serbest alan 6
irsatsp_iade boolean Hayır İade kalemi mi
irsatsp_iptal integer Hayır İptal kalemi (1=iptal)
irsatsp_depozitosira integer Hayır Depozito sıra numarası
irsatsp_koli string Hayır Koli bilgisi
irsatsp_temrintarihi date Hayır Termin tarihi
irsatsp_komisyon decimal Hayır Komisyon oranı

odemeler > odeme — Ödeme Satırı (tekrarlı liste)

Alan Tip Zorunlu Açıklama
od_tip string Evet Ödeme tipi
od_tutar decimal Evet Ödeme tutarı
od_tarih date Hayır Ödeme tarihi

XML Yapısı (satis parametresi)

<irsaliyeler>
  <irsaliye>
    <irsat_tarih>2024-06-01</irsat_tarih>
    <irsat_seribelgeno>I</irsat_seribelgeno>
    <irsat_belgeno>000001</irsat_belgeno>
    <irsat_carino>42</irsat_carino>           <!-- Cari ID -->
    <irsat_personel>5</irsat_personel>
    <irsat_sube>1</irsat_sube>
    <irsat_var1>DIS_IRSALIYE_NO</irsat_var1>
    <sepet>
      <kalem>
        <irsatsp_urunno>123</irsatsp_urunno> <!-- Ürün ID -->
        <irsatsp_adet>10</irsatsp_adet>
        <irsatsp_birim>ADET</irsatsp_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:importSalesReceiptXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <satis><![CDATA[
        <irsaliyeler>
          <irsaliye>
            <irsat_tarih>2024-06-01</irsat_tarih>
            <irsat_seribelgeno>I</irsat_seribelgeno>
            <irsat_belgeno>000001</irsat_belgeno>
            <irsat_carino>42</irsat_carino>
            <irsat_personel>5</irsat_personel>
            <sepet>
              <kalem>
                <irsatsp_urunno>123</irsatsp_urunno>
                <irsatsp_adet>10</irsatsp_adet>
                <irsatsp_birim>ADET</irsatsp_birim>
              </kalem>
            </sepet>
          </irsaliye>
        </irsaliyeler>
      ]]></satis>
    </tns:importSalesReceiptXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • Satış irsaliyesi malın fiili teslimatını belgeler; stok çıkış hareketi otomatik oluşturulur.
  • Dış sistem irsaliye numarasını irsat_var1–irsat_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