Ana içeriğe geç

importSellingXML

Genel Bilgi

Özellik Değer
Endpoint Adı importSellingXML
SOAPAction urn:WebticariService#importSellingXML
Açıklama Satış 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'ı
satis xsd:string Evet Satış 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

Sistem aşağıdaki alanların kombinasyonuna göre mükerrer kontrolü yapar: - st_tarih, st_seribelgeno, st_belgeno - cr_kod (cari kodu) veya st_carino - st_var, st_var1, st_var2 - st_personel, st_sube

B2C Entegrasyon Tetiklemesi

Satış faturası başarıyla kaydedildikten sonra sistem, faturadaki ürün ID'leri için B2C/e-ticaret platformu senkronizasyonunu otomatik tetikler. Bu sayede stok güncellemeleri entegre e-ticaret kanallarına yansır.

Parametre Yapıları

satis — Satış 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ü
sepet liste Evet Fatura kalemleri → bkz. sepet > kalem
odemeler liste Hayır Ödeme bilgileri → bkz. odemeler > odeme
efatura nesne Hayır e-Fatura durum bilgisi → bkz. efatura > efaturadurum
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_aciklama string Hayır Açıklama
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)
st_earsiv boolean Hayır e-Arşiv mi (E/H)
st_uuid string Hayır e-Fatura UUID
st_sablonkodu string Hayır e-Fatura şablon kodu
st_gelirvergisistopaj decimal Hayır Gelir vergisi stopajı
st_iptal string Hayır İptal durumu (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_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_koli string Hayır Koli bilgisi
sp_temrintarihi date Hayır Termin tarihi
sp_komisyon decimal Hayır Komisyon oranı
sp_kdvistisna_kodu string Hayır KDV istisna kodu
sp_kdvistisna_aciklama string Hayır KDV istisna açıklaması
sp_teslimsarti string Hayır Teslim şartı
sp_gtipno string Hayır GTİP numarası
sp_gonderilmesekli string Hayır Gönderilme şekli
sp_siniflandirmatipi string Hayır Sınıflandırma tipi
sp_siniflandirmakodu string Hayır Sınıflandırma kodu
sp_kapdeger decimal Hayır KAP değeri
sp_tevkifat decimal Hayır Tevkifat oranı
sp_tevkifatkod string Hayır Tevkifat kodu

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

efatura > efaturadurum — e-Fatura Durum Bilgisi

Sadece st_efatura='E' veya st_earsiv='E' olan faturalar için geçerlidir.

Alan Tip Zorunlu Açıklama
efd_durumkodu integer Evet e-Fatura durum kodu
efd_entdurumkodu string Hayır Entegratör durum kodu
efd_entegratorid integer Hayır Entegratör ID
efd_entegreturu integer Hayır Entegrasyon türü
efd_guid string Hayır GUID değeri
efd_uuid string Hayır e-Fatura UUID (ETTN)
efd_mesaj string Hayır Durum mesajı
efd_tarih datetime Hayır Durum tarihi
efd_iptal string Hayır İptal durumu (E/H)
efd_iptalentkod string Hayır İptal entegratör kodu
efd_iptalaciklama string Hayır İptal açıklaması
efd_iptaltarih datetime Hayır İptal tarihi

XML Yapısı (satis parametresi)

<satislar>
  <satis>
    <st_tarih>2024-06-01</st_tarih>
    <st_seribelgeno>F</st_seribelgeno>
    <st_belgeno>000001</st_belgeno>
    <st_carino>42</st_carino>              <!-- Cari ID (zorunlu) -->
    <st_personel>5</st_personel>
    <st_sube>1</st_sube>
    <st_kur>1.00</st_kur>                  <!-- Döviz kuru -->
    <st_doviz>TL</st_doviz>
    <st_var1>DIS_FATURA_NO</st_var1>
    <sepet>
      <kalem>
        <sp_urunno>123</sp_urunno>         <!-- Ürün ID -->
        <sp_adet>5</sp_adet>
        <sp_fiyat>100.00</sp_fiyat>
        <sp_birim>ADET</sp_birim>
        <sp_iskonto>0</sp_iskonto>          <!-- İskonto (%) -->
        <sp_kdv>18</sp_kdv>                 <!-- KDV oranı -->
      </kalem>
    </sepet>
  </satis>
</satislar>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importSellingXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <satis><![CDATA[
        <satislar>
          <satis>
            <st_tarih>2024-06-01</st_tarih>
            <st_seribelgeno>F</st_seribelgeno>
            <st_belgeno>000001</st_belgeno>
            <st_carino>42</st_carino>
            <st_personel>5</st_personel>
            <st_kur>1.00</st_kur>
            <st_doviz>TL</st_doviz>
            <sepet>
              <kalem>
                <sp_urunno>123</sp_urunno>
                <sp_adet>5</sp_adet>
                <sp_fiyat>100.00</sp_fiyat>
                <sp_birim>ADET</sp_birim>
              </kalem>
            </sepet>
          </satis>
        </satislar>
      ]]></satis>
    </tns:importSellingXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • Satış faturası aktarıldığında stok çıkış hareketleri otomatik oluşturulur.
  • Fatura kaydedilince B2C e-ticaret entegrasyonu tetiklenir (etkilenen ürünlerin stok bilgisi güncellenir).
  • 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