Virksomhedsindsats.KontaktpersonService (Version 1 [UDV UX], 2024-1)
Siden opdateres automatisk til at afspejle koden.
Metoder
CreateKontaktperson (POST /v1/Kontaktperson/{id})
Opretter en kontaktperson.
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 |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
Ikke defineret
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
id [Path] | uuid |
| 0 - 1 |
|
X-ActiveOrganisation [Header] | ActiveOrganisationDto |
| 1 | Impersoneret myndighed |
- organisationType |
| 1 |
| |
- organisationCode | string | Pattern: \d{1,8} | 1 |
|
X-RequestUserMetadata [Header] | RequestUserMetadataDto |
| 1 | Kaldende myndighed |
- requestUserStructure | RequestUserStructureDto |
| 1 |
|
- - userFullName | string | Length: 1-140 | 1 |
|
- - requestUserType |
| 1 |
| |
- - userIdentifier | string | Length: 1-255 | 1 |
|
- - userEmail |
| 0 - 1 |
| |
- requestOrganisationStructure | RequestOrganisationStructureDto |
| 1 |
|
- - organisationType |
| 1 |
| |
- - organisationCode | string | Pattern: \d{1,8} | 1 |
|
- registrationDateTime | date-time |
| 1 |
|
x-requestId [Header] | string |
| 1 | Unikt id for requestet (typisk guid). Hvis api'et modtager samme requestId mere end én gang returneres http status kode 412. Max længde for id'et er 46 chars |
requestBody | CreateKontaktpersonRequestDto |
| 1 |
|
- kontaktperson | KontaktpersonDto |
| 1 | Kontaktperson for en virksomhed. |
- - fornavne | string | Length: 1-50 | 1 | Fornavn(e). |
- - efternavn | string | Length: 1-50 | 1 | Efternavn. |
- - titel | string | MaxLength: 50 | 0 - 1 | Titel. |
- - emailadresse | MaxLength: 254 | 0 - 1 | E-mailadresse.
| |
- - telefonnummer | tel | MaxLength: 15 | 0 - 1 | Telefonnummer.
|
- - cvrNummer | string | Pattern: [0-9]{8} | 1 | CVR-nummer på virksomheden som kontaktpersonen tilhører. |
- - pNumre | stringCollection |
| 1 | P-numre på produktionsenheder som kontaktpersonen tilhører. |
- - - string | string |
| 0 - * |
|
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
response | CreateKontaktpersonResponseDto |
| 1 |
|
- id | uuid |
| 1 | Kontaktperson id. |
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
120501 | Virksomheden blev ikke fundet. | Virksomheden blev ikke fundet. |
120503 | Produktionsenheden blev ikke fundet. | Produktionsenheden blev ikke fundet. |
120507 | Produktionsenheden tilhører ikke den angivne virksomhed. | Produktionsenheden tilhører ikke den angivne virksomhed. |
120508 | Der skal være angivet et telefonnummer eller en e-mailadresse for en kontaktperson. | Der skal være angivet et telefonnummer eller en e-mailadresse for en kontaktperson. |
GetKontaktperson (GET /v1/Kontaktperson/{id})
Finder en kontaktperson.
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 |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
Ikke defineret
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
id [Path] | uuid |
| 1 |
|
X-ActiveOrganisation [Header] | ActiveOrganisationDto |
| 1 | Impersoneret myndighed |
- organisationType |
| 1 |
| |
- organisationCode | string | Pattern: \d{1,8} | 1 |
|
X-RequestUserMetadata [Header] | RequestUserMetadataDto |
| 1 | Kaldende myndighed |
- requestUserStructure | RequestUserStructureDto |
| 1 |
|
- - userFullName | string | Length: 1-140 | 1 |
|
- - requestUserType |
| 1 |
| |
- - userIdentifier | string | Length: 1-255 | 1 |
|
- - userEmail |
| 0 - 1 |
| |
- requestOrganisationStructure | RequestOrganisationStructureDto |
| 1 |
|
- - organisationType |
| 1 |
| |
- - organisationCode | string | Pattern: \d{1,8} | 1 |
|
- registrationDateTime | date-time |
| 1 |
|
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
response | GetKontaktpersonResponseDto |
| 1 |
|
- kontaktperson | KontaktpersonGetDto |
| 1 | Kontaktperson for en virksomhed. |
- - fornavne | string | Length: 1-50 | 1 | Fornavn(e). |
- - efternavn | string | Length: 1-50 | 1 | Efternavn. |
- - titel | string | MaxLength: 50 | 0 - 1 | Titel. |
- - emailadresse | MaxLength: 254 | 0 - 1 | E-mailadresse.
| |
- - telefonnummer | tel | MaxLength: 15 | 0 - 1 | Telefonnummer.
|
- - cvrNummer | string | Pattern: [0-9]{8} | 1 | CVR-nummer på virksomheden som kontaktpersonen tilhører. |
- - pNumre | stringCollection |
| 1 | P-numre på produktionsenheder som kontaktpersonen tilhører. |
- - - string | string |
| 0 - * |
|
- - id | uuid |
| 1 | Kontaktperson id. |
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
120504 | Kontaktpersonen blev ikke fundet. | Kontaktpersonen blev ikke fundet. |
UpdateKontaktperson (PUT /v1/Kontaktperson/{id})
Opdaterer en kontaktperson.
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 |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
Ikke defineret
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
id [Path] | uuid |
| 1 |
|
X-ActiveOrganisation [Header] | ActiveOrganisationDto |
| 1 | Impersoneret myndighed |
- organisationType |
| 1 |
| |
- organisationCode | string | Pattern: \d{1,8} | 1 |
|
X-RequestUserMetadata [Header] | RequestUserMetadataDto |
| 1 | Kaldende myndighed |
- requestUserStructure | RequestUserStructureDto |
| 1 |
|
- - userFullName | string | Length: 1-140 | 1 |
|
- - requestUserType |
| 1 |
| |
- - userIdentifier | string | Length: 1-255 | 1 |
|
- - userEmail |
| 0 - 1 |
| |
- requestOrganisationStructure | RequestOrganisationStructureDto |
| 1 |
|
- - organisationType |
| 1 |
| |
- - organisationCode | string | Pattern: \d{1,8} | 1 |
|
- registrationDateTime | date-time |
| 1 |
|
x-requestId [Header] | string |
| 1 | Unikt id for requestet (typisk guid). Hvis api'et modtager samme requestId mere end én gang returneres http status kode 412. Max længde for id'et er 46 chars |
requestBody | UpdateKontaktpersonRequestDto |
| 1 |
|
- kontaktperson | KontaktpersonDto |
| 1 | Kontaktperson for en virksomhed. |
- - fornavne | string | Length: 1-50 | 1 | Fornavn(e). |
- - efternavn | string | Length: 1-50 | 1 | Efternavn. |
- - titel | string | MaxLength: 50 | 0 - 1 | Titel. |
- - emailadresse | MaxLength: 254 | 0 - 1 | E-mailadresse.
| |
- - telefonnummer | tel | MaxLength: 15 | 0 - 1 | Telefonnummer.
|
- - cvrNummer | string | Pattern: [0-9]{8} | 1 | CVR-nummer på virksomheden som kontaktpersonen tilhører. |
- - pNumre | stringCollection |
| 1 | P-numre på produktionsenheder som kontaktpersonen tilhører. |
- - - string | string |
| 0 - * |
|
Output
Intet output
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
120504 | Kontaktpersonen blev ikke fundet. | Kontaktpersonen blev ikke fundet. |
120501 | Virksomheden blev ikke fundet. | Virksomheden blev ikke fundet. |
120503 | Produktionsenheden blev ikke fundet. | Produktionsenheden blev ikke fundet. |
120507 | Produktionsenheden tilhører ikke den angivne virksomhed. | Produktionsenheden tilhører ikke den angivne virksomhed. |
120508 | Der skal være angivet et telefonnummer eller en e-mailadresse for en kontaktperson. | Der skal være angivet et telefonnummer eller en e-mailadresse for en kontaktperson. |
DeleteKontaktperson (DELETE /v1/Kontaktperson/{id})
Sletter en kontaktperson.
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 |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
Ikke defineret
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
id [Path] | uuid |
| 1 |
|
X-ActiveOrganisation [Header] | ActiveOrganisationDto |
| 1 | Impersoneret myndighed |
- organisationType |
| 1 |
| |
- organisationCode | string | Pattern: \d{1,8} | 1 |
|
X-RequestUserMetadata [Header] | RequestUserMetadataDto |
| 1 | Kaldende myndighed |
- requestUserStructure | RequestUserStructureDto |
| 1 |
|
- - userFullName | string | Length: 1-140 | 1 |
|
- - requestUserType |
| 1 |
| |
- - userIdentifier | string | Length: 1-255 | 1 |
|
- - userEmail |
| 0 - 1 |
| |
- requestOrganisationStructure | RequestOrganisationStructureDto |
| 1 |
|
- - organisationType |
| 1 |
| |
- - organisationCode | string | Pattern: \d{1,8} | 1 |
|
- registrationDateTime | date-time |
| 1 |
|
x-requestId [Header] | string |
| 1 | Unikt id for requestet (typisk guid). Hvis api'et modtager samme requestId mere end én gang returneres http status kode 412. Max længde for id'et er 46 chars |
Output
Intet output
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
120504 | Kontaktpersonen blev ikke fundet. | Kontaktpersonen blev ikke fundet. |
SoegKontaktpersoner (GET /v1/Kontaktperson/soeg)
Fremsøger kontaktpersoner ud fra parametre.
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 |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
Ikke defineret
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
navn [Query] | string |
| 0 - 1 | Del af kontaktpersonens navn. |
telefonnummer [Query] | string |
| 0 - 1 | Del af kontaktpersonens telefonnummer. |
emailadresse [Query] | string | MaxLength: 254 | 0 - 1 | Del af kontaktpersonens e-mailadresse. |
cvrNummer [Query] | string | Pattern: [0-9]{8} | 0 - 1 | CVR-nummer på virksomheden som kontaktpersonen tilhører. |
pNummer [Query] | string | Pattern: [0-9]{10} | 0 - 1 | P-nummer på produktionsenheden som kontaktpersonen tilhører. |
X-ActiveOrganisation [Header] | ActiveOrganisationDto |
| 1 | Impersoneret myndighed |
- organisationType |
| 1 |
| |
- organisationCode | string | Pattern: \d{1,8} | 1 |
|
X-RequestUserMetadata [Header] | RequestUserMetadataDto |
| 1 | Kaldende myndighed |
- requestUserStructure | RequestUserStructureDto |
| 1 |
|
- - userFullName | string | Length: 1-140 | 1 |
|
- - requestUserType |
| 1 |
| |
- - userIdentifier | string | Length: 1-255 | 1 |
|
- - userEmail |
| 0 - 1 |
| |
- requestOrganisationStructure | RequestOrganisationStructureDto |
| 1 |
|
- - organisationType |
| 1 |
| |
- - organisationCode | string | Pattern: \d{1,8} | 1 |
|
- registrationDateTime | date-time |
| 1 |
|
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
response | SoegKontaktpersonerResponseDto |
| 1 |
|
- soegeresultater | KontaktpersonGetDtoCollection |
| 1 | Søgeresultater. |
- - KontaktpersonGetDto | KontaktpersonGetDto |
| 0 - * |
|
- - - fornavne | string | Length: 1-50 | 1 | Fornavn(e). |
- - - efternavn | string | Length: 1-50 | 1 | Efternavn. |
- - - titel | string | MaxLength: 50 | 0 - 1 | Titel. |
- - - emailadresse | MaxLength: 254 | 0 - 1 | E-mailadresse.
| |
- - - telefonnummer | tel | MaxLength: 15 | 0 - 1 | Telefonnummer.
|
- - - cvrNummer | string | Pattern: [0-9]{8} | 1 | CVR-nummer på virksomheden som kontaktpersonen tilhører. |
- - - pNumre | stringCollection |
| 1 | P-numre på produktionsenheder som kontaktpersonen tilhører. |
- - - - string | string |
| 0 - * |
|
- - - id | uuid |
| 1 | Kontaktperson id. |
Fejlkoder
Ingen fejlkoder