/
CPR Direkte OFF4 - Personnummeropslag til offentlige myndigheder

CPR Direkte OFF4 - Personnummeropslag til offentlige myndigheder

Jan 08, 2026

Indholdsfortegnelse

1. Indledning

Dette dokument beskriver CPR Direkte service grænsefladen for servicen "OFF4 - Personnummeropslag til offentlige myndigheder".

1.1. Formål

Servicen har til formål at levere detaljerede persondata til offentlige myndigheder. Servicen leverer data i samme recordformat som udtræksprodukt U12170P "Ændringsudtræk til offentlige med valgfrie recordtyper" og derfor kan udtrækskunder bruge servicen til at supplere eller genopfriske data i deres eget systemer mellem CPR batchkørsler.

Servicen leverer navne- og adressedata på personer, der er registreret med navne- og adressebeskyttelse jvf. CPR-lovens paragraf 38 stk.4.

2. Adgang

Følgende afsnit beskriver de adgangskrav der stilles til brugere af servicen.

2.1. Kundefokus

Brug af denne service henvender sig til offentlige myndigheder.

2.2. Adgangskontrol

Brugere skal kunne autentificeres af CPR-sikkerhedssystemet for at kunne benytte servicen. Derudover skal brugere være tildelt en CPR Direkte sikkerhedsprofil, der giver adgang til servicen.

3. Parametre

Servicen understøtter følgende parametre:

Parameter: Adresseringsnavn format
Der kan vælges, om adresseringsnavne udskrives i enten Fornavn(e) Efternavn eller Efternavn,Fornavn(e) formatter.
Standardværdi: Efternavn,Fornavn(e)

Parameter: Sidst kendte adresse på inaktive personer
Der kan vælges hvorvidt servicen leverer sidste kendte adresse på inaktive (CPR statuskode 70, 80 eller 90) personer i records, der indeholder adressedata.
Parameterværdier: Ja eller Nej
Standardværdi: Nej

Hvis der ønskes ændret i opgavens parametre skal du kontakte CPR Kundecenter.

Hvis CPR Direkte opgaven er tilknyttet en udtræksopgave vil indstillinger fra udtræksopgaven også bruges i CPR Direkte opgaven.

4. Kommunikationsprotokol

Kommunikationen med servicen foregår over en almindelig socketforbindelse. Beskeder mellem klientapplikationen og servicen sendes i fastlængde recordformat jvf. recordbeskrivelserne i dette dokument.

For at udføre personnummeropslag skal brugere først autentificeres af CPR-sikkerhedssystemet. Det sker ved at udføre følgende:

  1. Opret forbindelse til CPR Direkte

  2. Send Login forespørgsel

  3. Læs autentifikation token fra Login respons (eller håndtere evt. fejl angivet i respons)

Hvis brugeren blev autentificeret kan tokenværdien fra responsen bruges for at foretage et personnummeropslag:

  1. Opret forbindelse til CPR Direkte

  2. Send Personnummeropslag forespørgsel

  3. Læs data fra Personnummeropslag respons (eller håndtere evt. fejl angivet i respons)

Autentifikation tokenværdier kan genbruges i CPR Direkte OFF4 servicen. Det betyder at brugere kan nøjes med at logge på én gang hvorefter de kan foretage flere personnummeropslag med den samme tokenværdi efterfølgende.

CPR Direkte tokenværdier udløber 30 minutter fra tidspunktet, de sidst blev anvendt i CPR-systemet.

5. Inddata

I dette afsnit beskrives de recordtyper der bruges for at autentificere brugeren samt udføre personnummeropslag.

5.1. Login forespørgsel

Record der sendes for at hente en tokenværdi fra CPR-sikkerhedssystemet. Autentifikation er nødvendigt for at få en tokenværdi som er krævet for at foretage opslag i CPR.

Recordfeltnavn

Format

Længde

Position

Beskrivelse

Recordfeltnavn

Format

Længde

Position

Beskrivelse

CPRTRANS

A

4

1

Service transaktionskode: OFF4

KONSTANT

A

1

5

Konstantværdi (,)

KUNDENR

N

4

6

Brugerens kundenummer

KONSTANT

N

1

10

Konstantværdi (9)

KONSTANT

N

1

11

Konstantværdi (0)

BRUGER-ID

A

8

12

Brugerens CPR Direkte personkode

KENDEORD

A

8

20

Brugerens CPR Direkte adgangskode

NYT KENDEORD

A

8

28

Ny adgangskode (kun hvis der ønskes passwordskift)

Recordlængde: 35

Eksempel:

OFF4,111190BRUGER Password

5.2. Login respons

Record der leveres tilbage til brugeren i forbindelse med en login forespørgsel.

Hvis FEJLNR er 00 kan brugeren hente en tokenværdi fra TOKEN recordfeltet.

Recordfeltnavn

Format

Længde

Position

Beskrivelse

Recordfeltnavn

Format

Længde

Position

Beskrivelse

KUNDENR

N

4

1

Brugerens kundenummer

KONSTANT

N

1

