New Hire
Recommendation, 2007 April 15
Editor:
Kim Bartkus, HR-XML Consortium
Authors:
Romuald Restout, Humanuo
Contributors:
Alan Whitford, Abtech Partnership
Toby Shaw, Hewitt;
Kim Bartkus, HR-XML Consortium
Chuck Allen, HR-XML Consortium
Kathi Dolan, Manpower, Inc;
Jon Lehto, Monster;
Andreas Bolt, SAP;
Linda Larrivee, Ultimate Software;
Jorge O. Sanchez, Volt Information Sciences;
Copyright © 2007 HR-XML Consortium, Inc.
Abstract
This document describes the exchange of hire information between an Applicant Tracking System (ATS) and a Human Resources Management System (HRMS).
Table of Contents
2 Supported Business Processes
4 Implementation Considerations
4.3 EmploymentStartDate vs. FirstDayToWork
4.5 Overhead from Included Schemas
5 Appendix A - Document Version History
6 Appendix B – Related Documents
8 Appendix D – Reference Examples
The purpose of this project is to exchange information between the Applicant Tracking System (ATS) and a Human Resources Management System (HRMS).
The Employee Lifecycle is made up of several states and processes. Initially, a candidate demonstrates his/her interest by submitting a resume or candidate record. This may be a response to a job posting, a referral, or may be non-solicited. If an organization is interested in the individual, they may request assessments and background checks, and perform interviews. At the point an individual is offered and accepts a position, they become an employee.
The New Hire specification encompasses the data collected from the initial posting through the person becoming an employee.
Once employed, this information may be used to initiate the on-boarding process. For example, the employee’s workspace and equipment would be set up. Operations may issue security cards and computer passwords. Remuneration details may be sent to payroll and benefits enrollment. Training courses may be set up for the employee.
Please see the 1.4 Scope section for the items included in this specification. See 2 Supported Business Processes for details on the business process.
The objective of the New Hire specification is to provide schemas to support the closure of the recruiting process, i.e. the exchange of hire information between an ATS and an HRMS.
From an Information System perspective, candidate and employee concepts often are managed in two separate systems/applications.
Typical corporate information systems today are composed, among others, of:
· A staffing system or an Applicant Tracking System (ATS) that manages the pre-hire HR processes such as prescreening, screening, offer, etc.
· A Human Resources Management System (HRMS) that manages employees and post-hire HR processes, such as payroll, benefits, stock options, etc.
Currently HRMS systems, customer systems, and Applicant Tracking systems are unable to universally exchange information.
This leaves HR partners with the burden of keying data to multiple systems or writing programs to facilitate a particular vendor.
The new-hire information exchange is critical since it is the bridge between pre and post-hire processes. It closes pre-hire processes and triggers many post-hire ones.
It is also critical in the sense it aggregates the information that has been harnessed during the recruiting process: candidate and resume information, background check and assessment results.
This information will thereafter be used throughout the employee lifecycle: performance management, learning and development, career development, and succession planning.
Hence it is important that this information be accurate and comprehensive.
When used in this document, New Hire refers to the one-time event where a candidate is offered a job, accepts it, and becomes an employee or continues in a new role for a specific company in a given position. This also refers to a re-hire and transfer.
Within this document, recruiting refers to the steps taken to identify a candidate, proceed through the pre-screening, screening and interviews, through hiring an individual.
This term refers to any assessment and background checking performed on an individual during the recruiting process.
On-boarding specifies the actions taken once an individual has accepted a position. These include, but are not limited to payroll, benefits, security, training, orientation, and procurement.
The pre-hire processes have already been the target of several HR-XML specifications:
· Staffing Industry Data Exchange Standards (SIDES) tackles the exchange of data between staffing suppliers (companies), staffing customers and intermediaries
· Staffing Exchange Protocol (SEP) tackles the exchange of data between staffing suppliers (companies) and job advertisement companies (job boards)
The post-hire processes also have already been the target of several HR-XML specifications:
· Indicative Data describes basic employee census data (sourced from payroll or HRIS systems) that is supplied by an employer to a third-party administrator or business process outsourcer (BPO)
· Enrollment supports the transfer of benefits enrollment data between organizations
· PayrollInstruction is designed to enable the submission of payroll deduction requests and other instructions to an organization that processes payrolls
Some other specifications are cross-process:
· Assessments is designed to order assessments and receive assessment results between an organization and an assessment provider
· BackgroundCheck is designed to order background checks and receive results between an organization and a background check provider
· Competencies is designed for describing competencies.
Thus a design requirement for the New Hire specification is to extensively reuse existing components that have already been defined.
Essentially, New Hire contains the information from the Applicant Tracking System that is relevant to the ‘employee’ status after on-boarding.
· Data found in an Applicant Tracking System.
· Data used in post hire environment. For example, drug screening, skills, security checks.
· Supports new hire, re-hire and internal recruiting.
· Although these processes are described in the overview section for clarity, the data exchange is handled elsewhere and is out of scope for this specification.
· Candidates not hired
· Data provided for benefit or payroll outsourcers (Indicative Data).
The following two diagrams show the recruiting process, which leads up to the new hire and the on-boarding process that is initiated after the new hire.
1. The recruiting process starts when a position becomes vacant. This may be due to an employee resigning, taking a leave of absence, or an increase in the headcount.
2. A recruiter creates a requisition in its Applicant Tracking System that will convey the information about the position in the context of the recruiting activities.
3. The requisition goes through an approval process that may involve several persons. Whenever a person rejects the requisition, the entire recruiting process is stopped until the requisition is finally approved.
4. The recruiter or a specialized sourcer posts the requisition to job advertisers such as job boards.
5.
At some point in time, a candidate applies to the position, and goes
through the entire application process, providing information on his/her
experience, skills, location, etc.
This information is then passed back to the ATS.
6. The selection process then starts. Prescreening is initiated and candidates are filtered based on the information they provided during the application process.
7. Candidates that pass the prescreening are screened (i.e. their competencies are assessed and their background is checked) and interviewed.
8. Eventually a candidate passes all steps and is offered the position. The job offer includes some specific information on the terms of the employment proposition: a description of the position, the description of the compensation and the benefits plan.
9. Once the candidate accepts the offer, the process is considered a hire, and the the HRMS is notified.
Every step of this process collects some specific information on the future employee and on the position.

