Oppkobling FREG

Søknadsskjema (RF-1514)

1. Åpne søknaden via denne lenken (altinn.no) (info.altinn.no) og velg “Start tjenesten” (pålogging til Altinn kreves)
2. Utfyller må ha Altinn-rollen Begrenset signeringsrett (info.altinn.no) 
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  (info.altinn.no) eller være daglig leder / administrerende direktør.
• Skjemaet kan ikke brukes av privatpersoner.

I Maskinporten kan konsumenter gi fullmakt videre til en leverandør. 

1. Du finner veileder for hvordan delegere tilgang på Altinn (info.altinn.no)
2. Søk opp org.nr 999 523 625 Finans Norge Forsikringsdrift – søk opp og deleger tilgang til rettighetspakken virksomheten har blitt tildelt. 
3. Har du spørsmål om det å delegere fullmakt, se Altinns hjelpesider (info.altinn.no) 
4. Etter delegering, send epost til freg@forsikringsdrift.no (NO) og informer om at ditt selskap har delegert rettigheter til Finans Norge Forsikringsdrift
5. Finans-FREG gir tilbakemelding per epost om status.

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 (freg-finansnorge.no)

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

• https://qa-freg.finansnorge.no/ (qa-freg.finansnorge.no)

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

• https://inttest-freg.finansnorge.no (inttest-freg.finansnorge.no)

• Finans-FREG tjenesten er dokumentert i Swagger (app.swaggerhub.com). (0)
  • 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). (skatteetaten.github.io)

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 tjenesten er dokumentert i Swagger: https://app.swaggerhub.com/apis/Finans-FREG2/freg-api/v1.6.0 (0)
• Status for Finans Norge Forsikringsdrift sine tjenester finner du her: https://status.finansnorge.no (status.finansnorge.no)
• Informasjon og nyheter for Skatteetaten sine tjenester finner du her: https://skatteetaten.github.io/folkeregisteret-api-dokumentasjon/nyheter/ (skatteetaten.github.io)
• Skatteetaten sin statusside finner du her: https://status.skatteetaten.no (status.skatteetaten.no)

Eksterne lenker og informasjon

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

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'