importBankTransferXML

Genel Bilgi

Özellik	Değer
Endpoint Adı	importBankTransferXML
SOAPAction	urn:WebticariService#importBankTransferXML
Açıklama	Banka havale ve EFT işlemlerini XML formatında sisteme içe aktarır.
Kimlik Doğrulama Gerektirir	Evet (token)

havale XML Alanları (Banka Havalesi)

Alan	Tip	Zorunlu	Açıklama
bh_carino	integer	Evet	Cari hesap numarası
cr_kod	string	Hayır	Cari hesap kodu (carino yerine kullanılabilir)
bh_tarih	date	Evet	Havale tarihi
bh_bnid	integer	Evet	Banka hesap ID
tutarodeme	decimal	Evet	Ödeme tutarı
bh_var1	string	Hayır	Ek alan 1
bh_var2	string	Hayır	Ek alan 2
bh_var3	string	Hayır	Ek alan 3
bh_carisube	integer	Hayır	Cari şube ID
bh_tur	string	Hayır	Hareket türü (varsayılan: "Havale Tahsilat"/"Havale Tediye")
bh_aciklama	string	Hayır	Açıklama
bh_tutarkur	decimal	Hayır	Banka para birimi kuru
bh_tutarodemekur	decimal	Hayır	Cari para birimi kuru
tutarodemebirim	string	Hayır	Ödeme para birimi (varsayılan: cari para birimi)
tutarodemekur	decimal	Hayır	Ödeme kuru
bh_evrakno	string	Hayır	Evrak numarası
bh_islemno	string	Hayır	İşlem numarası
bh_muhonay	string	Hayır	Muhasebe onay (E/H)
bh_belgeturu	string	Hayır	Belge türü
bh_sube	integer	Hayır	Şube numarası (varsayılan: oturum şubesi)
personel	integer	Hayır	Personel numarası (varsayılan: oturum personeli)
kasa	integer	Hayır	Kasa numarası (varsayılan: oturum kasası)
kai_kod	string	Hayır	Kasa kodu (kasa yerine kullanılabilir)
bn_hesapkodu	string	Hayır	Banka hesap kodu (bh_bnid yerine kullanılabilir)
bn_hesapadi	string	Hayır	Banka hesap adı (bh_bnid yerine kullanılabilir)
bh_caribankaid	integer	Hayır	Cari banka ID
proje	string	Hayır	Proje kodu

Kontrol Alanları

Alan Adı	Tip	Açıklama
islemtipi	string	Tahsilat=banka girişi (tbodeme), Odeme=banka çıkışı (tbborc)

---

İstek Parametreleri

Parametre	Tip	Zorunlu	Açıklama
token	xsd:string	Evet	login endpoint'inden alınan oturum token'ı
islemtipi	xsd:string	Evet	İşlem tipi (örn. havale, eft)
havale	xsd:string	Evet	Banka havale işlem 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_HAVALE_NO</server_id>
    </transaction>
  </transferreds>
  <transposeds>...</transposeds>
  <duplicates>
    <transaction>
    </transaction>
  </duplicates>
</transactions>

---

Mükerrer Kayıt Tespiti

Aşağıdaki alanların kombinasyonuna göre kapsamlı mükerrer kontrolü yapılır: - bh_bnid (banka hesap ID) - tutarodeme (ödeme tutarı) - bh_tarih (işlem tarihi) - cr_kod (cari kodu) - bh_var1, bh_var2, bh_var3

---

XML Yapısı

<havaleler>
  <havale>
    <bh_tarih>2024-06-01</bh_tarih>
    <bh_carino>42</bh_carino>              <!-- Cari ID -->
    <tutarodeme>2500.00</tutarodeme>       <!-- Ödeme tutarı -->
    <bh_bnid>3</bh_bnid>                  <!-- Banka hesap ID -->
    <bh_aciklama>Havale açıklaması</bh_aciklama>
    <bh_var1>DIS_HAVALE_ID</bh_var1>
  </havale>
</havaleler>

---

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importBankTransferXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <islemtipi>havale</islemtipi>
      <havale><![CDATA[
        <havaleler>
          <havale>
            <bh_tarih>2024-06-01</bh_tarih>
            <bh_carino>42</bh_carino>
            <tutarodeme>2500.00</tutarodeme>
            <bh_bnid>3</bh_bnid>
            <bh_var1>BANKA_DEKONT_14001</bh_var1>
          </havale>
        </havaleler>
      ]]></havale>
    </tns:importBankTransferXML>
  </soapenv:Body>
</soapenv:Envelope>

---

Notlar

• islemtipi parametresi işlemin tipini belirtir (havale, eft, tahsilat vb.).
• Banka hesap ID (bh_bnid) sistemde tanımlı banka hesabının ID'sidir.
• Dış sistem referansını bh_var1–bh_var3 alanlarında saklamak mükerrer tespiti için kullanışlıdır.
• Token geçersizse yanıt Invalid Token string'i döner.