CPR Direkte PRIV - Personnummeropslag til private virksomheder
Indholdsfortegnelse
1. Indledning
Dette dokument beskriver CPR Direkte service grænsefladen for servicen "PRIV - Personnummeropslag til private virksomheder".
1.1. Formål
Servicen har til formål at levere persondata til private virksomheder. 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.
Medmindre andet er aftalt med CPR-kontoret leverer servicen ikke 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 private virksomheder.
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.
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:
Opret forbindelse til CPR Direkte
Send Login forespørgsel
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:
Opret forbindelse til CPR Direkte
Læs data fra Personnummeropslag respons (eller håndtere evt. fejl angivet i respons)
Autentifikation tokenværdier kan genbruges i CPR Direkte PRIV 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 |
|---|---|---|---|---|
CPRTRANS | A | 4 | 1 | Service transaktionskode: PRIV |
KONSTANT | A | 1 | 5 | Konstantværdi ( |
KUNDENR | N | 4 | 6 | Brugerens kundenummer |
KONSTANT | N | 1 | 10 | Konstantværdi ( |
KONSTANT | N | 1 | 11 | Konstantværdi ( |
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:
PRIV,111190BRUGER Password5.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 |
|---|---|---|---|---|
KUNDENR | N | 4 | 1 | Brugerens kundenummer |
KONSTANT | N | 1 | 5 | Konstantværdi ( |
KONSTANT | N | 1 | 6 | Konstantværdi ( |
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 0000285.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 |
|---|---|---|---|---|
CPRTRANS | A | 4 | 1 | Service transaktionskode: PRIV |
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):
PRIV,111106KETDqhzMBRUGER 0012121233335.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 |
|---|---|---|---|---|
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 |
|---|---|
000 | |
001 | |
001B | |
001K | |
002A | |
002B | |
003 | |
004 | |
005 | |
006 | |
011 | |
050 | |
052 | |
999 |
6.1.1. 000 Startrecord
Start record.
Format:
Recordfeltnavn | Format | Længde | Position | Beskrivelse |
|---|---|---|---|---|
RECORDTYPE | N | 3 | 1 | Lig tre sidste cifre i recordtype |
SORTFELT-10 | A | 10 | 4 |
|
OPGAVENR |