Indholdsfortegnelse

1 1. Indledning
- 1.1 1.1. Formål
2 2. Adgang
- 2.1 2.1. Kundefokus
- 2.2 2.2. Adgangskontrol
3 3. Nøglefelter
- 3.1 3.1. Nøgleregler
4 4. GCTP
- 4.1 4.1. GCTP Eksempler
- 4.2 4.2. Søgnings resultats datafelter
5 5. Appendiks
- 5.1 5.1. GCTP Søgeservices

1. Indledning

ID: PRIVSOGP
Navn: PRIVATSØGNING TIL PRIVATE
System: CprSoeg

1.1. Formål

At danne en udskrift af en persons adresseoplysninger på baggrund af en søgning.

Bemærk at de personer, som indgår i søgeresultaterne, er baseret på en efterhånden konsistent datakilde. Datakilden opdateres typisk hvert 10. minut med de seneste ændringer i CPR-data.

2. Adgang

2.1. Kundefokus

Brug af denne service henvender sig til private virksomheder.

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.

Køn feltet kan indsendes, men det anvendes ikke i søgningen.

Table 2. Nøglefelter.

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

Felt	Format	Krævet	Feltlængde (v)	Beskrivelse
PNR	Personnummer	Nej	10	Personnummer
KON	M eller K	Nej	1	Køn. Siden den 2025-02-20 anvendes køn ikke ved identifikation. Dvs. uanset om feltet er udfyldt, anvendes køn ikke til identifikation af den registrerede. Feltet er ikke krævet, men bør under alle omstændigheder helt udelades. Feltet er bibeholdt for at sikre bagud kompatibilitet. Feltet vil senere blive udfaset helt.
STAF	Tekst	Nej	N/A	Statuskode fra
FODT	Dato (yyyyMMdd)	Nej	8	Fødselsdato
KOMK	Heltal	Nej	4	Kommunekode
VEJK	Heltal	Nej	4	Vejkode
VEJKOD	Vejkode	Nej	4	Vejkode. Bemærk at dette felt eksisterer kun af hensyn til bagudkompatibilitet med ældre klienter, der ved en fejl benytter `VEJKOD` som feltreference i stedet for `VEJK`. `VEJKOD` inputfeltet kan blive fjernet i fremtiden og derfor skal `VEJK` inputfeltet bruges i stedet.
HNR	Husnummer der indeholder op til 3 cifre og evt. husbogstav	Nej	4	Husnummer
ETAG	Adressekomponent som kan være mellem 1 og 99	Nej	2	Etage
SIDO	Adressekomponent der kan indeholde op til 4 cifre/bogstaver	Nej	4	Sidedør
BNR	Tekst	Nej	4	Bygningsnummer
POST	Heltal	Nej	4	Postnummer
NVNP	Tekst	Nej	N/A	Navn
NDNR	Navnedel der skal søges på: ST1, ST2, ST3, ST4 (stavemåder) eller SY1, SY2, SY3, SY4 (synonymer)	Nej	N/A	Navnedel nummer
NVN1	Tekst	Nej	N/A	Alternativt navn 1
NVN2	Tekst	Nej	N/A	Alternativt navn 2
NVN3	Tekst	Nej	N/A	Alternativt navn 3
NNVN	Binær markering	Nej	1	Nuværende navn
SADR	Binær markering	Nej	1	Seneste adresse
RETI	Binær markering	Nej	1	Retlig interesse
KADV	Binær markering	Nej	1	Kreditadvarsel markering
VRGX	Binær markering	Nej	1	Lever svar med nyt adresseformat

