Employer   LOGIN   |   REGISTER
Job Seekers   LOGIN   |   REGISTER

XML Automated Job Posting Services

News and Updates
- 07/02/08 - Now you can post XML jobs as strings. See details below.

The XML automated job posting process is designed to allow for employers to easily post and edit jobs directly from their applicant tracking system or aggregation software.

1 - XML File Creation.
2 - Post XML file to server.
3 - Successful Server Return Message.
4 - Failure Server Return Message.
5 - Correction of Server Return Error Message.

Activity Diagram

Interaction Diagram

As an example, this diagram involves one error on the initial XML that is fixed by employer:


1 - XML File Creation

Download the XML file template: xml_job_sample.xml. XML files/strings to update and insert jobs are identical, the only difference is if you wish to add, edit or delete jobs. You will need to edit the action tag to determine it's usage. Use 'update' to update existing jobs, and 'insert' to create new jobs.

If you are trying to delete an existing job, please use this file instead: xml_job_sample_remove.xml

You can also download DTD if you want to see the format specifications and perform validations: incoming_job.dtd
XML can be created manually or automatically.

Dictionary Data
Field Type, sizes and values Comment
user_name varchar(255) Required. Employer user name.
pass varchar(50) Required. Employer password.
action enum('insert', 'update') Required. insert if want to create a new job. update if want to edit existing job. delete if you want to delete an existing job.
unique_id_job varchar(100) Required. Unique job identifier for this company. If editing, you will need to use the exact value. If inserting a new job, then this value must not be duplicated or currently existing.
company_name varchar(200) Required. Company name.
id_education integer(11) Required. More Details.
job_title varchar(255) Required. Job Title
begin_show_at date YYYY-MM-DD format Required. Current or later date. More Details
stop_show_at date YYYY-MM-DD format Required. Must be greater than begin_show_at. More Details
reference varchar(100) Optional
city varchar(100) Required. City name.
id_state integer(11) Required. More details.
zip varchar(20) Required. Job location zip code.
relocation enum('Y','N','TBD') Required. More Details.
relocation_assistance enum('0','1') Required. More Details.
level enum('Store','Executive') Required. More Details.
id_salary_range integer(11) Required. More detalis.
id_volume_responsibility_range integer(11) Required. More Details.
id_store_unit_count_range integer(11) Required. More Details.
id_travel_percentage_range integer(11) Required. More Details.
job_description text Optional. Job Description.
experience_summary text Optional. Experience Summary.
required_skills text Optional. Required Skills.
application_instructions text Optional. Application Instructions.
application_method enum('RetailManagerCareers.com','Company Url') Required. Use 'RetailManagerCareers.com' if Job Seeker applies on our site. Use 'Company Url' if jobseeker applies on an external URL.
applicant_notification_email text Required. If application_method = 'RetailManagerCareers.com' and notify_employer_about_applicants ='1'. This must be a valid e-mail. This is where new applicant notifications are sent.
notify_employer_about_applicants Required. '1' if you want to receive new applicant notifications. '0' if not.
job_applicant_url varchar(255) Required. If application_method = 'Company Url'
poster_name varchar(100) Required.
poster_email varchar(100) Required. Must be valid e-mail.
contact_email varchar(100) Optional. Must be a valid e-mail.
contact_name varchar(100) Optional.
show_google_map enum('0','1') Required. '1' If google map must be showed. '0' if not.
coord_latitude varchar(100) Optional. Job latitude for google map.
coord_longitude varchar(100) Optional. Job longitude for google map.
zoom_level integer(11) Optional. Google map zoom level.
anonymous_job enum('0','1') Required. '1' If job must be anonymous and '0' if not.
listing_status enum('active','inactive') Required. 'active' if job must appear in listing 'inactive' if must be hidden.
use_full_html_ad enum('0','1') Required. '1' if want to show you own HTML job offer ad. '0' if not.
full_html_page_ad text Required. If use_full_html_ad = '1'
job_image_url text Optional. Job image. If used it must be an url of an image on the web.
ask_eeo_question enum('0','1') Required. '1' if EEO questions must be asked to applicants, '0' if not.
ask_qualifier_questions enum('0','1') Required. '1' if prequalifier questions must be asked to applicants. '0' if not.
qualify_percentage float Optional. Percentage required to be considered as "qualified".
id_category integer(11) Optional. Job can be associated with more than one category. More Details.
id_type integer(11) Optional. Job can be associated with more than one type. More Details.
id_benefit integer(11) Optional. Job can be associated with more than one benefit. More Details.
id_eeo_question integer(11) Optional. EEO question to be asked. More Details.
qualify_question_item   Optional. Each job can contain multiple questions. Each question item must contain a valid question, correct_answer, score and position
question text Question text
correct_answer enum('No','Yes') Correct answer for question
score float Score assigned to this question.
position float Position order of this question.
paid enum('0','1') Required. 1 if job will be paid, 0 if you wish to leave it unpaid. If job is not paid,
the listing will be stored on our database but it will not be published.

