Standard Job Ad XML Fields

Our Ad Delivery system will post the job ad in a standard XML format that is documented below. The Fields listed as Required are required in our system to deliver the job. As long as you can process the Job Ad according to your own rules and specific fields, you can use or implement whichever fields you want. That is, even though SmashFly will pass you Travel or Education as a field, you can choose whether that field makes sense to implement. 

Please note that the job description/ Ad body will contain HTML. This is a requirement from our side. If you don’t allow HTML, you can define a Custom Field to require users to copy and paste a text-only version of the Ad. SmashFly, however, will always pass the HTML version, as well.

SmashFly Fields

This section describes the SmashFly job fields.

Note: In the Type column, Enum indicates that SmashFly will pass a SmashFly-defined parameter for this field; it is not a free-form field. For fields with a type of Enum, refer to the defined posting parameters.

Field

Type

Length

Required

Notes

Board

string

100

Yes

Your specific board name. It’s passed with every posting. We use this internally.

Username

string

100

Yes

Client’s defined username in your system. Use this field along with the password field to authenticate the user.

Password

string

100

Yes

Unique password for the client’s account or for the SmashFly account you configure for us.

AccountNumber

string

100

No

Account number of client ID. If you require us to pass an accountnumber or clientID, you can use this field.

PostingURL

string

255

Yes

URL we are posting the job to. This URL is configured when you add your board to SmashFly. The URL is then passed in every posting, and is used internally.

JobAction

string

Enum

Yes

Whether the posting is adding, updating or deleting a specific Job. Values are “Insert,” “Update,” and “Delete.”

Posting

120

string

Yes

Client’s unique Job ID for each posting. This value is the job ID that should display on your board.

JobTitle

150

string

Yes

Job Title that the client would like to appear on your site.

JobDescription

string

32000

Yes

Complete job description. The description will include HTML.

CompanyName

string

100

Yes

Name of the company that is posting the job.

JobCode

string

Enum*

Optional

SmashFly-defined Job Code. For valid values, refer to the Job Codes table.

JobCity

string

120

Yes

City where the job is located.

JobState

string

Enum*

Yes

State where the job is located. We use standard 2-letter State abbreviations. For valid values in North American, refer to the States, Provinces, and Regions in North America documentation. For valid values outside of North America, refer to the States, Provinces, and Regions Outside of North America documentation. (This information is available in the Job Import API > Lookup Values documentation.)

JobZipCode

string

20

No

Postal code of the Job.

JobCountry

string

Enum*

Yes

Country code of the job. For valid values, refer to the Countries documentation. (This information is available in the Job Import API > Lookup Values documentation.)

JobType

string

Enum*

Yes

Type of job, such as if it’s full-time or part-time, contract, or temporary. For valid values, refer to the Job Type table.

JobExperience

String

Enum*

Yes

Experience the candidate is expected to have to qualify for the posted job. For values, refer to the Experience table.

PayPeriod

string

Enum*

Yes

Payment period for the job, such as annual, salaried or an hourly payment. For valid values, refer to the Pay Period table.

MinimumSalary

string

20

Optional

Minimum salary for the job.

MaximumSalary

string

20

Optional

Maximum salary for the job.

Currency

string

20

Optional

Currency for salary. You can specify a currently code such as USD for US Dollars, or EUR for Euros. For valid values, refer to the Currency table.

Education

string

Enum*

Optional

Minimum level of education you require from a candidate. For valid values, refer to the Education table.

Travel

string

Enum*

Optional

Travel requirements for this specific Job. For valid values, refer to the Travel table below.

Shift

string

Enum*

Optional

Shift period. For part-time hourly positions, clients can specify which shift the candidate would be working. Examples include “First,” “Second,” “Rotating,” and so on. For values, refer to the Shift table.

Contact_FirstName

string

100

Optional

First name of the recruiter or the person who will be listed as the “contact person” for this job posting. Typically, this is the recruiter for the position

Contact_LastName

string

100

Optional

Last name of the recruiter or person who will be listed as the “contact person” for this job posting. Typically, this is the recruiter for the position.

ContactPhone

string

50

Optional

Phone number for the person identified as the contact for the job posting. It is not typical to provide a phone number, but this field is available for customers who like to provide phone support.

ContactFax

string

50

Optional

Fax number where candidates can fax their resumes for the specific position.

ContactEmail

string

250

*Optional

Email address to which candidates can forward their resumes or from which they can ask for additional information about the position. Either the ContactEmail or the ApplyURL will be passed in this field. The clients will determine which method to use for candidates to apply.

ApplyURL

string

250

*Optional

Job-specific Web URL for the posting; this URL is typically used to redirect the candidate to the job posting on their corporate site. From there, the candidate can complete the application process.

Commission

integer

20

Optional

Commission available for the job. This field will pass an integer value.

WillingtoRelocate

String

Enum*

Optional

Whether the candidate needs to be willing to relocate for this job. Valid values are Yes and No. For valid values, refer to the Willing To Relocate table.

 

Related Topics