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

Anchor
_adgang
_adgang
2. Adgang

...

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.

Fejlkode	Fejlbesked	Beskrivelse
725	Feltet skal være numerisk	Formatering af datatype.
949	Det indtastede kundenummer findes ikke.	Kundenummeret skal eksistere.
1069	Hæ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.
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	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.
4441	Du har ikke adgang til denn ønskede services	Du har ikke adgang til den ønskede service

...

Table 4. Standard stamdata for en kendt person.

Felt	Format	Evt. 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
I_VENT_MRK	Blank		Bliver ikke anvendt
ADRNVN	Tekst		Adresseringsnavn er en kommasepareret præsentation af efter- og fornavn. F.eks Andreasen, Andrea
KOEN	Bogstav (format M, K)		Køn benævner persons køn (mand M eller kvinde K)
STATUS	Heltal (format XX)	Tekst(t) 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"
STARTDATOSTATUS	Dato (format yyyyMMdd)		Startdato for personstatus
PNRGAELD	Tekst (format ddMMyyxxxx)		Gældende personnummer
FOEDDATO	Dato (format yyyyMMdd)		Fødselsdato
FOEDDATOUSM	Usikkerhedsmarkering (format blank eller *)		En usikker fødselsdato er en fødselsdagsdato fødselsdato der ikke med sikkerhed er korrekt. Den markeres med en *, altså en usikkerhedsmarkering
BESKYT	Heltal (format XX)	Tekst(t) beskrivelse af beskyttelsestypen, ts="Beskyt"	Beskyttelsestype beskriver typer af beskyttelse af personens data. F. eks. ”Navne og adressebeskyttelse”
CONVN	Tekst (format XxxYyyyy)		c/o navn er et navn på en ejer eller lejer, som en person flytter ind hos, og hvor personens eget navn ikke står på døren
ETAGE	Tekst/Heltal (format X.)		Etage anvendes til nummerering af bygningsdele. Etage er en vandret afdeling i en bygning.
HUSNR	Tekst/Heltal (format XXX..)		Nummer på et hus eller en opgang i en ejendom. Husnummer er en fortløbende nummerering af bygninger
SIDEDOER	Tekst (format tv, th, mf, X(dørnummer))		Sidedør (tv,th,mf eller dørnummer)
BNR	Tekst (format XX..)		Bygningsnummer er en entydig nummerering af ejendommens bygninger. Anvendes primært på grønlandske adresser.
KOMKOD	Kommunekode (format xxx)	Tekst(t) navnet på kommunen - til det lange navn på kommunen	Kommunekode er et trecifret identifikationsnummer for kommune. F.eks. 201 (Allerød)
VEJKOD	Vejkode (format xxxx)	Tekst(t) navnet på vejen	Vejkode er et firecifret identifikationsnummer for vej. F.eks. 9950 (Alleen) i Allerød
BYNVN	Tekst (format XXX..)		Bynavn er en benævnelse for kommune, by eller købstad
LOKALITET	Blank		Bliver ikke anvendt
POSTNR	Postnr (format xxxx)	Tekst(t) navnet på postdistriktet	Postnummer er et firecifret identifikationsnummer for et postdistrikt. F.eks 2730 Herlev
UDLANDSADR1	Tekst		Udenlandsadresse linie 1
UDLANDSADR2	Tekst		Udenlandsadresse linie 2
UDLANDSADR3	Tekst		Udenlandsadresse linie 3
UDLANDSADR4	Tekst		Udenlandsadresse linie 4
UDLANDSADR5	Tekst		Udenlandsadresse linie 5
UDR_LANDEKOD	Landekode (format xxxx)	Tekst(t) navnet på landet	Udrejselandekode er et firecifret identifikationsnummer for landet, landet der udrejses til. F.eks Sverige (5120)
STADR	Tekst		Standardadresse indeholder oplysninger, der normalt forbindes med en postaladresse til brug for adressering af et brev mv

...

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

...

Code Block

language	xml
title	Eksempel 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="2024050813575742691720240924170424323752" 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

language	xml
title	Eksempel 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="2024050813575742691720240924170424323752" 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

language	xml
title	Eksempel 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="2024050813575742691720240924170424323752" 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

language	xml
title	Eksempel 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="2024050813575742691720240924170424323752" 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

language	xml
title	Eksempel 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="2024050813575742691720240924170424323752" 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.41.10

Versions Compared

Old Version 1

New Version 2

Key

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

Anchor
_adgang
_adgang
2. Adgang

Page Comparison

Versions Compared

Old Version 1

New Version 2

Key

Anchor_formål_formål1.1. Formål

Anchor_adgang_adgang2. Adgang

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

Anchor
_adgang
_adgang
2. Adgang