Limits
Description Value
When job post is created, this is the maximum number of days that it can be published online. 90
When job is updated, this is the maximum number of days that it can be online since it was published online. 270
Job title and location cannot be changed after this number of days since it was published online. 90


Allowed values and meanings for action field
Description Value
Create a new job insert
Update an existing job update
Delete an existing job delete


Allowed values and meanings for id_state field
State Code Value
Alaska AK 60
Alabama AL 23
Arkansas AR 41
Arizona AZ 48
California CA 51
Colorado CO 44
Connecticut CT 8
District of Columbia DC 14
Delaware DE 13
Florida FL 21
Georgia GA 20
Hawaii HI 53
Iowa IA 30
Idaho ID 46
Illinois IL 36
Indiana IN 28
Kansas KS 38
Kentucky KY 26
Louisiana LA 40
Massachusetts MA 3
Maryland MD 16
Maine ME 6
Michigan MI 29
Minnesota MN 32
Missouri MO 37
Mississippi MS 25
Montana MT 35
North Carolina NC 18
North Dakota ND 34
Nebraska NE 39
New Hampshire NH 5
New Jersey NJ 10
New Mexico NM 49
Nevada NV 50
New York NY 9
Ohio OH 27
Oklahoma OK 42
Oregon OR 58
Pennsylvania PA 12
Rhode Island RI 4
South Carolina SC 19
South Dakota SD 33
Tennessee TN 24
Texas TX 43
Utah UT 47
Virginia VA 15
Vermont VT 7
Washington WA 59
Wisconsin WI 31
West Virginia WV 17
Wyoming WY 45


Allowed values and meanings for relocation field
Description Value
Relocation required Y
No relocation required N
TBD TBD


Allowed values and meanings for level field
Descritption Value
Store Store
Executive Executive


Allowed values and meanings for id_salary_range field
Description Value
DOE 8
Not Given 9
20k-40k 1
40k-60k 2
60k-80k 3
80k-100k 4
100k-120k 5
120k-140k 6
140k+ 7


Allowed values and meanings for id_volume_responsibility_range field

Description Value
Not Given 1
0-1 2
1-2 3
2-3 4
3-4 5
4-5 6
5-10 7
10-15 8
15-20 9
20-25 10
30-40 12
25-30 11
40-50 13
50-70 14
70-90 15
90-110 16
110-130 17
130-150 18
150-200 19
200-250 20
250-300 21
300-400 22
400-500 23
500-600 24
600-700 25
700-800 26
800-900 27
900-1B 28
1B-3B 29
3B-6B 30
6B-9B 31
9B-20B 32
20B+ 33



Allowed values and meanings for id_store_unit_count_range field
Description Value
Not Given 1
1 2
2 3
3 4
4 5
5 6
6-10 7
11-15 8
16-20 9
21-30 10
31-40 11
41-50 12
51-75 13
76-100 14
101-150 15
151-200 16
201-250 17
251-300 18
301-400 19
401-500 20
501-600 21
601-700 22
701-800 23
801-900 24
901-1000 25
1000+ 26


Allowed values and meanings for id_travel_percentage_range field

Description Value
Not Given 6
0% - 5% 1
5% - 15% 2
25% - 50% 3
50% - 75% 4
75% - 100% 5


Allowed values and meanings for level field
Description Value
No Relocation Assistance 1
Relocation Assistance 0

Allowed values and meanings for id_education field
Description Value
Not Given 7
High-School/GED 1
Associate Degree/Diploma 2
Bachelors Degree 3
Post Graduate Diploma 4
Masters Degree 5
Doctorate Degree 6



Allowed values and meanings for listing_status field
Description Value
List job online active
Do not list job online inactive


Allowed values and meanings for paid field
Description Value
Pay job to publish online 1
Do not pay for job for the moment 0


Allowed values and meanings for id_category field

Description Value
Administration 3
Buying 16
Corporate 1
Customer Service 5
Distribution 6
eCommerce 4
Field 2
Finance/Accounting 8
Human Resources 9
Information Technology 11
Internal Audit 17
Legal 12
Loss Prevention 10
Maintenance/Mechanical 24
Marketing 15
Merchandising 21
Operations 23
Pharmacy/Medical 25
Product Development 20
Real Estate/Construction 19
Risk Management 13
Sales 22
Strategic Planning 18
Supply Chain 14
Transportation 7


Allowed values and meanings for id_type field

Description Value
Area/Regional Manager 5
Assistant Store Manager 1
Corporate 6
Corporate Manager 7
Director 8
District/Market Manager 4
Multi-Store Manager 3
Other 16
Regional Vice President 9
Store Manager 2
Vice President & Above 10

Allowed values and meanings for id_benefit field
Description Value
401K 1
Bonus 3
Company Car 10
Company Matched 401K 2
Employee Discount 11
Full Dental 8
Full Family Healthcare 9
Full Medical 7
Medical, Dental 5
Profit Sharing 12
Retirement 13
Sign-on Bonus 4
Tuition 14
Vision 6


Allowed values and meanings for id_eeo_question field
Description Value
Gender 1
Which race or culture do you consider yourself? If you identify with more than one ethnic group, we respect your desire to do so. However, it would be helpful if you mark the ONE ethnic group with which you most identify. 2
Have you ever been on active duty in the U.S. Armed Forces? 3
Are you a Vietnam Era or disabled Veteran? 4
Do you meet the following disability definition? A person is disabled if he or she has a permanent physical or mental impairment that substantially limits one or more major life activities. A person is substantially limited if he or she is unable to perform a major life activity that the average person in the general population can perform. A major lift activity is one that is of central importance to daily life. 5

2 - Post XML to server

You can upload job info as a XML file or XML string.

You can choose how to post your XML file/string. The XML file must be sent in a variable called xml_file, and if you want to upload as strings you must send it as a variable called xml_string.

Here are the uploading options:

You can upload the file to this URL: https://www.retailmanagercareers.com/job_post_from_xml.php

XML file must be sent in a variable called xml_file. If you decide to post a file, it must be sent in variable called xml_file, alternatively if you decided to send it as a string you must do it in variable called xml_string

- You can upload using this form: Post XML here

- Paste this form on your own site if you want to upload an XML file:



- Paste this form on your own site if you want to post via XML string:

- To upload XML file use curl tool from linux command line in this way:

curl -F xml_file=@path_to_your_xml_file.xml https://www.retailmanagercareers.com/job_post_from_xml.php

- To post XML string use curl tool from linux command line in this way:

curl -d xml_string=xml_string_here https://www.retailmanagercareers.com/job_post_from_xml.php

IMPORTANT: XML string must be url encoded

Or you can write your own script in your preferred coding language to upload XML file or XML string. Remember if you post xml as string it must be url encoded.

3 - Successful Server Return Message.

After posting the XML file, our scripts will check your job details. If no errors are found, then our server will return this xml file as a success confirmation.

4 - Failure Server Return Message

If errors are found within the XML job file, our server will send a return message like this one. The status tag will read “fail” and will list the errors found. The error list contains the specific error as well as the description of the error.

Error code/s should be used by software to take the right actions. The description and recommendation field should be manually used to understand what is wrong and how to fix it. Programmers can also attempt to write their own scripts to prevent similar future errors.

The following is a list of all possible error codes that can occur while trying to post a job.

Errors Codes

