The following is version 1.0 of our specification. We will endevour to ensure that any future versions are backwards compatible with this one.

The following are the data fields which we can send out each time we post you a vacancy. How we send them to you depends upon which protocol you choose, whether that be HTTP, FTP or E-Mail.

The tick at the end of each row indicates whether or not there will always be a value in the field. For example, there is no tick next to 'duration' since this only applies to contract/part-time vacancies and so might not be present if the vacancy is a permanent one.

Most of the fields are self-explantory. However, if you have any questions please do not hesitate to E-Mail d.alexander@postingpal.com.

field name	description	data type	?
salary	Vacancy Salary	string(255)
benefits	Additional Benefits	string(255)
jobtype	Vacancy Type Description (eg. Permanent)	string(30)
contactname	Full Name of contact	string(200)
agencyname	Agency name	string(100)
contacttelephone	Telephone number	string(50)
contactfax	Fax number	string(50)
contactemail	E-Mail address for applications	string(255)
description	Job description	string(8000)
startdate	Start date of vacancy	string(255)
towncity	Town/City of vacancy	string(100)
countystate	County/State of vacancy	string(100)
postzipcode	Post/Zip code of vacancy	string(100)
country	Country of vacancy	string(100)
keywords	Keywords (skills), seperated by commas	string(255)
position	Job Title	string(100)
reference	Reference number	string(50)
duration	Duration (if jobtype<>'Permanent')	string(80)
candidateurl	URL for applications - preferred, but not required	string(255)
jobcategory	Vacancy Category Description (eg. I.T.)	string(50)
urlagencylogo	Vacancy Logo URL	string(255)

2. Advanced data fields

Everything you need is above. However, the following are what we class as 'advanced' (and essentially optional) fields and are simply a breakdown of the above.

They are of particular use for job boards who wish to search on a number of different criteria (eg. salary range, start dates and so on) without having to put excessive drain on database server resources by resorting to free-text queries.

field name	description	data type	?
idvacancy	Unique identifier for this vacancy.	int
idvacancypost	Unique identifier for this posting	int
startdateday	Start date of vacancy (day)	int
startdatemonth	Start date of vacancy (month)	int
startdateyear	Start date of vacancy (year)	int
asap	Is start date ASAP? (0 or 1)	int
salaryfrom	Vacancy Salary (from)	string(10)
salaryto	Vacancy Salary (to)	string(10)
idsalarytype	Salary Type ID	int
negotiable	Is salary negotiable? (0 or 1)	int
idcurrency	Salary Currency ID	int
idjobcategory	Vacancy Category ID	int
idjobtype	Vacancy Type ID	int
idcountry	Country ID of Vacancy	int

You'll notice that some of the fields are clickable. Clicking them will pop up with a window showing all of the current IDs and descriptions available in the live PostingPal database.

2. Custom data fields

Although the above covers all of the vacancy details that you will require along with a little more, it is likely that you will need us to pass you some additional details such as your own category, agency username, password and so on.

field name	description	data type	?
jbidcategory	My category id (post parameter)	int
jbusername	Agency account username	string(255)
jbpassword	Agency account password	string(255)

There are two types of custom data fields - 'Job Post Field' and 'Subscription Info Field'.

A subscription info field is something that PostingPal will prompt the consultant to enter when they first subscribe to your job board. For example, their account username and password.

A job post field is something that PostingPal will prompt the consultant to select when they are posting a job to your job board. For example, this might be a drop-down containing one or more categories. Note that we are able to send you an ID rather than the category description if this makes integration easier at your end.

The choice and quantity of these additional special fields is entirely up to you.