PNRABN-I - Personnummerabonnement privat/offentlig - indberet/slet
Indholdsfortegnelse
- 1 1. Indledning
- 1.1 1.1. Formål
- 2 2. Adgang
- 3 3. Kvitteringstyper
- 4 4. Serviceinitiering
- 4.1 4.1. Nøglefelter
- 4.2 4.2. Nøgleregler
- 5 5. Præsentation af Stamdata
- 6 6. Aktioner
- 7 7. Hændelsesdata
- 8 8. Afslutning
- 9 9. GCTP
- 10 10. Opdatering af data
- 11 11. Appendiks
- 11.1 11.1. GCTP Opdateringsservices
- 11.2 11.2. Initiering
- 11.3 11.3. Validering
- 11.4 11.4. Gem
1. Indledning
ID: PNRABN-I
Navn: Personnummerabonnement privat/offentlig - indberet/slet
System: CprAjour
1.1. Formål
Formålet med servicen er, at oprette og/eller slette abonnementer på personnummer for både private og offentlige kunder.
2. Adgang
2.1. Kundefokus
Brug af denne service henvender sig til offentlige myndigheder.
2.2. Adgangskontrol
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 |
Adgangskontrol
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 |
65 | Offentlige bebrænset (Kommune) | 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 |
Konstaterende Myndighedsprincip
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.
Myndighedsrestriktion
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)
3. Kvitteringstyper
Alle svar på handlinger i PNRABN-I ledsages af en kvittering indeholdt i et GCTP Kvit element, som beskrevet i servicehåndbogen, i dets GCTP service protokol bilag.
Kvitteringen indeholder en Kvitteringstypen, som angiver om handlingen er gennemført korrekt, eller om der er fejl eller anmærkninger.
Kvitteringstypen Ok anvendes når en forespørgsel er gennemført uden fejl eller anmærkninger.
Kvitteringstypen Fejl anvendes når en forespørgsel ikke kan gennemføres pga. en fejl i det indsendte data.
Kvitteringstypen Anmrk anvendes når en forespørgsel ikke gennemføres, fordi den giver anledning til en anmærkning/advarsel, brugeren skal være opmærksom på. En anmærkning vises kun én gang per service session, og forespørgsel kan gentages for at anerkende anmærkningen, og fortsætte behandlingen.
Kvitteringstypen Afslut anvendes når en afsluttende forespørgsel er gennemført, og servicesessionen er afsluttet.
4. Serviceinitiering
4.1. Nøglefelter
Når PNRABN-I skal initieres, er der visse nøglefelter, der kan forventes indsendt og derfor er påkrævet, mens andre felter kan være frivillige.
Herunder beskrives de felter der kan anvendes under initiering.
Table 3. Nøglefelter.
Felt | Format | Krævet | Feltlængde (v) | Beskrivelse |
|---|---|---|---|---|
KNR | Heltal | Ja | 4 | Kundenummer. |
4.2. Nøgleregler
Initiering af PNRABN-I kan kvittere med en række forskellige koder, hvis det indsendte data ikke accepteres af PNRABN-I, eller der er omstændigheder brugeren skal være opmærksom på.
Ved en godkendt initiering returneres kvitteringstype Ok i kvitteringen.
Table 4. Afvigende koder der kan opstå ved initiering.
Kvitteringskode | Kvitteringsbesked | 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 kvitteringskoder der ikke henvender sig til PNRABN-I eller dens data, findes også i servicehåndbogens bilag vedr. generelle fejlkoder.
5. Præsentation af Stamdata
Ved en successful initiering inkluderer svaret fra servicen en præsentation af stamdata. Dette data indeholder informationer, relevant for det domæne PNRABN-I omhandler.
Der findes en generel præsentation for hver af disse overordnede domæner: person, person i kirkeregi, ukendt person, og vej. Visse services kan dog have en speciel præsentation af stamdata, unik for netop den ene service.
5.1. Generelle Stamdata
Servicen præsenterer kun speciel stamdata.
5.2. Specielle Stamdata
Disse felter bliver altid præsenteret for en kunde, og er samlet under et <Praes r="STAMKUN">-element.
Table 5. Standard stamdata for en kunde.
Felt | Type | Beskrivelse |
|---|---|---|
KUNDENR | kundenr (format xxxx) | Kundenummer |
6. Aktioner
Efter initiering understøtter PNRABN-I følgende aktioner:
Table 6. Tilladte aktionsværdier og deres livscyklus funktionsbeskrivelse.
Værdi | Beskrivelse |
|---|---|
V | Validering |
F | Fortryd |
G | Gem |
7. Hændelsesdata
7.1. Redigerbare Datafelter
Data der kan eller skal indsendes til validering eller gem, er beskrevet i denne sektion.
Herunder angives felter til indrapportering af hændelsesdata.
Table 7. 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 8. 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 |
7.2. Dataregler
Ved validering og gem af det indsendte data, kan der opstå afvigende rapporteringer, hvis der er fejl eller mangler i det indsendte data, eller det danner grundlag for en advarsel brugeren skal være opmærksom på.
Ligesom ved initiering, betyder en kvitteringstype Ok at handlingen blev gennemført uden problemer.
Table 9. Afvigende kvitteringskoder der kan opstå på hændelsesdata.
Kvitteringskode | Kvitteringsbesked | 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.
7.2.1. Tegnsæt og Tekstfelter
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.
Servicen har ingen felter med det generelle tegnsæt.
8. Afslutning
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 10. Kvitteringsfelter for en person.
Felt | Format |
|---|