Bankovnictví - Přehled
Tento modul umožňuje komplexní správu bankovních účtů a transakcí v rámci AutoCRM systému. Zajišťuje automatické stahování výpisů z bank přes API, párování plateb s fakturami a notifikace o nových transakcích.
Klíčové funkcionality
Správa bank
- Evidence bank a jejich kontaktních údajů
- Podpora pro notifikace uživatelů a týmů
- Propojení s bankovními účty
Správa bankovních účtů
- Evidence domácích i zahraničních účtů
- Podpora pro IBAN a SWIFT kódy
- Napojení na bankovní API přes credentials
- Sledování aktuálního zůstatku
- Podporované banky:
- UniCredit
- ČSOB
- Česká spořitelna
- VÚB (Všeobecná úverová banka)
Bankovní transakce
- Automatické stahování transakcí z bank
- Evidence příchozích a odchozích plateb
- Podpora pro variabilní, konstantní a specifický symbol
- Kartové transakce (kreditní karty)
- Párování transakcí s fakturami:
- Vydané faktury (Invoice)
- Přijáté faktury (SupplierInvoice)
- Vydané zálohové faktury (ProformaInvoice)
- Přijáté zálohové faktury (ReceivedProformaInvoice)
Automatizace a notifikace
- Pravidelné stahování výpisů přes API
- E-mailové notifikace o nových transakcích
- Import transakcí z e-mailových výpisů
- Automatické párování plateb podle variabilního symbolu
- Označení transakcí bez nalezené faktury
Klíčové komponenty
Entity
- Bank - Banka (finanční instituce)
- BankAccount - Bankovní účet
- BankTransaction - Bankovní transakce
- Credentials - Přihlašovací údaje pro bankovní API:
- CeskaSporitelnaCredential
- CsobCredential
- UniCreditCredential
- VubCredential
Kontrolery
- Bank - Správa bank
- BankAccount - Správa bankovních účtů
- BankTransaction - Správa transakcí
Služby
- Bank - Business logika pro banky
- BankAccount - Logika pro účty a stahování transakcí
- BankTransaction - Logika pro transakce a párování faktur
Jobs (Naplánované úlohy)
- CleanupCsobExportFiles - Čištění dočasných exportních souborů
API
- Endpointy pro stahování transakcí
- Endpointy pro export dat
- Integrace s bankovními API
Integrace s ostatními moduly
Accounting (Účetnictví)
Modul Banking úzce spolupracuje s modulem Accounting:
- Párování bankovních transakcí s vydanými fakturami
- Propojení s přijatými fakturami od dodavatelů
- Sledování úhrad zálohových faktur
- Automatické označení faktur jako uhrazených
E-mail
- Import transakcí z e-mailových notifikací bank
- Propojení transakce se zdrojovým e-mailem
- Možnost zpracování výpisů zaslaných e-mailem
CRM entity
- Propojení s účty (Account) přes faktury
- Vazba na týmy (Team) pro notifikace
- Přiřazení uživatelů (User) k bankám a účtům
Technická architektura
Backend
- PHP 8.1+
- EspoCRM >= 7.2
- REST API endpointy
- Background jobs pro automatizaci
Frontend
- TypeScript/JavaScript
- Custom views a handlery
- Dynamické formuláře
- Real-time aktualizace
Databáze
- Entity s vazbami na faktury
- Indexy pro rychlé vyhledávání
- Optimalizované dotazy
Workflow
Proces stahování transakcí
- Bankovní účet má nastavené credentials pro bankovní API
- Naplánovaný job pravidelně stahuje nové transakce
- Transakce jsou automaticky importovány do systému
- Systém se pokusí spárovat transakce s fakturami podle VS
- Pokud je faktura nalezena, transakce se k ní připojí
- Pokud faktura není nalezena, transakce se označí
Proces notifikací
- Při nové transakci na bankovním účtu
- Systém zkontroluje nastavení banky
- Pokud jsou zapnuté notifikace, upozorní:
- Přiřazené uživatele
- Notifikační týmy
- E-mailovou adresu banky
Bezpečnost
- Credentials pro bankovní API jsou šifrovány
- Přístup k bankovním datům je řízen ACL
- Auditování změn na kritických entitách
- Bezpečné API komunikace s bankami
Rozšiřitelnost
Modul je navržen tak, aby bylo možné:
- Přidat podporu pro další banky
- Rozšířit párování transakcí o vlastní logiku
- Implementovat vlastní notifikační mechanismy
- Přidat další typy credentials
Poznámky k dokumentaci
Tato dokumentace pokrývá verzi 1.0.0 modulu Banking. Pro detailní informace o jednotlivých entitách, API endpointech a konfiguraci pokračujte v dalších sekcích dokumentace.