Virksomhedsindsats.JobannonceService (Version 2 [UDV], 2024-4)

NB!! Nedenstående viser kun de servicemetoder der er tilrettelser til.

Metoder

GetJobannonce (GET /v2/Jobannonce/{id})

Finder en jobannonce.

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

A-kasse

X

 

 

 

 

 

 

 

JobCenter

X

 

 

 

 

 

 

 

STAR

X

 

 

 

 

 

 

 

Virksomhed

X

 

 

 

 

 

 

 

Scope

virksomhedsindsats.jobannonce.read

Input

Element

Type

Detaljer

Forekomst

Beskrivelse

Element

Type

Detaljer

Forekomst

Beskrivelse

id [Path]

uuid

 

1

 

Output

Element

Type

Detaljer

Forekomst

Beskrivelse

Element

Type

Detaljer

Forekomst

Beskrivelse

response

GetJobannonceResponseDto

 

1

 

-    jobannonce

JobannonceGetDto

 

1

 

-    -    overskrift

string

Length: 1-250

1

Overskrift for jobannoncen.

-    -    broedtekst

string

Length: 1-16000

1

Brødtekst for jobannoncen.

Følgende HTML tags er tilladt:
"b", "i", "u", "br", "li", "p", "small", "big", "em", "strong", "sub", "sup", "ul", "ol", "a"

Følgende HTML atributter er tilladt:
"href"

-    -    publiceringstidspunkt

date-time

 

1

Tidspunktet jobannoncen publiceres på Jobnet.

Tidspunktet kan ikke være før dags dato.

Perioden mellem publiceringstidspunkt og afpubliceringstidspunkt må ikke være større end 8 uger.

-    -    afpubliceringstidspunkt

date-time

 

1

Tidspunktet jobannoncen afpubliceres på Jobnet.

Tidspunktet skal ligge længere ud i fremtiden end publiceringstidspunkt.

-    -    job

JobDto

 

1

 

-    -    -    type

JobTypeCodeList

 

1

 

-    -    -    adresse

AdresseDto

 

1

 

-    -    -    -    vejnavn

string

MaxLength: 100

0 - 1

Vejnavn.

Skal angives, hvis 'husnummer' er angivet.

-    -    -    -    husnummer

string

MaxLength: 10

0 - 1

Husnummer.

Skal angives, hvis 'etage' eller 'sidedoer' er angivet.

-    -    -    -    etage

string

MaxLength: 10

0 - 1

Etagebetegnelse.

-    -    -    -    sidedoer

string

MaxLength: 10

0 - 1

Side-/dørbetegnelse.

-    -    -    -    bynavn

string

MaxLength: 100

0 - 1

Bynavn.

-    -    -    -    postnummer

string

MaxLength: 10

0 - 1

Postnummer.

-    -    -    -    kommunenummer

int32

Pattern: [0-9]{3}

0 - 1

Kommunenummer.

Kan kun angives på danske adresser og er hermed samtidig påkrævet.

Skal være et gyldigt dansk kommunenummer, hvis angivet.

-    -    -    -    landekode

string

Pattern: [A-Z]{2}
MinLength: 1

1

Landekode.

Skal være en gyldig landekode (ISO 3166-1 alfa-2).

-    -    -    ingenFastArbejdsplads

boolean

 

1

Angiver, at der ikke er fast arbejdssted.

-    -    -    tidsbegraensetAnsaettelse

boolean

 

1

Hvorvidt ansættelsen er tidsbegrænset.

-    -    -    handicapIngenHindring

boolean

 

1

Hvorvidt et handicap er ingen hindring for at kunne besidde jobbet.

-    -    -    deltid

boolean

 

1

Hvorvidt ansættelsen er deltid.

Hvis jobbet er af typen 'Fleksjob', er det påkrævet at ansættelsen er deltid.

-    -    -    hoejsteUgentligeArbejdstimer

int32

MinInclusive: 1
MaxInclusive: 36

0 - 1

Højst antal ugentlige arbejdstimer.

