Importing job adverts

Adverts may be imported automatically into the system in addition to manually entering adverts via Profesia.sk. Importing adverts is a service outside the framework of credit packages and includes the following services:

Initial configuration of advert imports via API or XML
Phone support for any issues
1-year of import technical support

Adverts may be imported in two ways:

Using Profesia API Highly recommended
Adverts are immediately imported after posting in your system. Communication between your system and the Profesia.sk system uses API calls defined in Profesia API documentation. Code list updates occur just as dynamically. Direct application-to-application communication minimises the risk of errors occurring when adverts are imported. Job adverts may also be added automatically to Profesia.sk using a job advert import.

Using an XML file
Job adverts can be imported into Profesia.sk also from an XML file. There are two ways how to import an XML file:
- import as a draft - if you want to have full control over imported job adverts before their publishing/li>
- instantly published import - job adverts will be published immediately after the import by the following rules:
  - new adverts are added to www.profesia.sk
  - information in existing, posted adverts is updated
  - posting of adverts not found in the XML file is terminated

Note: A sufficient level of pre-paid credit is required when importing adverts into the system. The credit needed to post adverts is not included in the Import service.

TIP: Check to see if the supplier of your HR system supports exporting job adverts to our portal. This can save a large amount of time when preparing an XML file with adverts.

The Profesia API is a simple, fast and convenient way to import job adverts from your system to Profesia.sk. A beta version is currently being used.

To start using the Profesia API, you must have an existing account and an assigned authentication token, which you receive upon service activation.

You can then start using an API call to import adverts into Profesia.sk.

See the complete API call documentation.

TIP: Check to see if the supplier of your HR system supports exporting job adverts to Profesia.sk via API. This can save time in the technical preparations needed to import adverts.

We can activate this service if:

you have an existing company account at Profesia.sk
simply send us a link to the XML file containing the job adverts on your server – the XML file must be in the correct format

We provide our clients with code lists for XML files that permit the immediate posting of imported adverts on Profesia.
If you do not use our code lists, the adverts we import from you will be saved as drafts in your corporate account and you will have to post them manually.

Please contact the sales department or your account manager for more details.

XML file requirements

the structure of the XML file must be done in the defined format
every imported advert must have all mandatory fields complete
the XML file must be accessible at a fixed URL address
you must have sufficient credit for the imported adverts

Note: Adverts are not imported if you don’t have sufficient credit to post all adverts; an error message appears stating the job adverts were rejected due to insufficient credit. The validity of a single advert is 1 month max. If an advert remains in the XML file for longer, it is considered a newly added advert after this period and another credit is deducted for its posting.

Obsah:

Required fields of a job advert
Optional fields of a job advert
Optional fields (only for personnel agencies)
Custom solutions for clients
Code lists

Required fields of a job advert

Name (attribute/element)	Description and Field type	Example
externalid (A)	Job advert ID in partner system varchar(255)	`<job externalid="1821">`
offerlanguage (E)	Language of job advert Supported values: sk, cz, hu, en, de	`<offerlanguage>`en`</offerlanguage>`
position (E)	Name of the job position varchar(150)	`<position>`Real Estate Senior Consultant`</position>`
jobtasks (E)	Job description text	`<jobtasks>`Advise on leasing strategy (measurements, rental levels, lease conditions)`</jobtasks>`
workplacetype (E)	Type of job location 1 = The job is in a regular working place 2 = The job requires travelling (salesman, driver) 3 = Remote work 4 = The job is in a regular working place with possibility of working from home NEW	`<workplacetype id="1"/>` `<workplacetype id="2"/>` `<workplacetype id="3"/>` `<workplacetype id="4"/>`
offerlocation (E) street (A) location (E) id (A)	The job is in a regular working place Code list REGIONS for distinct job location	`<offerlocation street="Pribinova 19">` `<location id="101" />` `</offerlocation>`
offerlocation (E) location (E) id (A)	The job requires travelling (salesman, driver) Up to 3 locations. Code list REGIONS for jobs requiring travel	`<offerlocation>` `<location id="1"/>` `<location id="2"/>` `<location id="3"/>` `</offerlocation>`
offerlocation (E)	Job does not require visiting of office premises (Remote work) The element must be part of XML file, but it does not have to contain any value.	`<offerlocation/>`
offercategorypositions (E)	Category and position of job advert Code list CATPOS	`<offercategorypositions>` `<catpos category="1" position="2"/>` `<catpos category="2" position="22"/>` `</offercategorypositions>`
Jobtype (E)	Type of job Code list JOBTYPE	`<jobtype>` `<type id="1" />` `<type id="2" />` `</jobtype>`
educationlevel (E)	Required education level Code list EDUCATIONLEVELS	`<educationlevel> <education id="7" /> </educationlevel>`
numberofopenings (E)	Number of vacancies Int This information is not displayed in job advert.	`<numberofopenings>`3`</numberofopenings>`
contactperson (E)	Contact person	`<contactperson>`Ing. Mária Nová`</contactperson>`

