PNRABN-I - Personnummerabonnement privat/offentlig - indberet/slet
Indholdsfortegnelse
- 1 1. Indledning
- 1.1 1.1. Formål
- 2 2. Adgang
- 3 3. Serviceinitiering
- 3.1 3.1. Nøglefelter
- 3.2 3.2. Nøgleregler
- 4 4. Præsentation af Stamdata
- 5 5. Aktioner
- 6 6. Hændelsesdata
- 7 7. Afslutning
- 8 8. GCTP
- 9 9. Opdatering af data
- 10 10. Appendiks
- 10.1 10.1. GCTP Opdateringsservices
- 10.2 10.2. Initiering
- 10.3 10.3. Validering
- 10.4 10.4. Gem
ID: PNRABN-I
Navn: Personnummerabonnement privat/offentlig - indberet/slet
System: CprAjour
Formålet med servicen er, at oprette og/eller slette abonnementer på personnummer for både private og offentlige kunder.
Brug af denne service henvender sig til offentlige myndigheder.
PNRABN-I er underlagt adgangsprincipper som en del af adgangskontrollen til en service. Principperne for den generelle adgangskontrol er beskrevet IKKE OFFENTLIGT TILGÆNGELIG[her] og for vent IKKE OFFENTLIGT TILGÆNGELIG[her].
Nedenstående tabel viser, hvilke adgangsprincipper der gælder for PNRABN-I.
Table 1. Hovedprincipper for adgangskontrol på servicen.
Princip | Gælder |
|---|---|
Adgangskontrol | Ja |
DOKMYN Princip | Nej |
MATAP Princip | Nej |
En myndighed kan have adgang via FULD adgang, ALMEN adgang eller MATAP adgang.
FULD Adgang : Myndighedstyper med fuld adgang har adgang til samtlige services i cpr
ALMEN Adgang : Myndigheden har adgang via sin myndighedstype til servicen
MATAP Adgang : Myndigheden har adgang som MATAP. Der kan evt. gælde MATAP princip på servicen
Nedenstående tabel viser, hvilke myndighedstyper der har adgang til servicen.
Table 2. Følgende myndighedstyper har adgang til servicen
Myndighedstype | Myndighed | Adgangstype |
|---|---|---|
39 | CPR-Kontoret | Fuld Adgang |
4 | Personregisterfører | Almen Adgang |
5 | Kommuner | Almen Adgang |
7 | Fiktiv kommune (fx kildeskat) | Almen Adgang |
10 | Domstole | Almen Adgang |
14 | Valgkontoret | Almen Adgang |
15 | Familieretshuset/Statsforvaltning | Almen Adgang |
16 | Civilretskontoret/Justitsministeriet | Almen Adgang |
17 | Indfødsretskontoret | Almen Adgang |
18 | Udlændingestyrelsen | Almen Adgang |
19 | Offentlig myndighed udvidet | Almen Adgang |
20 | Trossamfund | Almen Adgang |
25 | Sogne | Almen Adgang |
30 | Land | Almen Adgang |
35 | Politi | Almen Adgang |
40 | Region | Almen Adgang |
41 | Borger | Almen Adgang |
42 | Borger Direkte | Almen Adgang |
43 | Kunder (abonnementer) | Almen Adgang |
45 | Skattecenter | Almen Adgang |
50 | EDB-central | Almen Adgang |
55 | Værnepligtsafdeling | Almen Adgang |
60 | Offentlig myndighed | Almen Adgang |
61 | Offentlig myndighed udvidet 2 (Udbetaling Danmark) | Almen Adgang |
70 | Ministerium | Almen Adgang |
71 | Kirkeministeriet | Almen Adgang |
75 | Landsdel | Almen Adgang |
80 | Stifter | Almen Adgang |
85 | Provstier | Almen Adgang |
98 | Øvre kommune | Almen Adgang |
99 | Maskinel mynkod | Almen Adgang |
Udover den overordnede adgangskontrol, er servicen underlagt et myndighedsprincip for den konstaterende myndighed. Princippet sætter begrænsninger for, hvilken type myndigheder der må angives, som den konstaterende myndighed på hændelsen.
Det vil altid være tilladt, at anvende myndigheder med myndighedstype:
39 - Indenrigsministeriet - CPR
0 - Ukendt Myndighed
Myndighedsprincippet håndhæves som dataregler. Brud på princippet udløser fejlrapporteringer. Aktioner der udløser valideringer er - f.eks. Validering og Gem.
Fælles for alle disse valideringer er, at der returneres fejlkoden: 4455, såfremt den konstaterende myndighed ikke er tilladt jf. det Konstaterende myndighedsprincip.
Det konstaterende myndighedsprincip er ikke aktivt for denne service.
Udover det konstaterende myndighedsprincip kan en service være underlagt en myndighedsrestriktion som begrænser hvilke myndigheder, der kan anvendes ved en række indberetninger.
Helt konkret er der umiddelbart tale om lande, men det er ikke begrænset til lande.
Myndighedsrestriktionen er tabelstyret og der kan angives om en myndighed:
Må indberette som konstaterende (Felt: Indberettende myndighed)
Må anvendes som Statsborgerretsland (Felt: Statsborger i)
Må anvendes som Fødselsregistreringssted (Felt: Indberettende myndighed)
Når PNRABN-I skal initieres, er der visse nøglefelter, der kan indsendes. Alle nøglefelter er påkrævede.
Initiering af PNRABN-I kan fejle med en række fejlkoder, hvis de indsendte data ikke accepteres af PNRABN-I.
Table 3. Fejl der kan opstå ved initiering.
Fejlkode | Fejlbesked | Beskrivelse |
|---|---|---|
725 | Feltet skal være numerisk | Formatering af datatype. |
949 | Det indtastede kundenummer findes ikke. | Kundenummeret skal eksistere. |
3763 | Kundenummer er ophørsmarkeret | Kundenummeret må ikke være ophørsmarkeret. |
3770 | Pnr-abonnement er ikke tilladt for dette kundenummer | Kundenummeret har ikke tilladelse til at behandle personnummerabonnementer. |
3978 | Pnr-abonnement er kun tilladt for egne kunder | Personnumerabonnement er kun tilladt for egne kunder. Det er kun muligt at oprette/slette abonnementer, som tilhører det kundenummer, brugeren er tilknyttet. I DEMO miljøet er kundenumret 3 cifre, mens det er 4 i alle andre miljøer. |
4441 | Du har ikke adgang til denn ønskede services | Du har ikke adgang til den ønskede service |
Endvidere er der fælles nøgleregler, der kan komme i spil. Disse er beskrevet i et af servicehåndbogens bilag ang. fælles nøgleregler.
Generelle systemfejlkoder der ikke henvender sig til PNRABN-I eller dens data, findes også i servicehåndbogens bilag vedr. generelle fejlkoder.
Ved en succesfuld initiering inkluderer svaret fra servicen en præsentation af stamdata. Disse data indeholder informationer, der er relevante for det domæne PNRABN-I tilhører.
Servicen præsenterer kun speciel stamdata.
Disse felter bliver altid præsenteret for en kunde, og er samlet under et <Praes r="STAMKUN">-element.
Table 4. Standard stamdata for en kunde.
Felt | Type | Beskrivelse |
|---|---|---|
KUNDENR | kundenr (format xxxx) | Kundenummer |
Efter initiering understøtter PNRABN-I følgende aktioner:
Table 5. Tilladte aktionsværdier og deres livscyklus funktionsbeskrivelse.
Værdi | Beskrivelse |
|---|---|
V | Validering |
F | Fortryd |
G | Gem |
Data der kan eller skal indsendes til validering eller gem, er beskrevet i denne sektion.
Herunder angives felter til indrapportering af hændelsesdata.
Table 6. Felter til indrapportering af hændelsesdata.
Felt | Format | Krævet | Feltlængde (v) | Attributter | Beskrivelse |
|---|
Udover de ovennævnte felter, indeholder servicens hændelsesdata også tabel-rækker.
Pnrabonnement offpriv
Table 7. Hændelsesdata til indrapportering pr. række på Pnrabonnement offpriv.
Felt | Format | Krævet | Feltlængde (v) | Attributter | Beskrivelse |
|---|---|---|---|---|---|
CBRU_NGLKONST | Tekst | Nej | N/A | v | Nøglekonstant |
CBRU_PNR | Personnummer | Ja | 10 | v | Personnummer |
CBRU_SLETSAETMRK | Feltet beskriver om pnr skal oprettes eller slettes på CTBRU eller CTPRIBRU | Ja | N/A | v | Sletmarkering |
CBRU_KVITNR | Tekst | Nej | N/A | v | Kvitteringsnummer |
CBRU_KVIT_TXT | Tekst | Nej | N/A | v | Kvitteringstekst |
Ved validering og gem af de indsendte data, kan der opstå fejlrapporteringer, hvis der er fejl og mangler i de indsendte data.
Table 8. Fejl der kan opstå på hændelsesdata.
Fejlkode | Fejlbesked | Beskrivelse |
|---|---|---|
141 | Personen er i CPR registreret som reserveret, annulleret, slettet eller ændret | Status for en person må ikke være Annulleret (30), slettet (50) eller ændret (60). |
172 | Personen %1%-%2% findes ikke i CPR. | Hændelsespersonen skal være registreret i CPR registeret. |
3522 | Der er ingen personnumre indtastet | Der skal være angivet indtastet mindst et personnummer. |
3707 | Personnummerabonnement findes i forvejen | Der findes allerede et personnummerabonnement på hændelsespersonen. |
3943 | Personnummerabonnement findes ikke | Personnummerabonnementet der skal slettes, findes ikke |
4442 | SLETSAETMRK skal have en af værdierne SL, OP eller ST | CBRU_SLETSAETMRK skal haves en af følgende værdier: SL, OP eller ST |
4443 | Der er ingen sletsaetmrk indtastet | Der skal være angivet mindst en sletmarkering for hvert personnummer |
4444 | Der må kun sendes max. 40 PNR | Der må maks indsendes 40 rækker |
Endvidere er PNRABN-I også underlagt de generelle regler, der dækker alle services. Disse regler er beskrevet i servicehåndbogens bilag om generelle dataregler.
En GCTP service kan have tekstfelter med specifikke tegnsæt. Disse tegnsæt opstiller regler for, hvilke tegn feltet må indeholde. Det overordnede tegnsæt som gælder på mange forskellige hændelser, er beskrevet i servicehåndbogens bilag med tegnsæt, mens tegnsæt der kun gælder for PNRABN-I, optræder som dataregler i tabellen ovenfor.
PNRABN-I har ingen felter med det generelle tegnsæt.
Ved en succesfuld afslutning på PNRABN-I, genererer PNRABN-I en afsluttende kvittering.
Denne kvittering har altid et <Table r="AFSLUT"> element, der indeholder et eller flere <Row>-elementer, med datafelter der er relevante for det gemte domæne.
For en personhændelse, returneres en kvittering med personens data. Kvitteringen indeholder følgende felter
i et <Row k="PNR={personnummer};">-element, hvor {personnummer} er personens CPR-nummer.
Table 9. Kvitteringsfelter for en person.
Felt | Format | Evt. ekstra attributter | Beskrivelse |
|---|---|---|---|
PNR | Personnummer (format ddMMyyxxxx) |
| Personnummer er et ticifret, personligt identifikationsnummer, hvor de første seks cifre angiver en fødselsdato, og de næste fire cifre angiver et løbenummer |
ADRNVN | Tekst (format Yyyyy, Xxx) |
| Adresseringsnavn er en kommasepareret præsentation af efter- og fornavn. F.eks Andreasen, Andrea |
FORNVN | Tekst |
| Fornavn |
MELNVN | Tekst |
| Mellemnavn |
EFTERNVN | Tekst |
| Efternavn |
STATUS | Heltal (format XX) | Tekst(t) indeholder tekstuel beskrivelse af statuskoden | Status på personenStatus kan være:01 "Fast bopæl i dansk kommune"03 "Uden fast bopæl i dansk kommune"05 "Fast bopæl i grønlandsk kommune"07 "Uden fast bopæl i grønlandsk kommune"20 "Administrativt personnummer"30 "Annulleret personnummer"50 "Slettet personnummer"60 "Ændret personnummer"70 "Forsvundet"80 "Udrejst"90 "Død" |
REL | Tekst |
| En eventuel relation til hovedpersonen |