Nordlet

← Grunnleggende / SDK-er

Bankforbindelser

Koble til en bank via åpen bankvirksomhet, knytt sammen kontoene, velg en importmal og synkroniser transaksjoner til hovedboken.

Denne guiden dekker live-tilkoblingen til en bank (PSD2 open banking): hvordan du kobler til, hvordan du knytter bankens kontoer til hovedboken din, hvordan hver synkronisering kan opprette partnere, matche fakturaer og bokføre gebyrer ved hjelp av en importmal, og hva synkroniseringen returnerer. API-detaljene finnes under Bank- og betalingsimport. For kontoutskriftsfiler i stedet for en live-tilkobling, se Import av kontoutskrifter (camt.053).

1. Koble til banken

Gå til Bank → Tilkoblinger, velg land og trykk på Vis banker. Velg banken din og kontoholdertype (bedrift eller privat), og trykk deretter på Koble til. Du blir omdirigert til bankens egen samtykkeside. Logg inn der og godkjenn tilgangen, hvorefter banken returnerer deg til Nordlet. Tilkoblingen vises i listen med utløpsdato for samtykket. Samtykker er tidsbegrenset av banken (vanligvis 90 eller 180 dager); når et samtykke utløper, må du koble til på nytt.

Listen over banker kommer fra open banking-tilbyderen som er konfigurert for Nordlet-instansen. Hvis landet ikke viser noen banker, dekker ikke tilbyderen dette landet ennå.

2. Knytte sammen bankens kontoer

Under tilkoblingen vises hver konto som banken eksponerer, med IBAN og valuta. For hver konto velger du en eksisterende bankkonto fra hovedboken eller Opprett en ny bankkonto, setter eventuelt en dato for synkronisering fra, og trykker på Knytt til. Kun tilknyttede kontoer synkroniseres. Uten en startdato for synkronisering henter den første synkroniseringen de siste 90 dagene.

3. Opprette importmalen

Gå til Bank → Importmaler, trykk på Ny importmal, velg type Bankforbindelse og gi den et navn. Radene er attributtene som bankfeeden returnerer per transaksjon. Feltet Påkrevd i fil beholdes for fullstendighetens skyld; en live-feed valideres ikke mot dette.

Hovedbokskonto. Den enkle beløpsraden transaction_amount.amount og regelradene kan tilordnes en hovedbokskonto. Hver synkroniserte transaksjon som produseres fra en tilordnet rad, bokføres umiddelbart og markeds som matchet mot bilaget. Regelradene plukker transaksjoner etter banktransaksjonskode eller retning:

Rad Plukker Typisk konto
Bankgebyrer (kode CHRG) transaksjoner der koden tilhører familien CHRG bankgebyrkostnad (6800 i standard kontoplan)
Renter (kode INTR) kodefamilie INTR renteinntekt eller rentekostnad
Skatter og avgifter (kode TAXE) kodefamilie TAXE skatte- og avgiftsbetalinger
Utgående betalinger ellers enhver annen debet la stå som "Ikke bokført" slik at betalinger matche mot kjøpsfakturaer
Inngående betalinger ellers enhver annen kredit la stå som "Ikke bokført" slik at innbetalinger matche mot salgsfakturaer
transaction_amount.amount alle transaksjoner som ingen regel plukket opp vanligvis "Ikke bokført"

En transaksjon bokføres på kontoen til den første raden den matcher: først kodefamilie, deretter retning, og til slutt den enkle beløpsraden. Koden kommer fra bankens bank_transaction_code; banker som ikke sender dette, etterlater koderadene uten treff.

Opprett manglende kunder / leverandører. Kryss av for Opprett manglende kunder på raden debtor.name for å opprette en kunde for hver ukjente betaler av innkommende midler, og Opprett manglende leverandører på raden creditor.name for hver ukjente mottaker av utgående midler. Partnere gjenkjennes etter IBAN (debtor_account.iban / creditor_account.iban, lagret på partnerens bankkonti), deretter etter nøyaktig navn. En partner som gjenkjennes på navn, får lagt til IBAN-en. En ny partner er en bedrift hvis navnet inneholder en selskapsform (AS, NUF, ANS, DA, ASA, …) og ellers en person.

