Pripojenia k bankám

Táto príručka sa zaoberá priamym pripojením k banke (PSD2 open banking): ako sa pripojiť, ako prepojiť bankové účty s účtovnou knihou, ako nastaviť, aby každá synchronizácia vytvorila obchodných partnerov (partners), priradila faktúry a zaúčtovala platby prostredníctvom šablóny importu, a čo synchronizácia vracia. Podrobnosti o API nájdete v časti Bankové a platobné importy. Ak chcete namiesto živého pripojenia použiť súbory výpisov, pozrite si Import bankových výpisov (camt.053).

1. Pripojenie banky

V časti Bank → Pripojenia (Connections) vyberte krajinu a kliknite na Zobraziť banky (Show banks). Vyberte svoju banku a typ majiteľa účtu (firma alebo súkromná osoba) a kliknite na Pripojiť (Connect). Systém vás presmeruje na prihlasovaciu stránku banky, kde sa prihlásite a schválite prístup; banka vás potom vráti späť do systému Nordlet. Pripojenie sa zobrazí v zozname spolu s dátumom exspirácie súhlasu. Súhlasy majú od banky časovo obmedzenú platnosť (zvyčajne 90 alebo 180 dní); po uplynutí platnosti je potrebné pripojenie zopakovať.

Zoznam baniek pochádza z poskytovateľa open banking služieb, ktorý je nakonfigurovaný pre vašu inštanciu Nordlet. Ak sa v krajine nezobrazujú žiadne banky, poskytovateľ ju zatiaľ nepodporuje.

2. Prepojenie bankových účtov

Pod pripojením sú uvedené všetky účty sprístupnené bankou spolu s ich IBAN-om a menou. Pre každý účet vyberte existujúci bankový účet z účtovnej knihy alebo zvoľte Vytvoriť nový bankový účet (Create a new bank account), prípadne nastavte dátum, od ktorého sa má synchronizovať, a kliknite na Prepojiť (Link). Synchronizujú sa iba prepojené účty. Bez zadaného počiatočného dátumu synchronizácie prvá synchronizácia stiahne údaje za posledných 90 dní.

3. Vytvorenie šablóny importu

V časti Bank → Šablóny importu (Import templates) kliknite na Nová šablóna importu (New import template), vyberte typ Bankové pripojenie (Bank connection) a zadajte jej názov. Riadky predstavujú atribúty, ktoré bankový feed vracia pre každú transakciu. Políčko Vyžadované v súbore (Required in file) sa ponecháva pre úplnosť; živý feed sa voči nemu nevaliduje.

Účet v účtovnej knihe. Jednoduchý riadok sumy transaction_amount.amount a riadok pravidiel je možné priradiť k účtu v účtovnej knihe; každá synchronizovaná transakcia vygenerovaná z priradeného riadku sa okamžite zaúčtuje a označí ako priradená k zápisu v denníku. Riadky pravidiel vyberajú transakcie podľa kódu bankovej transakcie alebo smeru:

Riadok	Vyberá	Typický účet
Bankové poplatky (kód CHRG)	transakcie, ktorých rodina kódov je CHRG	náklady na bankové poplatky (6800 v štandardnej osnove)
Úroky (kód INTR)	rodina kódov INTR	úrokové výnosy alebo nákladové úroky
Dane (kód TAXE)	rodina kódov TAXE	daňové platby
Iné odchádzajúce platby	akýkoľvek iný debet	ponechajte „Nezaúčtované“ (Not posted), aby sa platby priradili k dodávateľským faktúram
Iné prichádzajúce platby	akýkoľvek iný kredit	ponechajte „Nezaúčtované“ (Not posted), aby sa platby priradili k odoslaným faktúram
transaction_amount.amount	každá transakcia, ktorú nevybralo žiadne pravidlo	zvyčajne „Nezaúčtované“ (Not posted)

Transakcia sa zaúčtuje na účet prvého riadku, ktorému vyhovuje: najskôr podľa rodiny kódov, potom podľa smeru a nakoniec podľa riadku základnej sumy. Kód pochádza z poľa banky bank_transaction_code; banky, ktoré žiadny kód neposielajú, nechávajú riadky kódov bez zhody.

Vytvorenie chýbajúcich zákazníkov / dodávateľov. Začiarknite možnosť Vytvoriť chýbajúcich zákazníkov (Create missing customers) na riadku debtor.name, čím sa pre každého neznámeho platiteľa prichádzajúcich peňazí vytvorí zákazník, a možnosť Vytvoriť chýbajúcich dodávateľov (Create missing suppliers) na riadku creditor.name pre každého neznámeho príjemcu odchádzajúcich peňazí. Partneri sa rozpoznávajú podľa IBAN-u (debtor_account.iban / creditor_account.iban, ktorý sa ukladá k bankovým účtom partnera) a následne podľa presného názvu; partnerovi nájdenému podľa názvu sa priradí IBAN. Nový partner je spoločnosťou, ak jeho názov obsahuje právnu formu (UAB, MB, SIA, GmbH, Ltd, …), v opačnom prípade ide o fyzickú osobu.

