1. Indledning

Dette dokument beskriver CPR Direkte service grænsefladen for servicen "PRIV - Personnummeropslag til private kunder".

1.1. Formål

Servicen har til formål at levere persondata til private kunder. Servicen leverer data i samme recordformat som udtræksprodukt U09480P "Persondata Private Ændringsudtræk" 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 private kunder.

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: Navne- og adressebeskyttelse undtages
Angiver om der undlades navne- og adressedata på personer med aktiv navne- og adressebeskyttelse registreret i CPR.
Parameterværdier: Ja eller Nej
Standardværdi: Ja

Parameter: Adressematch kundenummer
Angiver kundenummer hvor kundens adressematch abonnementer oprettes.
Standardværdi: (ingen)

Parameter: Sidst kendte adresse på afdøde personer
Der kan vælges hvorvidt servicen leverer sidste kendte adresse på afdøde (CPR statuskode 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:

PRIV,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):

PRIV,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 Aktuelle data

Aktuelle data record.

Format:

Recordlængde: 469

Adressefelterne vil kun være udfyldt for personer, der er bosiddende i Danmark eller Grønland på udtræksdagen (status 01/05). Dog kan der vælges, at få den sidst kendte adresse leveret på døde (status 90).

Hvis personer har navne- og adressebeskyttelse leveres der ingen data i recordfelter markeret "beskyttet" medmindre det er aftalt med CPR-kontoret.

6.1.3. 001B Aktuelle data med adresse UUID

Aktuelle data record med adresse UUID.

Format:

Recordlængde: 511

Adressefelterne vil kun være udfyldt for personer, der er bosiddende i Danmark eller Grønland på udtræksdagen (status 01/05). Der kan vælges, at få den sidst kendte adresse leveret på døde (status 90).

Hvis personer har navne- og adressebeskyttelse leveres der ingen data i recordfelter markeret "beskyttet" medmindre det er aftalt med CPR-kontoret.

6.1.4. 002A Udlandsadresser

Udlandsadresser record.

Format:

Recordlængde: 195

Denne recordtype forekommer kun for udrejste personer.

Hvis personer har navne- og adressebeskyttelse leveres der ingen data i recordfelter markeret "beskyttet" medmindre det er aftalt med CPR-kontoret.

6.1.5. 002B Udlandsadresser

Udlandsadresser record.

Format:

Recordlængde: 199

Denne recordtype forekommer kun for udrejste personer.

Hvis personer har navne- og adressebeskyttelse leveres der ingen data i recordfelter markeret "beskyttet" medmindre det er aftalt med CPR-kontoret.

6.1.6. 003 Kontaktadresse

Kontaktadresse record.

Format:

Recordlængde: 195

6.1.7. 004 Civilstand

Civilstand record.

Format:

Recordlængde: 26

Kan kun vælges til brug vedrørende pension.

6.1.8. 005 Værge med text felter

Værge med text felter record.

Format:

Recordlængde: 217

Værgens nye adresse vil ikke blive leveret i forbindelse med f.eks. flytning.

6.1.9. 006 Ægtefælle oplysninger

Ægtefælle oplysninger record.

Format:

Recordlængde: 525

Kan kun vælges til brug vedrørende pension. Leveres kun for afdøde personer.

Hvis ægtefællen har navne- og adressebeskyttelse leveres der ingen data i recordfelter markeret "beskyttet" jvf. CPR-loven § 38, stk 3.

6.1.10. 011 Kunderefnr.

Flere kundereferencer record

Format:

Recordlængde: 88

Er kun aktuelt for kunder, der kører Adressematch ændringsudtræk.

6.1.11. 050 Kreditadvarsel

Kreditadvarsel record.

Format:

Recordlængde: 29

6.1.12. 052 Værge med text felter og værgemålstype

Værge med text felter og værgemålstype.

Format:

Recordlængde: 232

Værgens nye adresse vil ikke blive leveret i forbindelse med f.eks. flytning.

Værgemålstyper:

• DELVIS
• FULD

6.1.13. 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