Versions Compared

Old Version 1

changes.mady.by.user DXC Technology

Saved on

compared with

New Version Current

changes.mady.by.user DXC Technology

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Version 2.2.2

...

Anchor
_formål
_formål
1.1. Formål

Formålet med dokumentationen servicen er, at beskrive servicen Personnummerabonnement privat/offentlig - indberet/slet (PNRABN-I). Ved initiering af PNRABN-I opretter oprette og/eller sletter slette abonnementer på personnummer for både private og offentlige kunder. Når .

Anchor
_adgang
_adgang
2. Adgang

Anchor
_kundefokus
_kundefokus
2.1. Kundefokus

Brug af denne service henvender sig til offentlige myndigheder.

Anchor
_adgangskontrol
_adgangskontrol
2.2. Adgangskontrol

PNRABN-I initieres, er der visse nøglefelter, der kan forventes indsendt. Nogle nøglefelter er påkrævede, mens andre felter er valgfrie. Initiering af PNRABN-I kan fejle med en række fejlkoder, hvis det indsendte data ikke accepteres af PNRABN-I. Ved effektuering af aktioner kan eller skal der indsendes data. Ved validering og gem af det indsendte data, kan der opstå fejlrapporteringer, hvis der er mangler eller fejl i data.

...

Brug af denne service henvender sig til offentlige myndigheder.

...

PNRABN-I er underlagt adgangsprincipper som en del af adgangskontrollen til en service[1].

Nedenstående tabel viser, hvilke adgangsprincipper der gælder for PNRABN-I.

Table 1. Hovedprincipper for adgangskontrol på servicen.
PrincipGælder
AdgangskontrolJa
DOKMYN PrincipNej
MATAP PrincipNej

...

En myndighed kan have adgang via FULD adgang, ALMEN adgang eller MATAP adgang.

...

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.
PrincipGælder
AdgangskontrolJa
DOKMYN PrincipNej
MATAP PrincipNej

Anchor
_adgangskontrol_2
_adgangskontrol_2
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

...

Myndighedsprincippet håndhæves som dataregler. Brud på princippet udløser fejlrapporteringer; ved aktioner . 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.

...

Table 3. Fejl der kan opstå ved initiering.
FejlkodeFejlbeskedBeskrivelse
725Feltet skal være numerisk

Formatering af datatype.

949Det indtastede kundenummer findes ikke.

Kundenummeret skal eksistere.

3763
1069Hændelsesdatoen skal være større end - eller lig med gældende startdato for separation for personen

Hændelsesdatoen skal være større end eller lig med startdatoen på den aktuelle separation.

3763Kundenummer er ophørsmarkeretKundenummer er ophørsmarkeret

Kundenummeret må ikke være ophørsmarkeret.

3770Pnr-abonnement er ikke tilladt for dette kundenummer

Kundenummeret har ikke tilladelse til at behandle personnummerabonnementer.

3978Pnr-abonnement er kun tilladt for egne kunder

Pnr abonnement 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.

4441Du 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.

...

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.

...

Disse felter bliver altid præsenteret for en person, og er samlet under et <Praes r="STAMPNR">-element.

...

Generelle systemfejlkoder der ikke henvender sig til PNRABN-I eller dens data, findes også i servicehåndbogens bilag vedr. generelle fejlkoder.

Anchor
_præsentation_af_stamdata
_præsentation_af_stamdata
4. Præsentation af Stamdata

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.

Anchor
_generelle_stamdata
_generelle_stamdata
4.1. Generelle Stamdata

Servicen præsenterer kun speciel stamdata.

Anchor
_specielle_stamdata
_specielle_stamdata
4.2. Specielle Stamdata

PNRABN-I præsenterer ingen specielle 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.
FeltTypeBeskrivelse
KUNDENRkundenr (format xxxx)Kundenummer

Anchor
_aktioner
_aktioner
5. Aktioner

...

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.

Anchor
_tegnsæt_og_tekstfelter
_tegnsæt_og_tekstfelter
6.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.

