Nordlet

← Dokumentacija / Vadovai

Bankų sąsajos

Prijunkite banką per atvirąją bankininkystę (open banking), susiekite jo sąskaitas, pasirinkite importavimo šabloną ir sinchronizuokite operacijas į didžiąją knygą.

Šiame vadove aprašomas tiesioginis ryšys su banku (PSD2 atviroji bankininkystė): kaip prisijungti, kaip susieti banko sąskaitas su jūsų didžiąja knyga (ledger), kaip užtikrinti, kad kiekviena sinchronizacija sukurtų verslo partnerius, sudengtų sąskaitas faktūras ir įregistruotų mokesčius taikant importavimo šabloną, bei ką grąžina sinchronizacija. API informacija pateikiama skyriuje Bankų ir mokėjimų importavimas. Jei vietoj tiesioginio ryšio naudojate išrašo failus, žr. Banko išrašų importavimas (camt.053).

1. Prijunkite banką

Skiltyje Bankas → Sąsajos (Bank → Connections) pasirinkite šalį ir spauskite Rodyti bankus (Show banks). Pasirinkite savo banką ir paskyros turėtojo tipą (verslo arba asmeninį), tuomet spauskite Jungtis (Connect). Būsite nukreipti į paties banko sutikimo puslapį, kuriame turite prisijungti ir patvirtinti prieigą; tuomet bankas sugrąžins jus į Nordlet. Sąsaja bus rodoma sąraše kartu su sutikimo galiojimo pabaigos data. Bankai nustato sutikimų galiojimo laiką (dažniausiai 90 arba 180 dienų); jam pasibaigus, prisijunkite iš naujo.

Bankų sąrašas gaunamas iš atvirosios bankininkystės teikėjo, sukonfigūruoto jūsų Nordlet egzemplioriui. Jei prie šalies bankai nerodomi, teikėjas jos dar nepalaiko.

2. Susiekite banko sąskaitas

Po sąsaja kiekviena banko rodoma sąskaita pateikiama su IBAN numeriu ir valiuta. Kiekvienai iš jų pasirinkite esamą banko sąskaitą iš didžiosios knygos arba spauskite Sukurti naują banko sąskaitą (Create a new bank account), pasirinktinai nustatykite datą, nuo kurios pradėti sinchronizaciją, ir spauskite Susieti (Link). Sinchronizuojamos tik susietos sąskaitos. Nenurodžius sinchronizacijos pradžios datos, pirmosios sinchronizacijos metu bus parsiųstos paskutinės 90 dienų operacijos.

3. Sukurkite importavimo šabloną

Skiltyje Bankas → Importavimo šablonai (Bank → Import templates) spauskite Naujas importavimo šablonas (New import template), pasirinkite tipą Banko sąsaja (Bank connection) ir suteikite jam pavadinimą. Eilutės atitinka atributus, kurius banko srautas grąžina kiekvienai operacijai. Laukas Privaloma faile (Required in file) paliekamas dėl pilnumo; tiesioginis srautas pagal jį netikrinamas.

Didžiosios knygos sąskaita. Grynųjų sumų eilutė transaction_amount.amount ir taisyklėms skirtos eilutės gali būti priskirtos didžiosios knygos sąskaitai; kiekviena sinchronizuota operacija, sugeneruota iš priskirtos eilutės, įtraukiama iš karto ir pažymėta kaip sudengta su žurnalo įrašu. Taisyklėse operacijos atrenkamos pagal banko operacijos kodą arba kryptį:

Eilutė Atrenka Įprasta sąskaita
Banko mokesčiai (kodas CHRG) operacijas, kurių kodų šeima yra CHRG banko paslaugų sąnaudos (standartiniame plane 6800)
Palūkanos (kodas INTR) kodų šeima INTR gautos arba mokėtinos palūkanos
Mokesčiai (kodas TAXE) kodų šeima TAXE mokesčių mokėjimai
Kitos išėjusios lėšos bet kuris kitas debetas palikite „Nepriskirta“ (Not posted), kad mokėjimai būtų sudengti su pirkimo sąskaitomis faktūromis
Kitos įėjusios lėšos bet kuris kitas kreditas palikite „Nepriskirta“ (Not posted), kad įplaukos būtų sudengtos su pardavimo sąskaitomis faktūromis
transaction_amount.amount kiekvieną operaciją, kurios neatitiko jokia taisyklė paprastai „Nepriskirta“ (Not posted)

Operacija įtraukiama į pirmos eilutės, kurią ji atitinka, sąskaitą: pirmiausia tikrinama kodų šeima, tada kryptis ir galiausiai grynosios sumos eilutė. Kodas gaunamas iš banko lauko bank_transaction_code; bankai, kurie jo nesiunčia, kodo eilučių neatitinka.

Sukurti trūkstamus pirkėjus / tiekėjus. Pažymėkite Sukurti trūkstamus pirkėjus (Create missing customers) eilutėje debtor.name, kad būtų sukurtas pirkėjas kiekvienam nežinomam įeinančių lėšų mokėtojui, ir Sukurti trūkstamus tiekėjus (Create missing suppliers) eilutėje creditor.name kiekvienam nežinomam išeinančių lėšų gavėjui. Partneriai atpažįstami pagal IBAN (debtor_account.iban / creditor_account.iban, saugomą partnerio banko sąskaitose), o tuomet pagal tikslų pavadinimą; radus partnerį pagal pavadinimą, jam pridedamas IBAN. Naujas partneris tampa įmone, jei jo pavadinime yra teisinė forma (UAB, MB, SIA, GmbH, Ltd, ...), o kitu atveju – fiziniu asmeniu.

