Borgerkommunikation.BorgerkommunikationStatusService [UDV](Version 3, 2025-1)
Siden opdateres automatisk til at afspejle koden.
Metoder
GetPersonKommunikationStatus (GET /v3/BorgerkommunikationStatus)
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
A-kasse |
| X | Fra 120 dage inden medlemskab til 120 dage efter medlemskab | X |
|
|
|
|
JobCenter |
| X |
| X | X | X |
| X |
Kommune |
| X |
| X |
|
|
|
|
STAR | X |
|
|
|
|
|
|
|
Scope
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
x-civilregistrationIdentifier [Header] | string | Pattern: ((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|0000000000 | 1 | Beskrivelse af cpr |
personstatusstruktur [Query] | boolean |
| 0 - 1 |
|
personkommentarer [Query] | boolean |
| 0 - 1 |
|
gaesteadgang [Query] | boolean |
| 0 - 1 |
|
personnummerHistorik [Query] | boolean |
| 0 - 1 |
|
adresse [Query] | boolean |
| 0 - 1 |
|
midlertidigAdresse [Query] | boolean |
| 0 - 1 |
|
boernUnder18 [Query] | boolean |
| 0 - 1 |
|
andenaktoerhenvisning [Query] | boolean |
| 0 - 1 |
|
personFagprofessionelKontakt [Query] | boolean |
| 0 - 1 |
|
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
response | GetPersonKommunikationStatusResponseDto |
| 1 |
|
- personnummer | string | Pattern: ((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|0000000000 | 1 | Borgers personnummer |
- personstatusstruktur | PersonstatusstrukturDto |
| 0 - 1 |
|
- - personstatus |
| 1 |
| |
- - navnestruktur | NavnestrukturDto |
| 0 - 1 |
|
- - - fornavne | string | Length: 1-50 | 1 | Erklæring af personens fornavn(e). |
- - - mellemnavn | string | Length: 0-40 | 0 - 1 | Erklæring af personens mellemnavne(e). |
- - - efternavn | string | Length: 1-40 | 1 | Erklæring af en persons efternavne(e). |
- - statsborgerskab |
| 1 |
| |
- - indrejsedato | date-time |
| 0 - 1 | Dato for immigrering til Danmark. |
- - foedselsdato | date-time |
| 1 | Borgers fødselsdato. |
- - bopaelskommunekode | int32 |
| 0 - 1 | Bopælskommunekode. Udstilles for kommunenr. 101 - 851. Ellers tom. |
- - jobcentertilknytning | JobcentertilknytningDto |
| 1 |
|
- - - jobcenterKode | int32 | Pattern: [1-9][0-9]{4} | 1 | Jobcentres kode |
- - - jobcenterNavn | string | Length: 1-100 | 1 | Jobcentres navn |
- - - kommunekodeSamling | stringCollection |
| 1 | Kommuner som jobcentret repræsenterer. Af tekniske årsager har denne elementlistes elementer ikke navn og beskrivelse. |
- - - - string | string |
| 0 - * |
|
- - borgersKoen |
| 0 - 1 |
| |
- - nordiskBorger | boolean |
| 0 - 1 | Angiver om borgeren er nordisk statsborger |
- - civilstatus |
| 0 - 1 |
| |
- personkommentarer | PersonkommentarDtoCollection |
| 1 | Samling af generelle statuskommentarer tilknyttet personen ud fra(populært kaldet AMP kommentarfeltet). |
- - PersonkommentarDto | PersonkommentarDto |
| 0 - * |
|
- - - personkommentarId | uuid |
| 1 | Unik nøgle |
- - - kommentar | string | Length: 1-1000 | 1 | Kommentartekst |
- - - registreringstidspunkt | date-time |
| 1 | Hændelsesdato for registreringen |
- - - sagsbehandler | SagsbehandlerDto |
| 1 |
|
- - - - brugerId | string | Length: 1-64 | 1 | Sagsbehandlerens RID fra medarbejder OCES certifikatet.. |
- - - - brugerFuldtNavn | string | Length: 1-140 | 1 | Sagsbehandlers fulde navn, ved systemkald angives systemets og jobbets navn her. |
- - - registrerendeMyndighed | RegistrerendeMyndighedDto |
| 1 |
|
- - - - organisationType |
| 0 - 1 |
| |
- - - - organisationskode | string | Pattern: [-][1]|[0-9]{1,8} | 1 | Myndighedskode. |
- gaesteadgange | GaesteadgangDtoCollection |
| 1 | Samling af gaesteadgange. |
- - GaesteadgangDto | GaesteadgangDto |
| 0 - * |
|
- - - gaesteadgangId | uuid |
| 1 | Unik nøgle |
- - - gaesteadgangskommentar | string | Length: 1-1000 | 1 | Kommentartekst |
- - - dfdgRegisteringstidspunkt | date-time |
| 1 | Hændelsestidspunkt for registreringen i DFDG |
- - - registerendeBruger | SagsbehandlerDto |
| 1 |
|
- - - - brugerId | string | Length: 1-64 | 1 | Sagsbehandlerens RID fra medarbejder OCES certifikatet.. |
- - - - brugerFuldtNavn | string | Length: 1-140 | 1 | Sagsbehandlers fulde navn, ved systemkald angives systemets og jobbets navn her. |
- - - registrerendeMyndighed | RegistrerendeMyndighedDto |
| 1 |
|
- - - - organisationType |
| 0 - 1 |
| |
- - - - organisationskode | string | Pattern: [-][1]|[0-9]{1,8} | 1 | Myndighedskode. |
- personnummerHistorik | TidligereCPRnummerDtoCollection |
| 1 | Samling af tidligere personnummre. |
- - TidligereCPRnummerDto | TidligereCPRnummerDto |
| 0 - * |
|
- - - personnummer | string | Pattern: ((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|0000000000 | 1 | Tidligere CPR-nummer |
- - - personnummerstatus |
| 1 |
| |
- - - slutdato | date-time |
| 0 - 1 | Slutdato for borgers CPR-nrs gyldighed |
- adressestruktur | AdressestrukturDto |
| 0 - 1 |
|
- - navneOgAdressebeskyttelseStartdato | date-time |
| 0 - 1 | Startdato for navne og adresse beskyttelse |
- - navneOgAdressebeskyttelseSlutdato | date-time |
| 0 - 1 | Slutdato for navne og adresse beskyttelse |
- - adresse | AdresseDto |
| 0 - 1 |
|
- - - coNavn | string |
| 0 - 1 |
|
- - - vejnavn | string | Length: 1-40 | 1 |
|
- - - husnummer | string | Pattern: ^([1-9][0-9]{0,2}[a-zA-Z]?)(-[1-9][0-9]{0,2}[a-zA-Z]?)?$ | 1 |
|
- - - etage | string | Pattern: ^(?:([1-9]|[1-9][0-9]|KL|ST|kl|st|k[2-9]|K[2-9]))?$ | 0 - 1 |
|
- - - sideDoer | string | Length: 0-4 | 0 - 1 |
|
- - - bygningsnummer | string |
| 0 - 1 |
|
- - - bynavn | string | Length: 0-34 | 0 - 1 |
|
- - - postnummer | string | Pattern: [0-9]{4} | 1 |
|
- - - postdistrikt | string | Length: 1-20 | 1 |
|
- - - landekode | string | Pattern: ^(?:[a-zA-Z]{2}|[a-zA-Z]{3}|[0-9]{3}|[0-9]{4})?$ | 0 - 1 |
|
- - darAdresse | string |
| 0 - 1 |
|
- - geokoordinatStruktur | GeokoordinatStrukturDto |
| 0 - 1 |
|
- - - breddegrad | double |
| 1 |
|
- - - laengdegrad | double |
| 1 |
|
- temporaryAddress | MidlertidigAdresseDto |
| 0 - 1 |
|
- - startdato | date-time |
| 1 | Startdato for midlertidigadresse |
- - slutdato | date-time |
| 0 - 1 | Slutdato for midlertidigadresse |
- - coNavn | string | MaxLength: 75 | 0 - 1 | Navn på Co |
- - postadresse | PostAdresseDto |
| 1 |
|
- - - bygningsnavn | string | Length: 1-34 | 0 - 1 | Navn på bygning |
- - - vejnavn | string | Length: 1-40 | 1 | Vejnavn |
- - - vejnavnKort | string | Length: 1-20 | 0 - 1 | Vejnavn |
- - - husnummer | string | Pattern: ^(?:[0-9]{0,6}[a-zA-Z]|([1-9][0-9]{0,2}[a-zA-Z]?)(-[1-9][0-9]{0,2}[a-zA-Z]?)?)$ | 1 | Husnummer |
- - - etage | string | Pattern: ^([1-9]|[1-9][0-9]|KL|ST|kl|st|k[2-9]|K[2-9])$ | 0 - 1 | Etagenummer |
- - - sideDoer | string | Length: 1-4 | 0 - 1 | Dør-angivelse, fx th. |
- - - supplerendeBynavn | string | Length: 1-34 | 0 - 1 | Yderligere bynavn eller områdenavn hvor nødvendigt. |
- - - postboksnummer | string | Length: 1-10 | 0 - 1 | Postboksnummer |
- - - postnummer | string | Length: 1-10 | 1 | Postnummer |
- - - bynavn | string | Length: 1-20 | 1 | Bynavn |
- - - landekode | string | Pattern: ^[a-zA-Z]{2}$ | 1 | Landekode |
- boernUnder18 | BoernUnder18DtoCollection |
| 1 | Børn under 18 |
- - BoernUnder18Dto | BoernUnder18Dto |
| 0 - * |
|
- - - foedselsdato | date-time |
| 1 | Barnets fødselsdaton |
- - - maandeOgAarFor18Aar | string | Length: 7-7 | 1 | Måned hvor barnet fylder 18 år i formatet MM/YYYY, fx 12/2016 |
- - - opholdsland |
| 1 |
| |
- andenAktoerHenvisninger | AndenAktoerHenvisningDtoCollection |
| 1 | Samling af Anden Aktoer Henvisninger |
- - AndenAktoerHenvisningDto | AndenAktoerHenvisningDto |
| 0 - * |
|
- - - henvisningsId | uuid |
| 1 | Unik identifikation af anden aktør henvisning |
- - - eksternSystemAftaleId | uuid |
| 0 - 1 | Id på delaftale i det ekstern system |
- - - cvrEnhedsid | string | Pattern: [0-9]{8} | 1 | Anden aktørs CVR-nummer. |
- - - pNummer | string | Pattern: [0-9]{10} | 1 | P-nr på anden aktør |
- - - startDato | date |
| 1 | Dato for anden aktør henvisningens start. |
- - - slutDato | date |
| 1 | Dato for anden aktør henvisningens afslutning. |
- - - dfdgRegisteringstidspunkt | date-time |
| 1 | Dato for anden aktør henvisningens start. |
- - - erAnnulleret | boolean |
| 1 | Om Anden Aktør henvisning er annulleret eller ej |
- - - kommentar | string |
| 0 - 1 | Kommentar |
- - - sagsbehandler | AndenAktoerHenvisningSagsbehandlerDto |
| 1 |
|
- - - - brugerFuldtNavn | string | MaxLength: 140 | 0 - 1 | Sagsbehandlers fulde navn, ved systemkald angives systemets og jobbets navn her. |
- - - - brugerId | string | Length: 1-64 | 1 | Sagsbehandlerens RID fra medarbejder OCES certifikatet.. |
- - - registrerendeMyndighed | RegistrerendeMyndighedDto |
| 1 |
|
- - - - organisationType |
| 0 - 1 |
| |
- - - - organisationskode | string | Pattern: [-][1]|[0-9]{1,8} | 1 | Myndighedskode. |
- fagprofessionelleKontakter | PersonFagprofessionelKontaktDtoCollection |
| 1 | Samling af Fagprofessionelle Kontakter |
- - PersonFagprofessionelKontaktDto | PersonFagprofessionelKontaktDto |
| 0 - * |
|
- - - fagprofessionelKontaktId | uuid |
| 0 - 1 | Identifikation af kontaktpersontilknytningen. Hvis kontaktpersonen er mentor eller udslusningskoordinator er værdien null. |
- - - fagprofessionelKontaktNavn | string | Length: 1-250 | 1 | Navn på kontakt, team eller fornavn, mellemnavn, efternavn på kontaktpersonen |
- - - fagprofessionelKontaktType |
| 1 |
| |
- - - eksternKontaktReference | string | Length: 0-250 | 0 - 1 | Ekstern system reference på kontakten; f.eks. til AD |
- - - telefonnummer | string | Pattern: ^(?:\+?[0-9]{3,20})?$ | 0 - 1 | Kontaktens telefonnummer inkl. landekode |
- - - mobilnummer | string | Pattern: ^(?:\+?[0-9]{3,20})?$ | 0 - 1 | Kontaktens mobilnummer inkl. landekode |
- - - emailadresse | string | Pattern: ^(?:([^>\(\)\[\]\\,;:@\s]{0,191}@[^>\(\)\[\]\\,;:@\s]{1,64}))?$ | 0 - 1 | Kontaktens emailadresse |
- - - startDato | date-time |
| 1 | Startdato og tidspunkt for tilknytningen af kontakten |
- - - slutDato | date-time |
| 0 - 1 | Slutdato og tidspunkt for tilknytningen af kontakten |
- - - kontaktSkalVisesForBorger | boolean |
| 1 | Indikator for, om kontakten med denne rolle skal vises for borger på Jobnet.
|
- - - kommentarTilBorger | string | Length: 0-250 | 0 - 1 | Kommentar/bemærkninger til visning for borger på Jobnet. |
- - - kommentarTilSagsbehandler | string | Length: 0-250 | 0 - 1 | Kommentar/bemærkninger til visning for jobkonsulent i a-kasse og jobcenter. |
- - - ansvarligMyndighedDto | AnsvarligMyndighedDto |
| 1 |
|
- - - - organisationType |
| 1 |
| |
- - - - organisationCode | string | Pattern: [-][1]|[0-9]{1,8} | 1 | Organisationskode.
|
- - - - clientSystemType |
| 1 |
| |
- - - - cvrnummer | string | Pattern: ^(?:[0-9]{8})?$ | 0 - 1 | CVR-nummer på organisationen, som kontakten er tilknyttet |
- - - - produktionsenhedsnummer | string | Pattern: ^(?:[0-9]{10})?$ | 0 - 1 | Produktionsenhedsnummer på organisationen, som kontakten er tilknyttet |
- - - dfdgRegistreringstidspunkt | date-time |
| 1 | Slutdato og tidspunkt for tilknytningen af kontakten |
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
60006 | Unknown cpr | Unknown cpr |
1014 | The submitted message is not valid | The submitted message is not valid |
GetAdressehistorik (Tidl. PersonHistoryService.GetPersonAddressHistory)
Denne metode bruges til at hente historik for en borgers adresser
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
A-kasse | X |
|
|
|
|
|
|
|
AUB |
| X |
| X |
|
|
|
|
JobCenter |
| X |
|
| X |
|
|
|
Kommune |
| X |
|
|
|
|
|
|
STAR | X |
|
|
|
|
|
|
|
Scope
XXX
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
x-civilregistrationIdentifier [Header] | string | Pattern: ((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|0000000000 | 1 | Beskrivelse af cpr |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
response | GetPersonAddressHistoryResponseType |
| 1 |
|
| PersonCivilRegistrationIdentifierType | Pattern: ((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|0000000000 | 1 | Unik identifikation af en borger. |
| AddressHistoryCollection |
| 0 - 1 |
|
- Adressehistorikker | AddressHistoryCollectionTypeCollection |
| 1 | Liste af historiske adresseoplysninger. |
- - HistoriskAdresse | AddressHistoryCollectionType |
| 0 - * |
|
- - - BaseType | ServiceModelBase |
| 1 |
|
- - - registreringsmetadata | RegistrationMetadataType |
| 1 | Registrerende bruger og dennes organisation (som ved fx Anden Aktør kan være forskellig fra ovenfor) |
- - - - erSlettet | boolean |
| 1 | Angiver om registreringen er en sletning |
- - - - erAktuel | boolean |
| 1 | Det er en række som er aktuel (kan typisk også ses i PSS). |
- - - - registrerendeMyndighed | ActiveOrganisationHeaderType |
| 0 - 1 | Den myndighed som der er registreret på vegne af (v/ AA: som brugeren har impersonated) |
- - - - - organisationType | OrganisationTypeIdentifierType | MinInclusive: 1 | 1 |
Kodeliste med organisationstype / myndighedstype |
- - - - - organisationskode | OrganisationCodeType | Length: 1-20 | 1 |
Identifikation af organisation / myndighed |
- - - - - registrerendeBruger | RequestUserMetadataType |
| 0 - 1 | Registrerende bruger og dennes organisation (som ved fx Anden Aktør vil være forskellig fra RegisteringAuthority) |
- - - - - - kaldendeBruger | RequestUserStructureType |
| 1 | Information om den kaldende bruger. |
- - - - - - - UserFullName | UserFullNameType | Length: 1-140 | 1 | Sagsbehandlers fulde navn, ved systemkald angives systemets og jobbets navn her. |
- - - - - - - brugerType | RequestUserTypeCodeList |
| 1 | Brugertype |
- - - - - - - brugerId | UserIdentifierType | Length: 1-255 | 1 | Unik identifikation af brugeren, f.eks. en GUID, et medarbejder ID, system ID, bruger ID, certifikat ID, cpr-nummer, email (hvis den er unik) o.l. |
- - - - - - - brugerEmail | EmailAddressIdentifierType | Pattern: ([^>\(\)\[\]\\,;:@\s]{0,191}@[^>\(\)\[\]\\,;:@\s]{1,64}) | 0 - 1 | Brugers e-mail. |
- - - - - - brugerOrganisation | RequestOrganisationStructureType |
| 1 | Den organisation som registrerende bruger tilhører. |
- - - - - - - organisationType |
| 1 | Kodeliste med organisationstype / myndighedstype for registrerende bruger. | |
- - - - - - - organisationskode | OrganisationCodeType | Pattern: [-][1]|[0-9]{1,8} | 1 | Organisationskode for den registrerende bruger. |
- - - - - DFDGRegistreringstidspunkt | dateTime |
| 1 | Kaldende systems registreringstidspunkt. |
- - StartDate | dateTime |
| 1 | Startdatoen for borgers bopælsadresse |
| dateTime |
| 0 - 1 | Slutdatoen for borgers bopælsadresse |
| dateTime |
| 0 - 1 | Startdatoen for borgers bopælsadresse |
| dateTime |
| 0 - 1 | Slutdatoen for borgers adressebeskyttelse |
| boolean |
| 1 | Definition om det er en udlandsadresse eller indlandsadresse (true = udenlandsk) |
| string |
| 0 - 1 | CoName |
| string |
| 0 - 1 | Vejnavn |
| string |
| 0 - 1 | Husnummer |
| string |
| 0 - 1 | Etagenummer |
| string |
| 0 - 1 | Dørangivelse, f.eks. th |
| string |
| 0 - 1 | Postnummer. 9999 = Hjemløs |
| string |
| 0 - 1 | Bynavn |
| string |
| 0 - 1 | Landekode. 0000 = Ukendt |
| string |
| 0 - 1 | Benyttes på udenlands adresser |
| string |
| 0 - 1 | Benyttes på udenlands adresser |
| string |
| 0 - 1 | Benyttes på udenlands adresser |
| string |
| 0 - 1 | Benyttes på udenlands adresser |
| string |
| 0 - 1 | Benyttes på udenlands adresser |
| string |
| 0 - 1 | Benyttes på udenlands adresser |
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
1000 | Message can not be null | The message can not be null |
1001 | Invalid cpr | The submitted cpr is either to long or short or contains data not interpretable as a date |
1002 | Error converting response message | Error converting response message from XML stream to object |
1010 | Unknown cpr | The submitted cpr is unknown to the system |
4385 | The client does not have an unemploymentfund registration | The client does not have an unemploymentfund registration |
4575 | You are not authorized | You are not authorized to execute the operation |
4857 | Citizen belongs to different unemployment fund | Citizen belongs to different unemployment fund |
4922 | User is not allowed to access the specified person | User is not allowed to access the specified person |
6005 | The person with specified cpr does not belong to the jobcenter specified in ActiveOrganisationHeader | The person with specified cpr does not belong to the jobcenter specified in ActiveOrganisationHeader |