Vytvoriť partnera pre banku. Začiarknite túto možnosť na riadku pravidla pre bankové poplatky. Synchronizácia vytvorí dodávateľa s názvom pripojenej banky a zaeviduje každý poplatok v denníku s týmto partnerom.

Prepojiť faktúry podľa tohto poľa. Začiarknite túto možnosť na riadku remittance_information alebo reference_number. Každá nová transakcia, ktorej text platobného príkazu alebo variabilný symbol obsahuje číslo otvorenej vydanej faktúry (prichádzajúce peniaze) alebo zaevidovanej prijatej faktúry (odchádzajúce peniaze), sa k nej priradí a platba sa zaúčtuje. Ak je platiteľ známym partnerom na základe uloženého IBAN-u, presného názvu alebo kódu partnera, faktúra musí patriť tomuto partnerovi. Platba od neznámeho platiteľa sa priradí iba vtedy, ak sa rovná zostávajúcemu zostatku a číslo faktúry obsahuje prefix jej číselného radu. Platba presahujúca zostávajúci zostatok sa nepriradí nikdy. Transakcie, ktoré neprejdú týmito kontrolami, zostanú nepriradené, aby ste ich mohli priradiť manuálne. Možnosť Vytvoriť zálohové faktúry pre nepriradené prichádzajúce platby (Create advance invoices for unmatched incoming payments) premení nepriradenú platbu od známeho partnera na vydanú zálohovú faktúru na danú sumu, s dátumom platby a so zadanou sadzbou DPH alebo zvolenou položkou katalógu; táto funkcia vyžaduje zapnutú možnosť Vytvoriť chýbajúcich zákazníkov (Create missing customers), aby bol partner známy.

Šablónu uložte.

4. Použitie šablóny a výber harmonogramu

Späť v časti Bank → Pripojenia (Connections) má každý prepojený účet ponuku na výber šablóny a harmonogramu. Vyberte šablónu, zvoľte Synchronizovať manuálne (Sync manually), Synchronizovať denne (Sync daily), Synchronizovať týždenne (Sync weekly) alebo Synchronizovať mesačne (Sync monthly) a kliknite na Použiť (Apply). Prepojený účet bez šablóny sa síce synchronizuje, ale transakcie sa iba zaznamenajú; nič sa nezaúčtuje, nepriradi ani nevytvorí.

Pri dennom, týždennom alebo mesačnom harmonograme API synchronizuje účet samo: raz za hodinu vyhľadá účty, ktorých posledná synchronizácia je staršia ako ich interval (24 hodín, 7 dní alebo 30 dní), a vykoná synchronizáciu presne tak, ako keby ste spustili Synchronizovať teraz (Sync now), pričom následne spustí šablónu. Plánovaná synchronizácia sa započítava do využitia rovnako ako manuálna (každých 10 stiahnutých transakcií = jedna požiadavka). Ak banka synchronizáciu odmietne, napríklad z dôvodu uplynutia platnosti súhlasu, pripojenie sa označí chybou a preskočí sa, kým sa znova nepripojíte.

5. Synchronizácia

Kliknite na Synchronizovať teraz (Sync now) pri danom pripojení. Nordlet stiahne nové zaúčtované transakcie pre každý prepojený účet; čakajúce (pending) transakcie sa preskočia, kým ich banka nezaúčtuje. Systém ich stiahne (od poslednej synchronizácie s prekrytím jedného týždňa, aby sa nezmeškali neskôr zaúčtované položky), zaznamená ich – transakcie sa rozpoznávajú podľa referencie položky banky – a následne spustí šablónu účtu. Výsledný riadok informuje o tom, koľko transakcií bolo importovaných a koľko ich už existovalo; prostredníctvom API synchronizácia vráti aj počet zaúčtovaných pohybov, vytvorených partnerov, prepojených a vytvorených faktúr, priradených platieb a varovaní pre platby, ktoré sa nepodarilo priradiť.

Synchronizáciu je možné spustiť aj cez API (bank/feeds/sync) podľa harmonogramu; každých 10 stiahnutých transakcií sa počítame ako jedna požiadavka API.

6. Kde nájsť výsledky

• Bank → Transakcie (Transactions) – každá synchronizovaná transakcia s kartami pre jednotlivé účty; priradené transakcie obsahujú odkazy na faktúru alebo zápis v denníku.
• Faktúry (Invoices) – zálohové faktúry vytvorené pre nepriradené prijaté platby.
• Partneri (Partners) – vytvorení zákazníci a dodávatelia, pričom každý má uvedený IBAN v časti bankové účty.
• Účtovná kniha → Denník (Ledger → Journal) – účtovné zápisy pre poplatky (s bankou ako partnerom), úroky, dane a platby.

Keď pripojenie prestane fungovať

Neúspešná synchronizácia označí pripojenie chybovým hlásením banky. Najčastejšou príčinou je uplynutie platnosti súhlasu: opäť kliknite na Pripojiť (Connect) pre tú istú banku a schválte prístup; prepojené účty a ich šablóny zostanú zachované. Možnosť Odpojiť (Disconnect) odstráni pripojenie a prepojenia jeho účtov, nie však už zaznamenané transakcie.