Sukurti banko partnerį. Pažymėkite šią parinktį banko mokesčių taisyklės eilutėje. Sinchronizacijos metu sukuriamas tiekėjas, pavadintas prijungto banko vardu, ir visi mokesčiai žurnale įregistruojami su šiuo partneriu.

Susieti sąskaitas faktūras pagal šį lauką. Pažymėkite tai eilutėje remittance_information arba reference_number. Kiekviena nauja operacija, kurios mokėjimo paskirties tekste arba nuorodoje yra atviros išrašytos pardavimo sąskaitos faktūros (įplaukos) arba registruotos pirkimo sąskaitos faktūros (išmokos) numeris, yra sudengiama su ja ir įregistruojamas mokėjimas. Kai mokėtojas yra žinomas partneris (pagal išsaugotą IBAN, tikslų partnerio pavadinimą arba kodą), sąskaita faktūra privalo priklausyti tam partneriui. Mokėjimas iš nežinomo mokėtojo sudengiamas tik tada, kai jis lygus likusiam balansui, o sąskaitos faktūros numeris apima jos serijos prefiksą. Mokėjimas, viršijantis likutinį balansą, niekada nesudengiamas. Operacijos, kurioms nepavyksta praeiti šių patikrinimų, lieka nesudengtos, kad jas sudengtumėte rankiniu būdu. Parinktis Sukurti avansines sąskaitas faktūras nesudengtiems įeinantiems mokėjimams (Create advance invoices for unmatched incoming payments) paverčia nesudengtą įplauką iš žinomo partnerio išrašyta avansine sąskaita faktūra visai sumai, kurios data sutampa su mokėjimo data, pritaikant nurodytą PVM tarifą arba pasirinktą katalogo prekę; tam reikia, kad būtų įjungta parinktis Sukurti trūkstamus pirkėjus, kad partneris būtų žinomas.

Išsaugokite šabloną.

4. Pritaikykite šabloną ir pasirinkite grafiką

Grįžę į skiltį Bankas → Sąsajos (Bank → Connections), matysite, kad kiekviena susieta sąskaita turi šablono ir grafiko parinktis. Pasirinkite šabloną, nustatykite Sinchronizuoti rankiniu būdu (Sync manually), Sinchronizuoti kasdien (Sync daily), Sinchronizuoti kas savaitę (Sync weekly) arba Sinchronizuoti kas mėnesį (Sync monthly) ir spauskite Pritaikyti (Apply). Susieta sąskaita be šablono vis tiek sinchronizuojama, tačiau įrašomos tik operacijos; niekas nėra įtraukiama, sudengiama ar kuriama.

Pasirinkus kasdienį, savaitinį arba mėnesinį grafiką, API sąskaitą sinchronizuoja savarankiškai: kartą per valandą ieškoma sąskaitų, kurių paskutinė sinchronizacija yra senesnė nei jų periodas (24 valandos, 7 dienos arba 30 dienų), ir jos sinchronizuojamos lygiai taip pat, kaip paspaudus Sinchronizuoti dabar (Sync now), po to paleidžiant šabloną. Suplanuota sinchronizacija, kaip ir rankinė, įskaičiuojama į naudojimo limitus (kas 10 parsiųstų operacijų prilygsta vienai užklausai). Jei bankas atmeta sinchronizaciją, pavyzdžiui, pasibaigus sutikimo galiojimui, prie sąsajos pažymima klaida ir ji praleidžiama, kol vėl prisijungsite.

5. Sinchronizacija

Spauskite Sinchronizuoti dabar (Sync now) prie sąsajos. Nordlet parsiunčia naujas užregistruotas operacijas kiekvienai susietai sąskaitai; laukiančios (pending) operacijos praleidžiamos, kol bankas jas užregistruos. Jos parsiunčiamos (nuo paskutinės sinchronizacijos, taikant vienos savaitės persidengimą, kad neprarastume vėlai užregistruotų operacijų), įrašomos vieną kartą (operacijos atpažįstamos pagal banko įrašo nuorodą) ir tuomet paleidžiamas sąskaitos šablonas. Rezultatų eilutėje pateikiama, kiek operacijų buvo importuota ir kiek jau egzistavo; per API sinchronizacija taip pat grąžina įtrauktų judėjimų, sukurtų partnerių, susietų ir sukurtų sąskaitų faktūrų, sudengtų mokėjimų bei įspėjimų dėl mokėjimų, kurių nepavyko sudengti, skaičių.

Sinchronizaciją pagal grafiką galima inicijuoti ir per API (bank/feeds/sync); kas 10 parsiųstų operacijų skaičiuojama kaip viena API užklausa.

6. Kur žiūrėti vėliau

  • Bankas → Operacijos (Bank → Transactions) – visos sinchronizuotos operacijos su kortelėmis pagal sąskaitas; sudengtos operacijos turi nuorodas į sąskaitą faktūrą arba žurnalo įrašą.
  • Sąskaitos faktūros (Invoices) – avansinės sąskaitos faktūros, sukurtos nesudengtoms įplaukoms.
  • Partneriai (Partners) – sukurti pirkėjai ir tiekėjai, kurių kiekvienas turi IBAN, nurodytą banko sąskaitose.
  • Didžioji knyga → Žurnalas (Ledger → Journal) – mokesčių (su banku kaip partneriu), palūkanų, rinkliavų ir mokėjimų įrašai.

Kai sąsaja nustoja veikti

Jei sinchronizacija nepavyksta, prie sąsajos įrašomas banko klaidos pranešimas. Dažniausia priežastis – pasibaigęs sutikimo galiojimas: dar kartą spauskite Jungtis (Connect) tam pačiam bankui ir patvirtinkite prieigą; susietos sąskaitos ir jų šablonai išsaugomi. Atjungti (Disconnect) pašalina sąsają bei jos sąskaitų susiejimus, tačiau jau įrašytos operacijos lieka.