Jobat jobpost Service

This page contains all the information about the Jobat JobPost Webservice.
For more information or questions, please contact support@jobat.be or 02/467.48.35.

Jobpost functionality

JobPost is a webservice that allows to add, update or remove jobs from the Jobat website and partner network.
Location of the webservice: https://mnt.jobat.be/ws/JobPost.asmx

When the service is called and the consumer is authenticated and authorized, internally a job object is created which will contain all the necessary data to create, update, remove or test the job.
When the job object is created, the job will be processed. The process slightly differs from the action defined.

Connection over https
Connection uses TLS 1.3 or higher

Creditstatus API

As of 03/12/2015 we are offering an API to check the credit status of a customer. (Read more)

Datadictionary

Parameter Type Description Required Possible Values Max
LoginId string The login of the customer, provided by Jobat Yes    
Password string The password of the consumer, provided by Jobat Yes    
Action string The action the service should perform. (Read more) Yes new, update, delete, test  
YourJobId string ID of the job in your application No    
YourClientId string ID of the client provided by Jobat Yes    
Invoice string Specifies who needs to be invoiced, client or jobprovider. Yes client  
Anonymous bool Allows the recruiting company to publish anonymously. Yes true, false  
FunctionIds int[] The id of the functiontype for the job. Only one function type can be selected. (Read more) Yes 1 functionID 14
RegionIds or RegionZip int[] Region in which the job is being offered or Zip code. (Read more) Yes Zipcode or RegionId(s) 14 or 4
SectorId int Sector in which the job is being offered. (Read more) Yes 1 sectorID 4
Date string The date the job should go online in dd/mm/yyyy format (Read more) Yes   16
DateOffline string The date the job should go offline in dd/mm/yyyy format No   16
Address string The street name of the location of the job. Example: "Stationstraat". No    
AddressNumber string The house number of the location of the job. Example: "14A". No    
City string The city of the location of the job. Example: "Antwerpen". No    
PartTime int Indicates whether the job is a part time job Yes 0 = fulltime, 1 = parttime, 2 = both 1
CompanyNL
CompanyFR
CompanyEN		 string The companyname in Dutch, French and/or English No   255
AgencyNL
AgencyFR 
AgencyEN 		string The agencyname in Dutch, French and/or English No   255
CompanyDescriptionNL
CompanyDescriptionFR
CompanyDescriptionEN		 string The company description in Dutch, French and/or English No   2000
JobTitleNL
JobTitleFR
JobTitleEN		 string The job title in Dutch, French and/or English Yes   200
BaselineNL
BaselineFR
BaselineEN		 string Small description (just underneath the title) in Dutch, French and/or English - No HTML tags! No   255
FunctionDescriptionNL
FunctionDescriptionFR
FunctionDescriptionEN		 string The function description in Dutch, French and/or English No   20.000
ProfileNL
ProfileFR
ProfileEN		 string Profile description in Dutch, French and/or English No   20.000
OfferNL
OfferFR
OfferEN		 string The offer in Dutch, French and/or English No   20.000
ContactNL
ContactFR
ContactEN		 string The contact information in Dutch, French and/or English Yes   2000
SolicitationUrlNL
SolicitationUrlFR
SolicitationUrlEN 		string The URL of the apply form of the customer in Dutch, French and/or English.
Remark: When posting a new job "Email" has priority and can not be overwritten. Changes can be requested via support@jobat.be		 No    
Fax string The fax number of the company No   20
Email string The email address to which the application has to be sent.
Remark: When posting a new job "Email" has priority and can not be overwritten. Changes can be requested via support@jobat.be		 No   100
Official bool OBSOLETE Yes Not in use but needs to be provided in the xml! 1
CompanyCar bool Whether a company car is in the package included No true, false  
Manager bool Whether it’s a manager profile No true, false  
Interim bool Whether it’s an interim job No true, false  
InterimOptionalFixedContract bool Whether it’s an interim job with option of a fixed contract No true, false  
FixedContract bool Whether it’s a fixed contract of unlimited duration No true, false  
TemporaryContract bool Whether it’s a fixed contract of limited duration No true, false  
International bool Whether it’s an international profile No true, false  
Starter bool Whether it’s a starter profile No true, false  
Student bool Whether it’s a student’s profile No true, false  
Independent bool Whether it’s an independent profile No true, false  
FlexiJob bool Whether it’s a flexijob No true, false  
Internship bool Whether it’s an internship No true, false  
VolunteerJob bool Whether it’s a volunteer job No true, false  
EducationLevelID int The Id as defined in the education level table. (Read more) Yes   4
UseHtmlTemplateNL
UseHtmlTemplateFR
UseHtmlTemplateEN		 bool Whether an HTML template is used to show the job on the website in Dutch, French and/or English (Read more) Yes true, false  

