Přeskočit na hlavní obsah

Entita Banka (Bank)

Entita Bank reprezentuje finanční instituci (banku), která spravuje bankovní účty. Uchovává informace o bance, kontaktní údaje, nastavení notifikací a vazby na bankovní účty.

Klíčové atributy​

Základní informace​

  • Název (name): Název banky (povinné)
  • Popis (description): Textový popis banky
  • Kód banky (code): Kód banky (max 11 znaků)
  • Používá API (usesApi): Indikátor, zda banka podporuje API

Kontaktní údaje​

  • Webové stránky (website): URL adresa webu banky
  • E-mail (emailAddress): E-mailová adresa banky
  • Telefon (phoneNumber): Telefonní číslo banky (typy: Office, Mobile, Fax, Other)

Adresa​

  • Fakturační adresa (billingAddress): Kompletní fakturační adresa banky
    • billingAddressStreet - Ulice
    • billingAddressCity - Město
    • billingAddressState - Stát/Kraj
    • billingAddressCountry - Země
    • billingAddressPostalCode - PSČ
  • Doručovací adresa (shippingAddress): Kompletní doručovací adresa
    • shippingAddressStreet - Ulice
    • shippingAddressCity - Město
    • shippingAddressState - Stát/Kraj
    • shippingAddressCountry - Země
    • shippingAddressPostalCode - PSČ

Notifikace​

  • Upozornit uživatele (enableAlertUsers): Zapnutí/vypnutí notifikací (bool, default: false)
  • Uživatelé (users): Seznam uživatelů, kteří mají být upozorněni
  • Notifikační týmy (notificationTeams): Týmy, které mají být upozorněny
  • Notifikační e-mail (notificationEmailAddress): E-mailová adresa pro notifikace

Systémová pole​

  • Vytvořeno (createdAt): Datum a čas vytvoření (readonly)
  • Upraveno (modifiedAt): Datum a čas poslední úpravy (readonly)
  • Vytvořil (createdBy): Uživatel, který záznam vytvořil (readonly)
  • Upravil (modifiedBy): Uživatel, který záznam naposledy upravil (readonly)
  • Přiřazeno (assignedUser): Přiřazený uživatel
  • Týmy (teams): Týmy s přístupem k záznamu

Vztahy​

  • Bankovní účty (bankAccounts): Seznam bankovních účtů vedených v této bance
  • Bankovní transakce (bankTransactions): Seznam transakcí, kde je tato banka protistranou

Technické informace​

Backend​

Třída entity​

  • Cesta: Espo\Modules\Banking\Entities\Bank
  • Namespace: Espo\Modules\Banking\Entities
  • Konstanta: ENTITY_TYPE = 'Bank'

Definice entity​

Soubor: backend/Resources/metadata/entityDefs/Bank.json

Klíčová pole:

{
  "name": {
    "type": "varchar",
    "required": true,
    "trim": true
  },
  "code": {
    "type": "varchar",
    "maxLength": 11,
    "trim": true
  },
  "usesApi": {
    "notNull": true,
    "type": "bool"
  },
  "enableAlertUsers": {
    "notNull": true,
    "type": "bool",
    "default": false
  }
}

Vazby (links):

  • bankAccounts: hasMany → BankAccount (foreign: 'bank')
  • bankTransactions: hasMany → BankTransaction (foreign: 'counterBank')
  • users: hasMany → User (foreign: 'banks')
  • notificationTeams: hasMany → Team (foreign: 'banks')
  • createdBy: belongsTo → User
  • modifiedBy: belongsTo → User
  • assignedUser: belongsTo → User
  • teams: hasMany → Team

Indexy:

  • name: columns: [name, deleted]
  • assignedUser: columns: [assignedUserId, deleted]

Kolekce:

  • Výchozí řazení: createdAt DESC

Frontend​

Překlady (cs_CZ)​

Soubor: backend/Resources/i18n/cs_CZ/Bank.json

{
  "labels": {
    "Create Bank": "Vytvořit Banka",
    "Settings": "Nastavení"
  },
  "fields": {
    "bankAccounts": "Bankovní účty",
    "bankTransactions": "Bankovní transakce",
    "website": "Webové stránky",
    "usesApi": "Používá API",
    "enableAlertUsers": "Upozornit uživatele",
    "notificationTeams": "Tými které budou upozorněny"
  }
}

Použití​

Vytvoření banky​

Banka se vytváří standardně přes uživatelské rozhraní nebo API. Při vytváření je nutné vyplnit:

  • Název banky (povinné)
  • Kód banky (volitelné, ale doporučené)
  • Kontaktní údaje (volitelné)
  • Nastavení notifikací (volitelné)

Notifikace​

Pokud je u banky zaškrtnuto pole enableAlertUsers, systém bude při nových transakcích upozorňovat:

  1. Uživatele v poli users
  2. Všechny členy týmů v poli notificationTeams
  3. E-mailovou adresu v poli notificationEmailAddress

Vazba na bankovní účty​

Každý bankovní účet (BankAccount) musí být přiřazen k bance. Vazba je typu belongsTo, což znamená, že jeden účet patří právě jedné bance.

Vazba na transakce​

Bank může být proticstranou (counterBank) u bankovních transakcí. To znamená, že systém eviduje, která banka odeslala/přijala platbu.

Doporučené postupy​

  1. Vyplňte kód banky: Kód banky je důležitý pro automatické párování transakcí
  2. Nastavte notifikace: Pro důležité banky zapněte notifikace a přiřaďte relevantní uživatele/týmy
  3. Používejte konzistentní názvy: Názvy bank by měly odpovídat oficiálním názvům finančních institucí
  4. Vyplňte kontaktní údaje: Usnadní to komunikaci a řešení problémů

Příklady​

Příklad nastavení pro Českou spořitelnu​

Název: Česká spořitelna, a.s.
Kód: 0800
Webové stránky: https://www.csas.cz
Používá API: ✓
Upozornit uživatele: ✓
Notifikační týmy: [Finance, Accounting]

Příklad nastavení pro UniCredit​

Název: UniCredit Bank Czech Republic and Slovakia, a.s.
Kód: 2700
Webové stránky: https://www.unicreditbank.cz
Používá API: ✓

Poznámky​

  • Entita Bank podporuje standardní CRM aktivity (Meetings, Calls, Tasks)
  • Záznamy jsou auditovány (sledují se změny)
  • Přístup k záznamům je řízen ACL a týmy
  • Smazané záznamy jsou soft-delete (deleted flag)