Skal kun angives hvis jobbet er Deltid, hvormed feltet er påkrævet.
Skal være større end eller lig MindsteUgentligeArbejdstimer.

-    -    -    mindsteUgentligeArbejdstimer

int32

MinInclusive: 0
MaxInclusive: 36

0 - 1

Mindste antal ugentlige arbejdstimer.

Skal kun angives hvis jobbet er Deltid, hvormed feltet er påkrævet.
Skal være mindre end eller lig HoejesteUgentligeArbejdstimer.

-    -    -    ansaettelsesdato

date-time

 

0 - 1

Ansættelsesdato.

Hvis datoen ikke er angivet, betyder det, at man ansættes straks.

Hvis datoen er angivet, må den ikke være før dags dato.

-    -    -    conceptUriDa

uri

MinLength: 1

1

Stillingsbetegnelse angivet som ESCO-STAR kode.

Påkrævet at den er gyldig og aktiv.

-    -    -    aliasIdentifier

uuid

 

0 - 1

Alias identifier til stillingsbetegnelsen.

Påkrævet at den er gyldig og aktiv.

-    -    -    paakraevedeKoerekortTyper

DriverLicenseTypeCodeListCollection

 

0 - 1

Påkrævede kørekort typer.

-    -    -    -    DriverLicenseTypeCodeList

DriverLicenseTypeCodeList

 

0 - *

 

-    -    -    egenskaber

JobannonceEgenskabTypeCodeListCollection

 

0 - 1

Egenskaber.

-    -    -    -    JobannonceEgenskabTypeCodeList

JobannonceEgenskabTypeCodeList

 

0 - *

 

-    -    -    arbejdstider

ArbejdstidsforholdTypeCodeListCollection

 

0 - 1

Arbejdstider på dagen.

-    -    -    -    ArbejdstidsforholdTypeCodeList

ArbejdstidsforholdTypeCodeList

 

0 - *

 

-    -    ansoegning

AnsoegningDto

 

1

 

-    -    -    fristDato

date-time

 

1

Ansøgningsfrist.

Må ikke være før 'afpubliceringstidspunkt'.

Hvis 'ansaettelsesdato' er angivet, skal ansøgningsfristen være før eller lig med 'ansaettelsesdato'.

-    -    -    ledigeStillinger

int32

MinInclusive: 1
MaxInclusive: 999

1

Antal ledige stillinger.

-    -    -    kontaktpersoner

KontaktpersonDtoCollection

 

0 - 1

Kontaktpersoner.

-    -    -    -    KontaktpersonDto

KontaktpersonDto

 

0 - *

 

-    -    -    -    -    fornavne

string

Length: 1-50

1

Fornavn(e).

-    -    -    -    -    efternavn

string

Length: 1-50

1

Efternavn.

-    -    -    -    -    titel

string

MaxLength: 50

0 - 1

Titel.

-    -    -    -    -    eksternReference

uuid

 

0 - 1

Ekstern system reference for den angivne kontaktperson.

-    -    -    -    -    telefonnummer

tel

MaxLength: 15

0 - 1

Telefonnummer.

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

-    -    -    -    -    emailadresse

email

MaxLength: 254

0 - 1

E-mailadresse.

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

-    -    -    emailadresse

email

 

0 - 1

E-mailadresse som man kan ansøge via.

Mindst en ansøgningsmetode skal vælges.

-    -    -    url

uri

 

0 - 1

Url på hjemmeside som man kan ansøge via.

Mindst en ansøgningsmetode skal vælges.

-    -    -    telefonnummer

string

Pattern: (\+)?[0-9]{3,20}

0 - 1

Telefonnummer som man kan ansøge via.

Mindst en ansøgningsmetode skal vælges.

-    -    logo

base64Binary

 

0 - 1

Logo i et formaterne: PNG, JPEG (base64).

Må ikke fylde mere end 100 kB.
Må ikke være større end 200 x 200 pixels.

-    -    anonymArbejdsgiver

boolean

 

1

Hvorvidt arbejdsgiveren er anonym.

