1. Indledning

1.1. Formål

Formålet med dokumentationen er, at beskrive servicen Personnummerabonnement privat/offentlig - indberet/slet (PNRABN-I). Ved initiering af PNRABN-I opretter og/eller sletter 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.

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^[1].

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

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.

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

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

3.1. Nøglefelter

Når PNRABN-I skal initieres, er der visse nøglefelter, der kan indsendes. Alle nøglefelter er påkrævede.

3.2. Nøgleregler

Initiering af PNRABN-I kan fejle med en række fejlkoder, hvis de indsendte data ikke accepteres af PNRABN-I.

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.

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.

4.1. Generelle Stamdata

4.1.1. Person

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

4.2. Specielle Stamdata

PNRABN-I præsenterer ingen specielle stamdata.

5. Aktioner

Efter initiering understøtter PNRABN-I følgende aktioner:

6. Hændelsesdata

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

Udover de ovennævnte felter, indeholder servicens hændelsesdata også tabel-rækker.

Pnrabonnement offpriv

6.2. Dataregler

Ved validering og gem af de indsendte data, kan der opstå fejlrapporteringer, hvis der er fejl og mangler i de indsendte data.

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.

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.

PNRABN-I har ingen felter med det generelle tegnsæt.

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

Ved hændelser med én eller flere relaterede personer, kan der forekomme et <Row>-element for hver person relateret til hovedpersonen.

8. GCTP

Dette afsnit præsenterer en håndfuld ukomplette eksempler på de kald PNRABN-I kan modtage, og svarene den vil sende retur.

Formålet med eksemplerne er, at give et generelt overblik over, hvordan GCTP er struktureret for PNRABN-I. Fokus er lagt på de datafelter, en bruger kan interagere med eller redigere i.

Eksemplerne er underlagt følgende begrænsninger:

• For <Field>-elementer til nøglefelter og hændelsesdata
  • Data er udeladt, og er i stedet markeret med attributten v="[DATA]"
  • Alle andre attributter er udeladt (a, a1, t, osv)
• For <Praes>-elementer til stamdata
  • <Field>-underelementerne er udeladt
• For <Kvit>-element til afsluttende kvittering
  • <Row>-elementets identificerende nøgle er udeladt, og er i stedet markeret med attributten k="[ROW KEY]"
  • <Field>-underelementerne er udeladt i <Row>-elementet

GCTP eksemplerne er præsenteret i dokumentationens tilhørende appendiks.

8.1. GCTP Eksempler

Se appendiks 10.1.1

9. Opdatering af data

PNRABN-I opdaterer data i følgende tabeller:

• CTBRU (Primær)
• CTPRIBRU (Primær)
• CTTRANSBRU (Primær)
• CTTRANSPRIBRU (Primær)

Herunder er beskrevet et regelsæt, for opdatering af data i de respektive tabeller.

9.1. Primære registreringer (Personnummerabonnement)

9.1.1. CTBRU (Primær)

1)

Ny aktuel række på tabellen CTPBRU oprettes for det angivne personnummerabonnement.

2)

Aktuel række på tabellen CTPBRU slettes for det angivne personnummerabonnement.

9.1.2. CTPRIBRU (Primær)

1)

Ny aktuel række på tabellen CTPRIBRU oprettes for det angivne personnummerabonnement.

2)

Aktuel række på tabellen CTPRIBRU slettes for det angivne personnummerabonnement.

Hændelseskatalog

PNRABN-I opdaterer ikke hændelseskataloget.

Transaktionshændelser (Personnummerabonnent)

PNRABN-I opdaterer ikke data i transaktionstabellerne CTTRANSPNR og CTTRANSDATAGRP.

9.1.3. CTTRANSBRU (Primær)

1)

Oprettes der en række på tabellen CTBRU opdateres tilsvarende på transaktionstabellen CTTRANSBRU.

Hvis rækken på tabellen CTPBRU er oprettet, oprettes en række i den akkumulerede transaktionstabel:

• CTTRANSBRU

En række med følgende data:

• KUNDENR: Kundenummer på kunde
• PNR: Personnummer på abonnent
• TIMESTAMP: Tidsstempel for opdatering
• SLETSAETMRK: OP (oprettet)
• NGLKONST: Nøglekonstant
• INDBERET_SYSTEM: Tom

2)

Findes der en række, som er slettet på tabellen CTBRU opdateres tilsvarende på transaktionstabellen CTTRANSBRU.

Hvis rækken på tabellen CTBRU er slettet, oprettes en række i den akkumulerede transaktionstabel:

• CTTRANSBRU

En række med følgende data:

• KUNDENR: Kundenummer på kunde
• PNR: Personnummer på abonnent
• TIMESTAMP: Tidsstempel for opdatering
• SLETSAETMRK: SL (slettet)
• NGLKONST: Nøglekonstant
• INDBERET_SYSTEM: Tom

9.1.4. CTTRANSPRIBRU (Primær)

1)

Oprettes der en række på tabellen CTPRIBRU opdateres tilsvarende på transaktionstabellen CTTRANSPRIBRU.

Hvis rækken på tabellen CTPRIBRU er oprettet, oprettes en række i den akkumulerede transaktionstabel:

• CTTRANSPRIBRU

En række med følgende data:

• KUNDENR: Kundenummer på kunde
• PNR: Personnummer på abonnent
• TIMESTAMP: Tidsstempel for opdatering
• SLETSAETMRK = OP (opdatering)
• NGLKONST: Nøglekonstant
• INDBERET_SYSTEM: Tom

2)

Findes der en række, der er slettet på tabellen CTPRIBRU opdateres tilsvarende på transaktionstabellen CTTRANSPRIBRU.

Hvis rækken på tabellen CTPRIBRU er slettet, oprettes en række i den akkumulerede transaktionstabel:

• CTTRANSPRIBRU

En række i tabel-efter-rækken med følgende data:

• KUNDENR = KUNDENR
• PNR = PNR
• TIMESTAMP: Tidsstempel for opdatering
• SLETSAETMRK: SL (slettet)
• NGLKONST: Nøglekonstant
• INDBERET_SYSTEM: Tom

10. Appendiks

10.1. GCTP Opdateringsservices

10.1.1. GCTP Eksempler

I de kommende eksempler vises, hvorledes requests og svar ser ud fra servicen. Bemærk at der ikke er medtaget konkrete data eller attributter i eksemplerne. I feltoversigten er der angivet felter, som har attributter, men helt generelt er attributter noget der kommer med ud som svar på et request, og er ikke krævet i input til f.eks. Gem eller Valider. De må gerne være der, men de anvendes ikke til noget.

10.2. Initiering

<?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" st="P" mk="1" a="I">
                    <Key>
                        <Field r="KNR" v="[DATA]"/>
                    </Key>
                </CprServiceHeader>
            </Service>
        </System>
    </Gctp>
</root>

<?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="20240508135757426917" 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>

10.3. Validering

<?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="20240508135757426917" 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>

<?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="20240508135757426917" 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>

10.4. Gem

<?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="20240508135757426917" 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>

<?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="20240508135757426917" st="P" mk="1" a="G"/>
                <Kvit r="Afslut" v="0">
                    <Table r="AFSLUT">
                        <Row k="[ROW KEY]"/>
                    </Table>
                </Kvit>
            </Service>
        </System>
    </Gctp>
</root>

v1.4.1