JobAdService (Version 4, 2021-2)

Metoder

Metoder

AddJob

Denne metode bruges til at oprette jobannonce på Jobnet. Jobannoncen sendes straks til godkendelse.

Input

Element
Type
Detaljer
Forekomst
Beskrivelse
CredentialsJobAdService (Version 3, 2021-2)#CredentialsAngives i headeren1Username/password

AddJobRequestType

AddJobRequestType
1

Requeststruktur

- JobAd

JobAdService (Version 3, 2021-2)#JobAd
1Jobannoncens indhold

Output

Element
Type
Detaljer
Forekomst
Beskrivelse
AddJobResponseTypeAddJobResponseType
1Responsestruktur

- JobAdId

int
1Unique JobAd indentifier - Annonce ID. Tildeles af servicekaldet

UpdateJob

Denne metode bruges til at opdatere eksisterende jobannonce på Jobnet. Jobannoncen sendes til godkendelse. Metoden kan anvendes ved annoncer med tilstande Not Approved og PublicationEnd (Se JobAdService(Version3,2021-2)-Status)

Input

Element
Type
Detaljer
Forekomst
Beskrivelse
CredentialsJobAdService (Version 3, 2021-2)#CredentialsAngives i headeren1Username/password

UpdateJobRequestType

UpdateJobRequestType
1

Requeststruktur

- JobAd

JobAdService (Version 3, 2021-2)#JobAd
1Jobannoncens indhold

Output

Intet outputobjekt


SaveJobAsDraft

Denne metode bruges til at oprette eller opdatere en jobannonce der endnu ikke er færdig udfyldt på Jobnet. Annoncen forbliver i aktuel tilstand, dog ændres tilstand fra 1 NotReady til 2 ReadyButNotPublished, når annoncen kan valideres. Mettoden kan anvnedes ved tilstande: 1: Notready, 2: ReadyButNotPublished, 8: NotApproved, 9: PublicationEnd.
For at annoncen kan gemmes som kladde skal der som minimum være angivet: Information om virksomheden (HiringOrganizationDetails) og reference til personen der opretter annoncen (JobAdDetails.PostedBy), Arbejdssted (JobDetails.Joblocation) samt kontaktperson på annoncen (ApplicationDetails.JobcontactList).
Hvis der angives et JobAdId opdateres annoncen med det givne ID. Hvis der ikke angives et JobAdId oprettes en ny annoncen kladde. Jobannoncen har i kladde tilstand Status NotReady (Se JobAdService(Version3,2021-2)-Status)

Input

Element
Type
Detaljer
Forekomst
Beskrivelse
CredentialsJobAdService (Version 3, 2021-2)#CredentialsAngives i headeren1Username/password

SaveJobAsDraftRequestType

SaveJobAsDraftRequestType
1

Requeststruktur

- JobAd

JobAdService (Version 3, 2021-2)#JobAd
1Jobannoncens indhold

Output

Element
Type
Detaljer
Forekomst
Beskrivelse
SaveJobAsDraftResponseTypeSaveJobAsDraftResponseType
1Responsestruktur

- JobAdId

int
1Unique JobAd indentifier - Annonce ID. TIldeles af servicen, hvis det ikke er angivet i input. Dvs. create eller update afhængig af om JobAdId er angivet i input.

Generelle elementer

JobAd

Element

Type

Detaljer

Forekomst

Beskrivelse

JobAd

JobAd


1

Jobannoncens indhold

- ApplicationDetails

ApplicationDetailsType


1

Information om ansøgning og ansøgningsproces

- - ApplicationMethods

ApplicationMethodsType


1

Måder, som ansøgning kan sendes på

- - - ApplyByEmail

ApplyByEmail


0-1

Angiver om jobbet kan ansøges pr. e-mail.

- - - - Emailstring
0-1Email adresse, som ansøgning skal sendes til 

- - - ApplyByLetter

boolean


0-1

Angiver om jobbet kan ansøges pr. snail mail. Ansøgningen sendes til virksomhedens adresse

- - - ApplyByTelephone

ApplyByTelephone


0-1

Angiver om jobbet kan ansøges pr.telefon. 

- - - - TelephoneNumberstring
0-1Telefonnummer, hvor man kan ansøge

- - - ApplyOnline

ApplyOnline


0-1

Angiver om jobbet kan ansøges pr. webformular. URL er underelement.

- - - - Urlstring
0-1URL til webside, hvor man kan ansøge

- - Description

string


0-1

Yderligere information om ansøgningsproces. (Bruges sjældent)

- - JobContactList

JobContactType list


1

Kontaktpersoner vedr. jobbet

- - - JobContactType

JobContactType


1+

Kontaktperson vedr. jobbet

