Ana içeriğe geç

importIncomeExpenseXML

Genel Bilgi

Özellik Değer
Endpoint Adı importIncomeExpenseXML
SOAPAction urn:WebticariService#importIncomeExpenseXML
Açıklama Gelir ve gider hareketlerini XML formatında sisteme içe aktarır. Cari dışı gelir-gider işlemlerini kaydetmek için kullanılır.
Kimlik Doğrulama Gerektirir Evet (token)

gelirGider XML Alanları (Gelir/Gider)

Alan Tip Zorunlu Açıklama
mas_islemid integer Evet Gelir/gider tanım ID (tbfaturalar.ft_no)
mas_izahat string Evet Kayıt yeri — KASA, BANKA veya CARİ
mas_tarih date Hayır İşlem tarihi (varsayılan: bugün)
mas_vadetarih date Hayır Vade tarihi (varsayılan: bugün)
mas_tutar decimal Evet İşlem tutarı
mas_aciklama string Hayır Açıklama
mas_parabirim string Hayır Para birimi (varsayılan: sistem para birimi)
mas_kur decimal Hayır Döviz kuru
mas_kullanici integer Hayır Kullanıcı / personel no
mas_muhonay string Hayır Muhasebe onay (E/H)
mas_sube integer Hayır Şube numarası
mas_masrafmerkezi string Hayır Masraf merkezi
mas_belgeno string Hayır Belge numarası
mas_proje string Hayır Proje kodu
kai_no integer Koşullu Kasa numarası — mas_izahat=KASA ise zorunlu
bn_id integer Koşullu Banka hesap ID — mas_izahat=BANKA ise zorunlu
cr_no integer Koşullu Cari hesap no — mas_izahat=CARİ ise zorunlu
ka_ozelkod string Hayır Kasa özel kod 1 (yalnızca mas_izahat=KASA)
ka_ozelkod2 string Hayır Kasa özel kod 2 (yalnızca mas_izahat=KASA)
ka_ozelkod3 string Hayır Kasa özel kod 3 (yalnızca mas_izahat=KASA)
bh_tutarkur decimal Hayır Banka para birimi kuru (yalnızca mas_izahat=BANKA)
dk_tutarkur decimal Hayır Cari para birimi kuru (yalnızca mas_izahat=CARİ)
dk_carisube integer Hayır Cari şube ID (yalnızca mas_izahat=CARİ)

Kontrol Alanları

Alan Adı Tip Açıklama
mas_izahat string Kayıt yeri: KASA, BANKA veya CARİ — işlem hangi hesaba gidecek?

İstek Parametreleri

Parametre Tip Zorunlu Açıklama
token xsd:string Evet login endpoint'inden alınan oturum token'ı
gelirgider xsd:string Evet Gelir/gider hareket verilerini içeren XML

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_KAYIT_ID</server_id>
    </transaction>
  </transferreds>
  <transposeds>
    <transaction>
      <errorno>-1</errorno>
      <errormessage>Hata açıklaması</errormessage>
    </transaction>
  </transposeds>
  <duplicates/>
</transactions>

Önemli: Bu endpoint mükerrer kontrolü yapmaz. Her gönderim yeni bir gelir/gider kaydı oluşturur. <duplicates> bölümü her zaman boş döner.

XML Yapısı

<gelirgiderler>
  <gelirgider>
    <mas_islemid>5</mas_islemid>           <!-- tbfaturalar.ft_no (gelir/gider tanım ID) -->
    <mas_izahat>KASA</mas_izahat>          <!-- KASA, BANKA veya CARİ -->
    <mas_tarih>2024-06-01</mas_tarih>
    <mas_tutar>1000.00</mas_tutar>
    <mas_aciklama>Kira geliri</mas_aciklama>
    <mas_parabirim>TL</mas_parabirim>
    <kai_no>1</kai_no>                     <!-- mas_izahat=KASA ise kasa numarası -->
  </gelirgider>
</gelirgiderler>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importIncomeExpenseXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <gelirgider><![CDATA[
        <gelirgiderler>
          <gelirgider>
            <mas_islemid>5</mas_islemid>
            <mas_izahat>KASA</mas_izahat>
            <mas_tarih>2024-06-01</mas_tarih>
            <mas_tutar>1000.00</mas_tutar>
            <mas_aciklama>Kira geliri</mas_aciklama>
            <mas_parabirim>TL</mas_parabirim>
            <kai_no>1</kai_no>
          </gelirgider>
        </gelirgiderler>
      ]]></gelirgider>
    </tns:importIncomeExpenseXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • Bu endpoint işletme defteri modülü için gelir/gider kayıtlarının aktarımında kullanılır.
  • mas_islemid, tbfaturalar tablosundaki gelir/gider tanım kaydının ft_no değeridir. Bu tanım gelir/gider türünü (gelir mi gider mi) belirler.
  • mas_izahat alanı kaydın hangi hesaba yapılacağını belirtir: KASA için kai_no, BANKA için bn_id, CARİ için cr_no alanı ek olarak gönderilmelidir.
  • Mükerrer kontrolü yoktur: Aynı veri tekrar gönderilirse yeni bir kayıt oluşturulur; bunu önlemek için dış sistemden kontrol edilmesi gerekir.
  • Token geçersizse yanıt Invalid Token string'i döner.