Pangaliited

See juhend käsitleb otseühendust pangaga (PSD2 open banking): kuidas luua ühendust, siduda panga kontod oma pearaamaturakendusega, panna iga sünkroonimine impordimalli abil looma partnereid, sobitama arveid ja kandeid ning mida sünkroonimine tagastab. API üksikasjad leiate lehelt Panga- ja makseimpordid. Kui soovite otseühenduse asemel kasutada väljavõttefaile, vaadake juhendit Pangaväljavõtete importimine (camt.053).

1. Panga ühendamine

Valige jaotises Pank → Ühendused riik ja klõpsake nuppu Kuva pangad. Valige oma pank ja kontohalduri tüüp (äriklient või eraklient) ning klõpsake nuppu Ühenda. Teid suunatakse panga enda nõusolekulehele, kus peate sisse logima ja juurdepääsu kinnitama; seejärel suunab pank teid Nordletisse tagasi. Ühendus ilmub loendisse koos selle nõusoleku aegumiskuupäevaga. Pangad määravad nõusolekutele ajapiirangu (tavaliselt 90 või 180 päeva); kui nõusolek aegub, looge ühendus uuesti.

Pankade loend pärineb Nordleti eksemplari jaoks konfigureeritud avatud panganduse teenusepakkujalt. Kui riigi juures pole ühtegi pankade loendit, siis teenusepakkuja seda riiki veel ei toeta.

2. Panga kontode sidumine

Ühenduse all on loetletud kõik panga pakutavad kontod koos nende IBAN-i ja valuutaga. Valige iga konto jaoks olemasolev pangakonto pearaamatust või Loo uus pangakonto, määrake soovi korral alguskuupäev, millest alates sünkroonida, ja klõpsake nuppu Seo. Sünkroonitakse ainult seotud kontosid. Ilma alguskuupäevata laaditakse esimesel sünkroonimisel alla viimase 90 päeva andmed.

3. Impordimalli loomine

Valige jaotises Pank → Impordimallid nupp Uus impordimall, valige tüübiks Pangaliitlus ja sisestage nimi. Read vastavad andmeväljadele, mida pangaandmevoog iga tehingu kohta tagastab. Väli Failis kohustuslik on säilitatud terviklikkuse huvides; reaalajas andmevoogu selle alusel ei valideerita.

Pearaamatukonto. Lihtsale summareale transaction_amount.amount ja reegliridadele saab määrata pearaamatukonto - iga määratud rea alusel genereeritud sünkroonitud tehing kantakse kohe raamatupidamisse ja märgitakse kande vasteks. Reegliredalid valivad tehinguid pangatehingu koodi või suuna alusel:

Rida	Valib	Tüüpiline konto
Pangatasud (kood CHRG)	tehingud, mille koodiperekonnad on CHRG	pangakulud (standardplaanis 6800)
Intressid (kood INTR)	koodiperekond INTR	intressitulud või -kulud
Maksed (kood TAXE)	koodiperekond TAXE	maksumaksed
Muu väljaminev raha	mis tahes muu deebet	jätke valikuks "Pole kantud", et maksed sobitataks ostuarvetega
Muu sissetulev raha	mis tahes muu kreedit	jätke valikuks "Pole kantud", et laekumised sobitataks müügiarvetega
transaction_amount.amount	iga tehing, millele reegel ei rakendunud	tavaliselt "Pole kantud"

Tehing kantakse selle rea kontole, mille kriteeriumidele see esimesena vastab: esmalt koodiperekonna, seejärel suuna ja viimasena lihtsa summaroa järgi. Kood pärineb panga väljalt bank_transaction_code; pangad, mis seda ei saada, jätavad koodiread ilma vasteteta.

Puuduvate klientide / tarnijate loomine. Märkige välja debtor.name juures ruut Loo puuduvad kliendid, et luua klient igale tundmatule sissetuleva raha maksjale, ning välja creditor.name juures ruut Loo puuduvad tarnijad igale tundmatule väljamineva raha saajale. Partnereid tuvastatakse IBAN-i (debtor_account.iban / creditor_account.iban, mis salvestatakse partneri pangakontodele) ja seejärel täpse nime alusel; nime järgi leitud partnerile lisatakse IBAN. Uus partner on ettevõte, kui selle nimi sisaldab õigusvormi (UAB, MB, SIA, GmbH, Ltd jne), ja vastasel juhul füüsiline isik.

Pangale partneri loomine. Märkige see ruut pangatasude reeglireal. Sünkroonimisel luuakse ühendatud panga nimeline tarnija ja iga tasu registreeritakse pearaamatus selle partneriga.

