1. Indledning

ID: PNRMYN
Navn: Personmyndighedssøgning
System: CprSoeg

1.1. Formål

Servicen leverer de personer som er registeret af den indsendte myndighedskode, og filtreret for eventuelt medsendte afgrænsninger.

2. Adgang

2.1. Kundefokus

Brug af denne service henvender sig til offentlige myndigheder.

2.2. Adgangskontrol

Services er underlagt adgangsprincipper som en del af adgangskontrollen til en service. Nedenstående tabel viser, hvilke adgangsprincipper der gælder for denne service.

Table 1. Hovedprincipper for adgangskontrol på servicen.

Princip	Gælder

Princip	Gælder
Adgangskontrol	Ja

Adgangskontrol

For at en bruger kan kalde denne service skal brugerens personkode have en profil tilknyttet, der giver adgang til servicen. Profiler tildeles til en personkode enten af personkodens DAP-administrator eller ved oprettelse af personkoden.

3. Nøglefelter

Når søgningen kaldes, er der visse kriterier, der kan forventes indsendt og derfor er påkrævet, mens andre kriterier kan være frivillige, og derfor ikke er påkrævet.

Herunder beskrives de felter der kan anvendes under initiering.

Table 2. Nøglefelter.

Felt	Format	Krævet	Feltlængde (v)	Beskrivelse

Felt	Format	Krævet	Feltlængde (v)	Beskrivelse
AIA	Binær markering	Nej	1	Angiver om der skal leveres oplysning om, hvor mange rækker der opfylder søgekriterierne (Systemafhængigt om dette ønskes).
MAXA	Heltal	Nej	4	Max antal. Angiver hvor mange rækker der ønskes læst ad gangen. Default er 20.
REST	Tekst	Nej	N/A	Restart nøgle. Internt felt med nøgler til en fortsat søgning. Der læses normalt 20 rækker ad gangen. Restart (genstart) nøglen benyttes, når de næste 20 rækker skal læses.
MYNKOD	Myndighedskode	Ja	4	Myndighed
REGFRADTO	Dato (yyyyMMdd)	Nej	8	Oprettet fra
REGTILDTO	Dato (yyyyMMdd)	Nej	8	Oprettet til
FOEDFRADTO	Dato (yyyyMMdd)	Nej	8	Fødselsdato fra
FOEDTILDTO	Dato (yyyyMMdd)	Nej	8	Fødselsdato til
KOMKOD	Kommunekode	Nej	4	Kommunekode
STATUS	Statuskoden angiver om et personnummer (person) er aktiv eller inaktiv, samt andre oplysninger - se værdimængde	Nej	N/A	Status
SORTFIELDS	Tekst	Nej	N/A	Sortfields for sortering. Delimiter er komma.
SORTDIRECTIONS	Tekst	Nej	N/A	Sortdirections for sortering. Delimiter er komma.

3.1. Nøgleregler

Søgningen kan fejle med en række fejlkoder, hvis de indsendte kriterier ikke accepteres af servicen.

Table 3. Fejl der kan opstå ud fra søgekriterier.

Fejlkode	Fejlbesked	Beskrivelse

Fejlkode	Fejlbesked	Beskrivelse
104	Datoen skal være mindre end eller lig med dags dato og efter 1857.	Startdatoen må ikke ligge efter dags dato, men årstallet skal ligge efter år 1857.
5414	Myndighedskode %1% er ikke tilladt. De tilladte myndighedskoder er %2%.	`MYNKOD` nøgleværdien er en tilladt myndighed.
5415	Fødselsdato til skal være efter eller den samme dato som fødselsdato fra.	Fødselsdato til skal være efter eller den samme dato som fødselsdato fra.
5416	Oprettet til skal være efter eller den samme dato som oprettet fra.	Oprettet til skal være efter eller den samme dato som oprettet fra.

PNRMYN - Personmyndighedssøgning