Oppkobling FREG

Søknadsskjema (RF-1514)

1. Åpne søknaden via denne lenken (altinn.no) (nor01.safelinks.protection.outlook.com) og velg “Start tjenesten” (pålogging til Altinn kreves)
2. Søk om tilgang til rettighetspakke finans
3. Etter behandling og godkjenning mottar virksomheten melding i Altinn.
4. Ved godkjenning kan virksomheten gå videre til “Delegere tilgang til FNF”
5. Virksomheter uten konsesjon som finansforetak vurderes individuelt.

Hvorfor må virksomheten søke om tilgang

• Skjemaet brukes for tilgang til det moderniserte folkeregisteret.
• Alle må søke om ny tilgang, uavhengig av tidligere tilgang til folkeregisteropplysninger.

Hvem skal bruke skjemaet

• Alle virksomheter med norsk organisasjonsnummer kan bruke skjemaet.
• Utfyller må ha Altinn-rollen Begrenset signeringsrett (nor01.safelinks.protection.outlook.com) (nor01.safelinks.protection.outlook.com) eller være daglig leder / administrerende direktør.
• Skjemaet kan ikke brukes av privatpersoner.

Virksomheten oppretter tilgang til FNF via Altinn

Bemyndiget person må via Altinn (eur03.safelinks.protection.outlook.com) (nor01.safelinks.protection.outlook.com) delegere tilgangen til FNF:

1. Logg inn på Altinn og velg foretaket du representerer.
2. Klikk “profil” i toppmenyen.
3. Velg “Tilgang til programmeringsgrensesnitt - API”.
4. Klikk “Gi og fjerne API tilganger”.
5. Velg “+ Deleger nytt API”
6. Søk opp org.nr 999 523 625 Finans Norge Forsikringsdrift – trykk på «+» til høyre for Finans Norge Forsikringsdrift og velg «Neste».
7. I feltet “Velg hvilke API du vil gi tilgang til …” søk opp navnet på delegeringsskjema som ditt foretak er innvilget, for eksempel "Folkeregisteret - Finansforetak - På vegne av" og klikk dette.
8. Bekreft ved å klikke “+ tegnet” i «Delegerbare API»
9. Klikk «Neste» og deretter «Bekreft».
10. Etter bekreftelse, send epost til freg@forsikringsdrift.no (NO) (NO) og informer om at ditt selskap har delegert rettigheter til Finans Norge Forsikringsdrift
11. Finans-FREG gir tilbakemelding per epost om status.

• Ved spørsmål om delegeringsskjema, kontakt freg@forsikringsdrift.no (NO) (NO)

Etter at virksomheten har gitt FNF tilgang, kan FNF koble opp og generere token for å hente data på vegne av virksomheten.

• Finans-FREG oppretter MP-integrasjon på eget organisasjonsnummer 999 523 625 med korrekt scope.
• Finans-FREG bruker egen klient til å forespørre token på vegne av konsument (consumer_org).

• Dekkes av Skatts tilkoblingsavtale. Finans-FREG bruker samme SLA, virksomhetene er dermed dekket av Finans-FREGs avtale med Skatt.

URL til tjenestene bygges opp slik:

Produksjonsmiljø - brukes av virksomheter i produksjon med Finans-FREG tjenesten.

• https://freg-finansnorge.no (nor01.safelinks.protection.outlook.com)

QA-miljø - produksjonslikt miljø for testing av Finans-FREG tjenesten.

• https://qa-freg.finansnorge.no/ (nor01.safelinks.protection.outlook.com)

Inttest miljø - Finans-FREGs interne testmiljø, kun for Finans-FREG.

• https://inttest-freg.finansnorge.no (nor01.safelinks.protection.outlook.com)

• Finans-FREG tjenesten er dokumentert i Swagger (app.swaggerhub.com) (nor01.safelinks.protection.outlook.com).
  • Finans-FREG speiler Skatts løsning for Rettighetspakke finans.
  • Tenor testdatasøk er et verktøy for systemutviklere som trenger testdata. Tenor testdatasøk finnes her (skatteetaten.no) (nor01.safelinks.protection.outlook.com).

Kort om Finans-FREG løsningen:

• Finansvirksomhet gjør oppslag på person
  • Dette kreves for at HUB skal lagre data fra Freg. Første oppslag registreres hos Skatt.
  • Oppslaget må registreres for å motta hendelsesvarsel for personen.