Optional fields of a job advert

Name (attribute/element)	Description and Field type	Example
Job advert properties
last_modified (A)	Date and time of the last update of export file	`<export last_modified="2013-06-06 19:36">`
offerchannel (E), channel (E), id (A)	Channel ID where job advert was published 1 - profesia.sk 2 - workania.hu 3 - profesia.cz	`<offerchannel>` `<channel id="1"/>` `<channel id="2"/>` `</offerchannel>`
date (E), renew (A)	Date when the job advert should be renewed date (YYYY-MM-DD)	`<date renew="2013-06-06"/>`
refnr (E)	Reference number of job advert in partner system varchar(20)	`<refnr>`1-12-1727/PF`</refnr>`
sendcv (E), Id (A)	Suitable CV's will be sent to you per e-mail 0 – all 2 – do not send	`<sendcv id="2"/>`
applicationwithoutcv (E)	false - applying for job is possible only with CV attached (default) true - applying for job is possible without CV If you are using your own system to process applications (application_url) we recommend to set this value to false.	`<applicationwithoutcv>`false`</applicationwithoutcv/>`
Job advert options
otherbenefits (E)	Benefits offered by employer text	`<otherbenefits>`team events for employees (teambuildings, sport days, etc.)`</otherbenefits>`
prerequisites (E)	Personal prerequisites and skills text	`<prerequisites>`strong and proactive individual`</prerequisites>`
noteforcandidate (E)	Other information for applicant text	`<noteforcandidate>`selection process has two rounds`</noteforcandidate>`
salary (E)	Additional salary information - Other salary components, Christmas bonus salary, rewards and bonuses text	`<salary>`Christmas bonus salary, rewards and bonuses`</salary>`
salary interval (E), min (E), max (E), currency (E), period (E), id (A), hidden (A)	Salary range "min" and "max" is required "min" is expected greater as "1" "min" could not be greater than "max" Currency ID: 2 - EUR 4 - CZK 5 - HUF Period ID: 1 - monthly salary 2 - hourly wage	`<salaryinterval>` `<min>`700`</min>` `<max hidden="true">`900`</max>` `<currency id="2" />` `<period id="1" />` `</salaryinterval>`
startdate (E)	Start date - text information about employment date varchar(200)	`<startdate>`March 1st 2021`</startdate>` or `<startdate>`asap`</startdate>`
applicabletill (E)	Deadline for application date	`<applicabletill>`2021-06-16`</applicabletill>`
specialization (E)	Required specialization varchar(255)	`<specialization>`ekonomické / technické zameranie, MatFyz výhodou`</specialization>`
languageconjuction (E)	conjunction of language skills or and (optional)	`<languageconjuction>`or`</languageconjuction>`
offerskills (E), skill (E), id (A), Level (A)	Required skills (language, computer, administrativve and economic skills) Code list SKILLS, LEVELS	`<offerskills>` `<skill id="9" level="3" />` `<skill id="10" level="3" />` `<skill id="114" level="1" />` `<skill id="73" level="9" />` `</offerskills>`
drivinglicence (E)	driving licence type varchar(20)	`<drivinglicence>`B, C, D`</drivinglicence>`
validforgraduate (E), value (A)	Job advert is suitable for a graduate 1 – yes 2 - no	`<validforgraduate value="1" />`
requiredexperience (E), experiencesector (E), experienceyears (E)	Number of years of experience Varchar (for experiencesector) Int (for experienceyears)	`<requiredexperience>` `<experiencesector>`sales`</experiencesector>` `<experienceyears>`3`</experienceyears>` `</requiredexperience>`
suitableforukrainians (E) Coming soon	Job adverts for ukrainian refugees boolean	`<suitableforukrainians>`true`</suitableforukrainians>`
Contact person (must be registered in our system beforehand and an ID must be assigned to him/her).
title_before (E)	University degree varchar(30)	`<title_before>`Ing.`</title_before>`
first_name (E)	First name varchar(50)	`<first_name>`Mária`</first_name>`
surname (E)	Last name varchar(50)	`<surname>`Nová`</surname>`
contactphone (E)	Phone number varchar(50)	`<contactphone>`02 5919 2249`</contactphone>`
contactemail (E)	E-mail address varchar(60)	`<contactemail>`m.nova@abc.sk`</contactemail>`