- - - - Email

string


1

E-mail til kontaktperson

- - - - PersonNameStructure

PersonNameStructure


1

Kontaktpersonens navn

- - - - - PersonGivenName

string


1

Kontaktpersonens fornavn(e)

- - - - - PersonSurnameName

string


1

Kontaktpersonens efternavn

- - - - Title

string


1

Kontaktpersonens titel

- - - - HidePhoneNumbers

boolean


1

Angiver at telefonnumre til kontaktpersonen ønskes skjult

- - - - TelephoneNumberStructure

TelephoneNumberStructure


1

Telefonnumre til kontaktperson

- - - - - MobileNumber

string


0-1

Mobilnummer

- - - - - PrimaryNumber

string


0-1

Hovednummer

- - - - - SecondaryNumber

string


0-1

Sekundært nummer (bruges sjældent)

- - - - - Telefax

string


0-1

Telefaxnummer (bruges sjældent)

- - Referral

string


0-1

Virksomhedens referencenummer / -tekst for jobannoncen

- HiringOrganizationDetails

HiringOrganizationDetailsType


1

Information om arbejdsgiver, der opslår jobannoncen

- - AddressStructure

AddressStructure


1

Virksomhedsadresse

- - - CountryCode

string


1

Landekode (ISO 3166-1 alpha 2)

- - - FloorIdentifier

string


0-1

Etage

- - - MunicipalityId

int


1

Kommunenummer

- - - MunicipalityName

string


1

Kommunenavn

- - - PostalCity

string


1

Bynavn (postadresse)

- - - PostalCode

string


1

Postnummer

- - - StreetBuildingIdentifier

string


1

Husnummer

- - - StreetName

string


1

Vejnavn

- - - SuiteIdentifier

string


0-1

Angivelse af dør, lejlighed på etagen

- - BranchCode

int


0-1

Industrikode (reference?)

- - BranchDescription

string


1

Industribeskrivelse

- - Contact

HiringOrganizationContactType


1

Virksomhedens kontaktperson (Kan bruges af STAR). Vises ikke på jobannonce.

- - - Email

string


0-1

E-mail

- - - PersonNameStructure

PersonNameStructure


1

Kontaktpersonens navn

- - - - PersonGivenName

string


1

Kontaktpersonens fornavn

- - - - PersonSurnameName

string


1

Kontaktpersonens efternavn

- - - Title

string


0-1

Kontaktpersonens titel

- - - PrimaryNumber

string


0-1

Hovednummer

- - - SecondaryNumber

string


0-1

Sekundært nummer

- - - Telefax

string


0-1

Telefaxnummer

- - CvrNumber

string


0-1

8-cifret CVR-nummer

- - Name

string


1

Virksomhedens navn

- - PNumber

string


0-1

10-cifret p-nummer

- - Url

string


0-1

Virksomhedens hjemmeside

- Id

int


0-1

Unique JobAd indentifier - Annonce ID. Tildeles af JobAD

- JobAdDetails

JobAdDetailsType


1

Inforrmationer om jobannoncen

- - JobPublishDates

JobPublishDatesType


1

Datoer vedr. annoncens levetid

- - - LastModifiedDate

DateTime


0-1

Dato og tid for annoncens seneste ændring

- - - PublishEndDate

DateTime


1

Dato og tid for afpublicering af annoncen på Jobnet

- - - PublishStartDate

DateTime


1

Dato og tid for publicering af annoncen på Jobnet

- - Logo

string (Base64)
0-1Logo i et af følgende formater: JPG, PNG. Størrelse max. 200x135px / 100KB. Hvis logo er vedhæftet jobannoncen, præsenteres dette logo. Hvis logo ikke er defineret her, anvendes i prioriteret rækkefølge a) logo fra PNR (fra JobAG), b) logo fra CVR-nummer (fra JobAG), c) udelades.

- - NumberOfReadsByCitizen

int


1

Information om antal visninger på Jobnet. Readonly.

- - PostedBy

PostedByContactType


1

Person, som har indsendt jobannonncen. Vises ikke på Jobannoncen. Bruges af JobAD.

- - - Email

string


1

E-mail

- - - PersonNameStructure

PersonNameStructure


1

Personens navn

- - - - PersonGivenName

string


1

Personens fornavn

- - - - PersonSurnameName

string


1

Personens efternavn

- - - Title

string


0-1

Personens titel

- - - ContactGuid

string


0-1

Identificerer personen i STARs systemer.

- - - PrimaryNumber

string


0-1

Hovednummer

- - - Telefax

string


0-1

Telefaxnummer

- - - UserRid

string


0-1

Identificerer en sagsbehandler i et jobcenter.

- - Status