Arbejdsgiveren kan ikke være anonym, hvis jobannoncen er markeret med 'EURES'-jobegenskab.

-    -    ansvarligMyndighedskode

int32

 

0 - 1

Myndighedskode for den ansvarlige myndighed.

Påkrævet, hvis man kalder ind som jobcenter, a-kasse eller WIDK.

- - orgainsationTypeID

 

 

0 - 1

Sammen med ansvarligMyndighedskode kan det identificeres, hvem der står for annoncen i tilfælde af at anonymArbejdsgiver er angivet

-    -    id

uuid

 

1

Jobannonce id.

-    -    godkendelsesstatus

GodkendelsesstatusTypeCodeList

 

1

 

-    -    visninger

int32

 

1

Antal visninger af jobannoncen.

-    -    aftagerSystem

string

MinLength: 1

1

Id på system der har oprettet jobannoncen.

-    -    oprettetTidspunkt

date-time

 

1

Tidspunkt for oprettelse.

-    -    opdateretTidspunkt

date-time

 

1

Tidspunkt for sidste opdatering.

-    -    arbejdsgiver

ArbejdsgiverDto

 

0 - 1

 

-    -    -    cvrNummer

string

Pattern: [0-9]{8}

0 - 1

CVR-nummer.

Påkrævet for danske virksomheder.
Påkrævet hvis jobannoncen er markeret med 'EURES'-jobegenskab.
Påkrævet at den pågældende virksomhed er aktiv.

Hvis p-nummeret er angivet, skal CVR-nummeret også være angivet.

-    -    -    pNummer

string

Pattern: [0-9]{10}

0 - 1

P-nummer.

Påkrævet for danske virksomheder.
Påkrævet at den pågældende p-enhed er aktiv.

-    -    -    navn

string

Length: 1-50

1

Arbejdsgiverens navn.

-    -    -    adresse

AdresseDto

 

0 - 1

 

-    -    -    -    vejnavn

string

MaxLength: 100

0 - 1

Vejnavn.

Skal angives, hvis 'husnummer' er angivet.

-    -    -    -    husnummer

string

MaxLength: 10

0 - 1

Husnummer.

Skal angives, hvis 'etage' eller 'sidedoer' er angivet.

-    -    -    -    etage

string

MaxLength: 10

0 - 1

Etagebetegnelse.

-    -    -    -    sidedoer

string

MaxLength: 10

0 - 1

Side-/dørbetegnelse.

-    -    -    -    bynavn

string

MaxLength: 100

0 - 1

Bynavn.

-    -    -    -    postnummer

string

MaxLength: 10

0 - 1

Postnummer.

-    -    -    -    kommunenummer

int32

Pattern: [0-9]{3}

0 - 1

Kommunenummer.

Kan kun angives på danske adresser og er hermed samtidig påkrævet.

Skal være et gyldigt dansk kommunenummer, hvis angivet.

-    -    -    -    landekode

string

Pattern: [A-Z]{2}
MinLength: 1

1

Landekode.

Skal være en gyldig landekode (ISO 3166-1 alfa-2).

-    -    opretter

OpretterDto

 

0 - 1

Opretter.

-    -    -    fornavne

string

Length: 1-50

1

Fornavn(e).

-    -    -    efternavn

string

Length: 1-50

1

Efternavn.

-    -    -    titel

string

MaxLength: 50

0 - 1

Titel.

-    -    -    eksternReference

uuid

 

0 - 1

Ekstern system reference for den angivne kontaktperson.

-    -    -    telefonnummer

tel

Length: 1-15

1

Telefonnummer.

-    -    -    emailadresse

email

Length: 1-254

1

E-mailadresse.

Fejlkoder

Fejlkode

Fejltekst

Beskrivelse

Fejlkode

Fejltekst

Beskrivelse

121100

Jobannoncen blev ikke fundet.

Jobannoncen blev ikke fundet.

121104

Du har ikke adgang til at tilgå jobannoncen.

Du har ikke adgang til at tilgå jobannoncen.

