Jobat XML SETUP

This document contains all the information required to set-up an XML job feed via FTP. For more information, please contact our support team: support@jobat.be or 02/467.48.35.

General information

Type of feed format XML
Type of transfer FTP
Information to be supplied by Jobat FTP
Username
Password

XML Authentication
Username
Password
YourClientID
Date The date the job should go online in dd/mm/yyyy format
Preferred file name JobProviderName_ddmmyyhhmm.xml
Processing of new xml files Every hour
Does Jobat require a zip file? No
XML content 1 single job. Each additional language version is to be uploaded via a separate xml, as an update of the original job posting. (Read more)
How should modify/delete requests be handled? To modify or update a job, use the action attributes "update" or "delete" (<Job action="update">). Use <YourJobID> to refer to the job posting you want to update or delete. (Read more)
Does Jobat accept HTML in the job description? Yes, if the text is embedded in CDATA tags.
<JobTitle><![CDATA[Your <b>job title</b>]]</JobTitle>
Default publication period for jobs Depends on the ProductType of the job

Changelog:

Date Change
01/08/2023 Added new fields: <FlexiJob />, <VolunteerJob/>, <Internship/> and <NacebelCode/>
01/06/2023 Added new field: <DriversLicence /> (Read more)
There is no longer a possibility to extend your job for 20 days using the Extend field.
21/01/2022 Maximum length of JobTitle changed from 255 to 200 characters
04/09/2020 Added new field: <Homework />
11/12/2019 Added new ProductType: Basic plus
11/12/2019 Modified publication period for jobs
5/11/2019 Added new field: <ProductType /> (Read more)
1/10/2019 Added new fields: <Address />, <AddressNumber /> and <City />
8/02/2019 Added new field: <Whatsapp /> (Read more)
16/01/2019 The Jobsites ProductIDs 40 (Alterjob) and 63 (Hénallux) and Jobwidgets ID C11420 (Hénallux) have been removed.
New Jobsites IDs were added: 105 (Additional Jobat Express), 106 (Keyword Optimization), 107 (Digityser), 108 (Young Talent Target Pack), 109 (Facebook Start), 110 (Google Adwords Start).
26/10/2018 Updated list of available regions. Download changes here
16/10/2018 Added salary information.
14/09/2016 Added new field: <VideoName />
05/04/2016 Jobsite Guido.be (id 52) from the list of available jobsites is no longer available
03/12/2015 Added new field: <YearsExperience /> (Read more)
03/12/2015 Deleted 2 fields (no longer required and no longer in use): <ShortDescription /> and <ShortJobTitle />
04/09/2015 Maximum length of the following fields were raised to 20.000 for <FunctionDescription />, <Profile /> and <Offer /> (Read more)
15/01/2015 Added the tag <Jobsites /> (Read more)
01/07/2014 Added new functiontypes and regions (Read more)

Documentation

Download an example of an xml file
Download an xml schema

List of fields

