PNRABN-I - Personnummerabonnement privat/offentlig - indberet/slet

PNRABN-I - Personnummerabonnement privat/offentlig - indberet/slet

Indholdsfortegnelse

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

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

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

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

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

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æ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

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

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

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

Felt

Format