← Základy / Sady SDK
Bankovní připojení
Připojte banku prostřednictvím open banking, propojte její účty, vyberte šablonu importu a synchronizujte transakce do účetní knihy.
Tato příručka se věnuje přímému připojení k bance (PSD2 open banking): jak provést připojení, jak propojit bankovní účty s vaší účetní knihou, jak zajistit, aby každá synchronizace vytvořila partnery, spárovala faktury a zaúčtovala platby pomocí šablony importu, a co synchronizace vrací. Podrobnosti o API najdete v části Bankovní a platební importy. Pokud chcete namísto živého připojení použít soubory výpisů, podívejte se na Import bankovních výpisů (camt.053).
1. Připojení banky
V části Bankovnictví → Připojení vyberte zemi a stiskněte tlačítko Zobrazit banky. Vyberte svou banku a typ majitele účtu (firemní nebo osobní), a poté stiskněte Připojit. Budete přesměrováni na stránku pro udělení souhlasu (consent) dané banky, kde se přihlásíte a přístup schválíte. Banka vás následně vrátí zpět do systému Nordlet. Připojení se zobrazí v seznamu spolu s datem vypršení platnosti souhlasu. Souhlasy jsou ze strany banky časově omezené (obvykle na 90 nebo 180 dnů); po vypršení platnosti je nutné připojení obnovit.
Seznam bank pochází od poskytovatele open banking, který je nakonfigurován pro danou instanci Nordlet. Pokud se u zemi nezobrazují žádné banky, daný poskytovatel ji ještě nepodporuje.
2. Propojení bankovních účtů
V rámci připojení je každý účet zpřístupněný bankou uveden spolu se svým IBAN a měnou. Pro každý účet vyberte existující bankovní účet z účetní knihy nebo zvolte Vytvořit nový bankovní účet, případně nastavte datum, od kterého se má provést synchronizace, a stiskněte Propojit. Synchronizovány jsou pouze propojené účty. Bez zadaného počátečního data synchronizace první spuštění stáhne posledních 90 dnů.
3. Vytvoření šablony importu
V části Bankovnictví → Šablony importu stiskněte Nová šablona importu, zvolte typ Bankovní připojení a zadejte její název. Řádky představují atributy, které bankovní feed vrací pro každou transakci. Políčko Vyžadováno v souboru se ponechává kvůli úplnosti, živý feed se vůči němu nevaliduje.
Účet v účetní knize. Řádek prosté částky transaction_amount.amount a řádky pravidel lze přiřadit k účtu v účetní knize. Každá synchronizovaná transakce vytvořená z přiřazeného řádku se ihned zaúčtuje a označí jako spárovaná s účetním zápisem. Řádky pravidel vybírají transakce podle kódu bankovní transakce nebo směru:
| Řádek | Vybírá | Typický účet |
|---|---|---|
| Bankovní poplatky (kód CHRG) | transakce, jejichž rodina kódů je CHRG |
náklady na bankovní poplatky (6800 v rámcové účtové osnově) |
| Úroky (kód INTR) | rodina kódů INTR |
úrokové výnosy nebo náklady |
| Daně (kód TAXE) | rodina kódů TAXE |
platby daní |
| Jiné odchozí platby | jakýkoliv jiný debet | ponechte „Nezaúčtováno“, aby se platby párovaly k přijatým fakturám |
| Jiné příchozí platby | jakýkoliv jiný kredit | ponechte „Nezaúčtováno“, aby se platby párovaly k vydaným fakturám |
transaction_amount.amount |
každá transakce, kterou nezachytilo žádné pravidlo | obvykle „Nezaúčtováno“ |
Transakce se zaúčtuje na účet prvního řádku, kterému vyhovuje: nejprve se posuzuje rodina kódů, potom směr a nakonec řádek prosté částky. Kód pochází z položky bank_transaction_code od banky; banky, které tento kód nezasílají, ponechávají řádky kódů bez shody.
Vytvořit chybějící zákazníky / dodavatele. Zaškrtněte možnost Vytvořit chybějící zákazníky u řádku debtor.name pro vytvoření zákazníka pro každého neznámého plátce příchozích peněz a Vytvořit chybějící dodavatele u řádku creditor.name pro každého neznámého příjemce odchozích peněz. Partneři jsou rozpoznáváni podle IBAN (debtor_account.iban / creditor_account.iban, uloženého u bankovních účtů partnera) a následně podle přesného názvu. Partner nalezený podle názvu získá doplněný IBAN. Nový partner je evidován jako firma, pokud jeho název obsahuje právní formu (s.r.o., a.s., z.ú., k.s., v.o.s. atd.), v opačném případě jako fyzická osoba.
Vytvořit partnera pro banku. Zaškrtněte tuto možnost u řádku pravidla Bankovní poplatky. Synchronizace vytvoří dodavatele pojmenovaného podle připojené banky a každý poplatek zaúčtuje do deníku s tímto partnerem.
Propojit faktury podle tohoto pole. Zaškrtněte tuto možnost u řádku remittance_information nebo reference_number. Každá nová transakce, jejíž text zprávy pro příjemce nebo variabilní symbol obsahuje číslo otevřené vydané faktury (příchozí platba) nebo zaevidované přijaté faktury (odchozí platba), se s ní spáruje a platba se zaúčtuje. Pokud je plátce známým partnerem (podle uloženého IBAN, přesného názvu partnera nebo kódu), faktura musí patřit tomuto partnerovi. Platba od neznámého plátce se spáruje pouze tehdy, pokud se rovná zbývajícímu zůstatku a číslo faktury obsahuje předponu její řady. Platba vyšší než zbývající zůstatek se nespáruje nikdy. Transakce, které těmito kontrolami neprojdou, zůstanou nespárované, abyste je mohli ručně spárovat. Možnost Vytvořit zálohové faktury pro nespárované příchozí platby změní nespárovanou úhradu od známého partnera na vydanou zálohovou fakturu na danou částku s datem platby, příslušnou sazbou DPH nebo zvolenou položkou katalogu. Tato možnost vyžaduje aktivní Vytvořit chybějící zákazníky, aby byl partner známý.
Šablonu uložte.
4. Použití šablony a nastavení plánu synchronizace
Zpět v části Bankovnictví → Připojení má každý propojený účet výběr šablony a plánu synchronizace. Vyberte šablonu, zvolte Synchronizovat ručně, Synchronizovat denně, Synchronizovat týdně nebo Synchronizovat měsíčně a stiskněte Použít. Propojený účet bez šablony se sice také synchronizuje, ale pouze zaznamenává transakce, nic se neúčtuje, nepáruje ani nevytváří.
Při denním, týdenním nebo měsíčním plánu API synchronizuje účet samo: jednou za hodinu vyhledá účty, jejichž poslední synchronizace je starší než jejich interval (24 hodin, 7 dnů nebo 30 dnů), a provede synchronizaci přesně tak, jako byste klikli na Synchronizovat nyní, přičemž následně spustí příslušnou šablonu. Plánovaná synchronizace se započítává do limitu využití stejně jako ruční synchronizace (každých 10 stažených transakcí = jeden požadavek). Pokud banka synchronizaci odmítne (například z důvodu vypršení platnosti souhlasu), připojení se označí chybou a bude se přeskakovat, dokud se opět nepřipojíte.
5. Synchronizace
U připojení stiskněte tlačítko Synchronizovat nyní. Nordlet stáhne nové zaúčtované transakce pro každý propojený účet, přičemž nezaúčtované (čekající) transakce se přeskočí, dokud je banka nezaúčtuje. Systém transakce stáhne (od poslední synchronizace s jednodenním překryvem, aby se nezmeškaly pozdně zaúčtované položky), jednorázově zaznamená (transakce jsou rozpoznávány podle referenčního čísla záznamu z banky) a následně spustí šablonu účtu. Výsledný řádek informuje o tom, kolik transakcí bylo importováno a kolik jich již existovalo. Prostřednictvím API vrací synchronizace také počet zaúčtovaných pohybů, vytvořených partnerů, propojených a vytvořených faktur, spárovaných plateb a upozornění na platby, které nebylo možné spárovat.
Synchronizace lze spouštět také z API (bank/feeds/sync) podle harmonogramu; každých 10 stažených transakcí se počítá jako jeden požadavek API.
6. Kde hledat výsledky
- Bankovnictví → Transakce - všechny synchronizované transakce se záložkami pro jednotlivé účty. Spárované transakce odkazují na fakturu nebo účetní zápis.
- Faktury - zálohové faktury vytvořené pro nespárované příchozí platby.
- Partneři - vytvoření zákazníci a dodavatelé, každý s IBAN evidovaným v bankovních účtech.
- Účetní kniha → Deník - zaúčtování poplatků (s bankou jako partnerem), úroků, daní a plateb.
Když připojení přestane fungovat
Neúspěšná synchronizace označí připojení chybovou hláškou od banky. Obvyklou příčinou je vypršení platnosti souhlasu: stiskněte znovu Připojit u stejné banky a schvalte přístup. Propojené účty a jejich šablony zůstanou zachovány. Volba Odpojit odstraní připojení a vazby na účty, ale již zaznamenané transakce ponechá.