Ana içeriğe atla
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.
  • BankAccountName: 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.
Kurların hepsi entegratörden gelir: her satırın ExchangeRate’i ve fişin ExchangeRate’i (aşağıda). Tutarlar (satır Amount) da entegratörden gelir; API hiçbirini hesaplamaz ya da 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

Fiş seviyesindeki ExchangeRate sizin göndereceğiniz bir alandır (0’dan büyük olmalı, gönderilmezse 1). Noyax uygulaması burada satırların tutar ağırlıklı ortalama kurunu kullanır:
API bu değeri hesaplamaz, gönderdiğiniz gibi kaydeder.

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, işlem reddedilir (8207);
  • için bir ödeme planı oluşturulmuşsa, ö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).