importAccountingVoucherXML

Genel Bilgi

Özellik	Değer
Endpoint Adı	importAccountingVoucherXML
SOAPAction	urn:WebticariService#importAccountingVoucherXML
Açıklama	Muhasebe fişlerini XML formatında sisteme içe aktarır. Yevmiye fişleri, mahsup fişleri ve diğer muhasebe belgelerini 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'ı
fisler	xsd:string	Evet	Muhasebe fişi 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_FIS_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

Muhasebe fişi mükerrer tespiti sadece dış referans alanlarına göre yapılır: - fis_var1, fis_var2, fis_var3, fis_var4, fis_var5, fis_var6

Dış sistem fis numarasını bu alanlara yazarak mükerrer fiş oluşmasını engelleyebilirsiniz.

---

Parametre Yapıları

fis — Muhasebe Fişi

Alan	Tip	Zorunlu	Açıklama
fis_tarih	date	Hayır	Fiş tarihi (varsayılan: bugün)
fis_yevmiyeno	string	Hayır	Yevmiye numarası
fis_fisno	string	Hayır	Fiş numarası
fis_ozelkod	string	Hayır	Özel kod 1
fis_ozelkod2	string	Hayır	Özel kod 2
fis_aciklama	string	Hayır	Açıklama
fis_izahat	string	Hayır	Fiş tipi — Mahsup, Tahsil, Tediye, Açılış, Kapanış veya Özel (varsayılan: Mahsup)
fis_iptal	boolean	Hayır	İptal durumu (E/H)
fis_yetkiseviye	string	Hayır	Yetki seviyesi
fis_sube	integer	Hayır	Şube numarası
fis_var1	string	Hayır	Ek alan 1 (mükerrer kontrol)
fis_var2	string	Hayır	Ek alan 2 (mükerrer kontrol)
fis_var3	string	Hayır	Ek alan 3 (mükerrer kontrol)
fis_var4	string	Hayır	Ek alan 4 (mükerrer kontrol)
fis_var5	string	Hayır	Ek alan 5 (mükerrer kontrol)
fis_var6	string	Hayır	Ek alan 6 (mükerrer kontrol)
hareketler	liste	Evet	Muhasebe satırları → bkz. hareketler > hareket

hareketler > hareket — Muhasebe Satırı (tekrarlı liste)

Alan	Tip	Zorunlu	Açıklama
fishk_hesapid	integer	Hayır	Muhasebe hesap ID (hspl_kod yerine kullanılabilir)
hspl_kod	string	Hayır	Muhasebe hesap kodu (fishk_hesapid yerine kullanılabilir)
fishk_belgeno	string	Hayır	Belge numarası
fishk_aciklama	string	Hayır	Satır açıklaması
fishk_borc	decimal	Hayır	Borç tutarı (TL)
fishk_alacak	decimal	Hayır	Alacak tutarı (TL)
fishk_dovizborc	decimal	Hayır	Döviz borç tutarı
fishk_dovizalacak	decimal	Hayır	Döviz alacak tutarı
fishk_dovizparabirimi	string	Hayır	Döviz para birimi kodu
fishk_dovizkur	decimal	Hayır	Döviz kuru
fishk_cari	integer	Hayır	Cari hesap numarası
fishk_miktar	decimal	Hayır	Miktar
fishk_onay	boolean	Hayır	Onay durumu (E/H)
fishk_tarih	date	Hayır	Hareket tarihi
fishk_opsiyon	string	Hayır	Opsiyon
fishk_masrafmerkezi	string	Hayır	Masraf merkezi
fishk_belgeturu	string	Hayır	Belge türü
fishk_odemeturu	string	Hayır	Ödeme türü
fishk_var1	string	Hayır	Ek alan 1
fishk_var2	string	Hayır	Ek alan 2
fishk_var3	string	Hayır	Ek alan 3
fishk_var4	string	Hayır	Ek alan 4
fishk_var5	string	Hayır	Ek alan 5
fishk_var6	string	Hayır	Ek alan 6

Kontrol Alanları

Alan Adı	Tip	Açıklama
fis_iptal	string	H=aktif, E=iptal fişi
fis_izahat	string	Fiş tipi: Mahsup, Tahsil, Tediye, Açılış, Kapanış, Özel

---

XML Yapısı (fisler parametresi)

<fisler>
  <fis>
    <fis_tarih>2024-06-01</fis_tarih>
    <fis_izahat>Mahsup</fis_izahat>        <!-- Mahsup, Tahsil, Tediye, Açılış, Kapanış, Özel -->
    <fis_aciklama>Aylık kapanış fişi</fis_aciklama>
    <fis_var1>DIS_MUHASEBE_FIS_NO</fis_var1>
    <hareketler>
      <hareket>
        <fishk_hesapid>1</fishk_hesapid>   <!-- hspl_kod yerine kullanılabilir -->
        <fishk_borc>1000.00</fishk_borc>
        <fishk_alacak>0</fishk_alacak>
        <fishk_aciklama>Kasa girişi</fishk_aciklama>
      </hareket>
      <hareket>
        <hspl_kod>120</hspl_kod>           <!-- fishk_hesapid yerine kullanılabilir -->
        <fishk_borc>0</fishk_borc>
        <fishk_alacak>1000.00</fishk_alacak>
        <fishk_aciklama>Alacak kaydı</fishk_aciklama>
      </hareket>
    </hareketler>
  </fis>
</fisler>

---

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importAccountingVoucherXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <fisler><![CDATA[
        <fisler>
          <fis>
            <fis_tarih>2024-06-01</fis_tarih>
            <fis_izahat>Mahsup</fis_izahat>
            <fis_aciklama>Muhasebe fişi</fis_aciklama>
            <fis_var1>MUHASEBE_FIS_16001</fis_var1>
            <hareketler>
              <hareket>
                <fishk_hesapid>1</fishk_hesapid>
                <fishk_borc>1000.00</fishk_borc>
                <fishk_alacak>0</fishk_alacak>
              </hareket>
              <hareket>
                <fishk_hesapid>2</fishk_hesapid>
                <fishk_borc>0</fishk_borc>
                <fishk_alacak>1000.00</fishk_alacak>
              </hareket>
            </hareketler>
          </fis>
        </fisler>
      ]]></fisler>
    </tns:importAccountingVoucherXML>
  </soapenv:Body>
</soapenv:Envelope>

---

Notlar

• Her fiş satırında borç veya alacak taraf belirtilmelidir; fiş özet toplamında borç = alacak olmalıdır.
• Mükerrer tespiti sadece fis_var1–fis_var6 alanlarına göre yapılır; bu alanlara dış sistem fiş numarası yazılarak mükerrer önlenebilir.
• Hesap planı kodları Webticari'deki hesap tablosuyla eşleşmelidir.
• Token geçersizse yanıt Invalid Token string'i döner.