TemplateNameNL
TemplateNameFR
TemplateNameEN

 string The name of the template in Dutch, French and/or English. This field is only read when UseHtmlTemplate is true. No    
KeywordsNL
KeywordsFR
KeywordsEN		 string The keywords for a Dutch, French and/or English search No   2000
Languageknowledge string Languages that the applicant has to know. (Read more) No NL, EN, FR,...  
UseLogoNL
UseLogoFR
UseLogoEN		 bool Whether the job uses a logo for a job in Dutch, French and/or English

Remark: If both JoblogoURLXX and LogoName are defined, then JobLogoUrlXX has priority!
You can't use the old tag "UseLogo" no more. If you do then the old tag "UseLogo" has priority!		 Yes true, false  
LogoNameNL
LogoNameFR
LogoNameEN		 string The name of the Dutch, French and/or English logo.
This field is only read when UseLogo is true. (Read more)		 No Specifies the name of the logo that must be displayed in the NL version of the job.
JobLogoURLNL
JobLogoURLFR
JobLogoURLEN 		string The URL of the Dutch, French and/or English logo No Specifies the url of the logo that must be displayed in the NL version of the job.
JobSites string Used to publish the job on additional Jobsites within the Jobat network. (Read more) No ID(s 6
YearsExperience int Used to show the years of experience requied for the job.
Will be shown as either, less than 1 year: no experience required, between 1 and 2 years experience, between 2 and 5 years experience or more than 5 years experience		 No A number between 0 and 50  
VideoNameNL
VideoNameFR
VideoNameEN		 String Title of the video that has to be shown on the Dutch, French and/or English job page.
(Videos must first be added and activated by Jobat. The available VideoNames for your customer can be requested via support@jobat.be.)		 No    
VideoUrlNL
VideoUrlFR
VideoUrlEN		 String Link of the video that has to be shown on the Dutch, French and/or English job page.(Be aware that videos first need to be activated by Jobat, this can be requested via support@jobat.be.)

Remark: leave "VideoNameXX" empty when using "VideoUrlXX", otherwise the Video URL will not be taken into account		 No    
IsInternal string Clarify if it's an internal job or external (mainly for interim, agencies) No true, false  
SalaryType string Use "HOUR", "MONTH" or "YEAR" for your own custom salary input, use "CALCULATE" for the Attentia estimate. (Read more) No HOUR, MONTH, YEAR, CALCULATE  
SalaryCalculateType string This field is required when the field "SalaryType" is set to "CALCULATE". It specifies how the salary is shown. The possible values are "RANGE", "FIXED", "UPTO", "FROM". The default value is "RANGE" No RANGE, FIXED, UPTO, FROM  
SalaryFrom int Fill out this field if you want the salary to show as a "RANGE" or "FROM" No    
SalaryTo int Fill out this field if you want the salary to show as a "RANGE" or "UPTO" No    
SalaryFixed int Fill out this field if you want the salary to show as a "FIXED" salary. Make sure that the fields "SalaryFrom" and "SalaryTo" are empty. (Read more) No    
SalaryBenefits int[] This field should contain the benefits, which should be comma separated. (Read more) No    
WhatsappNL
WhatsappFR
WhatsappEN		 string Mobile phone number linked to a Whatsapp account to activate the "Apply via Whatsapp" functionality on the mobile website. (Read more) No    
ProductType string To set the publication type of the job under which the transmitted job should be published (Read more) No siteonly, basic, basicplus, light, full, power, ppp  
TeleworkDays int Possibility to work from home in days (Read more) No 0, 1, 2, 3, 4, 5 5
DriversLicences string Possibility to add drivers licence (Read more) No null, A, B, BE, C, CE, C1, C1E, D, DE, D1, D1E or G 5

Action: New, Update, Delete, Test

When the action "new" or "update" has been defined, the job is checked if it’s not yet defined. In case the action was "new" but an existing job matches the parameters, the action will be changed to update. The same happens for "update".

If the processing of the job was successful, the job will be saved or updated in the database and the consumer will get a response stating the update or insert was successful. If there was a validation error or some other kind of exception, the user will also be notified.

When the action "delete" has been defined, the job will not be removed from the database, but its status is going from online to offline. If the job does not exist, the user will get a response from the webservice stating the job doesn’t exist. On the other case the consumer will get a response that removing the job was successful.

Define the action "test" in order to test the import application.
By using this value, your job will be added to the database, but won’t be published.

Possible Success Messages

update:
OK JOB WITH ID X MODIFICATION DONE

new:
OK JOB WITH ID X INSERTED IN DATABASE
IT HAS BEEN PUBLISHED ON THE SITE

planned update:
OK JOB WITH ID X INSERTED IN DATABASE
IT IS SCHEDULED TO BE PUT ONLINE ON : dd/MM/yyyy
IT HAS BEEN PUBLISHED ON THE SITE

delete:
OK JOB WITH ID X DELETED FROM DATABASE

test:
OK JOB WITH ID X INSERTED IN DATABASE
IT HAS BEEN PUT ON SITE IN PREVIEW MODE

ATTENTION: action new and action update are treated the same way, so when you send a suspended job with action update, it will be put onine and an extra job credit will be taken into account!

Possible Error Messages

  • ERROR IN PROCESSING MSG: {SPECIFIC ERROR
  • Unkown partner with login X and password Y
  • WRONG INPUT
    following input was wrong:{Numeration of fields with a false input}

Date & DateOffline

For each job posting 1 job credit will be charged. The default publication period for jobs depends on the ProductType of the job. The default publication period for the different ProductTypes is:

ProductType Site only Basic Basic plus PPP Light network Full network Power network
Default Publication 28 days 28 days 40 days 40 days 60 days 60 days 60 days

By specifying a DateOffline, the default publication period can be adjusted.

DateOffline

  • If DateOffline is not specified, the job offer will be published with the default publication period of the ProductType of the job and 1 job credit will be charged.
  • When the transmitted DateOffline is less than the end of the default publication period, the job will be removed on the forwarded DateOffline. 1 job credit will be charged.
  • If the transmitted DateOffline exceeds the default publication period, 1 job credit will be charged for each additional default publication period of the used ProductType.

Note: When an update for a job posting contains a modified DateOffline that exceeds the original publication period, 1 extra job credit will be charged for each additional default publication period.

Putting the job offline and back online within the default publication period is possible without paying extra credits.

LanguageKnowledge

The “Languageknowledge” specifies the requested language skills needed by the applicant for this job.  Multiple languages can be specified (example: NL,FR,EN,DE).

Example: 

<Languageknowledge><string>NL</string><string>FR</string><Languageknowledge>

NL Dutch
FR French
EN English
DE German
ES Spanish
IT Italian
PT Portugese

For other languages, use the corresponding ISO 639-1 language code. See https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes

FunctionID

Only one FunctionID can be selected per job offer

SectorID

Only one “SectorID” can be specified for each job.

RegionZip OR RegionIds

You can determine the place of employment by sending a value for "RegionZip" OR "RegionIds".

  • Use RegionZip for jobs with a fixed place of employment in Belgium.
  • Use RegionIds for jobs that don’t have a fixed “Place of employment” (so called “Travelling jobs”).
  • Use RegionId "200" for jobs abroad

Fixed place of employment

Use the RegionZip element for jobs with a fixed place of employment.

  • RegionZip can contain one single zip code OR RegionIds can contain one single ID marked in green from this list.

Examples:

  • <RegionZip>2800</RegionZip>
  • <RegionIds><int>301</int></RegionIds>

No fixed place of employment / travelling jobs

Use the RegionIds element for jobs that don’t have a fixed place of employment. The RegionIds element can contain one or more values for subregions and/or provinces.

Examples:

  • <RegionIds><int>113</int></RegionIds>
  • <RegionIds><int>310</int><int>311</int><int>312</int></RegionIds>
  • <RegionIds><int>301</int><int>302</int><int>114</int></RegionIds>

EducationLevelID

The "EducationLevelID" specifies the requested education level needed for this job. Only one "EducationLevelID" can be specified for each job.

Layout For Jobs: UseHtmlTemplateXX and TemplateNameXX

  • Jobat clients can create multiple layouts for their job offers in the Jobat Back Office.
  • UseHtmlTemplateXX and TemplateNameXX allow to apply these layouts to the transfered job offer.
  • The selected layout can be different for each language version of the job.
  • The available template names for your clients can be retrieved by contacting support@jobat.be
  • Remark: the previously used tags "UseHtmlTemplate" and "TemplateName" are no longer in use.

Jobat offers 2 possibilities to define which logo should be shown:

LogoNameXX

Use Logoname if the logo was previously uploaded in the Jobat Back Office.

  • If you don't provide a logo name
    • Then the default logo of the company will be shown.
  • If you provide a logo name
    • Then the logo with that name for your company is retrieved.
    • Mind that if it does not exist no logo will be shown.
    • Contact support@jobat.be if a new logo needs to be installed.

JobLogoURLXX

You can also provide us a url on which the logo is available, by adding the url as an attribute in this tag.

Jobsites

How to publish on other job boards within the Jobat.be network

Use <JobSites> to indicate on which additional job boards you want to publish.

  • Example 1: <JobSites><string>1</string><string>2</string><string>37</string></JobSites>
  • Example 2: <JobSites><string>C1</string><string>C5240</string></JobSites>

The logic

  • You can find the list of all available jobsites here.
  • If the field JobSites is left empty, the job will be published only on Jobat.be
  • To publish on additional job boards (see "Job Sites"): enter the value(s) of the desired job board(s). A publication on a job board will always be published automatically on Jobat.be as well.
  • To publish on the job board of a Federation of Educational institution (see "Job Widgets): enter the value(s) of the desired website(s). A publication on these websites is NOT automatically accompanied by a publication on Jobat.be. To publish on Jobat as well, you should also pass the value C1.
  • Language restrictions: some websites have specific requirements about the language of job offers. These restrictions are indicated in the list of available websites.

Creditstatus API

As of 03/12/2015 we are offering an API to check the credit status of a customer.
A call can be made to mnt.jobat.be/ws/jobpost.asmx with the function "GetCreditStatus". This call requires 3 parameters:

  • LoginId
  • Password
  • YourClientId

The possible positive responses are:

  • A number up to 2 decimals. E.g. 10,24
  • "Unlimited"

The error responses start with "ERROR" following the actual error for example:

  • ERROR : YourClientID is invalid
  • ERROR : LoginId & Password are invalid
  • ERROR : Password is missing,
  • ERROR : ...

Whatsapp

The Whatsapp field allows you to fill out a phone number linked to a Whatsapp account. If this field is filled out, then the "Apply via Whatsapp" feature is activated, and the "Apply via Whatsapp" button will be shown on the job detail page. When the user clicks this button, a Whatsapp chat will be opened automatically. The "Apply via Whatsapp" button is only shown on the mobile website.

Please note that you can supply a different Whatsapp number per language. For Dutch use the field "WhatsappNL", for French use "WhatsappFR", and for English use "WhatsappEN".

Formatting

  • The mobile phone number should be formatted as such: 32494123456 for the number +32 494 12 34 56.

Salary

It's possible to add salary information to a job using the following fields.

SalaryType

The field allows you to customize how the salary is displayed, or whether it needs to be calculated.

Allowed values

  • "HOUR": Will show a salary as per hour, such as "€ 10 per hour"
  • "MONTH": Will show a salary as per month, such as "€ 2.000 per month"
  • "YEAR": Will show a salary as per year, such as "€ 50.000 per year"
  • "CALCULATE": Requires the system to calculate the salary based on several factors. This option requires the field SalaryCalculateType to be filled out.

SalaryCalculateType

This field is required when the field SalaryType is set to "CALCULATE". It allows you to choose how the calculated value is displayed. "RANGE" is the default value.

Allowed values

  • "RANGE": Will show a salary in a range, such as: "€ 2000 - € 3000"
  • "FIXED": Will show a salary as a fixed price, such as: "€ 2500"
  • "UPTO": Will show a salary as “up to”, such as: "Up to € 3000"
  • "FROM": Will show a salary as “from”, such as: "From € 2000"

SalaryFrom

Use the SalaryFrom field to show a salary as a "RANGE" or "FROM".

SalaryTo

Use the SalaryTo field to show a salary as a "RANGE" or "UPTO".

SalaryFixed

Use the SalaryFixed field to show a salary as a "FIXED" salary. Make sure that the SalaryFrom and SalaryTo fields are empty if this option is selected.

Examples:

SalaryType SalaryCalculateType SalaryFrom SalaryTo SalaryFixed Result
HOUR   10 11   € 10 - € 11 per hour
MONTH       2500 € 2500 per month
MONTH   3000     From € 3000 per month
YEAR   50000     From € 50000 per year
CALCULATE RANGE       € XXXX - YYYY per month
CALCULATE FROM       From € XX per hour
CALCULATE UPTO       Up to € XXXX per month

SalaryBenefits

It's possible to include benefits to a job by adding these in the "SalaryBenefits" field. Icons will automatically show up for the most common benefits.

All the id's that should be included in the job posting need to be added to this field. These id's should be comma separated. For example: 101,102,103

Examples:

SalaryBenefits Result
101 Group insurance
101,102 Group insurance
Individual hospital insurance
201,202,203,204,301 Company car
Petrol card
Company bicycle
Parking
Meal vouchers

All possible benefits

ID Dutch French English
101 Groepsverzekering Assurance groupe Group insurance
102 Individuele hospitalisatieverzekering Assurance hospitalisation individuelle Individual hospital insurance
103 Hospitalisatieverzekering voor familie Assurance hospitalisation pour la famille Family hospital insurance
104 Invaliditeitsverzekering Assurance-invalidité Disability insurance
201 Bedrijfswagen Voiture d'entreprise Company car
202 Tankkaart Carte carburant Petrol card
203 Bedrijfsfiets Vélo de société Company bicycle
204 Parking Parking Parking
205 Tussenkomst openbaar vervoer Intervention dans les frais de deplacement Public transport contribution
301 Maaltijdcheques Chèques-repas Meal vouchers
302 Maaltijdvergoeding Compensation de repas Compensation for meals
303 Geboorte Naissance Birth
304 Huwelijk Mariage Wedding
305 Jubileum Anniversaire Anniversary
306 Sinterklaas Saint Nicolas Saint Nicolas
401 Smartphone Smartphone Smartphone
402 Laptop Ordinateur portable Laptop
403 Internetvergoeding/Abonnement Abonnement internet Internet cost/Subscription
501 Forfaitaire Kosten Coûts forfaitaires Flat-rate allowance
502 Cultuur- en sportcheque Chèques culture et sports Culture and sports cheques
503 Ecocheques Éco-chèques Eco-vouchers
504 Opleiding Formations Training
505 Opvang kinderen Garderie pour enfants Children daycare
506 Medische check up Bilan de santé Medical check up
507 Fitnessabonnement Abonnement fitness Fitness subscription
508 Cafetaria plan Restaurant de l’entreprise à prix réduits Company meals at reduced prices
509 Aanvullend kinderbijslag Allocation familiale complémentaire Additional family benefits
601 Extra-legale vakantiedagen Congés rémunérés supplémentaires Additional paid leave
602 Thuiswerk Travail à domicile Remote work
603 Anciënniteitsverlof Congé d’ancienneté Furlough leave

ProductType

This field can be used to set the publication type under which the transmitted job should be published. Jobat has 6 different publication types.
This field is not mandatory. If this field is left blank, Jobat will publish the forwarded job according to a standard publication type that is assigned to the client.

Attention: each publication type is linked to a specific publication period. You can find more information about the correct forwarding of the publication period here.

The different publication types are:

Publication Type Publication type value Publication type value
Site only job siteonly 28 days
Basic job basic 28 days
Basic plus job basicplus 40 days
PPP ppp 40 days
Light network job light 60 days
Full network job full 60 days
Power network job power 60 days

TeleworkDays

This field can be used to to show to the candidate how many days per week they can work from home. The value can either be: empty, 0, 1, 2, 3, 4 or 5.

DriversLicences

This field can be used to to show to the candidate which drivers licence is applicable.
The value can either be: null, A, B, BE, C, CE, C1, C1E, D, DE, D1, D1E or G.

  • <DriversLicences>
        <string>A</string>
        <string>CE</string>
    </DriversLicences>