Figure 1 - Recruiting Process

Figure 2 - Post Hire processes
The NewHire schema contains five sections, including an area for any supporting documentation and proprietary data (User Area). EmployeeInfo contains information specific to the employee. ApplicationInfo contains data pertinent to the application, such as the application source, screening results, and interviews. The PositionInfo contains information about the offer, organization, and manager. Please see diagrams and definitions for further information.

|
Elements and Attributes [Global types listed alphabetically in following table.] |
ContentModel* |
Definition |
|
NewHire |
- NewHireType - (1/1) |
Contains information about the New Hire. |
|
/NewHire/TypeOfHire |
- TypeOfHireType - S (1/1) |
Describes the type of hire. |
|
/NewHire/TypeOfHire/ |
- TypeOfHireEnumType - C (0/1) |
A list of standard values. |
|
/NewHire/TypeOfHire/ |
- xsd:string - C (0/1) |
A string used to extend a list of non-standard values. |
|
/NewHire/ |
PersonName - PersonNameType
- S (1/1) |
A collection of employee-related information about an individual. |
|
/NewHire/ |
ApplicationHistory - [complexType]
- S (0/1) |
Contains information available on the application.
|
|
/ NewHire/ |
ReferenceInfo - [complexType]
- S (1/1) |
Contains information about the position. |
|
|
xsd:restriction base: xsd:string [Enumerations]: NewHire, Rehire, Transfer |
Globally scoped data type. See element or attribute declaration for definition. |
|
/ |
StandardValue - TypeOfHireEnumType
- C (0/1) |
Globally scoped data type. See element or attribute declaration for definition. |