Arvete sidumine selle välja alusel. Märkige see ruut väljal remittance_information või reference_number. Iga uus tehing, mille selgitus või viitenumber sisaldab tasumata väljastatud müügiarve (laekumine) või registreeritud ostuarve (makse) numbrit, seotakse sellega ja makse kantakse raamatupidamisse. Kui maksja on teadaolev partner (salvestatud IBAN-i, täpse nime või koodi järgi), peab arve kuuluma just sellele partnerile. Tundmatu maksja makse seotakse ainult juhul, kui see katab täpselt ülejääva saldo ja arvenumber sisaldab selle seeria eesliidet. Jäägist suuremat makset ei seotuta kunagi. Tehingud, mis neid kontrollkriteeriume ei läbi, jäävad sobitamata, et saaksite need käsitsi siduda. Valik Loo ettemaksuarved sobitamata sissetulevate maksete kohta muudab teadaoleva partneri sobitamata laekumise vastavasummaliseks väljastatud ettemaksuarveks, mille kuupäevaks on makse kuupäev ning millele rakendatakse antud käibemaksumäär või valitud kataloogiartikkel; see eeldab seadistust Loo puuduvad kliendid, et partner oleks teada.

Salvestage mall.

4. Malli rakendamine ja ajakava valik

Jaotises Pank → Ühendused on igal seotud kontol malli ja ajakava rippmenüü. Valige mall, valige Sünkrooni käsitsi, Sünkrooni iga päev, Sünkrooni iga nädal või Sünkrooni iga kuu ja klõpsake nuppu Rakenda. Ilma mallita seotud konto sünkroonitakse samuti, kuid see salvestab ainult tehingud - midagi ei kanta raamatupidamisse, ei seotuta ega loodeta.

Päeva-, nädala- või kuugraafiku korral sünkroonib API kontot ise: kord tunnis otsib see kontosid, mille viimane sünkroonimine on nende perioodist (vastavalt 24 tundi, 7 päeva või 30 päeva) vanem, ja sünkroonib need täpselt samamoodi nagu nupp Sünkrooni kohe, käivitades seejärel malli. Plaaniline sünkroonimine läheb arvesse kasutusmahuna sarnaselt käsitsisünkroonimisega (iga 10 laaditud tehingu kohta üks päring). Kui pank lükkab sünkroonimise tagasi (näiteks aegunud nõusoleku tõttu), märgitakse ühendus veaga ja seda vahele jäetakse seni, kuni loote uue ühenduse.

5. Sünkroonimine

Klõpsake ühenduse juures nuppu Sünkrooni kohe. Nordlet laadib alla uued broneeritud tehingud iga seotud konto kohta; ootel tehingud jäetakse vahele, kuni pank need broneerib. Tehingud laaditakse alla (alates viimasest sünkroonimisest, ühenädalase kattuvusega, et hilinenud kanded ei jääks kahe silma vahele), salvestatakse ühel korral - tehingud tuvastatakse panga kande viite alusel - ning seejärel käivitatakse konto mall. Tulemuste rida näitab, mitu tehingut imporditi ja mitu oli juba olemas; API kaudu tagastab sünkroonimine ka kannete arvu, loodud partnerid, seotud ja loodud arved, sobitatud maksed ning hoiatused maksete kohta, mida ei õnnestunud sobitada.

Sünkroonimisi saab käivitada ka API kaudu (bank/feeds/sync) ajakava alusel; iga 10 laaditud tehingut läheb arvesse ühe API päringuna.

6. Kust leida tulemusi hiljem

• Pank → Tehingud - kõik sünkroonitud tehingud konto kaupa; seotud tehingud viitavad arvele või raamatupidamiskandele.
• Arved - sobitamata laekumiste jaoks loodud ettemaksuarved.
• Partnerid - loodud kliendid ja tarnijad, igaühel IBAN pangakontode all.
• Pearaamat → Kanded - tasude (kus partneriks on pank), intresside, maksude ja maksete kanded.

Kui ühendus lakkab töötamast

Ebaõnnestunud sünkroonimine märgib ühenduse panga veateatega. Tavaline põhjus on aegunud nõusolek: klõpsake sama panga juures uuesti nuppu Ühenda ja kinnitage juurdepääs; seotud kontod ja nende mallid säilivad. Katkesta ühendus eemaldab ühenduse ja selle kontoseosed, kuid juba salvestatud tehingud jäävad alles.