...

Table 9. Kvitteringsfelter for en person.
FeltFormatEvt. ekstra attributterBeskrivelse
PNRPersonnummer (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
ADRNVNTekst (format Yyyyy, Xxx)Adresseringsnavn er en kommasepareret præsentation af efter- og fornavn. F.eks Andreasen, Andrea
FORNVNTekstFornavn
MELNVNTekstMellemnavn
EFTERNVNTekstEfternavn
STATUSHeltal (format XX)Tekst(t) indeholder tekstuel beskrivelse af statuskodenStatus 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"
RELTekstEn eventuel relation til hovedpersonen

...

Code Block
languagexml
titleEksempel på et GCTP svar fra servicen.
<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<root xmlns="http://www.cpr.dk">
    <Gctp v="2.0" env="Udvikling">
        <System r="CprAjour">
            <Service r="PNRABN-I">
                <CprServiceHeader r="PNRABN-I" ts="2024050813575742691720241105115528072486" st="P" a="I">
                    <Table r="Aktioner">
                        <Row>
                            <Field r="KODE" v="V" t="Validering"/>
                        </Row>
                        <Row>
                            <Field r="KODE" v="F" t="Fortryd"/>
                        </Row>
                        <Row>
                            <Field r="KODE" v="G" t="Gem"/>
                        </Row>
                    </Table>
                </CprServiceHeader>
                <CprData u="O">
                    <Rolle r="HovedRolle">
                        <Praes r="STAMPNR"/>
                    </Rolle>
                </CprData>
                <CprData u="I">
                    <Rolle r="HovedRolle">
                        <Table r="Pnrabonnement offpriv">
                            <Row u="M">
                                <Field r="CBRU_NGLKONST"/>
                                <Field r="CBRU_PNR"/>
                                <Field r="CBRU_SLETSAETMRK"/>
                                <Field r="CBRU_KVITNR"/>
                                <Field r="CBRU_KVIT_TXT"/>
                            </Row>
                            <Row k="[ROW KEY]">
                                <Field r="CBRU_NGLKONST" v="[DATA]"/>
                                <Field r="CBRU_PNR" v="[DATA]"/>
                                <Field r="CBRU_SLETSAETMRK" v="[DATA]"/>
                                <Field r="CBRU_KVITNR" v="[DATA]"/>
                                <Field r="CBRU_KVIT_TXT" v="[DATA]"/>
                            </Row>
                        </Table>
                    </Rolle>
                </CprData>
                <Kvit r="Ok" v="0"/>
            </Service>
        </System>
    </Gctp>
</root>

...

Code Block
languagexml
titleEksempel på et GCTP valideringskald til servicen.
<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<root xmlns="http://www.cpr.dk">
    <Gctp v="2.0" env="Udvikling">
        <System r="CprAjour">
            <Service r="PNRABN-I">
                <CprServiceHeader r="PNRABN-I" ts="2024050813575742691720241105115528072486" st="P" mk="1" a="V">
                    <Key>
                        <Field r="KNR" v="[DATA]"/>
                    </Key>
                </CprServiceHeader>
                <CprData u="I">
                    <Rolle r="HovedRolle">
                        <Table r="Pnrabonnement offpriv">
                            <Row u="M">
                                <Field r="CBRU_NGLKONST"/>
                                <Field r="CBRU_PNR"/>
                                <Field r="CBRU_SLETSAETMRK"/>
                                <Field r="CBRU_KVITNR"/>
                                <Field r="CBRU_KVIT_TXT"/>
                            </Row>
                            <Row k="[ROW KEY]">
                                <Field r="CBRU_NGLKONST" v="[DATA]"/>
                                <Field r="CBRU_PNR" v="[DATA]"/>
                                <Field r="CBRU_SLETSAETMRK" v="[DATA]"/>
                                <Field r="CBRU_KVITNR" v="[DATA]"/>
                                <Field r="CBRU_KVIT_TXT" v="[DATA]"/>
                            </Row>
                        </Table>
                    </Rolle>
                </CprData>
            </Service>
        </System>
    </Gctp>
</root>
Code Block
languagexml
titleEksempel på et GCTP svar med fejl fra servicen.
<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<root xmlns="http://www.cpr.dk">
    <Gctp v="2.0" env="Udvikling">
        <System r="CprAjour">
            <Service r="PNRABN-I">
                <CprServiceHeader r="PNRABN-I" ts="2024050813575742691720241105115528072486" st="P" mk="1" a="V">
                    <Key>
                        <Field r="KNR" v="[DATA]"/>
                    </Key>
                </CprServiceHeader>
                <CprData u="O">
                    <Rolle r="HovedRolle">
                        <Praes r="STAMPNR"/>
                    </Rolle>
                </CprData>
                <CprData u="I">
                    <Rolle r="HovedRolle">
                        <Table r="Pnrabonnement offpriv">
                            <Row u="M">
                                <Field r="CBRU_NGLKONST"/>
                                <Field r="CBRU_PNR"/>
                                <Field r="CBRU_SLETSAETMRK"/>
                                <Field r="CBRU_KVITNR"/>
                                <Field r="CBRU_KVIT_TXT"/>
                            </Row>
                            <Row k="[ROW KEY]">
                                <Field r="CBRU_NGLKONST" v="[DATA]"/>
                                <Field r="CBRU_PNR" v="[DATA]"/>
                                <Field r="CBRU_SLETSAETMRK" v="[DATA]"/>
                                <Field r="CBRU_KVITNR" v="[DATA]"/>
                                <Field r="CBRU_KVIT_TXT" v="[DATA]"/>
                            </Row>
                        </Table>
                    </Rolle>
                </CprData>
                <Kvit r="Fejl" t="[FEJLTEKST TIL FEJLKODE 42]" v="42"/>
            </Service>
        </System>
    </Gctp>
</root>

...

Code Block
languagexml
titleEksempel på et GCTP gem-kald til servicen.
<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<root xmlns="http://www.cpr.dk">
    <Gctp v="2.0" env="Udvikling">
        <System r="CprAjour">
            <Service r="PNRABN-I">
                <CprServiceHeader r="PNRABN-I" ts="2024050813575742691720241105115528072486" st="P" mk="1" a="G">
                    <Key>
                        <Field r="KNR" v="[DATA]"/>
                    </Key>
                </CprServiceHeader>
                <CprData u="I">
                    <Rolle r="HovedRolle">
                        <Table r="Pnrabonnement offpriv">
                            <Row u="M">
                                <Field r="CBRU_NGLKONST"/>
                                <Field r="CBRU_PNR"/>
                                <Field r="CBRU_SLETSAETMRK"/>
                                <Field r="CBRU_KVITNR"/>
                                <Field r="CBRU_KVIT_TXT"/>
                            </Row>
                            <Row k="[ROW KEY]">
                                <Field r="CBRU_NGLKONST" v="[DATA]"/>
                                <Field r="CBRU_PNR" v="[DATA]"/>
                                <Field r="CBRU_SLETSAETMRK" v="[DATA]"/>
                                <Field r="CBRU_KVITNR" v="[DATA]"/>
                                <Field r="CBRU_KVIT_TXT" v="[DATA]"/>
                            </Row>
                        </Table>
                    </Rolle>
                </CprData>
            </Service>
        </System>
    </Gctp>
</root>
Code Block
languagexml
titleEksempel på et GCTP svar fra servicen.
<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<root xmlns="http://www.cpr.dk">
    <Gctp v="2.0" env="Udvikling">
        <System r="CprAjour">
            <Service r="PNRABN-I">
                <CprServiceHeader r="PNRABN-I" ts="2024050813575742691720241105115528072486" st="P" mk="1" a="G"/>
                <Kvit r="Afslut" v="0">
                    <Table r="AFSLUT">
                        <Row k="[ROW KEY]"/>
                    </Table>
                </Kvit>
            </Service>
        </System>
    </Gctp>
</root>

v1v2.42.12