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.

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.

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)

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.

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.

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.

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.

Recordlængde: 28 + DATALÆNGDE

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.

6.1. Recordtyper (DATA)

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

6.1.1. 000 Startrecord

Start record.

Format:

Recordlængde: 35

6.1.2. 001 Personoplysninger

Personoplysninger record.

Recordtypen leveres altid.

Format:

Recordlængde: 106

6.1.3. 002 Aktuelle adresseoplysninger

Adresseoplysninger record.

Ved valg af denne recordtype, bliver recordtype 004 Beskyttelser også leveret.

Format:

Recordlængde: 306

Denne recordtype forekommer kun for personer med status < 30. Se statuskoder i postopbygning 001.

Dog kan der vælges, at få den sidst kendte adresse leveret hvis personen er udrejst, død eller forsvundet (status 70, 80 eller 90 - se statuskoder i recordtype 001).

6.1.4. 002B Aktuelle adresseoplysninger med adresse UUID

Adresseoplysninger record med adresse UUID.

Ved valg af denne recordtype, bliver recordtype 004 Beskyttelser også leveret.

Format:

Recordlængde: 382

Denne recordtype forekommer kun for personer med status < 30. Se statuskoder i postopbygning 001.

Dog kan der vælges, at få den sidst kendte adresse leveret hvis personen er udrejst, død eller forsvundet (status 70, 80 eller 90 - se statuskoder i recordtype 001).

6.1.5. 003 Adrnvn og klarskriftadresse

Adresse navn og klarskfit record.

Ved valg af denne recordtype, skal recordtype 004 Beskyttelse også vælges.

Format:

Recordlængde: 249

Adressefelterne forekommer kun for personer med status < 30. Se statuskoder i postopbygning 001.

Der kan vælges, at få den sidst kendte adresse leveret hvis personen er udrejst, død eller forsvundet (status 70, 80 eller 90 - se statuskoder i recordtype 001).

Ved større systemer, kan recordtype 002 og CPR’s vejregister benyttes i stedet for recordtype 003.

6.1.6. 004 Beskyttelse

Skriver beskyttelser for personen

Skal vælges, hvis en af følgende records vælges:

• 002 Aktuelle adresseoplysninger
• 003 Adrnvn og klarskriftadresse
• 008 Aktuelle navneoplysninger

Format:

Recordlængde: 37

6.1.7. 005 Aktuelle udrejseoplysninger

Aktuelle udrejseopysninger record.

Format:

Recordlængde: 200

6.1.8. 006 Kontaktadresse

Aktuel kontaktadresse record.

Format:

Recordlængde: 203

6.1.9. 007 Aktuelle forsvindingsoplysning

Aktuel forsvindingsoplysning record.

Format:

Recordlængde: 26

6.1.10. 008 Aktuelle navneoplysninger

Aktuelt navn record.

Ved valg af denne recordtype, skal recordtype 004 Beskyttelse også vælges.

Format:

Recordlængde: 193

6.1.11. 009 Fødselsregistreringsoplysninger

Fødselregistreringsoplysninger record.

Format:

Recordlængde: 37

6.1.12. 010 Aktuelt statsborgerskab

Aktuelt statsborgerskab records.

Format:

Recordlængde: 30

6.1.13. 011 Folkekirkeoplysninger

Aktuel folkekirkeforhold record.

Format:

Recordlængde: 25

6.1.14. 012 Aktuel civilstand

Aktuel civilstand record

Format:

Recordlængde: 95

Civilstand (CIVST) kan være:

• U = Ugift
• G = Gift
• F = Fraskilt
• E = Enke/enkemand
• P = Registreret partnerskab
• O = Ophævet partnerskab
• L = Længestlevende partner
• D = Død

6.1.15. 013 Aktuel separation

Aktuel separation record.

Format:

Recordlængde: 36

6.1.16. 014 Børn

Børnerecords.

Format:

Recordlængde: 23

6.1.17. 015 Mor/Far og far oplysninger

Laver Mor/Far rekord.

Format:

Recordlængde: 147