GetJobannonceViaBillet (GET /v2/Jobannonce/billet/{billetId})

Henter en jobannonce, givet en billet.

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

A-kasse

X

 

 

 

 

 

 

 

JobCenter

X

 

 

 

 

 

 

 

STAR

X

 

 

 

 

 

 

 

Scope

virksomhedsindsats.jobannonce.billet.read

Input

Element

Type

Detaljer

Forekomst

Beskrivelse

Element

Type

Detaljer

Forekomst

Beskrivelse

billetId [Path]

uuid

 

1

 

Output

Element

Type

Detaljer

Forekomst

Beskrivelse

Element

Type

Detaljer

Forekomst

Beskrivelse

response

GetJobannonceViaBilletResponseDto

 

1

 

-    jobannonce

JobannonceGetDto

 

1

 

-    -    overskrift

string

Length: 1-250

1

Overskrift for jobannoncen.

-    -    broedtekst

string

Length: 1-16000

1

Brødtekst for jobannoncen.

Følgende HTML tags er tilladt:
"b", "i", "u", "br", "li", "p", "small", "big", "em", "strong", "sub", "sup", "ul", "ol", "a"

Følgende HTML atributter er tilladt:
"href"

-    -    publiceringstidspunkt

date-time

 

1

Tidspunktet jobannoncen publiceres på Jobnet.

Tidspunktet kan ikke være før dags dato.

Perioden mellem publiceringstidspunkt og afpubliceringstidspunkt må ikke være større end 8 uger.

-    -    afpubliceringstidspunkt

date-time

 

1

Tidspunktet jobannoncen afpubliceres på Jobnet.

Tidspunktet skal ligge længere ud i fremtiden end publiceringstidspunkt.

-    -    job

JobDto

 

1

 

-    -    -    type

JobTypeCodeList

 

1

 

-    -    -    adresse

AdresseDto

 

1

 

-    -    -    -    vejnavn

string

MaxLength: 100

0 - 1

Vejnavn.

Skal angives, hvis 'husnummer' er angivet.

-    -    -    -    husnummer

string

MaxLength: 10

0 - 1

Husnummer.

Skal angives, hvis 'etage' eller 'sidedoer' er angivet.

-    -    -    -    etage

string

MaxLength: 10

0 - 1

Etagebetegnelse.

-    -    -    -    sidedoer

string

MaxLength: 10

0 - 1

Side-/dørbetegnelse.

-    -    -    -    bynavn

string

MaxLength: 100

0 - 1

Bynavn.

-    -    -    -    postnummer

string

MaxLength: 10

0 - 1

Postnummer.

-    -    -    -    kommunenummer

int32

Pattern: [0-9]{3}

0 - 1

Kommunenummer.

Kan kun angives på danske adresser og er hermed samtidig påkrævet.

Skal være et gyldigt dansk kommunenummer, hvis angivet.

-    -    -    -    landekode

string

Pattern: [A-Z]{2}
MinLength: 1

1

Landekode.

Skal være en gyldig landekode (ISO 3166-1 alfa-2).

-    -    -    ingenFastArbejdsplads

boolean

 

1

Angiver, at der ikke er fast arbejdssted.

-    -    -    tidsbegraensetAnsaettelse

boolean

 

1

Hvorvidt ansættelsen er tidsbegrænset.

-    -    -    handicapIngenHindring

boolean

 

1

Hvorvidt et handicap er ingen hindring for at kunne besidde jobbet.

-    -    -    deltid

boolean

 

1

Hvorvidt ansættelsen er deltid.

Hvis jobbet er af typen 'Fleksjob', er det påkrævet at ansættelsen er deltid.

-    -    -    hoejsteUgentligeArbejdstimer

int32

MinInclusive: 1
MaxInclusive: 36

0 - 1

Højst antal ugentlige arbejdstimer.

Skal kun angives hvis jobbet er Deltid, hvormed feltet er påkrævet.
Skal være større end eller lig MindsteUgentligeArbejdstimer.

