Fio banka a doklad.ai: automatické párování plateb přes API

Napojení Fio banky na doklad.ai je přímé: v internetovém bankovnictví Fio si vygenerujete API token pouze pro čtení, vložíte ho k účtu v doklad.ai a od té chvíle se pohyby na účtu stahují automaticky (pravidelně na pozadí i na vyžádání). Příchozí platby doklad.ai přiřadí ke správné vydané faktuře podle variabilního symbolu a částky a fakturu označí jako uhrazenou — bez nahrávání výpisu a bez ručního odškrtávání. Alternativně fungují i e-mailové notifikace Fio. Níže najdete, jak token získat, co integrace umí dnes a co je zatím ve fázi příprav.

Co integrace Fio × doklad.ai umí dnes

Automatické stahování pohybů z účtu Fio přes oficiální Fio API (token jen pro čtení — doklad.ai nemůže nic odeslat ani změnit).
Párování příchozích plateb s vystavenými fakturami podle variabilního symbolu a částky; spárovaná faktura se označí jako uhrazená s datem platby.
Ruční dopárování plateb bez VS, částečných plateb a přeplatků.
Automatické upomínky k fakturám, které po splatnosti zaplacené nejsou.
E-mailové notifikace jako záložní cesta: Fio umí posílat oznámení o příchozích platbách na e-mail pro párování plateb v doklad.ai.

Co integrace zatím nedělá: neodesílá příkazy k úhradě (token je jen pro čtení) a nezakládá z pohybů automaticky náklady.

Jak napojení nastavit krok za krokem

V internetbankingu Fio otevřete Nastavení → API a vytvořte nový token pro váš účet. Zvolte oprávnění pouze sledování pohybů (čtení). Token si zkopírujte.
V doklad.ai přidejte bankovní účet u Fio (Nastavení → Bankovní účty) a do pole Fio API token vložte zkopírovaný token. Token se ukládá zabezpečeně a v rozhraní se zobrazuje jen maskovaně.
Vystavujte faktury s variabilním symbolem (nejlépe rovným číslu faktury) a číslem účtu u Fio. Právě podle VS a částky probíhá párování.
Zkontrolujte spárování v sekci Párování plateb — jednoznačné shody se spárují samy, nejasné případy potvrdíte ručně.

Pozor na limit Fio API: token má omezený počet dotazů za časové okno, proto doklad.ai stahuje pohyby v pravidelných intervalech a ne při každém načtení stránky.

Jaký problém to reálně řeší

Ruční kontrola, kdo zaplatil, je u desítek faktur měsíčně práce na hodiny a snadno se v ní přehlédne nezaplacená faktura. S napojením na Fio máte stav pohledávek aktuální bez vlastního zásahu: faktury po splatnosti vidíte na první pohled a upomínky se posílají samy. Zákazník, který platí QR kódem z faktury, má správný VS i částku automaticky — a tím se spáruje prakticky vše.

Fio API vs. e-mailové notifikace

Obě cesty vedou ke stejnému výsledku, liší se spolehlivostí a nastavením:

API token (doporučeno) — stahuje se celá historie pohybů za období, nic se neztratí ani při výpadku e-mailu; nastavení zabere dvě minuty.
E-mailové notifikace — Fio posílá oznámení o každé příchozí platbě na vaši adresu pro párování plateb (p-…@doklad.ai); doklad.ai z něj vytěží částku a VS. Hodí se, když token z nějakého důvodu nechcete vydávat.

Obě cesty můžete kombinovat; doklad.ai stejnou platbu dvakrát nezapočítá.

Co je připravované

Uvádíme upřímně, co zatím není hotové:

Nahrání výpisu (ABO/GPC, CSV) pro jednorázové dopárování starších období bez tokenu.
Odesílání příkazů k úhradě z doklad.ai do Fio (vyžadovalo by token s právem zápisu).
Automatický vznik nákladů z odchozích plateb.

Vyzkoušejte doklad.ai zdarma, vložte Fio token a první platby se spárují během několika minut.

Časté dotazy

Označí doklad.ai fakturu jako zaplacenou automaticky, když přijde platba na Fio?

Ano. Po vložení Fio API tokenu doklad.ai stahuje pohyby na účtu automaticky a příchozí platbu se shodným variabilním symbolem a částkou spáruje s fakturou, kterou označí jako uhrazenou s datem platby.

Podle čeho se platba páruje s fakturou?

Podle variabilního symbolu (obvykle čísla faktury) a částky. Platby bez VS, částečné platby a přeplatky doklad.ai zobrazí zvlášť k ručnímu přiřazení.

Umí doklad.ai přes Fio i posílat příkazy k úhradě?

Ne. Token, který do doklad.ai vkládáte, je jen pro čtení pohybů — doklad.ai nemůže z účtu nic odeslat. Odesílání příkazů k úhradě je mezi připravovanými funkcemi.