Hvis mor/far har et personnummer er PNRMOR udfyldt, og felterne Mor/far fødselsdato (MOR_FOED_DT) og mor/far navn (MORNVN) blankt

Hvis far/medmor har et personnummer er PNRFAR udfyldt, og felterne Far/medmor fødselsdato (FAR_FOED_DT) og far/medmor navn (FARNVN) blankt

MORNVN_MRK og FARNVN_MRK:

• + = Navnet er forkortet
• * = Navnet indeholder tegn der ikke kan indrapporteres til CPR
• = = Navnet er utilstrækkeligt dokumenteret

6.1.18. 016 Forældremyndighed

Forældremyndighed record.

Format:

Recordlængde: 58

Recordfeltet RELTYP-CTFORÆLDRE_MYN-1 kan være:

• 0003 = Den første forælder som fremgår af record 015 (PNRMOR) er forældremyndighedsindehaver
• 0004 = Den anden forælder som fremgår af record 015 (PNRFAR) er forældremyndighedsindehaver
• 0005 = Forældremyndighedsindehaver 1 er ikke en forælder
• 0006 = Forældremyndighedsindehaver 2 er ikke en forælder

Kun børn og unge, som ikke er fyldt 18 år, er registreret med forældremyndighed. Børn og unge, hvor forældremyndighedsforholdende ikke er afklaret, kan være registreret uden oplysning om forældremyndighed.

Relationstype 0003 og 0004:
Hvis forældremyndighedsindehaveren er en registreret forælder er relationstypen 0003 henholdsvis 0004, og forældremyndighedsindehaveren fremgår af record 015 "Mor og far oplysninger". Hvis relationstypen er 0003 eller 0004 er recordfeltet RELPNR derfor tomt.

Relationstype 0005 og 0006:
Hvis forældremyndighedsindehaveren ikke er en registreret forælder er relationstypen 0005 henholdsvis 0006, og forældremyndighedsindehaveren identificeres ved anvendelse af recordfeltet RELPNR.

6.1.19. 017 Umyndiggørelse og værge

Umyndiggørelse og værge records.

Format:

Recordlængde: 272

Relation type: - UMYN_RELTYP = 0000 - Værge findes ikke i CPR - UMYN_RELTYP = 0001 - Værges Personnummer findes - UMYN_RELTYP = 0002 - Værges adresse findes

Hvis værge har et personnummer er RELPNR udfyldt, og felterne værges navn (RELADRSAT_RELPNR_TXT), værges adresse startdato (START_DT-RELPNR_TXT) samt RELTXT1 til RELTXT5 ikke udfyldt

6.1.20. 018 Kommunale forhold

Komunnale forhold record.

Format:

Recordlængde: 60

Der er følgende sammenhæng mellem KOMFORTYP og KOMFORHKOD:

KOMFORHTYP:

• Type 1 - adskilt - kode = A
• Type 2 - plejebarn - kode = P
• Type 3 - pensionsforhold - kode = F - Folkepension
  • kode = I - Førtidspension
  • kode = N - Delpension
• Type 4 - Betalingskommunekode - kode = Valid kommunekode
• Type 5 - Fri værdimængde
• Type 6 - Fri værdimængde

6.1.21. 037 PersonID

PersonID recordtype.

Format:

Recordlængde: 49

Et PersonID knyttes til et personnummer. Hvis et personnummer ændres, som følge af ændring i køn, fødselsdato eller en person tildeles et nyt personnummer med samme køn og fødselsdato som hidtil, bevares samme PersonID. Der kan således være mere end ét personnummer knyttet til samme PersonID.

En person, der samtidigt er tildelt mere end ét personnummer, er således også registreret med mere end ét PersonID. Hvis det konstateres, og et personnummer nedlægges og knyttes sammen med gældende personnummer, bevarer det historiske personnummer fortsat samme PersonID, ligesom det gældende personnummer bevarer samme PersonID.

6.1.22. 050 Kreditadvarsel

Skriver en aktuel kreditadvarsel record for personen.

Format:

Recordlængde: 29

6.1.23. 052 Umyndiggørelse og værge med værgemåltype