-    -    -    mindsteUgentligeArbejdstimer

int32

MinInclusive: 0
MaxInclusive: 36

0 - 1

Mindste antal ugentlige arbejdstimer.

Skal kun angives hvis jobbet er Deltid, hvormed feltet er påkrævet.
Skal være mindre end eller lig HoejesteUgentligeArbejdstimer.

-    -    -    ansaettelsesdato

date-time

 

0 - 1

Ansættelsesdato.

Hvis datoen ikke er angivet, betyder det, at man ansættes straks.

Hvis datoen er angivet, må den ikke være før dags dato.

-    -    -    conceptUriDa

uri

MinLength: 1

1

Stillingsbetegnelse angivet som ESCO-STAR kode.

Påkrævet at den er gyldig og aktiv.

-    -    -    aliasIdentifier

uuid

 

0 - 1

Alias identifier til stillingsbetegnelsen.

Påkrævet at den er gyldig og aktiv.

-    -    -    paakraevedeKoerekortTyper

DriverLicenseTypeCodeListCollection

 

0 - 1

Påkrævede kørekort typer.

-    -    -    -    DriverLicenseTypeCodeList

DriverLicenseTypeCodeList

 

0 - *

 

-    -    -    egenskaber

JobannonceEgenskabTypeCodeListCollection

 

0 - 1

Egenskaber.

-    -    -    -    JobannonceEgenskabTypeCodeList

JobannonceEgenskabTypeCodeList

 

0 - *

 

-    -    -    arbejdstider

ArbejdstidsforholdTypeCodeListCollection

 

0 - 1

Arbejdstider på dagen.

-    -    -    -    ArbejdstidsforholdTypeCodeList

ArbejdstidsforholdTypeCodeList

 

0 - *

 

-    -    ansoegning

AnsoegningDto

 

1

 

-    -    -    fristDato

date-time

 

1

Ansøgningsfrist.

Må ikke være før 'afpubliceringstidspunkt'.

Hvis 'ansaettelsesdato' er angivet, skal ansøgningsfristen være før eller lig med 'ansaettelsesdato'.

-    -    -    ledigeStillinger

int32

MinInclusive: 1
MaxInclusive: 999

1

Antal ledige stillinger.

-    -    -    kontaktpersoner

KontaktpersonDtoCollection

 

0 - 1

Kontaktpersoner.

-    -    -    -    KontaktpersonDto

KontaktpersonDto

 

0 - *

 

-    -    -    -    -    fornavne

string

Length: 1-50

1

Fornavn(e).

-    -    -    -    -    efternavn

string

Length: 1-50

1

Efternavn.

-    -    -    -    -    titel

string

MaxLength: 50

0 - 1

Titel.

-    -    -    -    -    eksternReference

uuid

 

0 - 1

Ekstern system reference for den angivne kontaktperson.

-    -    -    -    -    telefonnummer

tel

MaxLength: 15

0 - 1

Telefonnummer.

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

-    -    -    -    -    emailadresse

email

MaxLength: 254

0 - 1

E-mailadresse.

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

-    -    -    emailadresse

email

 

0 - 1

E-mailadresse som man kan ansøge via.

Mindst en ansøgningsmetode skal vælges.

-    -    -    url

uri

 

0 - 1

Url på hjemmeside som man kan ansøge via.

Mindst en ansøgningsmetode skal vælges.

-    -    -    telefonnummer

string

Pattern: (\+)?[0-9]{3,20}

0 - 1

Telefonnummer som man kan ansøge via.

Mindst en ansøgningsmetode skal vælges.

-    -    logo

base64Binary

 

0 - 1

Logo i et formaterne: PNG, JPEG (base64).

Må ikke fylde mere end 100 kB.
Må ikke være større end 200 x 200 pixels.

-    -    anonymArbejdsgiver

boolean

 

1

Hvorvidt arbejdsgiveren er anonym.

Arbejdsgiveren kan ikke være anonym, hvis jobannoncen er markeret med 'EURES'-jobegenskab.