5

Konstantværdi (9)

KONSTANT

N

1

6

Konstantværdi (0)

TOKEN

A

8

7

Autentifikation tokenværdi

BRUGER-ID

A

8

15

Brugerens CPR Direkte personkode

FEJLNR

N

2

23

Fejlnummer. Se Fejlnumre og fejltekster

LÆNGDE

N

4

25

Svarlængde

Recordlængde: 28

Eksempel (tokenværdi er KETDqhzM):

111190KETDqhzMBRUGER 000028

5.3. Personnummeropslag forespørgsel

Record der indeholder data relateret til det personnummer (CPR-nr.) der ønskes slået op.

Recordfeltnavn

Format

Længde

Position

Beskrivelse

Recordfeltnavn

Format

Længde

Position

Beskrivelse

CPRTRANS

A

4

1

Service transaktionskode: OFF4

KONSTANT

A

1

5

Konstantværdi (,)

KUNDENR

N

4

6

Brugerens kundenummer

ABON_TYPE

N

1

10

Abonnementssætning/sletning. Se Abonnementstyper

DATA_TYPE

N

1

11

DATA recordfeltformat (0=Ingen data ønskes, 6=Data ønskes)

TOKEN

A

8

12

Autentifikation tokenværdi

BRUGER-ID

A

8

20

Brugerens CPR Direkte personkode

FEJLNR

N

2

28

Fejlnummer. Se Fejlnumre og fejltekster

PNR

N

10

30

CPR-nr. der ønskes data på

Recordlængde: 39

Eksempel (PNR er 1212123333):

OFF4,111106KETDqhzMBRUGER 001212123333

5.4. Personnummeropslag respons

Record der indeholder responsen for et personnummeropslag.

Hvis der fandtes et personnummer i CPR leveres der data relateret til personnummeret tilbage i DATA recordfeltet. Hvilke records der leveres tilbage i DATA feltet styres af kundens opgaveindstillinger.

Recordfeltnavn

Format

Længde

Position

Beskrivelse

Recordfeltnavn

Format

Længde

Position

Beskrivelse

KUNDENR

N

4

1

Brugerens kundenummer

ABON_TYPE

N

1

5

Abonnementssætning/sletning. Se Abonnementstyper

DATA_TYPE

N

1

6

DATA recordfeltformat (0=Ingen Uddata ønskes, 6=Uddata ønskes)

TOKEN

A

8

7

Autentifikation tokenværdi

BRUGER-ID

A

8

15

Brugerens CPR Direkte personkode

FEJLNR

N

2

23

Fejlnummer. Se Fejlnumre og fejltekster

LÆNGDE

N

4

25

Svarlængde

DATA

A

*

29

Se Uddata

Recordlængde: 28 + DATALÆNGDE (samlet længde angives i LÆNGDE recordfeltet)

6. Uddata

Servicen returnerer data i form af fastlængde records. Hvilke records leveres i svaret fra servicen afhænger af kundens opgave konfiguration. I de følgende afsnit beskrives dataformatet for de records, der kan leveres tilbage i responsen.

Dokumentation og opbygning af recordfelter er identisk mellem CPR udtræk og CPR Direkte for de recordtyper, de forskellige produkter har tilfælles. I visse records står der at "der kan uden yderligere varsel tilføjes felter for enden af recorden." Dette gælder imidlertid ikke for CPR Direkte records i og med nye felter forenden af recorden vil påvirke starten af de evt. efterfølgende records i responsen fra CPR Direkte servicen.

6.1. Recordtyper (DATA)

Oversigten viser, hvilke records der kan forekomme i DATA recordfeltet.

Recordtype

Recordnavn

Recordtype

Recordnavn

000

STARTRECORD

001

PERSONOPLYSNINGER

002

AKTUELLE ADRESSEOPLYSNINGER

002B

AKTUELLE ADRESSEOPLYSNINGER MED ADRESSE UUID

003

ADRNVN OG KLARSKRIFTADRESSE

004

BESKYTTELSE

005

AKTUELLE UDREJSEOPLYSNINGER

006

KONTAKTADRESSE

007

AKTUELLE FORSVINDINGSOPLYSNING

008

AKTUELLE NAVNEOPLYSNINGER

009

FØDSELSREGISTRERINGSOPLYSNINGER

010

AKTUELT STATSBORGERSKAB

011

FOLKEKIRKEOPLYSNINGER

012

AKTUEL CIVILSTAND

013

AKTUEL SEPARATION

014

BØRN

015

MOR/FAR/MEDFAR OG FAR OPLYSNINGER

016

FORÆLDREMYNDIGHED

017

UMYNDIGGØRELSE OG VÆRGE

018

KOMMUNALE FORHOLD

037

PERSONID

050

KREDITADVARSEL

052

UMYNDIGGØRELSE OG VÆRGE MED VÆRGEMÅLTYPE

053

VÆRGEMÅL OG VÆRGE MED GENERISK ADRESSE.

999

SLUTRECORD

6.1.1. 000 Startrecord

Start record.

Format: