Nordlet

← Dokumentaatio / Oppaat

Pankkiyhteydet

Yhdistä pankki avoimen pankkitoiminnan kautta, linkitä sen tilit, valitse tuontipohja ja synkronoi tapahtumat kirjanpitoon.

Tässä oppaassa käsitellään reaaliaikaista pankkiyhteyttä (PSD2 open banking): miten yhteys muodostetaan, miten pankin tilit linkitetään kirjanpitoon, miten jokainen synkronointi luo kumppaneita, täsmäyttää laskuja ja kirjaa maksuja tuontipohjan avulla, sekä mitä synkronointi palauttaa. API-tiedot löytyvät kohdasta Pankki- ja maksutuonnit. Jos haluat käyttää tiliotetiedostoja reaaliaikaisen yhteyden sijaan, katso Pankkitiliotteiden tuonti (camt.053).

1. Yhdistä pankki

Valitse kohdassa Pankki → Yhteydet maa ja paina Näytä pankit. Valitse pankkisi ja tilinhaltijan tyyppi (yritys tai henkilö) ja paina Yhdistä. Sinut ohjataan pankin omalle suostumus-sivulle, jolla kirjaudut sisään ja hyväksyt käyttöoikeuden. Tämän jälkeen pankki palaa takaisin Nordletiin. Yhteys näkyy luettelossa yhdessä sen suostumuksen voimassaolon päättymispäivän kanssa. Pankit asettavat suostumuksille aikarajat (tyypillisesti 90 tai 180 päivää); kun suostumus vanhenee, muodosta yhteys uudelleen.

Pankkiluettelo tulee Nordlet-instanssille määritetyltä avoimen pankkitoiminnan palveluntarjoajalta. Jos maalle ei näy pankkeja, palveluntarjoaja ei vielä kata sitä.

2. Linkitä pankin tilit

Yhteyden alla on lueteltu jokainen pankin tarjoama tili IBAN-tunnuksella ja valuutalla varustettuna. Valitse kullekin tilille olemassa oleva pankkitili kirjanpidosta tai Luo uusi pankkitili, aseta halutessasi alkupäivämäärä, josta alkaen synkronoidaan, ja paina Linkitä. Vain linkitetyt tilit synkronoidaan. Ilman synkronoinnin alkupäivämäärää ensimmäinen synkronointi hakee viimeiset 90 päivää.

3. Luo tuontipohja

Valitse kohdassa Pankki → Tuontipohjat Uusi tuontipohja, valitse tyypiksi Pankkiyhteys ja anna sille nimi. Rivit vastaavat pankin syötteen tapahtumakohtaisia attribuutteja. Vaaditaan tiedostossa -valintaruutu säilytetään yhteensopivuuden vuoksi, mutta reaaliaikaista syötettä ei validoida sitä vasten.

Kirjanpitotili. Yksittäiselle summamääräiselle riville transaction_amount.amount ja sääntöriveille voidaan määrittää kirjanpitotili. Jokainen määritetyltä riviltä syntynyt synkronoitu tapahtuma kirjataan heti ja merkitään täsmäytetyksi tositteeseen. Sääntörivit poimivat tapahtumia pankkitapahtumakoodin tai suunnan perusteella:

Rivi Poimii Tyypillinen tili
Pankkikulut (koodi CHRG) tapahtumat, joiden koodiryhmä on CHRG pankkikulut (vakio-tilikartassa 6800)
Korot (koodi INTR) koodiryhmä INTR korkotuotot tai -kulut
Verot (koodi TAXE) koodiryhmä TAXE veromaksut
Muut lähtevät maksut mikä tahansa muu debet jätä tilaan "Ei kirjattu", jotta maksut täsmäytetään ostolaskuihin
Muut saapuvat maksut mikä tahansa muu kredit jätä tilaan "Ei kirjattu", jotta suoritukset täsmäytetään myyntilaskuihin
transaction_amount.amount kaikki tapahtumat, joihin mikään sääntö ei osunut yleensä "Ei kirjattu"

Tapahtuma kirjataan sen ensimmäisen rivin tilille, johon se täsmää: ensin koodiryhmän, sitten suunnan ja lopulta pelkän summarivin mukaan. Koodi tulee pankin kentästä bank_transaction_code. Pankit, jotka eivät lähetä koodia, jättävät koodirivit ilman osumia.

Luo puuttuvat asiakkaat / toimittajat. Valitse Luo puuttuvat asiakkaat rivillä debtor.name luodaksesi asiakkaan jokaiselle tuntemattomalle saapuvan rahan maksajalle, ja Luo puuttuvat toimittajat rivillä creditor.name jokaiselle tuntemattomalle lähtevän rahan saajalle. Kumppanit tunnistetaan IBAN-tunnuksen (debtor_account.iban / creditor_account.iban, tallennetaan kumppanin pankkitileille) ja sen jälkeen tarkan nimen perusteella. Nimellä löytyvälle kumppanille lisätään IBAN. Uusi kumppani on yritys, jos sen nimessä on yhtiömuoto (UAB, MB, SIA, GmbH, Ltd jne.), ja muuten henkilö.

