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

 

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

Element

Type

Detaljer

Forekomst

Beskrivelse

id [Path]

uuid

 

0 - 1

 

X-ActiveOrganisation [Header]

ActiveOrganisationDto

 

1

Impersoneret myndighed

-    organisationType

OrganisationTypeCodeList

 

1

 

-    organisationCode

string

Pattern: \d{1,8}
MinLength: 1

1

 

X-RequestUserMetadata [Header]

RequestUserMetadataDto

 

1

Kaldende myndighed

-    requestUserStructure

RequestUserStructureDto

 

1

 

-    -    userFullName

string

Length: 1-140

1

 

-    -    requestUserType

RequestUserTypeCodeList

 

1

 

-    -    userIdentifier

string

Length: 1-255

1

 

-    -    userEmail

email

 

0 - 1

 

-    requestOrganisationStructure

RequestOrganisationStructureDto

 

1

 

-    -    organisationType

OrganisationTypeCodeList

 

1

 

-    -    organisationCode

string

Pattern: \d{1,8}
MinLength: 1

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

email

MaxLength: 254

0 - 1

E-mailadresse.
Feltet er påkrævet, hvis Telefonnummer ikke er sat.

-    -    telefonnummer

tel

MaxLength: 15

0 - 1

Telefonnummer.
Feltet er påkrævet, hvis Emailadresse ikke er sat.

-    -    cvrNummer

string

Pattern: [0-9]{8}
MinLength: 1

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

Element

Type

Detaljer

Forekomst

Beskrivelse

response

CreateKontaktpersonResponseDto

 

1

 

-    id

uuid

 

1

Kontaktperson id.

Fejlkoder

Fejlkode

Fejltekst

Beskrivelse

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

 

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

Element

Type

Detaljer

Forekomst

Beskrivelse

id [Path]

uuid

 

1

 

X-ActiveOrganisation [Header]

ActiveOrganisationDto

 

1

Impersoneret myndighed

-    organisationType

OrganisationTypeCodeList

 

1

 

-    organisationCode

string

Pattern: \d{1,8}
MinLength: 1

1

 

X-RequestUserMetadata [Header]

RequestUserMetadataDto

 

1

Kaldende myndighed

-    requestUserStructure

RequestUserStructureDto

 

1

 

-    -    userFullName

string

Length: 1-140

1

 

-    -    requestUserType

RequestUserTypeCodeList

 

1

 

-    -    userIdentifier

string

Length: 1-255

1

 

-    -    userEmail

email

 

0 - 1

 

-    requestOrganisationStructure

RequestOrganisationStructureDto

 

1

 

-    -    organisationType

OrganisationTypeCodeList

 

1

 

-    -    organisationCode

string

Pattern: \d{1,8}
MinLength: 1

1

 

-    registrationDateTime

date-time

 

1

 

Output

Element

Type

Detaljer

Forekomst

Beskrivelse

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

email

MaxLength: 254

0 - 1

E-mailadresse.
Feltet er påkrævet, hvis Telefonnummer ikke er sat.

-    -    telefonnummer

tel

MaxLength: 15

0 - 1

Telefonnummer.
Feltet er påkrævet, hvis Emailadresse ikke er sat.

-    -    cvrNummer

string

Pattern: [0-9]{8}
MinLength: 1

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

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

 

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

Element

Type

Detaljer

Forekomst

Beskrivelse

id [Path]

uuid

 

1

 

X-ActiveOrganisation [Header]

ActiveOrganisationDto

 

1

Impersoneret myndighed

-    organisationType

OrganisationTypeCodeList

 

1

 

-    organisationCode

string

Pattern: \d{1,8}
MinLength: 1

1

 

X-RequestUserMetadata [Header]

RequestUserMetadataDto

 

1

Kaldende myndighed

-    requestUserStructure

RequestUserStructureDto

 

1

 

-    -    userFullName

string

Length: 1-140

1

 

-    -    requestUserType

RequestUserTypeCodeList

 

1

 

-    -    userIdentifier

string

Length: 1-255

1

 

-    -    userEmail

email

 

0 - 1

 

-    requestOrganisationStructure

RequestOrganisationStructureDto

 

1

 

-    -    organisationType

OrganisationTypeCodeList

 

1

 

-    -    organisationCode

string

Pattern: \d{1,8}
MinLength: 1

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

email

MaxLength: 254

0 - 1

E-mailadresse.
Feltet er påkrævet, hvis Telefonnummer ikke er sat.

-    -    telefonnummer

tel

MaxLength: 15

0 - 1

Telefonnummer.
Feltet er påkrævet, hvis Emailadresse ikke er sat.

-    -    cvrNummer

string

Pattern: [0-9]{8}
MinLength: 1

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

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

 

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

Element

Type

Detaljer

Forekomst

Beskrivelse

id [Path]

uuid

 

1

 

X-ActiveOrganisation [Header]

ActiveOrganisationDto

 

1

Impersoneret myndighed

-    organisationType

OrganisationTypeCodeList

 

1

 

-    organisationCode

string

Pattern: \d{1,8}
MinLength: 1

1

 

X-RequestUserMetadata [Header]

RequestUserMetadataDto

 

1

Kaldende myndighed

-    requestUserStructure

RequestUserStructureDto

 

1

 

-    -    userFullName

string

Length: 1-140

1

 

-    -    requestUserType

RequestUserTypeCodeList

 

1

 

-    -    userIdentifier

string

Length: 1-255

1

 

-    -    userEmail

email

 

0 - 1

 

-    requestOrganisationStructure

RequestOrganisationStructureDto

 

1

 

-    -    organisationType

OrganisationTypeCodeList

 

1

 

-    -    organisationCode

string

Pattern: \d{1,8}
MinLength: 1

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

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

 

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

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

OrganisationTypeCodeList

 

1

 

-    organisationCode

string

Pattern: \d{1,8}
MinLength: 1

1

 

X-RequestUserMetadata [Header]

RequestUserMetadataDto

 

1

Kaldende myndighed

-    requestUserStructure

RequestUserStructureDto

 

1

 

-    -    userFullName

string

Length: 1-140

1

 

-    -    requestUserType

RequestUserTypeCodeList

 

1

 

-    -    userIdentifier

string

Length: 1-255

1

 

-    -    userEmail

email

 

0 - 1

 

-    requestOrganisationStructure

RequestOrganisationStructureDto

 

1

 

-    -    organisationType

OrganisationTypeCodeList

 

1

 

-    -    organisationCode

string

Pattern: \d{1,8}
MinLength: 1

1

 

-    registrationDateTime

date-time

 

1

 

Output

Element

Type

Detaljer

Forekomst

Beskrivelse

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

email

MaxLength: 254

0 - 1

E-mailadresse.
Feltet er påkrævet, hvis Telefonnummer ikke er sat.

-    -    -    telefonnummer

tel

MaxLength: 15

0 - 1

Telefonnummer.
Feltet er påkrævet, hvis Emailadresse ikke er sat.

-    -    -    cvrNummer

string

Pattern: [0-9]{8}
MinLength: 1

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