Přeskočit na hlavní obsah

Bank - Přehled

Entita Bank reprezentuje finanční instituci (banku), která spravuje bankovní účty. Je základním stavebním kamenem modulu Banking.

Účel entity​

Bank slouží k:

  • Evidence bank - Správa finančních institucí
  • Notifikace - Nastavení upozornění o nových transakcích
  • Kontakty - Uchování kontaktních údajů na banku
  • Organizace účtů - Seskupení bankovních účtů podle banky

Klíčové vlastnosti​

Základní informace​

  • Název a kód banky
  • Kontaktní údaje (telefon, e-mail, web)
  • Fakturační a doručovací adresa
  • Přiřazený uživatel a týmy

Notifikační systém​

  • Zapnutí/vypnutí notifikací
  • Seznam uživatelů pro upozornění
  • Notifikační týmy
  • E-mailová adresa pro notifikace

Vazby​

  • Bankovní účty - Všechny účty vedené u této banky
  • Transakce - Transakce, kde je banka proticstranou
  • Aktivity - CRM aktivity (schůzky, hovory, úkoly)

Kdy použít​

Běžné use cases​

  1. Přidání nové banky do systému

    • Při otevření účtu u nové banky
    • Pro evidenci bank, se kterými firma obchoduje

  2. Nastavení notifikací

    • Pro automatické upozornění na nové transakce
    • Pro monitoring plateb na důležitých účtech

  3. Organizace účtů

    • Pro přehlednou správu více účtů u jedné banky
    • Pro rychlé vyhledání všech účtů banky

Workflow​

Standardní postup​

1. Vytvoření banky
   ├─ Vyplnění základních údajů (název, kód)
   ├─ Doplnění kontaktů (volitelné)
   └─ Nastavení notifikací (volitelné)

2. Přidání bankovních účtů
   ├─ Vytvoření záznamů BankAccount
   ├─ Propojení s bankou
   └─ Nastavení API přístupu

3. Aktivní používání
   ├─ Stahování transakcí
   ├─ Notifikace o nových platbách
   └─ Monitoring aktivit

Vztah k ostatním entitám​

BankAccount (Bankovní účet)​

  • Vztah: One-to-Many (jedna banka má více účtů)
  • Povinnost: Bank musí existovat před vytvořením BankAccount
  • Použití: Každý účet patří právě jedné bance

BankTransaction (Bankovní transakce)​

  • Vztah: One-to-Many (jedna banka může být u mnoha transakcí)
  • Role: Bank je protistranou (counterBank) transakce
  • Použití: Identifikuje banku odesílatele/příjemce platby

User (Uživatel)​

  • Vztah: Many-to-Many (banka může mít více uživatelů)
  • Použití: Uživatelé pro notifikace o transakcích

Team (Tým)​

  • Vztah: Many-to-Many
  • Použití:
    • Týmy s přístupem k bance
    • Notifikační týmy

Konfigurace​

Povinná pole​

  • name - Název banky (varchar, required)

Doporučená pole​

  • code - Kód banky (varchar, 11 znaků)
  • usesApi - Zda banka podporuje API (bool)

Volitelná pole​

  • website - Webové stránky banky
  • emailAddress - Kontaktní e-mail
  • phoneNumber - Telefon
  • billingAddress - Fakturační adresa
  • shippingAddress - Doručovací adresa

Notifikace​

  • enableAlertUsers - Zapnout notifikace (bool, default: false)
  • users - Uživatelé pro notifikace
  • notificationTeams - Týmy pro notifikace
  • notificationEmailAddress - E-mail pro notifikace

Integrace​

CRM moduly​

  • Activities - Podporuje schůzky, hovory a úkoly
  • Teams - Týmové oprávnění a notifikace
  • Users - Přiřazení a notifikace uživatelů

Banking moduly​

  • BankAccount - Správa účtů
  • BankTransaction - Sledování transakcí
  • Credentials - Nepřímé propojení přes účty

Best practices​

Pojmenování​

  • Používejte oficiální názvy bank včetně právní formy
  • Příklad: "Česká spořitelna, a.s." místo "ČS"

Kód banky​

  • Vždy vyplňte kód banky pro české a slovenské banky
  • Kód je důležitý pro automatické rozpoznávání transakcí

Notifikace​

  • Zapněte notifikace pouze pro důležité banky
  • Používejte týmy místo jednotlivých uživatelů
  • Nastavte e-mailovou adresu pro zálohu

Údržba​

  • Pravidelně aktualizujte kontaktní údaje
  • Kontrolujte, zda jsou notifikace aktuální
  • Neaktivní banky označte v popisu

Příklady​

Příklad 1: Hlavní banka firmy​

{
  "name": "Česká spořitelna, a.s.",
  "code": "0800",
  "website": "https://www.csas.cz",
  "usesApi": true,
  "enableAlertUsers": true,
  "notificationTeams": ["Finance", "Accounting"]
}

Příklad 2: Banka dodavatele​

{
  "name": "Komerční banka, a.s.",
  "code": "0100",
  "usesApi": false,
  "enableAlertUsers": false
}

Omezení a poznámky​

  • Banku nelze smazat, pokud má přiřazené bankovní účty
  • Smazané záznamy jsou soft-delete (deleted flag)
  • Přístup k bance je řízen ACL a týmy
  • Historie změn je auditována

Další kroky​

Po vytvoření banky:

  1. Vytvořte bankovní účet
  2. Nastavte API přístup
  3. Začněte stahovat transakce