Luo kumppani pankille. Valitse tämä pankkikulujen sääntörivillä. Synkronointi luo yhdistetyn pankin nimisen toimittajan kerran ja kirjaa jokaisen kulun kirjanpitoon kyseisen kumppanin kanssa.

Linkitä laskut tämän kentän perusteella. Valitse tämä rivillä remittance_information tai reference_number. Jokainen uusi tapahtuma, jonka viestiteksti tai viitenumero sisältää avoimen myyntilaskun (saapuva raha) tai rekisteröidyn ostolaskun (lähtevä raha) numeron, täsmäytetään siihen ja maksu kirjataan. Kun maksaja on tunnettu kumppani tallennetun IBAN-tunnuksen, tarkan kumppanin nimen tai koodin perusteella, laskun on oltava kyseisen kumppanin. Tuntemattoman maksajan suoritus täsmäytetään vain silloin, kun se vastaa jäljellä olevaa saldoa ja laskun numero sisältää sen etuliitteen. Jäljellä olevaa saldoa suurempaa maksua ei koskaan täsmäytetä. Tapahtumat, jotka eivät läpäise näitä tarkistuksia, jäävät täsmäyttämättä, jotta voit täsmäyttää ne manuaalisesti. Valinta Luo ennakkomaksulaskuja täsmäyttämättömille saapuville maksuille muuttaa tunnetun kumppanin täsmäyttämättömän suorituksen kyseisen summan suuruiseksi ennakkomyyntilaskuksi, jonka päiväys on maksupäivä ja jolla on annettu arvonlisäverokanta tai valittu tuoterekisterinimike. Tämä edellyttää asetusta Luo puuttuvat asiakkaat, jotta kumppani tunnetaan.

Tallenna pohja.

4. Ota pohja käyttöön ja valitse aikataulu

Kohdassa Pankki → Yhteydet jokaisella linkitetyllä tilillä on pohjan valinta ja aikataulun valinta. Valitse pohja, valitse Synkronoi manuaalisesti, Synkronoi päivittäin, Synkronoi viikoittain tai Synkronoi kuukausittain, ja paina Käytä. Linkitetty tili ilman pohjaa synkronoi silti, mutta tallentaa vain tapahtumat; mitään ei kirjata, täsmäytetä tai luoda.

Päivittäisellä, viikoittaisella tai kuukausittaisella aikataululla API synkronoi tilin itsenäisesti: kerran tunnissa se etsii tilit, joiden viimeisin synkronointi on vanhempi kuin niiden aikaväli (24 tuntia, 7 päivää tai 30 päivää) ja synkronoi ne täsmälleen samoin kuin Synkronoi nyt tekisi, ajaen pohjan sen jälkeen. Ajastettu synkronointi lasketaan käyttöön samoin kuin manuaalinen (jokaista 10 haettua tapahtumaa kohti yksi pyyntö). Jos pankki hylkää synkronoinnin esimerkiksi siksi, että suostumus on vanhentunut, yhteyteen merkitään virhe ja se ohitetaan, kunnes muodostat yhteyden uudelleen.

5. Synkronointi

Paina Synkronoi nyt yhteyden kohdalla. Nordlet hakee uudet kirjatut tapahtumat jokaiselle linkitetylle tilille; odottavat tapahtumat ohitetaan, kunnes pankki kirjaa ne. Se hakee ne (edellisen synkronoinnin jälkeen, yhden viikon päällekkäisyydellä, jotta myöhäiset kirjaukset eivät jää huomaamatta), tallentaa ne kerran – tapahtumat tunnistetaan pankin kirjausviitteen perusteella – ja ajaa sitten tilin pohjan. Tulosrivi kertoo, kuinka monta tapahtumaa tuotiin ja kuinka monta oli olemassa ennestään; API:n kautta synkronointi palauttaa myös kirjattujen liikkeiden, luotujen kumppanien, linkitettyjen ja luotujen laskujen, täsmäytettyjen maksujen sekä sellaisten maksujen varoitusten määrän, joita ei voitu täsmäyttää.

Synkronointeja voidaan käynnistittää API:n kautta (bank/feeds/sync) aikataulun mukaisesti; jokaista 10 haettua tapahtumaa kohti laskutetaan yksi API-pyyntö.

6. Mistä löydät tiedot jälkikäteen

  • Pankki → Tapahtumat – kaikki synkronoidut tapahtumat tilitietyillä Välilehdillä; täsmäytetyt linkittyvät laskuun tai tositteeseen.
  • Laskut – täsmäyttämättömille suorituksille luodut ennakkomaksulaskut.
  • Kumppanit – luodut asiakkaat ja toimittajat, joilla jokaisella on IBAN pankkitilien alla.
  • Kirjanpito → Pääkirja / Tositteet – kirjaukset kuluille (pankki kumppanina), coroille, veroille ja maksuille.

Kun yhteys lakkaa toimimasta

Epäonnistunut synkronointi merkitsee yhteyteen pankin virheilmoituksen. Vanhentunut suostumus on tavallisin syy: paina saman pankin kohdalla Yhdistä uudelleen ja hyväksy käyttöoikeus. Linkitetyt tilit ja niiden pohjat säilytetään. Katkaise yhteys poistaa yhteyden ja sen tililinkitykset, ei jo tallennettuja tapahtumia.