-    -    ansvarligMyndighedskode

int32

 

0 - 1

Myndighedskode for den ansvarlige myndighed.

Påkrævet, hvis man kalder ind som jobcenter, a-kasse eller WIDK.

- - orgainsationTypeID

 

 

0 - 1

Sammen med ansvarligMyndighedskode kan det identificeres, hvem der står for annoncen i tilfælde af at anonymArbejdsgiver er angivet

-    -    id

uuid

 

1

Jobannonce id.

-    -    godkendelsesstatus

GodkendelsesstatusTypeCodeList

 

1

 

-    -    visninger

int32

 

1

Antal visninger af jobannoncen.

-    -    aftagerSystem

string

MinLength: 1

1

Id på system der har oprettet jobannoncen.

-    -    oprettetTidspunkt

date-time

 

1

Tidspunkt for oprettelse.

-    -    opdateretTidspunkt

date-time

 

1

Tidspunkt for sidste opdatering.

-    -    arbejdsgiver

ArbejdsgiverDto

 

0 - 1

 

-    -    -    cvrNummer

string

Pattern: [0-9]{8}

0 - 1

CVR-nummer.

Påkrævet for danske virksomheder.
Påkrævet hvis jobannoncen er markeret med 'EURES'-jobegenskab.
Påkrævet at den pågældende virksomhed er aktiv.

Hvis p-nummeret er angivet, skal CVR-nummeret også være angivet.

-    -    -    pNummer

string

Pattern: [0-9]{10}

0 - 1

P-nummer.

Påkrævet for danske virksomheder.
Påkrævet at den pågældende p-enhed er aktiv.

-    -    -    navn

string

Length: 1-50

1

Arbejdsgiverens navn.

-    -    -    adresse

AdresseDto

 

0 - 1

 

-    -    -    -    vejnavn

string

MaxLength: 100

0 - 1

Vejnavn.

Skal angives, hvis 'husnummer' er angivet.

-    -    -    -    husnummer

string

MaxLength: 10

0 - 1

Husnummer.

Skal angives, hvis 'etage' eller 'sidedoer' er angivet.

-    -    -    -    etage

string

MaxLength: 10

0 - 1

Etagebetegnelse.

-    -    -    -    sidedoer

string

MaxLength: 10

0 - 1

Side-/dørbetegnelse.

-    -    -    -    bynavn

string

MaxLength: 100

0 - 1

Bynavn.

-    -    -    -    postnummer

string

MaxLength: 10

0 - 1

Postnummer.

-    -    -    -    kommunenummer

int32

Pattern: [0-9]{3}

0 - 1

Kommunenummer.

Kan kun angives på danske adresser og er hermed samtidig påkrævet.

Skal være et gyldigt dansk kommunenummer, hvis angivet.

-    -    -    -    landekode

string

Pattern: [A-Z]{2}
MinLength: 1

1

Landekode.

Skal være en gyldig landekode (ISO 3166-1 alfa-2).

-    -    opretter

OpretterDto

 

0 - 1

Opretter.

-    -    -    fornavne

string

Length: 1-50

1

Fornavn(e).

-    -    -    efternavn

string

Length: 1-50

1

Efternavn.

-    -    -    titel

string

MaxLength: 50

0 - 1

Titel.

-    -    -    eksternReference

uuid

 

0 - 1

Ekstern system reference for den angivne kontaktperson.

-    -    -    telefonnummer

tel

Length: 1-15

1

Telefonnummer.

-    -    -    emailadresse

email

Length: 1-254

1

E-mailadresse.

Fejlkoder

Fejlkode

Fejltekst

Beskrivelse

Fejlkode

Fejltekst

Beskrivelse

121100

Jobannoncen blev ikke fundet.

Jobannoncen blev ikke fundet.

121104

Du har ikke adgang til at tilgå jobannoncen.

Du har ikke adgang til at tilgå jobannoncen.

121140

Billetten blev ikke fundet.

Billetten blev ikke fundet.

121142

Billetten er udløbet.

Billetten er udløbet.