Endringer i tjenesten

Historiske kundeforhold

Fra 15.07.2026 støtter KFR registrering av historiske kundeforhold via de eksisterende endepunktene for enkeltregistrering (POST relationshipType) og batch (POST batch). Endringen er dokumentert i API-spesifikasjon v1.4.0 og er bakoverkompatibel: Forespørsler uten datoangivelse fungerer som før, og kundeforholdet åpnes da fra dagens dato.

Finansforetak bør registrere historiske kundeforhold slik at registeret blir mest mulig fullstendig, også for kundeforhold som er avsluttet.

Hva er nytt

Enkeltregistrering – POST /customers/financialInstitutions/{fid}/relationshipType/{type} kan nå ta et valgfritt JSON-body:

{
  "openDate": "2020-01-01",
  "closeDate": "2020-12-31"
}

• openDate er første dag kundeforholdet gjelder fra (inklusiv). Utelates body, åpnes kundeforholdet fra dagens dato.
• closeDate er siste dag kunden fortsatt er i kundeforholdet (inklusiv). Utelates closeDate, eller settes den til null, registreres kundeforholdet som åpent fra openDate.

Batch – POST /customers/financialInstitutions/{fid}/batch. Hver post i CSV-filen kan nå angi en periode med # som skilletegn:

customerId#openDate#closeDate

Eksempler: 999888777#2019-11-08 (åpent fra dato) eller 999888777#2019-11-08#2020-11-08 (avsluttet historisk kundeforhold). Poster uten dato fungerer som før. Merk at batch er asynkron: Responsen bekrefter at filen er gyldig og mottatt, men dataene er ikke nødvendigvis lest inn i databasen når svaret mottas.

I v1.4.0 er CorrelationID-headeren også gjort påkrevd på GET-endepunktene (tidligere valgfri).

Hva må finansforetak gjøre?

• Implementere støtte for openDate og closeDate ved enkeltregistrering og batch, dersom historiske kundeforhold skal registreres.
• Verifisere registreringer med GET /customers/financialInstitutions/{fid}/relationships etter både enkeltregistrering og batch.
• Være oppmerksom på at batch er asynkron, og at poster som overlapper med allerede registrerte kundeforhold ikke blir lagt inn.
• Gjennomføre relevante testcaser i testmiljø før produksjonssetting.

Valideringsregler

De fullstendige valideringsreglene er beskrevet i API-spesifikasjon. For historiske kundeforhold er disse forholdene særlig viktige:

• Datoformatet er YYYY-MM-DD, og datoer kan ikke ligge frem i tid (KFR-010).
• closeDate kan bare brukes sammen med openDate, og closeDate kan ikke være før openDate.
• Overlappende perioder for samme kunde, finansforetak og kundeforholdstype er ikke tillatt.
• Et nytt kundeforhold kan starte samme dag som et tidligere kundeforhold ble avsluttet. Dette regnes ikke som overlapp.

Ved enkeltregistrering vil en overlappende periode ikke bli registrert, selv om tjenesten returnerer 200. Ved batch vil overlapp innenfor samme fil avvises med 409 (KFR-011), mens poster som overlapper med allerede registrerte kundeforhold ikke blir lest inn. Dette må verifiseres i etterkant, siden batch behandles asynkront.

Testcaser for historiske kundeforhold

Finansforetak som skal ta i bruk historiske kundeforhold, bør gjennomføre testcasene under i testmiljøet i tillegg til de ordinære integrasjonstestene.

Enkeltregistrering (POST relationshipType):

Batch (POST batch):

Registreringene verifiseres med GET /customers/financialInstitutions/{fid}/relationships, som returnerer fromDate og eventuell toDate per kundeforhold. Ved batch bør man vente noe tid før verifisering, siden innlesningen skjer asynkront.

Se API-spesifikasjon for den generelle tekniske beskrivelsen av endepunktene, Datamodell for felter og objekter, og API-specification v1.4.0 for full formell spesifikasjon.