Vacancy Template
Below is a list of the information we need to receive in order to publish your vacancy successfully. It shows all of the possible field labels in the correct order.
| Field label | Mandatory/optional field | Details |
|---|---|---|
| client_id | Mandatory | This is your unique account number issued by This is Sussex Jobs. |
| client_password (not required when sending jobs by FTP) | Mandatory | This is the password used with your Client ID when publishing vacancies. |
| job_ reference | Mandatory |
The reference identifier you give to your vacancy. Note that, in order to ensure that your identifier remains unique we will prefix it with your Client ID followed by a hyphen. The job reference you provide should be no longer than 19 characters. If any of the following characters are found in the reference then they are changed to a minus sign (-): hash (#), forward slash (/), space ( ), plus |
| job_title | Mandatory |
The title of the vacancy to be advertised. This field is searchable by the candidates so you should ensure the job title adequately describes the position. The field must be less than 69 characters long. |
| job_description | Mandatory |
The general description of the vacancy to be advertised. The field must be no more than 2900 characters long, including spaces and line breaks and any hidden characters. This field is searchable by the candidate so you should ensure the job description adequately describes the position and contains keywords that the candidate might use in their search. Whilst a vague description may receive a larger number of responses, a detailed description will produce a higher quality response. The section_end tag can be used at the end of this field, on a new line. What is this for? |
| job_type | Mandatory |
The field value must be 1 single character from - C, P or E. This is used to indicate whether the job is 'Contract/temp' or 'Permanent' or 'Either'. This field can be included in the candidates search so you should ensure the job type accurately describes the position. |
| job_location | Mandatory |
The location(s) of the vacancy to be advertised. Separate locations with commas and ensure the total list of locations does not exceed 199 characters including spaces and commas. This can be a town, city, county or region. Don't be tempted to enter lots of places in order to broaden the appeal, research has shown that this can put the job hunter off applying. Simply state where the job is located. This field is searchable by the candidate, so you should try to be as precise as you can with the location mentioning the nearest town or city. This is Sussex Jobs' search technology will ensure your vacancy gets the right exposure based on a location search. |
| job_contact_email | Mandatory |
Enter the email address of the person to whom applications are to be sent. Maximum field length is 129 characters. |
| job_industry_sector | Mandatory |
This is a 2-character code and is searchable by the candidate.
AC Accounting AU Automotive AV Aviation FI Banking & Finance CN Construction CY Consultancy CU Customer Service DE Defence DI Distribution ED Education EL Electronics EN Engineering GR Graduate OT Health HR Human Resources IT Information Technology IN Insurance LW Legal LO Transport & Logistics ME Management & Executive MA Manufacturing MK Marketing MD Media MI Military PO Production PS Public Sector PU Purchasing RC Recruitment RT Retail SM Sales SC Scientific SE Secretarial & Administration TE Telecommunications TR Training TV Travel & Hospitality |
| job_contact_name | Mandatory |
The name of the person to contact is displayed with the vacancy. The field value can be up to 60 characters long. |
| job_duration | Optional |
The duration of the employment displayed on the vacancy. It can be entered in any form e.g. 3 weeks, 6 weeks, or Neg. If the vacancy is for a permanent position enter 'Permanent'. The field value can be up to 20 characters long, if a value is not provided then 'tbd' will be displayed on the vacancy. |
| job_start_date | Optional |
The start date of the employment displayed on the vacancy. This can be written either as a date (e.g. 01/05/08), or as text (e.g. ASAP, Immediate,TBA, or TBC). The field value can be up to 50 characters long. This field value is optional. If a value is not provided then 'ASAP' will be displayed on the vacancy. |
| job_weeks_to_advertise | Mandatory |
This refers to the number of weeks that you wish your vacancy to be advertised for. The field value must be a whole number in the range 1 to 52. |
| job_salary_or_rate | Optional |
The salary or rate for the employment as displayed on the vacancy.Note that whilst searching for jobs, candidates have the option to exclude vacancies with no salary specified. So to increase your vacancy exposure you should ensure, where possible, that a salary or rate is given. The field can be up to 25 characters long. If a value is not provided then 'Neg.' will be displayed on the vacancy. |
| Unused (this blank field should only be used when sending csv or txt files via FTP) |
This field must be included in csv files when using FTP to send vacancies. Simply add another delimiter character to create the blank field. |
|
| site_code (this field should only be used when sending csv or txt files via FTP) |
The site(s) upon which the vacancy is to be advertised. This is optional, if the field is left blank the vacancy will be posted to the primary site/country for the Client ID. If this field is present then it must contain the 2 character site code from the following:
|
|
| job_application_form | Optional |
The number identifying the filtering form you wish to attach to this vacancy (you will find the number in the Filtering Form manager in Client Home). Note that if you have declared a Filtering Form as the default form in your account, leaving this field blank will result in the default form being used. If you have a default form specified you can override this by entering the reference for another form, or 0 (zero) for no form. |
| Unused (this blank field should only be used when sending csv or txt files via FTP) | Optional |
This field must be included in csv files when using FTP to send vacancies. Simply add another delimiter character to create the blank field. |
| job_template_ref | Optional |
This is the number that identifies the Semi-Display template you use to display the vacancy. You only need to include a value if you have more than one template. |
| job_direct_app | Optional |
The URL that the candidate will be re-directed to when making an application to your vacancy. This field can only be used on prior agreement with This is Sussex Jobs. |
| job_footer_type | Optional |
The name identifying the footer you would like to use, either
Note that if you have declared a vacancy footer as the default in your account, leaving this field blank will result in the default footer being used. |
| job_footer_text | Optional |
The footer text you would like to use in the vacancy you are posting. This will only get published with the vacancy if the account setting allows recruiters to edit footers. If you have already defined footer text in your account online then you only need to enter the name of the footer in the job_footer_type field. The section_end tag can be used at the end of this field, on a new line. What is this for? |
