12. 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ší.

12.1 Stažení GPC výpisu z banky

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

BankaCesta v internet bankingu
KBÚčet → Historie pohybů → Export → formát „GPC ABO"
FioPřehled účtu → Stažení dat → formát „GPC"
ČSOBÚčet → Výpisy → Stáhnout → formát „ABO"
RaiffeisenDetail účtu → Pohyby → Export → ABO formát
ČSDetail účtu → Výpisy → formát „ABO"

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

12.2 Upload výpisu do MyInvoice

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

Upload výpisu
Upload výpisu

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.

12.3 Seznam výpisů

Banka → Výpisy ukáže historii.

SloupecVýznam
DatumDatum výpisu
ČísloČíslo výpisu z banky
ÚčetČíslo účtu / IBAN
MěnaCZK / EUR / …
PříchozíSuma kreditních transakcí
OdchozíSuma debetních transakcí
Spárováno12/14 — 12 z 14 transakcí spárováno na faktury
ImportovánoDatum + uživatel

12.4 Detail výpisu

Klik na řádek → detail.

Tabulka transakcí:

SloupecVýznam
DatumDatum zaúčtování
Částka+ (kredit) / − (debet)
Měna
ProtistranaNázev + číslo účtu (pokud bance zaslala)
VSVariabilní symbol z transakce
KS / SSKonstantní / specifický symbol
PopisPoznámka z banky
StavSpárováno (zelená) / Bez shody (šedá) / Ignorováno (oranž.)
FakturaPokud spárováno, číslo faktury (klikatelné)

12.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.

12.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á.

12.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.

12.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/

12.7 Tipy