JobAdService(Version3,2021-2)-Status


1

Annoncens status. Readonly værdi, som administreres af JobAD. Denne værdi ignoreres ved add og update operationer.

- - Type

JobAdService(Version3,2021-2)-Type


1

Jobannoncetype. Ansættelsesbetingelser o.l.

- JobDetails

JobDetailsType


1

Informationer om jobbet

- - AuthorityId

int


1

Jobcenterkode

- - AuthorityPhoneNumber

string


0-1

Telefonnummer til Jobcenter

- - Classification

Classification


1

Struktur med egenskaber for jobbet eller jobannoncen

- - - EmploymentType

JobAdService (Version 3, 2021-2)#EmploymentType


1

Permanent eller tidsbegrænset job.

Defaultværdi ved manglende element

- - - IsEuresJob

boolean


1

Angiver om jobannoncen skal slå op på EURES. Annoncen slås op på EURES som engelsksproget, hvis WorkInDenmark er valgt og eller som dansksproget

- - - IsPublicSectorJob

boolean


1

Angiver om jobannoncen vedrører et offentligt job

- - - IsWorkInDenmarkJob

boolean


1

Angiver om jobannoncen skal slå op som WorkInDenmark job og dermed have engelsk Title og Description. 

- - Description

string

maks. længde: 16000

1

Feltet indeholder HTML tekst (encodes med CDATA), hvor følgende tags er tilladt:

  • <b>, <i>, <u>, <br>, <li>, <p>, <small>, <big>, <em>, <strong>, <sub>, <sup>, <ul>, <ol>, <a>

Hvis feltet indeholder andre tags, vil jobannoncen blive afvist.

- - DriversLicences

JobAdService (Version 3, 2021-2)#DriversLicence list


1

Liste med krav til kørekort og tilsvarende certifikater

- - HidePhonenumbers

boolean


1

Angiver om telefonnumre skal skjules ved visning af jobannoncen

- - IsAnonymousEmployer

boolean


1

Angiver om arbejdsgiveren skal skjules ved visning af jobannoncen 

- - IsDisabilityFriendly

boolean


1

Angiver om jobbet er velegnet til handicappede

- - JobDates

JobDatesType


1

Datoer vedrørende jobbbet

- - - ApplicationDeadlineDate

DateTime


1

Ansøgningsfrist

- - - EmploymentDate

DateTime


0-1

Ansættelsesdato

- - - StartAsSoonAsPossible

boolean


1

Angiver om jobbet ønskes besat hurtigst muligt

- - JobLocation

JobLocationType


1

Arbejdsstedet adresse (kan være anderledes end virksomhedens adresser)

- - - Address

AddressStructure


1

Informationer om arbejdsstedet adresse

- - - - CountryCode

string


1

Landekode (ISO 3166-1 alpha 2)

- - - - FloorIdentifier

string


0-1

Etage

- - - - MunicipalityId

int


1

Kommunenummer

- - - - MunicipalityName

string


1

Kommunenavn

- - - - PostalCity

string


1

Bynavn (postadresse)

- - - - PostalCode

string


1

Postnummer

- - - - StreetBuildingIdentifier

string


1

Husnummer

- - - - StreetName

string


1

Vejnavn

- - - - SuiteIdentifier

string


0-1

Angivelse af dør, lejlighed på etagen

- - - NoLocalBusinessAddress

boolean


1

Angiver, at der ikke er fast arbejdssted

- - NumberOfPositions

int

Værdi: 0-99

1

Antal ledige stillinger

- - OccupationConceptUri

string


1

Stillingsbetegnelse - ESCO-STAR code

- - Schedule

Schedule


1

Informationer om arbejdstid

- - - DailyWorkTime

DailyWorkTimeType


1

Arbejdstider 

- - - - Day

boolean


0-1

Dagtimer

- - - - Evening

boolean


0-1

Aften

- - - - Night

boolean


0-1

Nat

- - - - Weekend

boolean


0-1

Weekend

- - - WeeklyWorkTimeTypes

JobAdService (Version 3, 2021-2)#WeeklyWorkTimeTypes


1

Fuldtid eller deltid

- - - WorkHour

WorkHourType


1

Antal timer pr. uge

- - - - Max

int

Værdi: 0-99

0-1

Kun tilladt hvis WeeklyWorkTime = PartTime

Skal være større end eller lig Min. Dog aldrig under 1.

- - - - Min

int

Værdi: 0-99

0-1

Kun tilladt hvis WeeklyWorkTime = PartTime

Skal være mindre end eller lig Max

- - Title

string

maks. længde 255

1

Overskrift på jobannoncen. Bør være på engelsk, hvis IsWorkInDenmarkJob er sat