23. Banka — import výpisů a párování plateb

Místo ručního označování faktur jako zaplacených, naimportuj GPC výpis z banky a systém automaticky spáruje platby s fakturami podle variabilního symbolu a částky.

GPC (ABO) je standardní český formát pro elektronickou výměnu výpisů. Umí ho exportovat: KB, Fio Bank, ČSOB, Raiffeisenbank, Česká spořitelna, mBank, a další.

23.1 Stažení GPC výpisu z banky

Postup je v každé bance trochu jiný:

Stáhni soubor (typicky .gpc nebo .abo, někdy .txt). Velikost ~10–100 KB na měsíc obvykle.

23.2 Upload výpisu do MyInvoice

V hlavním menu Banka → Nahrát výpis.

Vyber soubor (drag & drop nebo klik). Po nahrání:

1. Hash kontrola (SHA-256) — pokud je stejný soubor už importovaný, hláška „Tento výpis už byl importovaný" + zrušení.
2. Validace bankovního účtu — server zkontroluje, že číslo účtu z hlavičky výpisu patří některé z měn aktuálního dodavatele.
3. Parsing transakcí — přečte všechny řádky.
4. Auto-matching — pro každou kreditní transakci s VS hledá fakturu se shodným varsymbolem a sumou v rozmezí ± 0,01 (tolerance haléře).
5. Update faktur — spárované faktury → status paid, paid_at = transakce.datum_zaúčtování.

Hláška o výsledku:

Importováno: 12 transakcí, spárováno: 8, k manuálnímu párování: 4.

23.3 Seznam výpisů

Banka → Výpisy ukáže historii.

23.4 Detail výpisu

Klik na řádek → detail.

Tabulka transakcí:

23.4.1 Manuální párování

Pro transakce, které se nespárovaly automaticky (typicky chybí VS, nebo částka nesedí kvůli částečné platbě, devizovému kurzu, bankovnímu poplatku):

1. Klik Spárovat → otevře se modal s vyhledávačem.
2. Najdeš fakturu (číslo / klient / částka).
3. Vyber a potvrď.

Faktura → status paid, paid_at = datum transakce. Activity log: bank.matched_manual.

23.4.2 Ignorovat transakci

Pro transakce, které nejsou platby faktur (poplatky, převody mezi vlastními účty, refundace, …):

1. Klik Ignorovat.
2. Status → Ignorováno. Pro reporting se nepočítá.

23.4.3 Vytvoření přijaté faktury z výpisu (doklad o úhradě)

U odchozí (záporné) platby, ke které ještě nemáš v systému přijatou fakturu, můžeš rovnou založit její koncept přímo z výpisu:

1. Detail výpisu → najdi odchozí transakci → klik Vytvořit fakturu.
2. Vyber existujícího dodavatele (nebo klik Nový dodavatel a založ ho). Dodavatel se nezakládá automaticky — musíš ho potvrdit.
3. Potvrď → vznikne koncept přijaté faktury v hrubé částce platby (1 položka, 0 % DPH) a rovnou se otevře v editoru.
4. V editoru doplň rozpad DPH, skutečné číslo dokladu a nahraj PDF.

Variabilní symbol z platby se předvyplní do pole VS; číslo dokladu dostane dočasný placeholder BANK-{id} (přepiš ho na reálné číslo z faktury). Platba se zároveň spáruje na nově vzniklý koncept (vazba, ne paid — to potvrdíš až po finalizaci faktury).

💡 Tlačítko „Otevřít" u spárované transakce přeskočí na navázanou fakturu (vydanou i přijatou).

23.5 Reverse: zrušení spárování

Pokud automatika spárovala chybně:

1. Detail výpisu → najdi transakci → klik Zrušit párování.
2. Faktura → status zpět na předchozí (sent / issued).
3. Activity log: bank.unmatched.

23.6 Cron — automatický scan

Místo ručního uploadu můžeš nastavit cron, který bude pravidelně skenovat adresář (např. private/bank-incoming/) a importovat nové výpisy:

cmd/cron-bank-scan.sh        # každých 30 minut

Setup:

1. Banka pravidelně exportuje výpis e-mailem nebo SFTP do private/bank-incoming/
2. Cron každých 30 min spustí php api/bin/cron-bank-scan.php
3. Skript projde nové soubory, importuje, přesune do private/bank-archive/

23.7 Tipy

• Nahraj výpis denně/týdně** — čím čerstvější, tím dříve se ti vyfiltrují faktury po splatnosti správně.
• Auto-match funguje jen s VS — bez VS musíš párovat ručně. Apeluj na klienty, aby VS vyplňovali (typicky ho v bance nabízí, když napíšeš číslo faktury jako popis).
• Platby kartou (bez VS) se zkusí spárovat na přijatou fakturu i podle částky + podobnosti názvu dodavatele (název protistrany na výpisu nemusí přesně sedět s názvem dodavatele). Spáruje se jen při jednoznačné shodě; jinak nech na ručním párování / založení dokladu (viz § 23.4.3).
• Tolerance ± 0,01 — částečné platby (klient pošle míň) se nespárují automaticky, musíš ručně. Zvaž nastavení tolerance v cfg.php → bank.matching.tolerance; u bankovních e-mailových avíz ji nastavíš přímo v mapování účtu.
• Devizový kurz — pokud klient pošle EUR a faktura je v CZK, transakce nebude spárovaná (jiná měna). Manuálně.
• Bankovní poplatek — pokud banka strhla ze 100 EUR poplatek 1.5 EUR a klient zaplatil 100, dostáváš 98.5. Manuálně označíš jako částečně zaplacené nebo přijmeš tuto „ztrátu" jako bank fee.