Datamodell

Denne siden beskriver objektene og feltene som inngår i KFR, uavhengig av det enkelte endepunktet. For fullstendig skjemadefinisjon, se API-specification v1.4.0.

RelationshipType

Angir hvilken type kundeforhold som registreres eller slettes.

Verdi	Beskrivelse
DSOPBANK	Kunden eier minst én konto eller tilsvarende som kan brukes til betalingstransaksjoner, eller som kan holde disponible midler i finansforetaket.
DSOPBANKRIGHTTOUSE	Kunden eier ikke en slik konto, men har rett til å utføre betalingstransaksjoner i finansforetaket.

Kundeforhold (Customer)

Returneres fra GET /customers/financialInstitutions/{fid}/relationships og representerer én periode med et gitt kundeforhold:

Felt	Type	Beskrivelse
relationshipType	enum	Se RelationshipType over.
fromDate	dato	Dato kundeforholdet ble opprettet/åpnet fra (inklusiv).
toDate	dato	Dato kundeforholdet ble avsluttet (inklusiv). Returneres ikke dersom kundeforholdet fortsatt er aktivt.

Responsen inneholder i tillegg feltet customerRelationshipIdentifier (kunde-ID lagret i KFR). Dette feltet er foreløpig ikke i bruk.

Et kundeforhold kan altså være aktivt (uten toDate) eller historisk (med toDate). Se Endringer i tjenesten for hvordan periodene registreres.

Kundeforhold per finansforetak (CustomerRelation)

Returneres fra GET /customers/financialInstitutions/{fid}/ og representerer opplysninger om det angitte finansforetaket dersom kunden har eller har hatt kundeforhold der:

Felt	Type	Beskrivelse
organizationID	string	Organisasjonsnummer, 9 siffer.
bankName	string	Navn på finansforetaket.
activeAccount	boolean	Se eget avsnitt under.

Om feltet activeAccount

Feltet indikerer om kunden har minst én konto som er aktiv og kan motta betalinger via NICS (Norwegian Interbank Clearing System). I KFR vil dette feltet alltid være false, fordi KFR opererer på personnivå og ikke har tilgang til kontodetaljer eller informasjon om NICS-berettigelse. Til sammenligning benytter KAR (Konto- og adresseringsregisteret) kontodata og kan derfor avgjøre om en konto oppfyller kriteriene for å være aktiv. Se Om tjenesten for forskjellen mellom KFR og KAR.

Perioder og historikk (fra 15.07.2026)

Ved registrering, enten ved enkeltregistrering eller batch, kan det angis en periode i stedet for kun en startdato:

Felt	Påkrevd	Beskrivelse
openDate	Nei	Første dag kundeforholdet gjelder fra (inklusiv). Utelates den, åpnes kundeforholdet fra dagens dato.
closeDate	Nei	Siste dag kunden fortsatt er i kundeforholdet (inklusiv). Krever at openDate også er satt.

Se API-spesifikasjon for valideringsregler knyttet til disse feltene, og Endringer i tjenesten for testcaser.

Identifikatorer

• CustomerID – fødselsnummer eller D-nummer (11 siffer), eller organisasjonsnummer (9 siffer).
• fid – organisasjonsnummer for finansforetaket, slik det er registrert i Brønnøysundregistrene.
• CorrelationID – UUID som følger hver forespørsel/respons for sporing.