Skip to main content
Banka havale fişi, bir banka hesabından gelen ya da giden parayı bir ya da daha fazla cariye yansıtır. Gelen (TransferType 1) ve giden (TransferType 2) havale aynı endpoint’leri kullanır.

​
Zorunlu alanlar

  • TransferType: 1 gelen, 2 giden. Fiş oluşturulduktan sonra değiştirilemez.
  • VoucherNumber: şirkette bütün banka fişi tipleri arasında (yalnızca havale değil) benzersiz, en fazla 20 karakter. "Next" gönderilirse "BANKAFİŞNO" serisinden otomatik üretilir. Güncellemede "Next" gönderilemez.
  • Date: fiş tarihi. Saat de gönderilirse fiş saati olarak yazılır, gönderilmezse o anki saat kullanılır.
  • BankAccountCode: banka hesaplarından biri. Fişteki bütün satırlar bu hesaba yazılır.
  • Lines: en az bir satır.
Description ve SharingCode isteğe bağlıdır; SharingCode boşsa fiş herkese açık, doluysa kullanıcının paylaşım kodlarından biri olmalıdır.
Diğer modüllerden farklı olarak kur değeri entegratörden gelen bir alan üzerinden API tarafından hesaplanır: her satırın kendi ExchangeRate’i verilir, fişin kur değeri satırların tutar ağırlıklı ortalamasıdır (aşağıda). Tutarların kendisi (satır Amount) yine entegratörden gelir ve API bunu değiştirmez.

​
Satırlar

Her satır bir cariye yapılan/cariden gelen tutarı taşır:
  • CustomerCode: zorunlu, görülebilen bir cari.
  • Amount: zorunlu, banka hesabının kendi dövizinde, 0’dan büyük olmalı.
  • ExchangeRate: banka hesabının dövizi şirketin varsayılan dövizinden farklıysa zorunlu (ve 0’dan büyük olmalı); aynıysa gönderilmese de 1 kabul edilir.
  • Description: isteğe bağlı, satıra özel açıklama.

​
Fişin kur değeri

Yanıttaki ExchangeRate (fiş seviyesinde), satırların tutar ağırlıklı ortalamasıdır:
6 ondalık hassasiyetle hesaplanır ve kaydedilir.

​
Cari hareket farkı

Varsayılan olarak carinin kendi hesabına, satırdakiyle aynı tutar/döviz/kur ile ters yönde (borç/alacak) bir kayıt düşülür. İsterseniz bunu CustomerAmount, CustomerCurrencyCode ve CustomerExchangeRate ile farklı bir dövizde/kurda yansıtabilirsiniz — üçü birlikte gönderilir (biri gönderilip diğerleri boş bırakılamaz). Tek şart: iki tarafın da varsayılan dövizdeki karşılığı eşit olmalıdır:

​
Güncellemede satırın kimliği

İrsaliye satırlarıyla aynı mantık geçerlidir: bir satırın cari hareketi, kapatılmış hareket ve ödeme planı kontrolleri tarafından referans verilir. İstekteki satır sırası, güncellemede satırın kimliğini belirler: i. sıradaki satır, mevcut i. sıradaki satırla aynı kabul edilir ve yerinde güncellenir; daha kısa bir liste sondaki satırları kaldırır, daha uzun bir liste sona yeni satırlar ekler.

​
Kapatılmış hareket ve ödeme planı kilidi

Bir satırın carisi, tutarı, dövizi ya da kuru değişmiyorsa kilit yoktur. Değişiyorsa ve o satırın mevcut cari hareketi:
  • bir tahsilat/ödeme ile kapatılmışsa (CST_FIN_CARI_BORC_ALACAK_KARSILIKLARI), işlem reddedilir (8207);
  • için bir ödeme planı oluşturulmuşsa (CST_FIN_TAHSILAT_VE_ODEME_PLANLARI), önce planın silinmesi istenir (8208).
Silme (DELETE) aynı iki kontrolü her satır için koşulsuz uygular (satır kaldırılmış sayılır); herhangi bir satır takılırsa fişin tamamı silinmez.

​
Muhasebeleşmiş fiş

IsPosted true ise (muhasebe fişine bağlanmışsa) fiş güncellenemez ve silinemez (8109).