|
Elements and Attributes [Global types listed alphabetically in following table.] |
ContentModel* |
Definition |
|
/ |
PersonName - PersonNameType
- S (1/1) |
A collection of employee-related information about an individual. |
|
/ EmployeeInfo/ |
- PersonNameType - S (1/1) |
The name of a person. |
|
/ EmployeeInfo/ |
- EntityIdType - S (0/1) |
A unique id for the applicant. |
|
/ EmployeeInfo/ |
- EntityIdType - S (0/1) |
A unique identifier for an employee. |
|
/ EmployeeInfo/ |
- EntityIdType - S (0/*) |
An Id assigned to the employee while previously employed with the same organization. |
|
/ EmployeeInfo/ |
- ContactMethodType - S (0/*) |
Defines the methods to contact a person or
organizations. |
|
/ EmployeeInfo/ |
- ContactInfoType - S (0/*) |
Contains information necessary to contact a person
for emergency purposes. |
|
/ EmployeeInfo/ |
- PersonDescriptorsType - S (0/1) |
Contains legal, biological, and demographic descriptors for a person. |
|
/ EmployeeInfo/ |
- EducationHistoryType - S (0/1) |
A list of the educational institutions at which a
person has received training. |
|
/ EmployeeInfo/ |
- EmploymentHistoryType - S (0/1) |
A container for previous positions a person held. |
|
/ EmployeeInfo/ |
xsd:extension base: AssociationType |
Contains information about an individual's participation in a professional or industry group or association. |
|
/ EmployeeInfo/ Association/ |
- EntityIdType - S (1/1) |
Unique identifier for the organization. It may be an internal identifier assigned by the sender. |

|
Elements and Attributes [Global types listed alphabetically in following table.] |
ContentModel* |
Definition |
|
/ |
ApplicationHistory - [complexType]
- S (0/1) |
Contains information available on the application.
|
|
/ ApplicationInfo/ |
HiringProcessActivity - ActivityType
- S (1/*) |
Contains the aggregate of all past events that occurred during a particular application process. |
|
/ ApplicationInfo/ ApplicationHistory/ |
- ActivityType - S (1/*) |
Specifies a particular event or activity that
occurs as a part of the hiring process. |
|
/ ApplicationInfo/ ApplicationHistory/
HiringProcessActivity/ |
- xsd:string - S (1/1) |
Further defines the associated element in the context provided. |
|
/ ApplicationInfo/ ApplicationHistory/
HiringProcessActivity/ |
PersonName - PersonNameType
- S (0/1) |
Contains information about the person performing
the activity. |
|
/ ApplicationInfo/ ApplicationHistory/
HiringProcessActivity/ ActivityPerformer/ |
- PersonNameType - S (0/1) |
The name of a person. |
|
/ ApplicationInfo/ ApplicationHistory/
HiringProcessActivity/ ActivityPerformer/ |
- EntityIdType - S (0/1) |
A unique identifier for a person. |
|
/ ApplicationInfo/ ApplicationHistory/ HiringProcessActivity/
ActivityPerformer/ |
- xsd:string - S (0/1) |
A function of a person or entity within a given context. |
|
/ ApplicationInfo/ ApplicationHistory/
HiringProcessActivity/ ActivityPerformer/ |
- xsd:string - S (0/1) |
Describes the contextual information relating to a group of elements. |
|
/ ApplicationInfo/ ApplicationHistory/
HiringProcessActivity/ |
- AnyDateTimeType - S (0/1) |
A date within the given context. |
|
/ ApplicationInfo/ ApplicationHistory/
HiringProcessActivity/ |
- xsd:string - S (0/1) |
Specifies the outcome resulting from an activity. |
|
/ ApplicationInfo/ ApplicationHistory/ |
- xsd:string - S (0/1) |
Describes the contextual information relating to a group of elements. |
|
/ ApplicationInfo/ |
AssessmentResult - AssessmentResultType
- S (0/*) |
A textual definition of the screening results. |
|
/ ApplicationInfo/ ScreeningResults/ |
- AssessmentResultType - S (0/*) |
Container for AssessmentResult schema, which is designed to hold data necessary to convey information on the results of the assessment. |
|
/ ApplicationInfo/ ScreeningResults/ |
- ScreeningReportType - S (0/*) |
Contains results from a specific background check.
|
|
/ ApplicationInfo/ ScreeningResults/ |
- xsd:string - S (0/1) |
Recorded outcome(s) of a medical test, study, examination or procedure. |
|
/ ApplicationInfo/ |
countryCode - CountryCodeType
- |
Indicates whether the individual being hired entitles the hiring company to tax credits or other benefits through government or other 3rd party entities. |
|
/ ApplicationInfo/ TaxCreditInfo/ |
- CountryCodeType - |
Contains the ISO 3166-1 two-character country
code. |
|
/ ApplicationInfo/ TaxCreditInfo/ |
- xsd:string - S (1/1) |
The limits or territory within which authority may be exercised. |
|
/ ApplicationInfo/ TaxCreditInfo/ |
- xsd:boolean - S (1/1) |
Indicates if the associated element applies to this transaction. |
|
/ ApplicationInfo/ TaxCreditInfo/ |
- xsd:string - S (0/1) |
The name of the program that entitles the company to tax credits. |
|
/ ApplicationInfo/ TaxCreditInfo/ |
xsd:extension base: xsd:string |
The monetary value of the associated item. |
|
/ ApplicationInfo/ TaxCreditInfo/ Amount/ |
- CurrencyCodeType - |
A three-letter code identifying the currency of a
monetary amount. |
|
/ ApplicationInfo/ TaxCreditInfo/ |
- xsd:string - S (0/1) |
Describes the contextual information relating to a specific element. |
|
/ ApplicationInfo/ |
FormId - EntityIdType - S (0/1) |
Provides details on visa, citizenship, or other requirements related to legal eligibility to hold the job/position. |
|
/ ApplicationInfo/ |
- SupplierType - S (0/1) |
Reference information about the person or entity
that is acting on behalf of a candidate. |
|
|
Type - xsd:string - S (1/1) |
|

|
Elements and Attributes [Global types listed alphabetically in following table.] |
ContentModel* |
Definition |
|
/ |
countryCode - CountryCodeType
- |
Indicates whether the individual being hired entitles the hiring company to tax credits or other benefits through government or other 3rd party entities. |
|
/ TaxCreditInfo/ |
- CountryCodeType - |
Contains the ISO 3166-1 two-character country
code. |
|
/ TaxCreditInfo/ |
- xsd:string - S (1/1) |
The limits or territory within which authority may be exercised. |
|
/ TaxCreditInfo/ |
- xsd:boolean - S (1/1) |
Indicates if the associated element applies to this transaction. |
|
/ TaxCreditInfo/ |
- xsd:string - S (0/1) |
The name of the program that entitles the company to tax credits. |
|
/ TaxCreditInfo/ |
xsd:extension base: xsd:string |
The monetary value of the associated item. |
|
/ TaxCreditInfo/ Amount/ |
- CurrencyCodeType - |
A three-letter code identifying the currency of a
monetary amount. |
|
/ TaxCreditInfo/ |
- xsd:string - S (0/1) |
Describes the contextual information relating to a specific element. |

|
Elements and Attributes [Global types listed alphabetically in following table.] |
ContentModel* |
Definition |
|
/ |
FormId - EntityIdType - S (0/1) |
Provides details on visa, citizenship, or other requirements related to legal eligibility to hold the job/position. |
|
/ WorkEligibilityInfo/ |
- EntityIdType - S (0/1) |
An identifier for the form. |
|
/ WorkEligibilityInfo/ |
- EntityIdType - S (0/1) |
A unique identifier for a particular document. |
|
/ WorkEligibilityInfo/ |
- xsd:string - S (0/1) |
The name of a contract or agreement. |
|
/ WorkEligibilityInfo/ |
OrganizationName - xsd:string
- S (0/1) |
Contains information about the entity that performed the validation. |
|
/ WorkEligibilityInfo/ VerificationInfo/ |
- xsd:string - S (0/1) |
The name by which an organization or enterprise is known as established under the laws of a country, state, province or ruling governmental body for the purpose of conducting business transactions. |
|
/ WorkEligibilityInfo/ VerificationInfo/ |
- xsd:string - S (0/1) |
The status of the associated item. If the status isn't specified, the implementer may place the record in whatever status seems appropriate given the context of the data. |
|
/ WorkEligibilityInfo/ VerificationInfo/ |
- LocalDateType - S (0/1) |
A date within the given context. |
|
/ WorkEligibilityInfo/ VerificationInfo/ |
- PersonNameType - S (00/1) |
The name of a person. |
|
/ WorkEligibilityInfo/ VerificationInfo/ |
- EntityIdType - S (0/1) |
A unique identifier for a person. |
|
/ WorkEligibilityInfo/ |
- xsd:string - S (0/1) |
Specifies the issuing authority of the associated
element. |
|
/ WorkEligibilityInfo/ |
- xsd:boolean - S (0/1) |
Indicates if the document was signed by the candidate. |
|
/ WorkEligibilityInfo/ |
- xsd:string - S (0/1) |
Describes the contextual information relating to a group of elements. |

|
Elements and Attributes [Global types listed alphabetically in following table.] |
ContentModel* |
Definition |
|
/ |
ReferenceInfo - NewHireReferenceInfoType
- S (1/1) |
Contains information about the position. |
|
/ PositionInfo/ |
- NewHireReferenceInfoType
- S (1/1) |
Contains reference information for the associated element. |
|
/ PositionInfo/ ReferenceInfo/ |
- EntityIdType - S (0/1) |
Unique identifier for a requisition. |
|
/ PositionInfo/ ReferenceInfo/ |
- EntityIdType - S (0/1) |
Unique identifier for a staffing order. |
|
/ PositionInfo/ ReferenceInfo/ |
- EntityIdType - S (0/1) |
Reference to a uniquely identifiable position. |
|
/ PositionInfo/ ReferenceInfo/ |
- EntityIdType - S (0/1) |
Uniquely identifies a job within an organization. |
|
/ PositionInfo/ ReferenceInfo/ |
- EntityIdType - S (0/*) |
Contains an identifier not previously specified. |
|
/PositionInfo/
ReferenceInfo/ |
- EntityIdType - S (0/1) |
Unique identifier for search criteria. |
|
/PositionInfo/
ReferenceInfo/ |
- EntityIdType - S (0/1) |
Unique identifier for search results. |
|
/ PositionInfo/ |
NegotiatedPositionTitle - xsd:string
- S (0/1) |
Contains information about the job offer. |
|
/ PositionInfo/ |
- OrganizationalUnitType - S (0/*) |
Contains information about a sub-entity or entities within an organization that have no unique legal identification or designation. |
|
/ PositionInfo/ |
role - xsd:string - |
Contains information about the manager. |
|
/ PositionInfo/ ManagerInfo/ |
- xsd:string - |
A function of a person or entity within a given context. |
|
/ PositionInfo/ ManagerInfo/ |
- ContactInfoType - S (0/1) |
Contains information to contact a person or
entity. |
|
/ PositionInfo/ ManagerInfo/ |
- EntityIdType - S (0/1) |
A unique identifier for the manager. |
|
/ PositionInfo/ |
- xsd:boolean - S (0/1) |
A Boolean value that specifies if the person is
concurrently holding more than one job. |

|
Elements and Attributes [Global types listed alphabetically in following table.] |
ContentModel* |
Definition |
|
/ |
NegotiatedPositionTitle - xsd:string
- S (0/1) |
Contains information about the job offer. |
|
/ OfferInfo/ |
- xsd:string - S (0/1) |
The position title negotiated at the time of the offer. |
|
/ OfferInfo/ |
- xsd:string - S (0/1) |
The position description negotiated at the time of the offer. |
|
/ OfferInfo/ |
OfferedBy - [complexType]
- S (0/1) |
Contains information about who made the job offer and when it was made. |
|
/ OfferInfo/ OfferMade/ |
PersonName - [see
include/import] - S (0/1) |
Contains information about the person who made the job offer. |
|
/ OfferInfo/ OfferMade/ OfferedBy/ |
- PersonNameType - S (0/1) |
The name of a person. |
|
/ OfferInfo/ OfferMade/ OfferedBy/ |
- EntityIdType - S (0/1) |
A unique identifier for a person. |
|
/ OfferInfo/ OfferMade/ |
- LocalDateType - S (0/1) |
Specifies the date the job offer was made. |
|
/ OfferInfo/ |
- LocalDateType - S (0/1) |
Specifies the date the job offer was accepted. |
|
/ OfferInfo/ |
- LocalDateType - S (1/1) |
The date the employment contract starts. |
|
/ OfferInfo/ |
- LocalDateType - S (0/1) |
The date the assignment is expected to end. |
|
/ OfferInfo/ |
- AnyDateTimeType - S (0/1) |
The date and time (optional) the person first reports to work. |
|
/ OfferInfo/ |
BasePay - xsd:decimal - S (0/1) |
A collection of information about remuneration for a particular job or position. |
|
/ OfferInfo/ RemunerationInfo/ |
xsd:extension base: xsd:decimal |
Describes the monetary pay structure considered standard for a particular job or position. |
|
/ OfferInfo/ RemunerationInfo/ BasePay/ |
- CurrencyCodeType - |
A three-letter code identifying the currency of a
monetary amount. |
|
/ OfferInfo/ RemunerationInfo/ BasePay/ |
- FrequencyType - |
The interval or increment in which an event is
measured. |
|
/ OfferInfo/ RemunerationInfo/ |
xsd:extension base: xsd:decimal |
Describes the pay structure considered additional, flexible or atypical for a particular job or position. |
|
/ OfferInfo/ RemunerationInfo/ OtherPay/ |
- CurrencyCodeType - |
A three-letter code identifying the currency of a
monetary amount. |
|
/ OfferInfo/ RemunerationInfo/ OtherPay/ |
- FrequencyType - |
The interval or increment in which an event is
measured. |
|
/ OfferInfo/ RemunerationInfo/ OtherPay/ |
- OtherPayTypeTypes - |
Further defines the associated element in the
context provided. |
|
/ OfferInfo/ RemunerationInfo/ |
- BenefitsType - S (0/1) |
Describes other forms of compensation or
remuneration a person might receive. |
|
/ OfferInfo/ |
- WorkShiftScheduleType - S (0/*) |
Work shift as it pertains to a particular work engagement. |
|
/ OfferInfo/ |
- EmploymentLevelEnumType - S (0/1) |
Container to indicate full-time or part-time employment. |
|
/ OfferInfo/ |
- ResourceRelationshipEnumType - S (0/1) |
Indicates whether the worker is an employee or
sub-contractor. |
|
/ OfferInfo/ |
- EmploymentTermType - S (0/1) |
Expresses the classification of the employment
contract. |
Human resources data, by its very nature, is personal data. The laws of many jurisdictions as well as codes of fair information practice require organizations to handle personal data in a way that protects individuals from loss of privacy.
The data exchange specifications developed by the HR-XML Consortium are designed to be useful across many jurisdictions and within a variety of business contexts. It is not feasible for the HR-XML Consortium to develop specific privacy guidance for every jurisdiction or business context in which the Consortium's specifications might be implemented. When implementing data exchanges using the HR-XML Consortium's data definitions (or, for that matter, using any other type of data exchange mechanism), organizations are advised to examine the privacy protections that may be required under applicable law and codes of fair information practice.
For information on protecting personal data, general references include: European Union Data Protection Directive (95/46/EC); the Association Computing Machinery Code of Ethics (1992); Canadian Standards Association Model Code for the Protection of Personal Information (1995 – PIPEDA); and U.S.-EU Safe Harbor Principles and FAQs (2000).
If information changed or was incorrect in the original New Hire data exchange, the recommendation is to resend the entire record with the corrected data. For example, John originally expected to start working for Company B on June 15. However, his current employer (Company A) didn’t require 2 weeks notice, so John was able to start work on June 1. The first New Hire transaction showed John’s expected start date as June 15. A second ‘full’ New Hire transaction would need to be sent with the June 1 expected start date.
This recommendation also applies to incorrect data. For instance, if an erroneous government id was sent in the original New Hire transaction, then a full xml file would be re-sent with the correct government id.
Please note that this solution applies to the current version. It is anticipated that a future version may provide alternatives for changed and incorrect data exchanges, without the need to resend the entire transaction.
The offer information includes two dates that are slightly different: EmploymentStartDate and FirstDayToWork. The EmploymentStartDate is the date the employment contract starts, whereas the FirstDayToWork is the date/time the person is expected to report to work.
There are several cases where those dates might differ, including, but not limited to, the following examples:
In some countries, employment starts on the 1st or 15th day of the month. When the 1st or 15th of the month is a non-worked day (perhaps Saturday or Sunday), the date the employment starts will differ from the actual first day of work.
<OfferInfo>
<EmploymentStartDate>2005-01-15</EmploymentStartDate>
<FirstDayToWork>2005-01-17</FirstDayToWork>
</OfferInfo>
A person might accept an offer, while
his/her vacations were already scheduled. In this case, the person would
negotiate to start his new employment with vacations.
<OfferInfo>
<EmploymentStartDate>2005-02-07</EmploymentStartDate>
<FirstDayToWork>2005-01-14</FirstDayToWork>
</OfferInfo>
After an interview and selection process, a person has been hired by a placement agency or directly by a company. In order to transfer the person’s hire information from an Applicant Tracking System (ATS) to the hiring company’s Human Resources Information System (HRIS), eligibility information must be provided to begin an official on-boarding process.
Eligibility information encompasses two primary types, and it must be part of a NewHire package. One type includes eligibility to work in the country where the person will perform the work. The second covers security clearance eligibility to perform a job with sensitive or protected data.
Within the NewHire HR-XML transaction package are the WorkEligibilityInfo elements that meet these requirements. Three instances where eligibility is detailed appear below.
In the case of employment eligibility, an XML package must represent the summary and status of a document that demonstrates an employer confirmed a person can legally work in the country where the work is to be performed. This form is known as the I-9 in the United States. Eligibility in the United Kingdom is also established and confirmed using forms issued by government that have a form name or identification as well as a number specific to the document instance. Unlike an I-9, a Right of Abode, Right to Work, Work Permit and Citizenship in the EEU have form names and a specific number when issued. Cases for each follow.
<!-- UK Eligibility Right of Abode Example -->
<ApplicationInfo>
<WorkEligibilityInfo>
<FormId>
<IdValue>Right of Abode</IdValue>
</FormId>
<DocumentId>
<IdValue>ROA-7895699</IdValue>
</DocumentId>
<DocumentName>Right of Abode</DocumentName>
<VerificationInfo>
<Status>Verified by Employer</Status>
<Date>2005-05-05</Date>
<PersonName>
<FormattedName>Joe Blogs</FormattedName>
</PersonName>
<PersonId>
<IdValue>32-89636-9</IdValue>
</PersonId>
</VerificationInfo>
<IssuingAuthority>UKDOI</IssuingAuthority>
<IsDocumentSignedByCandidate>true</IsDocumentSignedByCandidate>
<Comments>Document is photocopied and the copy is filed with application documents.</Comments>
</WorkEligibilityInfo>
<!-- UK Eligibility Right to Work Example -->
<WorkEligibilityInfo>
<FormId>
<IdValue>Right to Work</IdValue>
</FormId>
<DocumentId>
<IdValue>RTW-12345</IdValue>
</DocumentId>
<DocumentName>Right to Work</DocumentName>
<VerificationInfo>
<Status>Verified by Employer</Status>
<Date>2005-05-08</Date>
<PersonName>
<FormattedName>Joe Blogs</FormattedName>
</PersonName>
<PersonId>
<IdValue>32-89636-9</IdValue>
</PersonId>
</VerificationInfo>
<IssuingAuthority>UK Home Office</IssuingAuthority>
<IsDocumentSignedByCandidate>true</IsDocumentSignedByCandidate>
<Comments>Document is photocopied and the copy is filed with application documents.</Comments>
</WorkEligibilityInfo>
<!-- US I9 Eligibility Example -->
<WorkEligibilityInfo>
<FormId>
<IdValue>I9</IdValue>
</FormId>
<DocumentName>I-9 Proof of Employment Eligibility</DocumentName>
<VerificationInfo>
<Status>Verified by Recruiter</Status>
<Date>2005-05-05</Date>
<PersonName>
<FormattedName>John Doe</FormattedName>
</PersonName>
<PersonId>
<IdValue>EMPLID-456-336622</IdValue>
</PersonId>
</VerificationInfo>
<IssuingAuthority>US DOJ</IssuingAuthority>
<IsDocumentSignedByCandidate>true</IsDocumentSignedByCandidate>
<Comments>Hard copy filed under employee name</Comments>
</WorkEligibilityInfo>
Security clearances are of different levels. Each may have multiple and varied requirements. The WorkEligibilityInfo schema is designed to represent each scenario. When this section is filled for security requirements, the schema contains the type of document that is being captured and signature statuses. It also supplies data that indicate the type of document that was reviewed and the issuing authority. In many cases, a document form number is also supplied. The SupportingMaterials section can be used to describe the system or method for tracking the forms. SupportingMaterials can also be used to describe the agency that provided the service. Often in the U.S., the Defense Security Services Department provides the investigative services through a web-based application to complete the clearances.
<!-- US Security Example -->
<WorkEligibilityInfo>
<FormId>
<IdValue>SS-77-A</IdValue>
</FormId>
<DocumentId>
<IdValue>890-89-998969</IdValue>
</DocumentId>
<DocumentName>Top Secret Security Clearance</DocumentName>
<VerificationInfo>
<Status>Completed by Candidate</Status>
<Date>2005-05-05</Date>
<PersonName>
<FormattedName>Jeanine Lewis</FormattedName>
</PersonName>
<PersonId>
<IdValue>TR-561203</IdValue>
</PersonId>
</VerificationInfo>
<IssuingAuthority>Defense Security Services</IssuingAuthority>
<IsDocumentSignedByCandidate>true</IsDocumentSignedByCandidate>
<SupportingMaterials>
<dc:title>Link to Defense Security Services</dc:title>
<dc:format>text/html</dc:format>
<ReferenceInfo>
<InternetWebAddress>https://dss.gov/verisystem</InternetWebAddress>
</ReferenceInfo>
</SupportingMaterials>
</WorkEligibilityInfo>
The New Hire schema has built-in flexibility. Since most elements are optional, the schema can be used to structure a thin message that simply ties a candidate’s information to a position, or, if desired, it can be used to handle a very rich set of information gathered during the recruiting process (e.g., background check and assessment results). To facilitate the latter case, the New Hire schema directly includes HR-XML’s BackgroundReports and AsessmentResults schemas.
While the direct include of the separate BackgroundReports and AsessmentResults schemas may be useful to some implementers, it may provide complexity and unnecessary processing overhead for others. For example, the output from code generation tools is likely to be much larger and more complex with the included schemas.
Rather than using the directly included schemas, some implementers may find it easier to associate supplemental data (such as BackgroundReports and AssessmentResults) in a way that creates less processing overhead. For example, one approach would be to remove the AssessmentResultType and ScreeningReportType from the New Hire schema and to simply send the associated reports as attachments. The NewHire schema uses HR-XML’s SupportingMaterialsType, which offers a way to provide a manifest of such attachments.
|
Date |
Description |
|
2005-Jan-20 |
Draft |
|
2005-Mar-04 |
Updated definition tables, diagrams, overview, scope and appendix B. |
|
2005-Mar-15 |
Updated sections 1, 2, and 4. |
|
2005-May-02 |
Updated diagrams and hrdd tables |
|
2005-Nov-29 |
Remove 'Info' from NewHireInfo and NewHireInfoType Make TypeOfHire element to be of type "TypeOfHireType" Replace TypeOfHire extension with new method Change enumerations to UpperCamelCase |
|
2006-Feb-28 |
Approved by Consortium |
|
2006-Nov-15 |
Named anonymous type for within ReferenceInfo element to NewHireReferenceInfoType. Added locally scoped elements SearchCriteriaId and SearchResultId (both of type EntityIdType). |
|
2007-April-15 |
Approved by Consortium |
|
Issue |
Resolution |
|
How do we handle when information changed or was incorrect in the original New Hire data exchange? |
Currently, we recommend the full file be re-sent with the corrected data. However, in a future release we will review alternatives. Possibly a solution similar to the transaction type used in Enrollment. |
John Doe is currently employed part-time with UPS. He responded to Acme Corporations job posting on www.SuperrrBoard.com, a popular Job Board/Applicant Tracking System (ATS) system used by Acme and other large corporations, where he was able to enter his resume, employment history, and other personal and background information.
Acme recruiter, Harry D. Recruit, reviewed numerous resumes and contacted John, then proceeded with multiple interviews, screenings, and other hiring exercises to ensure that John was a good fit for the company. This entire process was tracked and recorded via the ATS system.
On May 9th, 1999 Harry offered John
a position which he quickly accepted. John's intended start date was
scheduled for May 15th, 1999. SuperrrBoard promptly transmitted the NEW HIRE
information to Acme's HRMS system using HR-XML's New Hire Schema.
Example Comments:
This is a typical NEW HIRE
message between an ATS and an HRMS system. This message initiates the transfer
of the new hire information to the HRMS eliminating the re-keying of employee
information entered during the hiring process.
<NewHire>
<TypeOfHire>
<StandardValue>NewHire</StandardValue>
</TypeOfHire>
<EmployeeInfo>
<PersonName>
<GivenName>John</GivenName>
<FamilyName>Doe</FamilyName>
</PersonName>
<ApplicantId idOwner="SuperrrBoard">
<IdValue name="candidateId">8885533</IdValue>
</ApplicantId>
<ContactMethod>
<Use>personal</Use>
<Location>home</Location>
<WhenAvailable>Nights and Weekends</WhenAvailable>
<Telephone>
<FormattedNumber>847-222-9500</FormattedNumber>
</Telephone>
<Mobile>
<FormattedNumber>847-693-4500</FormattedNumber>
</Mobile>
<InternetEmailAddress>www.JDOE@GMAIL.com</InternetEmailAddress>
<PostalAddress type="streetAddress">
<CountryCode>US</CountryCode>
<PostalCode>60150</PostalCode>
<Region>IL</Region>
<Municipality>Bartlet</Municipality>
<DeliveryAddress>
<AddressLine>567 North Grove Ave</AddressLine>
</DeliveryAddress>
</PostalAddress>
</ContactMethod>
<EmergencyContact>
<PersonName>
<FormattedName>String</FormattedName>
<GivenName>Sally</GivenName>
<FamilyName>Doe</FamilyName>
</PersonName>
<ContactMethod>
<Use>business</Use>
<Location>office</Location>
<WhenAvailable>Normal Business Hours</WhenAvailable>
<Telephone>
<FormattedNumber>847-777-8700</FormattedNumber>
</Telephone>
</ContactMethod>
</EmergencyContact>
<PersonDescriptors>
<LegalIdentifiers>
<PersonLegalId validFrom="notKnown" validTo="notKnown" idOwner="SSA" countryCode="US" jurisdiction="Country" issuingRegion="US" documentType="Social Security Card" idSource="">
<IdValue name="SSN">123456789</IdValue>
</PersonLegalId>
<PersonLegalId validFrom="1998-07-01" validTo="2003-07-01" idOwner="ILDOT" countryCode="US" jurisdiction="State" issuingRegion="IL" documentType="Drivers License">
<IdValue name="ilDriversLicense">11155558886315</IdValue>
</PersonLegalId>
<VisaStatus countryCode="US">Active</VisaStatus>
<Citizenship>US</Citizenship>
<Residency>US</Residency>
</LegalIdentifiers>
<DemographicDescriptors>
<Race>Caucasian</Race>
<Nationality>American</Nationality>
<MaritalStatus>Married</MaritalStatus>
</DemographicDescriptors>
<BiologicalDescriptors>
<DateOfBirth>1975-06-07</DateOfBirth>
<GenderCode>1</GenderCode>
</BiologicalDescriptors>
</PersonDescriptors>
<EducationHistory>
<SchoolOrInstitution schoolType="college">
<SchoolName>University of Illinois</SchoolName>
<School type="prior">
<SchoolId idOwner="Acme">
<IdValue>5423</IdValue>
</SchoolId>
</School>
<Degree degreeType="bachelors" graduatingDegree="graduating">
<DegreeDate>
<AnyDate>1998-12-15</AnyDate>
</DegreeDate>
<DegreeMajor>
<ProgramId idOwner="Acme">
<IdValue>120</IdValue>
</ProgramId>
<Name>Computer Science</Name>
</DegreeMajor>
<DegreeMinor>
<ProgramId idOwner="Acme">
<IdValue>340</IdValue>
</ProgramId>
<Name>Business</Name>
</DegreeMinor>
<DatesOfAttendance studentInGoodStanding="true">
<StartDate>
<AnyDate>1996-09-01</AnyDate>
</StartDate>
<EndDate>
<AnyDate>1998-12-15</AnyDate>
</EndDate>
</DatesOfAttendance>
</Degree>
</SchoolOrInstitution>
</EducationHistory>
<EmploymentHistory>
<EmployerOrg>
<EmployerOrgName>UPS</EmployerOrgName>
<EmployerContactInfo contactType="directSupervisor">
<PersonName>
<GivenName>Jim</GivenName>
<FamilyName>Smith</FamilyName>
</PersonName>
<ContactMethod>
<Use>business</Use>
<Location>office</Location>
<WhenAvailable>Normal Business Hours</WhenAvailable>
<Telephone>
<FormattedNumber>815-458-7896</FormattedNumber>
</Telephone>
<PostalAddress type="streetAddress">
<CountryCode>US</CountryCode>
<PostalCode>60078</PostalCode>
<Region>IL</Region>
<Municipality>Buffalo Grove</Municipality>
<DeliveryAddress>
<AddressLine>1234 Hicks Road</AddressLine>
</DeliveryAddress>
</PostalAddress>
</ContactMethod>
</EmployerContactInfo>
<PositionHistory positionType="directHire" currentEmployer="true">
<Title>Package Sorter</Title>
<OrgName organizationType="branch">
<OrganizationName>Palatine</OrganizationName>
</OrgName>
<Description>Sort Packages by zipcode</Description>
<StartDate>
<AnyDate>1998-11-15</AnyDate>
</StartDate>
</PositionHistory>
</EmployerOrg>
</EmploymentHistory>
</EmployeeInfo>
<ApplicationInfo>
<ApplicationHistory>
<HiringProcessActivity>
<Type>Review Resume</Type>
<ActivityPerformer>
<PersonName>
<GivenName>Harrry</GivenName>
<FamilyName>Recruit</FamilyName>
</PersonName>
<PersonId idOwner="Acme">
<IdValue>7832</IdValue>
</PersonId>
<Role>Recruiter</Role>
</ActivityPerformer>
<Date>1999-05-01</Date>
<ActivityResults>Passed Initial Screening</ActivityResults>
</HiringProcessActivity>
<HiringProcessActivity>
<Type>Conduct Interview</Type>
<ActivityPerformer>
<PersonName>
<GivenName>Harrry</GivenName>
<FamilyName>Recruit</FamilyName>
</PersonName>
<PersonId idOwner="Acme">
<IdValue>7832</IdValue>
</PersonId>
<Role>Recruiter</Role>
</ActivityPerformer>
<ActivityPerformer>
<PersonName>
<GivenName>Sally</GivenName>
<FamilyName>Smith</FamilyName>
</PersonName>
<PersonId idOwner="Acme">
<IdValue>8436</IdValue>
</PersonId>
<Role>Hiring Manager</Role>
</ActivityPerformer>
<Date>1999-05-06</Date>
<ActivityResults>Very Competant. Make offer</ActivityResults>
</HiringProcessActivity>
<HiringProcessActivity>
<Type>Submit Offer</Type>
<ActivityPerformer>
<PersonName>
<GivenName>Harrry</GivenName>
<FamilyName>Recruit</FamilyName>
</PersonName>
<PersonId idOwner="Acme">
<IdValue>7832</IdValue>
</PersonId>
<Role>Recruiter</Role>
</ActivityPerformer>
<Date>1999-05-06</Date>
</HiringProcessActivity>
<HiringProcessActivity>
<Type>Offer Accepted</Type>
<ActivityPerformer>
<PersonName>
<GivenName>Harrry</GivenName>
<FamilyName>Recruit</FamilyName>
</PersonName>
<PersonId idOwner="Acme">
<IdValue>7832</IdValue>
</PersonId>
<Role>Recruiter</Role>
</ActivityPerformer>
<Date>1999-05-11</Date>
<ActivityResults>Applicant Hired</ActivityResults>
</HiringProcessActivity>
</ApplicationHistory>
<WorkEligibilityInfo>
<DocumentId idOwner="SSA">
<IdValue name="SSN">123456789</IdValue>
</DocumentId>
<DocumentName>Social Security Card</DocumentName>
<IssuingAuthority>US SSA</IssuingAuthority>
<IsDocumentSignedByCandidate>true</IsDocumentSignedByCandidate>
</WorkEligibilityInfo>
<WorkEligibilityInfo>
<DocumentId idOwner="IL DOT">
<IdValue name="Drivers License">11155558886315</IdValue>
</DocumentId>
<DocumentName>Illinois Drivers License</DocumentName>
<IssuingAuthority>IL DOT</IssuingAuthority>
<IsDocumentSignedByCandidate>true</IsDocumentSignedByCandidate>
</WorkEligibilityInfo>
</ApplicationInfo>
<PositionInfo>
<ReferenceInfo>
<RequisitionId idOwner="SuperrrBoard">
<IdValue name="reqId">89752282</IdValue>
</RequisitionId>
<PositionId idOwner="Acme">
<IdValue name="positionId">7835</IdValue>
</PositionId>
<JobId idOwner="Acme">
<IdValue name="jobId">544</IdValue>
</JobId>
</ReferenceInfo>
<OfferInfo>
<OfferMade>
<OfferedBy>
<PersonName>
<GivenName>Sally</GivenName>
<FamilyName>Smith</FamilyName>
</PersonName>
<PersonId idOwner="Acme">
<IdValue>8436</IdValue>
</PersonId>
</OfferedBy>
<OfferedOnDate>1999-05-06</OfferedOnDate>
</OfferMade>
<DateJobAccepted>1999-05-11</DateJobAccepted>
<EmploymentStartDate>1999-05-15</EmploymentStartDate>
<RemunerationInfo>
<BasePay currencyCode="USD" baseInterval="Annually">45000</BasePay>
</RemunerationInfo>
<EmploymentLevel>FullTime</EmploymentLevel>
<ResourceRelationship>Employee</ResourceRelationship>
</OfferInfo>
</PositionInfo>
</NewHire>
Jane Doe is a UI designer working for Acme Corporation in the Intranet Department for several months.
Following her spouse’s relocation, she was looking for a job in the South California area. Her friend Lori Stihl from the Software development department heard of a position opening in the Los Angeles office and referred Jane (see ApplicationInfo/CandidateSupplier).
At first Jane, through the Applicant Tracking System (ATS) application, provided all her personal information (see EmployeeInfo): name, address, education and employment history, SSN, EEO information, associations and unions to which she belonged.
Then, she went through the usual selection process: interviews (see ApplicationInfo/ApplicationHistory), background checks, assessments and medical tests (see ApplicationInfo/ScreeningResult) and performed very well. She was even identified as a potential leader for the future. All this occurred within the ATS.
She negotiated the terms of her employment:
Jane is currently an employee of the organization, so she already has an employee identifier. She actually has two employee identifiers: one that she uses everyday to access the different systems (CentralId) and one that is used by all HR systems to uniquely identify her (EmployeeId).
Since the position she is hired for is a full-time position the multiple position indicator is set to false.
Once she accepted the offer she has been proposed, the new hire transaction that includes all the aforementioned information is sent to the HRMS.
Note: Some elements are not displayed in the xml example since they are already described in their own specification document. This includes:
<NewHire>
<TypeOfHire>
<StandardValue>Transfer</StandardValue>
</TypeOfHire>
<EmployeeInfo>
<PersonName>
<FormattedName>String</FormattedName>
<LegalName>Jane Doe</LegalName>
<GivenName>Jane</GivenName>
<FamilyName>Doe</FamilyName>
</PersonName>
<ApplicantId idOwner="Applicant Tracking System">
<IdValue name="CandidateId">124578</IdValue>
</ApplicantId>
<EmployeeId idOwner="myERP">
<IdValue name="CentralId">jdoe0258</IdValue>
<IdValue name="EmployeeId">65982</IdValue>
</EmployeeId>
</EmployeeInfo>
<ApplicationInfo>
<ApplicationHistory>
<HiringProcessActivity>
<Type>Application submitted</Type>
<ActivityPerformer>
<PersonName>
<FormattedName>String</FormattedName>
<GivenName>Jane</GivenName>
<MiddleName>P</MiddleName>
<FamilyName>Doe</FamilyName>
</PersonName>
<Role>Candidate</Role>
</ActivityPerformer>
<Date>2005-01-18</Date>
</HiringProcessActivity>
<HiringProcessActivity>
<Type>Application reviewed</Type>
<ActivityPerformer>
<PersonName>
<GivenName>John</GivenName>
<FamilyName>Clark</FamilyName>
</PersonName>
<PersonId>
<IdValue name="EmployeeId">789654</IdValue>
</PersonId>
<Role>Recruiter</Role>
<Comments>Seems like a perfect fitneed to contact her asap before the competition does.</Comments>
</ActivityPerformer>
<Date>2005-01-18</Date>
<ActivityResults>Candidate moved to 1st Interview</ActivityResults>
</HiringProcessActivity>
<HiringProcessActivity>
<Type>1st Interview</Type>
<ActivityPerformer>
<PersonName>
<GivenName>John</GivenName>
<FamilyName>Clark</FamilyName>
</PersonName>
<PersonId>
<IdValue name="EmployeeId">789654</IdValue>
</PersonId>
<Role>Recruiter</Role>
<Comments>Very articulated candidate.fit with the corporate culturewith non-compete clause</Comments>
</ActivityPerformer>
<ActivityPerformer>
<PersonName>
<GivenName>Rachel</GivenName>
<FamilyName>Lang</FamilyName>
</PersonName>
<PersonId>
<IdValue name="EmployeeId">659832</IdValue>
</PersonId>
<Role>Manager</Role>
<Comments>Knows the job. She actually did it for one of our competitor.</Comments>
</ActivityPerformer>
<Date>2005-01-25</Date>
<ActivityResults>Initiates background check and deeper assessment</ActivityResults>
</HiringProcessActivity>
<HiringProcessActivity>
<Type>Background Check Requested</Type>
<ActivityPerformer>
<PersonName>
<GivenName>John</GivenName>
<FamilyName>Clark</FamilyName>
</PersonName>
<PersonId>
<IdValue name="EmployeeId">789654</IdValue>
</PersonId>
<Role>Recruiter</Role>
</ActivityPerformer>
<Date>2005-01-25</Date>
<ActivityResults>Credit Report</ActivityResults>
</HiringProcessActivity>
<HiringProcessActivity>
<Type>Assessment Requested</Type>
<ActivityPerformer>
<PersonName>
<GivenName>John</GivenName>
<FamilyName>Clark</FamilyName>
</PersonName>
<PersonId>
<IdValue name="EmployeeId">789654</IdValue>
</PersonId>
<Role>Recruiter</Role>
</ActivityPerformer>
<Date>2005-01-25</Date>
<ActivityResults>LeadershipDesignmanagement</ActivityResults>
</HiringProcessActivity>
<HiringProcessActivity>
<Type>Background Check</Type>
<Date>2005-01-26</Date>
<ActivityResults>Passed</ActivityResults>
</HiringProcessActivity>
<HiringProcessActivity>
<Type>Assessment</Type>
<Date>2005-01-26</Date>
<ActivityResults>Behavioural: 68Design: 86: 90Management: 58</ActivityResults>
</HiringProcessActivity>
<HiringProcessActivity>
<Type>2nd Interview</Type>
<ActivityPerformer>
<PersonName>
<GivenName>John</GivenName>
<FamilyName>Clark</FamilyName>
<