Application methods

email of the kontakt person/registered user: For responses to an email address is necessary to identify the the contact person (the advert submitter). Multiple e-mail adresses with one contact person are not supported.
URL address: Just enter the URL address that includes a response form for a specific advert.
unique email address: some systems are using unique tracking email addresses for each job.

Name (attribute/element)	Description and Field type	Example
application_url (E)	Applications to other HR system (Taleo, Kenexa, G2,...)	`<application_url>`http://www.ats.sk/applications/hr-form/index/index/lang/sk/id/22/position/CRM+IT+Analytik`</application_url>`
applicationemail (E)	a unique email address for each job	<`applicationemail`>applicationemail@profesia.sk`</applicationemail>`

Only for personnel agencies

Name (attribute/element)	Description and Field type	Example
Businessarea (E), Id (A)	Main area of business of the client's company Code list BUSINESSAREAS	`<businessarea id="2" />`
Shortcompanycharacteristics (E)	Short description of client's company text	`<shortcompanycharacteristics>`The company advises and represents clients on all aspects of property occupancy and investment.`</shortcompanycharacteristics>`

Custom solutions for clients

It is necessary to include your Custom fields in the XML file if you use this service.

What are Custom fields?

These are fields that we are able to add or display within the detail of the job offer or the company's subpage.

Text fields:

textfield - for entering short text information, a one-line field
textarea - field for entering a longer text, a more-line field

Custom categories:

Custom fields can be also used for entering custom categories.
The client has the option to ask for custom categories that will enable him to display different elements (text/picture) or to use them as a custom filter for the different categories of the job offers.

single select - Drop down list with the choice of one category
selectize - Multi select with the possibility to choose more categories
checkbox - Where we can determine whether the job offer belongs to a certain category. Whether the value is true/false, where true = 1.

Name (attribute/element)	Description and Field type	Example
Customfields (E), Customfield (E), Name (A) * *name of the field will be provided to you after creating	User defined fields and categories	`<customfields>` `<customfield name="textfield">`Lorem ipsum...`</customfield>` `<customfield name="textarea">`Curabitur...`</customfield>` `<customfield name="singleselect">`1001`</customfield>` `<customfield name="selectize">`2001`</customfield>` `<customfield name="checkbox">`1`</customfield>` `</customfields>`

Code Lists

If you want the job seeker to find your job offers as simple as can be and if you wish that relevant job seekers would apply for the jobs, apart from text information we recommend also to fill in code list values in the job offers.

TIP: Our code lists are updated from time to time. Therefore, we recommend to follow the changes in these XML files regularly.