XML_anonymous_job_can_not_use_company_url_application_method
Description If using the anonymous posting feature, you cannot use company url as your application method.
How to fix Do not use the anonymous posting feature or change your application method to "Retailmanagercareers.com."
   
XML_begin_show_date_is_older_than_current_date
Description Begin show date is older than current date.
How to fix You must use a value that is current or later than begin show date.
   
XML_company_has_no_posting_credits
Description Company has no posting credits.
How to fix Get more credits or post job as unpaid (paid=0). You can get more credits here: http://www.retailmanagercareers.com/employer_posting_credits.php.
   
XML_file_not_uploaded
Description XML file could not be uploaded.
How to fix You must upload xml_file with job info.
   
XML_invalid_applicant_notification_email
Description Invalid applicant notification e-mail address.
How to fix If contact method is RetailManagerCareers you must use a valid applicant notification e-mail address.
   
XML_invalid_applicant_notification_url
Description Invalid applicant url.
How to fix If application method is set to company url a valid external url must be used.
   
XML_invalid_city
Description Invalid city
How to fix Use correct city.
   
XML_invalid_company_name
Description Invalid company name.
How to fix Company name cannot be empty.
   
XML_invalid_contact_email
Description Invalid contact e-mail.
How to fix Use valid contact e-mail, or use empty if not required.
   
XML_invalid_full_html_page_ad
Description Invalid full-page HTML ad.
How to fix If you using a full-page HTML then you must insert text for it.
   
XML_invalid_job_begin_show_at
Description Invalid begin show at date.
How to fix Use a valid date with YYYY-MM-DD format.
   
XML_invalid_job_level_option
Description Invalid job level option.
How to fix Use valid job level option, you can see valid level options here: http://www.retailmanagercareers.com/jobs_valid_codes.php#job_level_option.
   
XML_invalid_job_relocation_assistence
Description Invalid relocation assistance option.
How to fix User valid relocation assistance option, you can see valid options here: http://www.retailmanagercareers.com/jobs_valid_codes.php#relocation_assistance.
   
XML_invalid_job_relocation_option
Description Invalid relocation option
How to fix Use valid relocation option. You can see relocation option here http://www.retailmanagercareers.com/jobs_valid_codes.php#relocation_option
   
XML_invalid_job_salary_range
Description Invalid salary range.
How to fix Use a valid salary range. You can see valid salary ranges here: http://www.retailmanagercareers.com/jobs_valid_codes.php#salary_range.
   
XML_invalid_job_state
Description Invalid job state.
How to fix Use a valid state code. You can see valid sate codes here: http://www.retailmanagercareers.com/jobs_valid_codes.php#id_state.
   
XML_invalid_job_stop_show_at
Description Invalid stop show date.
How to fix Use a valid date with YYYY-MM-DD format.
   
XML_invalid_job_store_unit_count_range
Description Invalid store unit count range.
How to fix Use a valid unit count range.
   
XML_invalid_job_title
Description Invalid job title.
How to fix Use job title.
   
XML_invalid_job_travel_percentage_range
Description Invalid travel percentage range.
How to fix Use a valid percentage range, you can see valid percentages here: http://www.retailmanagercareers.com/jobs_valid_codes.php#travel_percentage.
   
XML_invalid_job_volume_responsibility_range
Description Invalid volume responsability range.
How to fix User a valid volume responsability range. You can see valid values here: http://www.retailmanagercareers.com/jobs_valid_codes.php#responsability_range.
   
XML_invalid_job_zip
Description Invalid zip code.
How to fix Use a valid zip code.
   
XML_invalid_listing_status
Description Invalid listing status.
How to fix Use a valid listing status, you can see valid values here: http://www.retailmanagercareers.com/jobs_valid_codes.php#listing_status.
   
XML_invalid_login_info
Description Invalid login info.
How to fix Check user name and password. Contact info@retailmanagercareers.com if the problem persists.
   
XML_invalid_operation
Description Invalid action.
How to fix Use a valid action. You can see valid actions here: http://www.retailmanagercareers.com/jobs_valid_codes.php#action.
   
XML_invalid_paid_option
Description Invalid paid option.
How to fix Use a valid paid option, you can see valid paid options here: http://www.retailmanagercareers.com/jobs_valid_codes.php#paid.
   