Hvis man vil søge på aktuel adresse og tidligere adresser skal SADR udfyldes med N ellers hvis SADR udfyldes med J søges kun på aktuel adresse. Hvis SADR ikke er udfyldt vil der søge på aktuel adresse og tidligere adresser.

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
2554	Der er ikke fundet nogen personer med disse søgekriterier	Der er ikke fundet nogen matchende personer for de angivne søgekriterier.
2555	Der er fundet mere end 1 person med disse søgekriterier	Der blev fundet for mange personer for de angivne søgekriterier. Søgningen skal give præcis 1 match.
2592	Navn skal angives	Navn er krævet.
2616	Navn skal udfyldes med mindst 2 af personens navnedele	Der skal indsendes et navn der består af mindst 2 navnedele.
2618	Der skal være mindst 2 uforkortede navnedele	Der skal indsendes et navn der består af mindst 2 hele navnedele.
2619	Navn må højst indeholde 1 * ved 3 navnedele	Der skal indsendes mindst 2 hele navnedele når der angives et navn med 3 navnedele.
2620	Navn må højst indeholde 2 * ved 4 navnedele	Der skal indsendes mindst 2 hele navnedele når der angives et navn med 4 navnedele.
2622	Personummer, Fødselsdato eller kommune/postnr. skal udfyldes	Enten kommunekode eller postnummer skal indsendes ved adressesøgninger.
2623	Vej skal udfyldes	Vejkode skal udfyldes i forb. med adressesøgninger.
2624	Husnummer eller bygningsnummer skal udfyldes	Enten husnummer eller bygningsnummer skal indsendes ved adressesøgninger.
3855	Vej= %1% %2% - udfyld Kommmune eller Postdistrikt	Enten kommunekode eller postdistrikt skal indsendes når der angives en vej.
3875	Der skal være mindst 1 ekstra navn, når navnedel er udfyldt	Når NDNNR nøgleværdien indsendes skal der også indsendes en eller flere værdier i de ekstra navnefelter.
3879	Der kan kun være stjerne i den navnedel hvortil der er valgt stavemåde	Evt. wildcard i navn skal være i navnedelen angivet i NDNR nøgleværdien.
3880	Der kan kun være underscore i den navnedel hvortil der er valgt stavemåde	Evt. udeladte bogstaver i navn skal være i navnedelen angivet i NDNR nøgleværdien.
3884	Der kan kun være underscore ' _' ifm. Stavesøgning	Udeladte bogstaver (`_`) må ikke bruges medmindre der angives andre stavemåder.
3885	Der kan kun være stjerne midt i en navnedel ifm. Stavesøgning	Der må maks angives 4 navne i NVN-feltet.
4047	Der kan kun vælges dobbelte ekstra navne, når der er mindre end 4 navnedele i navnet	Der må ikke angives flere end 1 navn i de alternative navnefelter når NVN-feltet indeholder 4 navne.

Den generelle dokumentation af fejlkoder og fejltekster står beskrevet i servicehåndbogens bilag vedr. generelle fejlkoder.

Endvidere er der fælles regler, der kan komme i anvendelse. Disse er beskrevet i servicehåndbogens bilag ang. fælles nøgleregler.

4. GCTP

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

Formålet med eksemplerne er, at give et generelt overblik af hvordan GCTP er struktureret for denne service med fokus på de søgekriterier, en bruger kan interagere med og felter der returneres.

Disse begrænsninger har følgende konsekvenser for eksemplerne:

For <Field>-elementer til nøglefelter
- Data er udeladt, og er i stedet markeret med attributten v="[DATA]".
- Alle andre attributter er udeladt (a, a1, t, osv).
For <Field>-elementer til søgning svar
- Data er udeladt, og er i stedet markeret med attributten v="[DATA]".
For <Table>-element til søgning svar
- <Row>-elementets identificerende nøgle er udeladt, og er i stedet markeret med attributten k="[ROW KEY]"
- <Field>-Data er udeladt og er i stedet markeret med attributten v="[DATA]".
- Der er kun elementer for 1 række.
For <Kvit>-element til kvittering ved fejl
- Data er udeladt, og er i stedet markeret med attributten for fejlnummer v="[DATA]" og for fejltekst t="[DATA]".

De felter, der er udeladt i disse eksempler, er beskrevet i deres respektive afsnit i dette dokumentet.

4.1. GCTP Eksempler

Se Appendiks.

4.2. Søgnings resultats datafelter

Data der returneres er beskrevet i denne sektion.

Hvert felt har et navn og kan have et antal attributter (v, t, ts, tm, tl, bv). Hvis der ikke findes data til en attribut sættes attributten ikke for feltet.

Vær opmærksom på at der kun returneres de felter, der indeholder data.

Servicen returnerer følgende felter:

Table 4. Felter der returneres.

Felt	Format	Attributter	Beskrivelse

Felt	Format	Attributter	Beskrivelse
PNRFODT	Tekst	v	Personnummer eller fødselsdato afhængig af søgekriterier
STATUS-LINIE	Tekst	v	Status linie
STARTDATO	Dato	v	Startdato
TILFLYDTO	Dato	v	Tilflytningsdato
TILFLY_USM	Usikkerhedsmarkering	v,t	Tilflytningsdato usikkerhedsmarkering
ADRNVN	Tekst	v,t	Adresseringsnavn
ADR1	Tekst	v	Adresselinje 1
ADR2	Tekst	v	Adresselinje 2
ADR3	Tekst	v	Adresselinje 3
ADR4	Tekst	v	Adresselinje 4
ADR5	Tekst	v	Adresselinje 5
ADR6	Tekst	v	Adresselinje 6
BESKTXT	Tekst	v	Tekst vedrørende beskyttelsestype
REKBESK	Binær markering (X)	v,t	Reklamebeskyttelse
KREDADV	Binær markering (X)	v,t	Kreditadvarsel markering
KOMMUNE	Kommunekode	v,t,tl	Kommunekode
RETSKREDS	Myndighedskode	v,t,tl	Retskreds
STILLING	Tekst

PRIVSOGP - Privatsøgning til private