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 |
---|---|---|---|---|
Credentials | JobAdService (Version 3, 2021-2)#Credentials | Angives i headeren | 1 | Username/password |
AddJobRequestType | AddJobRequestType | 1 | Requeststruktur | |
- JobAd | JobAdService (Version 3, 2021-2)#JobAd | 1 | Jobannoncens indhold |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
AddJobResponseType | AddJobResponseType | 1 | Responsestruktur | |
- JobAdId | int | 1 | Unique 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 |
---|---|---|---|---|
Credentials | JobAdService (Version 3, 2021-2)#Credentials | Angives i headeren | 1 | Username/password |
UpdateJobRequestType | UpdateJobRequestType | 1 | Requeststruktur | |
- JobAd | JobAdService (Version 3, 2021-2)#JobAd | 1 | Jobannoncens 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 |
---|---|---|---|---|
Credentials | JobAdService (Version 3, 2021-2)#Credentials | Angives i headeren | 1 | Username/password |
SaveJobAsDraftRequestType | SaveJobAsDraftRequestType | 1 | Requeststruktur | |
- JobAd | JobAdService (Version 3, 2021-2)#JobAd | 1 | Jobannoncens indhold |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
SaveJobAsDraftResponseType | SaveJobAsDraftResponseType | 1 | Responsestruktur | |
- JobAdId | int | 1 | Unique 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. | |
string | 0-1 | Email 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. | |
- - - - TelephoneNumber | string | 0-1 | Telefonnummer, hvor man kan ansøge | |
- - - ApplyOnline | ApplyOnline | 0-1 | Angiver om jobbet kan ansøges pr. webformular. URL er underelement. | |
- - - - Url | string | 0-1 | URL 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 | |
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. | |
string | 0-1 | |||
- - - 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-1 | Logo 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. | |
string | 1 | |||
- - - 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 | 1 | Annoncens status. Readonly værdi, som administreres af JobAD. Denne værdi ignoreres ved add og update operationer. | ||
- - 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 | 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:
Hvis feltet indeholder andre tags, vil jobannoncen blive afvist. |
- - DriversLicences | 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 | 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 |