Ana içeriğe geç

importBuyingXML

Genel Bilgi

Özellik Değer
Endpoint Adı importBuyingXML
SOAPAction urn:WebticariService#importBuyingXML
Açıklama Alış faturalarını 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ış fatura 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_FATURA_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: - st_tarih, st_seribelgeno, st_belgeno - cr_kod (cari kodu) veya st_carino - st_var, st_var1, st_var2 - st_personel, st_sube

Konaklama Faturası Otomatik Tespiti

Sistem ayarında kvOtomotikIslem=E yapılandırılmışsa, alış faturasının açıklaması (st_aciklama) "tur" veya "esnaf" kelimelerini içermiyorsa belge türü otomatik olarak "KONAKLAMA FATURASI" olarak ayarlanır. Bu işlem dışsal kullanıcının müdahale etmesi gerekmez; sistem içsel bir yapılandırmadır.

Parametre Yapıları

alis — Alış Faturası

Alan Tip Zorunlu Açıklama
st_tarih date Evet Fatura tarihi
st_seribelgeno string Evet Seri belge numarası
st_belgeno string Evet Belge numarası
st_carino integer Evet Cari hesap numarası
cr_kod string Hayır Cari hesap kodu (carino yerine kullanılabilir)
st_var string Hayır Ek alan 1
st_var1 string Hayır Ek alan 2
st_var2 string Hayır Ek alan 3
st_personel integer Hayır Personel numarası
st_sube integer Hayır Şube numarası
st_belgeturu string Hayır Belge türü
st_aciklama string Hayır Açıklama
sepet liste Evet Fatura kalemleri → bkz. sepet > kalem
odemeler liste Hayır Ödeme bilgileri → bkz. odemeler > odeme
st_kur decimal Hayır Döviz kuru
st_doviz string Hayır Para birimi
st_carisube integer Hayır Cari şube numarası
st_ozelkod string Hayır Özel kod 1
st_ozelkod2 string Hayır Özel kod 2
st_ozelkod3 string Hayır Özel kod 3
st_altiskonto decimal Hayır Alt iskonto oranı
st_opsiyon date Hayır Opsiyon tarihi
st_odeme integer Hayır Ödeme şekli ID
st_aciklama1 string Hayır Açıklama 2
st_aciklama2 string Hayır Açıklama 3
st_aciklama3 string Hayır Açıklama 4
st_aciklama4 string Hayır Açıklama 5
st_muhonay string Hayır Muhasebe onay durumu
st_sevkiyat date Hayır Sevkiyat tarihi
st_satici integer Hayır Satıcı cari numarası
st_masrafmerkezi string Hayır Masraf merkezi
st_yazdirma string Hayır Yazdırma seçeneği
st_var3 string Hayır Ek alan 4
st_var4 string Hayır Ek alan 5
st_var5 string Hayır Ek alan 6
st_efatura boolean Hayır e-Fatura mi (E/H)

sepet > kalem — Fatura Kalemi (tekrarlı liste)

Alan Tip Zorunlu Açıklama
sp_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 (sp_urunno yerine)
ur_kod string Hayır Alternatif: stok kodu ile stok arama (sp_urunno yerine)
sp_urunkod string Hayır Ürün kodu
sp_urunadi string Hayır Ürün adı
sp_adet decimal Evet Miktar/adet
sp_birim string Hayır Birim
sp_fiyat decimal Evet Birim fiyat
sp_iskonto decimal Hayır İskonto oranı
sp_tutar decimal Hayır Toplam tutar
sp_kdv decimal Hayır KDV oranı
sp_maliyet decimal Hayır Maliyet
sp_otv decimal Hayır ÖTV oranı
sp_oiv decimal Hayır OİV oranı
sp_tax4 decimal Hayır Vergi 4
sp_iskonto2 decimal Hayır İskonto 2 oranı
sp_iskonto3 decimal Hayır İskonto 3 oranı
sp_iskonto4 decimal Hayır İskonto 4 oranı
sp_carpan decimal Hayır Birim çarpanı
sp_urunkur decimal Hayır Ürün döviz kuru
sp_fiyatkdvdahil boolean Hayır E ise fiyat KDV dahildir
sp_depo integer Hayır Depo numarası
sp_aciklama string Hayır Kalem açıklaması
sp_satici integer Hayır Satıcı
sp_opsiyon date Hayır Opsiyon tarihi
sp_siparisno integer Hayır Bağlı sipariş numarası
sp_proje string Hayır Proje kodu
sp_masrafmerkezi string Hayır Masraf merkezi
sp_giristar date Hayır Giriş tarihi
sp_cikistar date Hayır Çıkış tarihi
sp_belgetar date Hayır Belge tarihi
sp_var string Hayır Serbest alan 1
sp_var2 string Hayır Serbest alan 2
sp_var3 string Hayır Serbest alan 3
sp_var4 string Hayır Serbest alan 4
sp_var5 string Hayır Serbest alan 5
sp_var6 string Hayır Serbest alan 6
sp_iade boolean Hayır İade kalemi mi
sp_iptal string Hayır İptal kalemi (E/H)
sp_gecisid integer Hayır Dönüştürülen kaynak belge ID'si
sp_gecisyer string Hayır Dönüştürülen kaynak belge türü
sp_depozitosira integer Hayır Depozito sıra numarası
sp_temrintarihi date Hayır Termin tarihi
sp_tevkifat decimal Hayır Tevkifat 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ı (alis parametresi)

<alislar>
  <alis>
    <st_tarih>2024-06-01</st_tarih>
    <st_seribelgeno>A</st_seribelgeno>
    <st_belgeno>000001</st_belgeno>
    <st_carino>15</st_carino>              <!-- Tedarikçi cari ID -->
    <st_personel>5</st_personel>
    <st_sube>1</st_sube>
    <st_kur>1.00</st_kur>
    <st_doviz>TL</st_doviz>
    <st_aciklama>Hammadde alımı</st_aciklama>
    <st_var1>TEDARIKCI_FATURA_NO</st_var1>
    <sepet>
      <kalem>
        <sp_urunno>456</sp_urunno>         <!-- Ürün ID -->
        <sp_adet>100</sp_adet>
        <sp_fiyat>50.00</sp_fiyat>
        <sp_birim>KG</sp_birim>
        <sp_kdv>18</sp_kdv>
      </kalem>
    </sepet>
  </alis>
</alislar>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importBuyingXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <alis><![CDATA[
        <alislar>
          <alis>
            <st_tarih>2024-06-01</st_tarih>
            <st_seribelgeno>A</st_seribelgeno>
            <st_belgeno>000001</st_belgeno>
            <st_carino>15</st_carino>
            <st_personel>5</st_personel>
            <sepet>
              <kalem>
                <sp_urunno>456</sp_urunno>
                <sp_adet>100</sp_adet>
                <sp_fiyat>50.00</sp_fiyat>
                <sp_birim>KG</sp_birim>
              </kalem>
            </sepet>
          </alis>
        </alislar>
      ]]></alis>
    </tns:importBuyingXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • Alış faturası aktarıldığında stok giriş hareketleri otomatik oluşturulur.
  • Tedarikçinin sistemdeki cari kaydı mevcut olmalıdır; yoksa importCustomerXML ile önce tedarikçi ekleyin.
  • Dış sistem fatura numarasını st_var1–st_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 faturayı günceller