FIELDNAME DESCRIPTION REQUIRED MAX
UserID Authentication – Userid is provided by Jobat Yes  
Password Authentication – Password is provided by Jobat Yes  
ClientEmail Return email address for success or failed import notification (Read more) Yes  
YourOrderID Optional ID assigned to this XML feed No  
YourJobID ID of the job in your application Yes  
YourClientID ID of the client provided by Jobat Yes  
Invoice Specifies who needs to be invoiced - Use client or jobprovider (Read more) Yes  
Anonymous Allows the recruiting company to publish anonymously (Read more) Yes  
LanguageID Language of the advertisement (Read more) Yes 4
FunctiontypeID Functiontype of the jobposting (Read more) Yes 14
SectorID Sector in which the job is being offered (Read more) Yes 4
Date The date the job should go online in DD/MM/YYYY format (Read more) Yes 16
DateOffline The date the job should go offline in DD/MM/YYYY format No 16
RegionID or RegioZip Region code or Zip code where the job is being offered (Read more) Yes 14 or 4
Address The street name of the location of the job. Example: "Stationstraat". No  
AddressNumber The house number of the location of the job. Example: "14". No  
City The city of the location of the job. Example: "Antwerpen". No  
Parttime Part-time or Full-time (Read more) Yes 1
Company Company name - Language dependant No 255
Agency Name of the agency - Language dependant No 255
CompanyDescription Company description - Language dependant - Use CDATA tags No 2000
JobTitle Title of the joboffering - Language dependant Yes 200
Baseline Small description (just underneath the title) - Language dependant - No HTML tags! No 255
FunctionDescription Function description - Language dependant - Use CDATA tags No 20.000
Profile Profile description - Language dependant - Use CDATA tags No 20.000
Offer Offer - Language dependant - Use CDATA tags No 20.000
Contact Contact information - Language dependant - Use CDATA tags Yes 2000
SolicitationUrl The URL to the apply form of the customer
REMARK: when Email and SolicitationUrl all both filled in, the Email value will be prior to the SolicitationUrl. To avoid any issues, only send one of both values.		 No  
Fax The fax number of the company No 20
Email The email address to which the application has to be sent No 100
Official State officer No 1
Company Car Whether a company car is in the package included No 1
Manager Whether it’s a manager profile No 1
Interim Whether it’s an interim job No 1
InterimOptFixed Whether it’s an interim job with option of a fixed contract No 1
FixedContract Fixed contract of unlimited duration No 1
TemporaryContract Fixed contract of limited duration No 1
International Whether it’s an international profile No 1
Starter Whether it’s a starter profile No 1
Student Whether it’s a student’s profile No 1
Independent Whether it’s an independent profile No 1
FlexiJob Whether it’s a flexijob No 1
Internship Whether it’s an internship No 1
VolunteerJob Whether it’s a volunteer job No 1
LanguageReq Required language skills for the job (Read more) No 50
EducationLevelID Required education level (Read more) Yes 4
HTMLTemplate Show job in client’s own layout (Read more) Yes 1
TemplateName Name of the template to use. Available template names can be obtained from the Jobat Webmaster.
Contact support@jobat.be		 No  
Keywords Keywords for the job - Language dependant No 2000
LanguageKnowledge Languages that the applicant has to know (Read more) No  
Logo Show a logo or not - 0 or 1 (Read more)
Remark: if both Joblogo and LogoName are defined, then JobLogo has priority!		 Yes 1
LogoName Name of the logo. Available LogoNames can be obtained from the Jobat Webmaster.
Contact support@jobat.be		 No  
JobLogo You can also provide us a url on which location the logo is available. No  
JobSites You can provide a jobsite or jobwidget ID to post on the relevant jobsite or widget (Read more) No  6
YearsExperience Experience level required in years - Value between 0 and 50 is required if filled in - Integer No 2
VideoName Title of the video that has to be shown on the 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  
VideoUrl URL of the video that has to be shown on the job page. No  
IsInternal Clarify if it's an internal job or external (mainly for interim, agencies) No  
SalaryType Use "HOUR", "MONTH" or "YEAR" for your own custom salary input, use "CALCULATE" for the Attentia estimate (Read more) No  
SalaryCalculateType 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" (Read more)		 No  
SalaryFrom Fill out this field if you want the salary to show as a "RANGE" or "FROM" (Read more) No  
SalaryTo Fill out this field if you want the salary to show as a "RANGE" or "UPTO" (Read more) No  
SalaryFixed 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 This field should contain the benefits - Comma separated (Read more) No  
Whatsapp Activates the "Apply via Whatsapp" functionality on the mobile website (Read more) No  
ProductType To set the publication type under which the transmitted job should be published (Read more) No
TeleworkDays Possibility to work from home (Read more) No 5
DriversLicences Possibility to add drivers licence - Comma separated (Read more) No  
NacebelCode Possibility to add Nacebel Code No  

Job Action attribute

The “action” attribute specifies whether the job needs to be published, updated or removed.
Use the value “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.

new Add a new job
update Update an existing job
delete Delete an existing job
test Add a new job without publishing it on the live site

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 online and an extra job credit will be taken into account!

Invoice

Invoice specifies whether the client’s or the jobprovider’s credits need to be checked, changed and/or invoiced.

Client The client needs to be invoiced
Jobprovider The jobprovider needs to be invoiced

Anonymous

This field needs to be activated if the recruiting company whishes to remain anonymous.

1 The company is anonymous - Company name will not be shown
0 The company is NOT anonymous - Company name will be visible. When Company name is empty, Agency name wille be used.

LanguageID

We allow you to publish your job in maximum 3 languages. The LanguageID's are:

1 Dutch
2 French
3 English

Each additional language version is to be uploaded via a separate xml, as an update of the original job posting:

  • set <Action> as "update"
  • set <YourJobID> as in the original posting
  • set <languageID> to the correct languageID