Opprett partner for banken. Kryss av for dette på regelraden for bankgebyrer. Synkroniseringen oppretter en leverandør oppkalt etter den tilkoblede banken én gang og registrerer hvert gebyr i journalen med den partneren.

Knytt til fakturaer med dette feltet. Kryss av for dette på raden remittance_information eller reference_number. Hver nye transaksjon der betalingsinformasjonen eller referansen inneholder nummeret til en ubetalt utstedt salgsfaktura (innkommende midler) eller en registrert kjøpsfaktura (utgående midler), matche mot denne, og betalingen bokføres. Når betaleren er en kjent partner (via en lagret IBAN eller det nøyaktige partnernavnet eller -koden), må fakturaen tilhøre den partneren. En betaling fra en ukjent betaler matches bare når den tilsvarer restansesaldoen, og fakturanummeret inneholder seriemafikset. En betaling som er større enn restansesaldoen, matches aldri. Transaksjoner som ikke består disse kontrollene, forblir umatchet slik at du kan matche dem manuelt. Alternativet Opprett forskuddsfakturaer for umatchede innbetalinger gjør en umatchet innbetaling fra en kjent partner om til en utstedt forskuddsfaktura på beløpet, datert til betalingsdagen, med angitt mva-sats eller valgt artikkel. Dette krever at Opprett manglende kunder er aktivert slik at partneren er kjent.

Lagre malen.

4. Bruk malen og velg tidsplan

Tilbake under Bank → Tilkoblinger har hver tilknyttet konto en nedtrekksmeny for mal og tidsplan. Velg mal, velg Synkroniser manuelt, Synkroniser daglig, Synkroniser ukentlig eller Synkroniser månedlig, og trykk på Bruk. En tilknyttet konto uten mal synkroniseres fremdeles, men registrerer bare transaksjonene; ingenting bokføres, matches eller opprettes.

Med en daglig, ukentlig eller månedlig tidsplan synkroniserer API-et kontoen på egen hånd: en gang i timen sjekker systemet etter kontoer hvis siste synkronisering er eldre enn perioden deres (24 timer, 7 dager eller 30 dager) og synkroniserer dem nøyaktig slik Synkroniser nå ville gjort, og kjører malen etterpå. En planlagt synkronisering teller med i forbruket på lik linje med en manuell (hver 10. hentede transaksjon = én forespørsel). Hvis banken avviser synkroniseringen, for eksempel fordi samtykket er utløpt, merkes tilkoblingen med feilen og hoppes over til du kobler til på nytt.

5. Synkronisering

Trykk på Synkroniser nå på tilkoblingen. Nordlet henter nye bokførte transaksjoner for hver tilknyttede konto; ventende transaksjoner hoppes over til banken bokfører dem. Den henter dem (siden forrige synkronisering, med en ukes overlapp slik at sen bokføring ikke går glipp av), registrerer dem én gang – transaksjoner gjenkjennes på bankens bilagsreferanse – og kjører deretter kontoens mal. Resultatlinjen rapporterer hvor mange transaksjoner som ble importert, og hvor mange som allerede fantes. Via API-et returnerer synkroniseringen også antall bokførte bevegelser, opprettede partnere, tilknyttede og opprettede fakturaer, matchede betalinger samt advarsler for betalinger som ikke kunne matches.

Synkroniseringer kan utløses fra API-et (bank/feeds/sync) etter en tidsplan, der hver 10. hentede transaksjon teller som én API-forespørsel.

6. Hvor du finner ting etterpå

  • Bank → Transaksjoner – hver synkroniserte transaksjon, fordelt på kontofanene; matchede transaksjoner har lenke til fakturaen eller bilaget.
  • Fakturaer – forskuddsfakturaer opprettet for umatchede innbetalinger.
  • Partnere – opprettede kunder og leverandører, hver med IBAN lagret under bankkonti.
  • Hovedbok → Journal – bokføringen for gebyrer (med banken som partner), renter, skatter og avgifter samt betalinger.

Når tilkoblingen slutter å fungere

En synkronisering som feiler, merker tilkoblingen med bankens feilmelding. Utløpt samtykke er den vanlige årsaken: trykk på Koble til for den samme banken igjen og godkjenn tilgangen. De tilknyttede kontoene og malene deres beholder. Fjern tilkobling sletter tilkoblingen og kontotilkoblingene dens, men ikke transaksjonene som allerede er registrert.