XML_invalid_poster_email
Description Invalid poster e-mail.
How to fix Use a valid poster e-mail.
   
XML_invalid_poster_name
Description Invalid poster name.
How to fix Use poster name.
   
XML_invalid_unique_id_job
Description Unique id job field cannot be empty.
How to fix A unique ID is required for each posted job. This will allow you to access this job posting at a later time.
   
XML_is_not_well_formed
Description XML is not formed correctly.
How to fix Check XML syntax and try again
   
XML_job_already_paid
Description Job has already been paid.
How to fix Use paid = 1. Credit will not be taken again.
   
XML_job_do_not_belong_2_company
Description Job does not belong to your company.
How to fix Check unique code. You can only update jobs posted by your company.
   
XML_job_education_level_invalid
Description Invalid education level.
How to fix Use a valid education level, you can see valid values here: http://www.retailmanagercareers.com/jobs_valid_codes.php#education_level.
   
XML_job_location_can_not_be_changed
Description Job location cannot be changed.
How to fix You must use the same city. The city cannot be changed after 6 months. You can see the limits here: http://www.retailmanagercareers.com/jobs_valid_codes.php#limits.
   
XML_job_logo_must_is_not_image
Description Job logo is not an image file.
How to fix You must use an image file.
   
XML_job_maximun_days_online
Description Number of posted days exceeds 90 days.
How to fix You can either change the begin show date to a later date or change the stop show date to an earler date. You can see limits here: http://www.retailmanagercareers.com/jobs_valid_codes.php#limits.
   
XML_job_not_found
Description Job not found.
How to fix You can only update jobs that belong to your company. Ensure that the unique id is correct for the job that you are trying to access.
   
XML_job_title_can_not_be_changed
Description Job title cannot be changed.
How to fix You must use the same job title. Job title cannot be changed after 6 months. You can see the limits here: http://www.retailmanagercareers.com/jobs_valid_codes.php#limits.
   
XML_new_job_stop_show_at_is_so_late
Description New stop show date exceeds limit.
How to fix Adjust stop show date to an earlier date. Jobs can be posted for a maximum of 90 days. You can check the limits here: http://www.retailmanagercareers.com/jobs_valid_codes.php#limits
   
XML_one_or_more_correct_answer_invalid
Description One or more correct pre-qualifier answers is invalid.
How to fix Use a valid option for tag, you can see correct answers here: http://ubuntu/dev/retail/jobs_valid_codes.php#correct_answer.
   
XML_one_or_more_eeo_questions_invalid
Description One or more EEO questions are invalid.
How to fix Use valid EEO question values, you can see valid values here: http://www.retailmanagercareers.com/jobs_valid_codes.php#eeo_question.
   
XML_one_or_more_job_benefit_invalid
Description One or more benefits are invalid.
How to fix Use a valid benefit option. You can see valid values here: http://www.retailmanagercareers.com/jobs_valid_codes.php#benefit_option.
   
XML_one_or_more_job_category_invalid
Description One or more job categories are invalid.
How to fix Use a valid job category, you can see valid job categories here: http://www.retailmanagercareers.com/jobs_valid_codes.php#job_category.
   
XML_one_or_more_job_type_invalid
Description One or more job types are invalid.
How to fix Use a valid job type, you can see valid job types here: http://www.retailmanagercareers.com/jobs_valid_codes.php#job_type.
   
XML_one_or_more_questions_invalid
Description One or more pre-qualifier questions are invalid.
How to fix Pre-qualifier question is empty, insert content into 'question' tag.
   
XML_one_or_more_question_position_invalid
Description One or more question positions are invalid.
How to fix Use float or integer value for tag.
   
XML_one_or_more_score_invalid
Description One or more scores are invalid.
How to fix Use positive float for tag.
   
XML_stop_date_is_older_than_begin_date
Description Stop show date is older than begin show date.
How to fix Adjust show dates.
   
XML_unique_company_id_job_already_exists
Description Unique job id already exists.
How to fix Change unique job id.
   

© Retail Manager Careers.com   |   Terms of Use   |   About Us   |   Contact Us   |   Site Map  |   Privacy Policy  |   Web Design