LanguageRequirements

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

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

For other languages, use the corresponding ISO 639-1 language code. See the list with all language codes.

FunctionTypeID

SectorID

Date

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 extra 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.

RegioZip OR RegionID

You can determine the place of employment by sending a value for "RegioZip" OR "RegionID".

  • Use RegioZip or RegionID for jobs with a fixed place of employment in Belgium.
  • Use RegionID for jobs that don’t have a fixed “Place of employment” (so called “Travelling jobs”).
  • Use RegionID "200" for jobs abroad.
  • If RegioZip is null, City will be checked and RegioZip will be retreived from there. 
  • If more than 1 location is associated with a zip code, the first value will be used.

Fixed place of employment

  • Use the RegioZip OR the RegionID element for jobs with a fixed place of employment.
  • RegioZip can contain one single zip code or RegionID can contain one single regionIDs marked in green from this list.
  • Examples:
    <RegioZip>2800</RegioZip>
    <RegionID>301</RegionID>

No fixed place of employment / travelling jobs

  • Use the RegionID element for jobs that don’t have a fixed place of employment.
  • The Region element can contain one or more values for subregions and/or provinces.
  • Download the list of available regions.
  • Examples:
    <RegionID>310,311,312,313</RegionID>
    <RegionID>113</RegionID>
    <RegionID>301,302,114</RegionID>

EducationLevelID

The "EducationLevelID" specifies the requested education level needed for this job.
Only one "EducationLevelID" can be specified for each job.
Download the list with available education levels.

Parttime

1 Part time
0 Full time
2 Both

Layout for jobs

Jobat customers can create multiple layouts for their job offers in the Jobat Back Office.
<HTMLTemplate> and <TemplateName> allow to apply these layouts to the transfered job offer.
The selected layout can be different for each language version of the job.

HTMLTemplate

1 Activates the use of a specific layout
0 Shows the job in the default Jobat.be layout

TemplateName

  • Specify the name of the layout that has to be shown.
    Example: <TemplateName>marketinglayout</TemplateName>
  • The available template names for your clients can be retrieved by contacting support@jobat.be.

Show a company logo or not.

0 Don't show a logo
1 Show a logo

If the <Logo> field is left empty like <Logo /> it will be viewed as if it had a value of 0. (like <Logo>0</Logo>)

Jobat offers 2 possibilities to define which logo should be shown: <LogoName> and <JobLogo>

LogoName

  • Use LogoName if the logo that has to be shown was uploaded via the Jobat Back Office. Contact support@jobat.be if a new logo needs to be added.
  • Leave LogoName empty if you want to show the default company logo, or define the filename of the logo that should be shown

JobLogo

  • You can also send us the 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 if the job has to be published on additional websites within the Jobat network. Separate multiple values by a comma.

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

The logic

  • Download the list of available websites.
  • 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.

ClientEmail: receive feedback

Use the ClientEmail tag to enter an email address on which you wish to receive feedback on the processing of your posting.

  • Error in processing msg: {specific error}
  • Unknown partner with login X and password Y
  • Wrong input. Following input was wrong: {list of fields with a false input}
  • Server was unable to read request. ---> There is an error in XML document (1, 643). ---> Input string was not in a correct format.

    no login information in the xml / missing content in required fields
  • exception] => Server was unable to process request. ---> SqlDateTime overflow. Must be between 1/1/1753 12:00:00 AM and 12/31/9999 11:59:59 PM
    wrong company id

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 on the mobile website, and the "Apply via Whatsapp" button will be shown on the job detail page. This button is not shown on desktop. When the user clicks this button, a Whatsapp chat will be opened automatically.

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.

Note: please respect the order of the following fields. If you add information to the XML, then the order should be respected like this:

  • <SalaryType></SalaryType>
  • <SalaryFrom></SalaryFrom>
  • <SalaryTo></SalaryTo>
  • <SalaryBenefits></SalaryBenefits>

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.
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 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

Examples:

  • <ProductType>light</ProductType>
  • <ProductType></ProductType>

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.

  • <TeleworkDays>2</TeleworkDays>
  • <TeleworkDays></TeleworkDays>

DriversLicences

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

  • <DriversLicences>A</DriverLicences>
  • <DriversLicences>A,B</DriverLicences>
  • <DriversLicences></DriverLicences>