• Endringshendelse på person i Freg
  • HUB lytter på endringsmeldinger fra Freg og oppdaterer data i henhold til rettighetspakke.
• Sender hendelsesvarsel videre til alle som har gjort oppslag. Applikasjoner registrert med kundeforhold får tilleggsinformasjon.
• Kundeforhold avsluttes
  • Virksomhet kan melde til HUB ved avsluttet kundeforhold for å stoppe oppdateringer.
  • Hvis ingen kundeforhold eksisterer, slettes persondata fra HUB.

Finans-FREG teknisk beskrivelse finnes på Swagger (app.swaggerhub.com) (nor01.safelinks.protection.outlook.com) - inkluderer også versjonsoversikt.

Status publiseres på en egen nettside - UptimeMonitor for tjenesten finnes her (status.finansnorge.no) (nor01.safelinks.protection.outlook.com)

Nyheter fra Folkeregisteret finnes her (skatteetaten.github.io) (nor01.safelinks.protection.outlook.com)

Eksterne lenker og informasjon

• Folkeregisteret - Swagger. Informasjon om Folkeregisteret - lesemodell begrenset taushetsbelagt finnes her (6) (nor01.safelinks.protection.outlook.com).
• Informasjonsmodell. Folkeregisterets informasjonsmodell finnes her (skatteetaten.github.io) (nor01.safelinks.protection.outlook.com).

For å bruke kunderegister må selskapet opprette kunderegister og foreta bulkoppslag på kundene i det spesifikke kunderegisteret.

Hva som må gjøres:

• Virksomheten registrerer personer som skal tilhøre kundeporteføljer.
• En person kan knyttes til kundenummer og flere applikasjoner per virksomhet.

Muligheter i kunderegistre

• Opprette register
• Spørre på person i register / endringer for person i register
• Slette register

Eksempler:

1. Opprettelse av kunderegister.

curl --cert ./auth.pem -X POST 'https://qa-freg.finansnorge.no/api/registre' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"registerkode": "KREG01", "registernavn": "Kunderegister 1"}'

2. Bulkoppslag for personer i eget kunderegister, for sporing hos Skatteetaten og oppdatering av egne data.

curl --cert ./auth.pem -X POST 'https://qa-freg.freg.finansnorge.no/api/finans/v1/personer/bulkoppslag?somBestilt=true&part=person-basis&part=historikk&part=identitetsgrunnlag-utvidet&part=relasjon-utvidet' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{ "foedselsEllerDNummer": [ "12345678901", "14848399257", "04887797019" ] }'

3. Innmelding av personer i kunderegister (egenId = egen id / kundenummer for kunde).

curl --cert ./auth.pem -X POST 'https://qa-freg.finansnorge.no/api/registre/KREG01/personer' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"personer":[ {"egenId": "id1", "foedselsEllerDNummer": "12345678901"}, {"egenId": "id2", "foedselsEllerDNummer": "14848399257"}, {"egenId": "id3", "foedselsEllerDNummer": "04887797019"} ]}'

4. Hendelser for personer i kunderegister (seq = sekvensnummer for siste nedlastede hendelse pluss én).

curl --cert ./auth.pem -X GET 'https://qa-freg.finansnorge.no/api/finans/v1/hendelser/feed?seq=1&registerkode=KREG01' -H 'Accept: application/json'

5. Nedlasting av persondata knyttet til hendelse, for oppdatering av person i eget kunderegister.

curl --cert ./auth.pem -X GET 'https://qa-freg.finansnorge.no/api/finans/v1/personer/01010100646?part=person-basis&part=historikk&part=identitetsgrunnlag-utvidet&part=relasjon-utvidet' -H 'Accept: application/json'

6. Sletting av personer fra kunderegister.

curl --cert ./auth.pem -X POST 'https://qa-freg.finansnorge.no/api/registre/KREG01/personer/slett' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"personer":[ {"egenId": "id1" }, {"egenId": "id2" }, {"egenId": "id3" } ]}'

7. Sletting av kunderegister med personer.

curl --cert ./auth.pem -X DELETE 'https://qa-freg.finansnorge.no/api/registre/KREG01?slettPersoner=true' -H 'Accept: application/json'