Umyndiggørelse og værge med værgemålstype.

Format:

Recordlængde: 287

Relation type:

• UMYN_RELTYP = 0000 - Værge findes ikke i CPR
• UMYN_RELTYP = 0001 - Værges Personnummer findes
• UMYN_RELTYP = 0002 - Værges adresse findes

Hvis værge har et personnummer er RELPNR udfyldt, og felterne værges navn (RELADRSAT_RELPNR_TXT), værges adresse startdato (START_DT-RELPNR_TXT) samt RELTXT1 til RELTXT5 ikke udfyldt

Værgemålstyper:

• DELVIS
• FULD

6.1.24. 999 Slutrecord

Slut record.

Format:

Recordlængde: 21

7. Hjælp

Følgende ressourcer kan bruges hvis der opleves fejl eller problemer med kald til servicen:

• CPR Dokumentationssite
• CPR Direkte kodeeksempler
• CPR Driftsstatus
• CPR Servicedesk

8. Bilag - Abonnementer, krav til adgangskoder og fejlkoder

8.1. Abonnementstyper

Servicen understøtter oprettelse og sletning af personnnummer-abonnementer i forbindelse med personnummeropslag. Abonnementer gøre det muligt for CPRs udtrækskunder at modtage løbende opdateringer på de personer, der findes abonnementer på. Læs mere om abonnementer på CPRs hjemmeside.

Følgende abonnementstype værdier må angives i ABON_TYPE recordfeltet i Personnummeropslag forespørgsel.

• 0: Ingen abonnementhandling
• 1: Opret personnummer-abonnement
• 3: Slet personnummer-abonnement

8.2. Krav til adgangskode/kendord

Password skal være 8 tegn.

• Mindst 1 lille bogstav (a-z)
• Mindst 1 stort bogstav (A-Z)
• Mindst 1 tal (0-9)
• Mindst en speciel karakter: ~ ` ! @ # $ % ^ * ( ) _ - + = , . / \ { } [ ] ; :
• Der er kontrol for store og små bogstaver
• Karaktererne < > & ? ' æ ø og å kan ikke benyttes
• Password kan kun skiftes en gang pr døgn
• Det er ikke tilladt at skifte til et kendeord, som har været benyttet tidligere

8.3. Fejlnumre og fejltekster

Dette afnsit beskriver de mulige fejlnumre, der kan forekomme i FEJLNR feltet i responsen fra servicen fx 00 ("Ingen fejl").

Fejl fra CPR-sikkerhedssystemet under autentifikation:

• 01: BRUGER-ID/KENDEORD ikke korrekt
• 02: KENDEORD udløbet, NYT KENDEORD krævet
• 03: NYT KENDEORD opfylder ikke formatet
• 16: IP-adressen forkert

Fejl fra servicen, der skyldes forkert data i forespørgslen:

• 04: Ikke adgang til CPR (CTSERVICE er midlertidigt lukket)
• 05: PNR ukendt i CPR
• 06: Ukendt KUNDENR
• 07: Timeout / ny LOGON nødvendig
• 08: Ikke adgang til CPR (CTSERVICE er ikke aktiv)
• 10: ABON_TYPE ukendt
• 11: DATA_TYPE ukendt
• 14: BRUGER-ID har ikke adgang til transaktionen (CTPROFIL er midlertidigt lukket)
• 18: BRUGER-ID har ikke adgang til transaktionen (CTPROFIL er ikke aktiv)
• 24: BRUGER-ID har ikke adgang til transaktionen (CTPERSKOD_PROFIL er midlertidigt lukket)
• 28: BRUGER-ID har ikke adgang til transaktionen (CTPERSKOD_PROFIL er ikke aktiv)

Fejl fra servicen hvor det anbefales, at CPR kontaktes hvis fejlen opstår gentagne gange:

• 40: Opgave findes ikke
• 41: Opgave konfiguration mangler
• 42: Opgave udtræksrelation mangler eller inaktiv
• 43: Opgave version mangler eller inaktiv
• 44: Ingen opgaver fundet for den angivne transaktionskode
• 99: Server fejl. Se log