The job search can be done in more ways

Simple search on the main page by entering the position and locality: https://www.profesia.sk/en/
Extended search: https://www.profesia.sk/en/search_offers.php
By creating a job alert https://www.profesia.sk/en/agent/

Mandatory code lists

Type of work place
Work place
Category and position of the job offer
Type of employment
Required level of education

See section: Mandatory fields of the job offer

All code lists

Summary of all code lists for profesia.sk in the Slovak language (by using the parameter lang=sk can be found on this link:https://www.profesia.sk/codebook.php?lang=sk

Supported languages

Code lists can be displayed in five languages with the help of the parameter lang

Code lists are also available separately

By channel

Profesia.sk: https://www.profesia.sk/codebook.php?lang=sk
Profesia.cz: https://www.profesia.cz/codebook.php?lang=cz
Workania.hu: https://www.workania.hu/codebook.php?lang=hu

By type

Type of work place: https://www.profesia.sk/codebook_workplacetypes.php?lang=en
Work place at the permanent working place: https://www.profesia.sk/codebook_regions.php?workplacetype=1&lang=en
Work place - job that requires travelling: https://www.profesia.sk/codebook_regions.php?workplacetype=2&lang=en
Areas and positions: https://www.profesia.sk/codebook_catpos.php?lang=en
Type of employment: https://www.profesia.sk/codebook_jobtypes.php?lang=en
Education: https://www.profesia.sk/codebook_educationlevels.php?lang=en
Skills – language and other skills: https://www.profesia.sk/codebook_skills.php?lang=en

The most frequent XML error messages

www.profesia.sk - automatic import log report - FATAL ERROR

Our system is unable to read the XML file containing job adverts. The file is corrupted or otherwise inaccessible for our system. The adverts could not be imported. Please contact your IT department or the provider of your export file and ensure the XML file is in the defined format.

Contact person not registered in the www.profesia.sk system / Incorrectly entered contact details (ID, email, or first and last name)

Even though adverts are imported automatically, every advert must have a defined contact person registered at Profesia.sk. Please check to ensure the person identified for each advert is a person registered in your corporate account at Profesia.sk. Log in to the company account

The following errors may occur when identifying contact persons:

The contact person is not registered at www.profesia.sk. Please check your account to determine if the person identified in the advert is registered. If not, the person must be added.
The contact person is registered at www.profesia.sk, but no contact was identified for the advert (identification details - first and last name and email). These items are mandatory when importing job adverts.
The contact person is registered at www.profesia.sk but the identification details were not completed correctly (i.e. first name, last name and email of the contact person). The contact details identified in the Profesia.sk system must match those in the job advert.
You entered the identification details for multiple contact persons. A job advert may only be assigned to a single submitter. If you need to provide a different contact person, we recommend making this change in the job advert itself as text information.

Undefined positions or work areas

The job advert you are attempting to import does not contain the mandatory field Position or Work area. Ensure the mandatory values (positions, offercategorypositions) are entered in the XML file.

Undefined place of work

The job advert you are attempting to import must have a defined mandatory field for Place of work. Ensure the mandatory value (offerlocation) is entered in the XML file.

Type of employment (ID) not assigned, configured value: 1

If you did not define a type of employment for a specific advert, our system automatically configures a value of 1 (full-time employment).

If you don’t want to receive this type of message when importing adverts, we recommend setting the type of employment parameter directly in the XML file. Details can be found in the technical specifications.

Incorrect combination of position and work area

The position in the imported file is not classified to the correct work area.

The classification must be modified per the specifications of the position based on the CATPOS code list.

Multiple uses of an external ID - Identical adverts

Multiple adverts are entered in the imported XML file with the same ID or the same advert was exported multiple times with an identical ID.

Our system imports the first advert with a duplicate identifier and the other adverts are not imported.

If you want to avoid the error message, check to ensure the same external ID parameter does not appear for multiple adverts.

Importing job adverts

The most frequent XML error messages

Other Articles