Staffing Industry Data Exchange Standards (SIDES)
Recommendation, 2007 April 15
Editors:
Kim Bartkus, HR-XML Consortium
Contributors:
Gail Bubsey (Kelly Services ), Kim Bartkus (HR-XML Consortium), Barbara Johnson (Adecco NA), Tara Ryan (Adecco), Kazuko Sugamura (Manpower Japan), Takahiro Fujiwara (EAST Co., Ltd.), Magali Munoz (Manpower France), Bruno Alcotte (Manpower France), Rémy Bailly (Randstad), Yves Berdah (VidiorBis), Serguei Dounaevetski (Manpower France), Patrice Aranega (Adecco France)
Copyright 2007 HR-XML Consortium, Inc.
Abstract
The HR-XML SIDES Workgroup has produced 7 major schemas and several reusable modules to allow for transmission of Staffing Industry information between trading partners. This document describes the Human Resource schema, its expected usage, and the business processes meant to be supported.
Table of Contents
1.2.1 Business Process Terminology
1.5 SIDES Schema Cross-reference
2 SIDES Business Process Overview
3 Implementation Considerations
4 Appendix A - Document Version History
5 Appendix B Related Documents
1 Overview
Changes were made to the base SIDES specification based on feedback from the European and Japanese Chapters. If available, localized items are documented in the implementation guidelines or in individual country documentation.
1.1 Objective
The staffing industry (staffing companies) requires a compendium of XML schemas to enable the exchange of data between its staffing customers (hiring companies), intermediaries (vendor management services) and its own members. The Staffing Industry Data Exchange Standards (SIDES) comprises this compendium of relevant XML schemas, some already approved, some of which are cross process objects, and some newly created.
Details surrounding modifications can be found in the individual schema documents. See section1.5 SIDES Schema Cross-reference.
1.1.1 Domain Issues
The cost of exchanging data between staffing suppliers (companies), staffing customers and intermediaries due to the diversity of existing front and back-office systems, and the need for many-to-many connections, is proving to be extremely high. SIDES offers a cost effective means of exchanging data over the Internet using XML, by standardizing data elements and attributes and the way they are exchanged. SIDES will assist in eliminating duplicate effort and streamlining processes and cross-company data exchanges. Through standardized XML data exchanges, staffing suppliers, staffing customers and third party vendor managers may share orders, assignments, resumes, etc.
It enables a common standard to be applied by large and small companies alike, yet does not impact upon the competitive differences between staffing suppliers.
1.2 Terminology
1.2.1 Business Process Terminology
The SIDES document describes the business processes involved in typical staffing transactions in general terms. Those reading this section are not necessarily interested in the technical aspects of SIDES or XML, but are more interested in the functionality that SIDES is intended to support. For this section, a language explanation is needed. XML schema and element names are used throughout the document. In cases where more than one noun word forms the title, each noun is joined, with each word starting with a capital (i.e. CamelCase).
Staffing Supplier - This is the entity that provides a staffing resource, that is a suitable person, to fill a service need expressed by the customer or in some cases on behalf of the customer by the intermediary.
Staffing Customer - This is the entity that has a servicing need, and is looking to use a person sent from the staffing supplier.
Intermediary Any business or product between the staffing supplier and a staffing customer, e.g. a vendor management service.
Human Resource The staffing resource employed or retained by the staffing supplier, who is sent to work at a staffing customer site.
1.2.2 Schema Terminology
XML schemas express shared vocabularies and allow machines to carry out rules made by people. They provide a means for defining the structure, content and semantics of the SIDES XML documents. The documents are the payloads that travel back and forth between trading partners.
This section describes the SIDES schemas. The eight major SIDES schemas include:
StaffingOrder information describing a staffing customers servicing need, e.g. position description, start and end dates, estimated bill rate. The StaffingOrder XML document moves from the staffing customer to the staffing supplier and this transmission marks the beginning of the business process addressed by SIDES.
HumanResource information describing a staffing resource employed by a staffing supplier e.g. their skills, experiences, cost. The HumanResource XML document moves from the staffing supplier to the staffing customer, usually in response to a StaffingOrder XML document.
Assignment information confirming the actual work agreed upon to be done, e.g. the agreed upon staffing resource to perform the work, and the agreed upon bill rate. This XML document marks the end of the order/selection section of the process, and the beginning of the actual work-performed section.
Staffing Organization information describing a staffing company, customer, or intermediary, e.g. government corporate identifier, billing or branch addresses and contacts, specific facility addresses, remit to data, and work environments.
Staffing Action request and response schema, e.g. interview request and response. The StaffingAction XML document moves in either direction between the staffing customer or intermediary and staffing supplier as required to provide a communication mechanism between these trading partners.
Extended TimeCard information showing the actual amount of time spent by the staffing resource performing work on the assignment over a particular time period. It also captures expenses. SIDES uses an extended form of the HR-XML schema TimeCard.
Invoice information associating the actual time expended as shown via the Timecard, with the bill rate, as confirmed in the Assignment.
Two types of reusable schemas are also identified within The SIDES reusable modules are specific to the SIDES domain. The non-SIDES reusable schemas are either cross-process objects, meaning they span all HR domains, or they are from another specific HR domain, such as recruiting.
CustomerReportingRequirements contains a list of items to allow for specialized reporting and data tracking, such as purchase order numbers, supervisor names, and department numbers. This list can be expanded as needed.
Rates - defines pay rates, bill rates and expenses, based on the enumerations.
ContactInfo contains contact information such as the person name, postal address, contact method, and organization name.
ResourceScreening - describes pre or post-hire screening data for a staffing resource. This reusable module allows the staffing company to report basic information about screenings or evaluations completed pertaining to the staffing resource. Privacy requires that only the fact that a screen or check was done, when it was done, and the generic result (requirement met or not met) is passed to the customer. Examples are credit checks, education verification, reference checks.
StaffingShift provides a mechanism for exchanging shift information between trading partners and within internal applications.
DateTimeDataTypes contains a variety of date and time data types, to allow for consistent use of date and times.
EntityIdType provides a method for uniquely identifying an entity, such as a person, position, organization, etc.
PersonName contains the formatted and non-formatted version of a persons name.
PostalAddress contains the postal address.
ContactMethod provides the methods contacting an organization or person, such as phone number, e-mail, and postal address.
WorkSite contains common work site information, such as the work site name, parking instruction, and travel directions.
WorkSiteEnvironment contains common work environment information, such as physical considerations, safety equipment, and dress code.
PositionHeader contains common position information, such as the position title and description.
Competencies provides a mechanism to express skills, experience and/or training.
Resume allows for a structured or text resume, or a URL to a resume.
ReferenceInformation - the Id's necessary to precisely identify schema components relevant to the content of the document containing the reference information. e.g. the StaffingOrder, Assignment, or HumanResource.
1.3 Design Requirements
1.3.1 Vocabulary
The vocabulary developed for SIDES to describe stakeholders, business processes, and information modules has two goals:
To ensure terms are generic enough to accommodate the variety of staffing models and scenarios that exist today as well as new scenarios that may exist in the future.
To avoid name collisions with future data models that may better support specific types of staffing or recruiting scenarios.
Language used in the staffing industry is not standardized and may vary from company to company and industry category. For instance, while the terms assignment and order may be used interchangeably in a colloquial conversation, the two terms have separate and distinct meanings within the human resource management profession. SIDES utilizes clear and understandable terminology in all possible cases to minimize vocabulary misinterpretations.
1.3.2 Activity Diagrams
The activity diagrams show the actors, actions and schemas. The vertical swim lanes depict the boundaries across which XML transports data.
The activity diagrams are a summary of staffing processes. They do not include all of the actions or schemas but only those central to understanding the process.
1.4 Scope
SIDES supports seven independent payloads, plus the reusable modules described in section 1.2. It provides a full set of specifications for each payload, summarizes its purpose and dependencies, and indicates where each payload fits into the overall business process.
1.4.1 Major Components
Major components of the SIDES specification include:
Models of supported staffing processes - By modeling supported business processes, the intent is to present an easy to understand context for implementing how data is likely to be exchanged. There is no intent to impose any particular recruiting and staffing model or process on those who implement SIDES whether in part or in full.
Data dictionary - The data dictionary provide highlights of the schema specification including the element or attribute name, description, content model, and the restricted value list. The content model describes whether the entity is optional or required, as well as whether multiple elements with the identical name may exist. The restricted value list specifies what values are acceptable in the XML file for a specific attribute. The list enables the schema to restrict certain data to a single, clearly agreed upon contextual value.
Schema diagrams Shows a high level graphical view of the schema structure.
Schemas - Schemas set constraints on the structure and content of the messages exchanged between stakeholders. The schemas define message payloads.
Reference examples.
1.4.2 Items Within Scope
Business processes supported in SIDES include the ability to exchange:
Order information between a staffing supplier and a staffing customer or their intermediary (StaffingOrder).
Information describing a human resource between a staffing supplier and a staffing customer or their intermediary (HumanResource).
Other basic request/response communication between a staffing supplier and a staffing customer or their intermediary (StaffingAction).
Assignment information between a staffing supplier and a staffing customer or their intermediary. (Assignment).
Timecard and expense information between a staffing supplier and a staffing customer or their intermediary. (Extended TimeCard)
An Invoice between a staffing supplier and a staffing customer or their intermediary. (Invoice).
1.4.3 Items Outside of Scope
Implementation guidelines for message delivery. See Implementation Considerations section within this document.
Skills taxonomy.
Selection and matching methodologies. (Performed by the staffing supplier(s) prior to the submission of a HumanResource XML document to a staffing customer or intermediary).
Security - This responsibility resides with system integrators during implementation of data exchange systems.
Post-assignment evaluation process. This may be a future SIDES consideration.
Reporting. This may be a future SIDES consideration.
Accounting and payment processes.
Background checks, drug screening, reference checks, etc. This is being developed by a separate HR-XML workgroup. SIDES provides for linkage.
Payroll processing.
Sub-contractor or Affiliate Vendor contracts. This may be a future SIDES consideration.
1.5 SIDES Schema Cross-reference
The table below identifies where each schema is documented, and any related xml examples.
|
Schema |
Documentation |
Example |
|
Assignment.xsd |
Assignment.doc |
Assignment.xml |
|
BankAccountInfo.xsd |
StaffingOrganization.doc |
StaffingOrganization.xml |
|
ContactInfo.xsd |
SIDESReusableModules.doc |
ContactInfo.xml, EntityContactInfo.xml |
|
CustomerReportingRequirements.xsd |
SIDESReusableModules.doc |
CustomerReportingRequirements.xml |
|
HumanResource.xsd |
HumanResource.doc |
HumanResource.xml, HumanResource_SocialInsurance.xml |
|
Invoice.xsd |
StaffingInvoice.doc |
Invoice.xml |
|
Localizations.xsd |
Assignment.doc, StaffingOrder.doc |
StaffingPositionHeader_NoLimitStaffing.xml, Assignment_ContractRequirements.xml |
|
Rates.xsd |
SIDESReusableModules.doc |
Rates.xml |
|
ResourceScreening,xsd |
SIDESReusableModules.doc |
ResourceScreening.xml |
|
StaffingAction.xsd |
StaffingAction.doc |
StaffingAction.xml |
|
StaffingContactType.xsd |
SIDESReusableModules.doc |
StaffingOrder.xml |
|
StaffingOrder.xsd |
StaffingOrder.doc |
StaffingOrder.xml |
|
StaffingOrganization.xsd |
StaffingOrganization.doc |
StaffingOrganization.xml, StaffingOrganization_TaxEval.xml |
|
StaffingPosition.xsd |
StaffingOrder.doc, HumanResource.doc |
StaffingOrder.xml, HumanResource.xml |
|
StaffingPostitionHeader.xsd |
StaffingOrder.doc, HumanResource.doc |
StaffingOrder.xml, HumanResource.xml |
|
StaffingShift.xsd |
SIDESReusableModules.doc |
StaffingShift.xml |
|
StaffingWorkSite.xsd |
StaffingWorkSite.doc |
StaffingWorkSite.xml |
|
StaffingWorkSiteEnvironment.xsd |
StaffingWorkSite.doc |
StaffingWorkSiteEnvironment.xml |
|
TimeCardAdditionalData.xsd |
ExtendedTimeCard.doc |
ExtendedTimeCard.xml ExtendedTimeCard_1.xml (NL folder) |
|
JPLocalizations.xsd |
SIDESJPLocalizations.doc |
StaffingPositionHeader_NoLimitStaffing.xml, Assignment_ContractRequirements.xml (both in JP Folder) |
|
FRLocalizations.xsd |
Assignment.doc |
Assignment.xml |
2 SIDES Business Process Overview
This overview of the staffing process clarifies the main processes occurring between the staffing supplier, the staffing customer and the intermediary. Often the services of an intermediary (which may be part of a vendor management service) are not required, as the staffing supplier will deal directly with the staffing customer.
The staffing action consists of six main processes:
1. Quote and Order (StaffingOrder).
2. Submission and Selection. (HumanResource and StaffingAction).
3. Fulfillment. (Assignment).
4. Time and Expense capture. (Extended TimeCard).
5. Invoicing (Invoice).
6. Reporting (Currently outside scope of SIDES).
3 Implementation Considerations
3.1 ISO Standards
Country codes must conform to ISO 3166 Representation of Countries, which is a 2-character (A-Z) code. Use of currency must conform to ISO 4217 - Representation of Currency and Funds, which is a 3-character (A-Z) code. Days of the week must conform to ISO 8601; 2000(E), which is a numeric value starting with 1 as Monday.
3.2 Entity Identifier
The SIDES specification employs the Entity Identifier convention defined by the HR-XML consortium. Identifiers are a convention borrowed from the database management system (DBMS) domain. The identifier concept provides a concise form of reference to a specific collection of data related to the identifier.
The identifier concept provides a meaningful reference only within a well-defined context. Database management systems commonly use an identifier as a primary key or as a unique identifier for a table. The DBMS ensures that an identifier is assigned only once within the table. Any reference to the table using a valid identifier value is assured to correlate to exactly one row in the table.
The SIDES use of the entity identifier concept does not directly specify the context for the identifiers used beyond the XML schema in which they are defined. The specification does not directly specify a method to ensure that an identifier is used only once within that context. The specification does include an explicit assertion that the identifiers included in the specification rely on referential integrity between the XML schemata defined in the specification. For example, the HumanResource entity identifier defined in the Assignment schema is intended to reference a single HumanResource schema instance.
SIDES relies on the Trading Partner Agreement (TPA) between two parties implementing the SIDES specification to define context and the referential integrity for the identifiers included in the specification. It is noteworthy that the SIDES specification sets the maximum cardinality for each identifier to many (max occurs = unbounded). This allows, but does not require, each trading partner to include their own identifier values for the entities defined in the specification.
3.3 Messaging
The SIDES specification defines message content or payload. This version does not explicitly address implementation-specific issues for the exchange of these messages. One implementation-specific issue not directly addressed by the current specification is the message envelope mechanism. There are many message envelope mechanism options currently available. These include, but are not limited to the following:
email attachments (no envelope)
HTTP with SSL (no envelope)
Open Applications Group Integration Standard (OAGIS) Business Object Document (BOD)
Simple Object Access Protocol (SOAP)
Rosetta Net
Web Services
The specific intent of the SIDES is, as much as possible, to facilitate implementation using any envelope mechanism, without dictating a specific implementation.
4 Appendix A - Document Version History
|
Date |
Description |
|
2004-03-01 |
Initial Draft |
|
2004-04-19 |
Updated overview, implementation guidelines. |
|
2004-06-09 |
Added note about deprecation of staffing customer and staffing supplier. |
|
2004-06-16 |
Updated dependencies table. |
|
2004-Aug-02 |
Approved by membership. |
|
2006-Feb-28 |
Approved by Consortium |
|
2006-Mar-01 |
See specifific documents for schema modifications. |
|
2006-Jul-14 |
See specific documents for details: Assignment:
BankAccountInfo (new schema) Created new schema from the BankAccountInfo within FRLocalization.xsd. ContactInfo: Added ContactId to ContactInfoType. HumanResource Added Reference Id's to match other SIDES schema: MasterOrderId, TimeCardId, InvoiceId, BillToEntityId and StaffingOrganizationId. Added staffing-relevant information to PositionHeader. See StaffingOrder.doc (StaffingPositionHeader) for details.
Localization Removed FRBankAccountInfoType. It is not longer a localized structure. Added hook to LocalStaffingPositionInfoType. Added hook to JPContractRequirements. Rates: Added TimeWorkedRounding. StaffingAction Added Reference Id's to match other SIDES schemas: BillToEntityId, MasterOrderId and StaffingOrganizationId. Added 'Modification', 'Cancelled', 'Request' enumerations to StaffingActionReasonCode.
StaffingContactType Added 'first day contact', ' customer complaints', 'supplier manager', 'supplier complaints', and 'deputy time approver' enumerations to KnownContactType. StaffingOrder Added Reference Id's to match other SIDES schemas: TimeCardId, InvoiceId, PositionId, AssignmentId, HumanResourceId and StaffingOrganizationId. Added 'extension' and 'replacement' enumerations to OrderStatus. StaffingOrganization Added Reference Id's to match other SIDES schemas: MasterOrderId and StaffingOrganizationId. Added TaxEvaluation structure to PaymentInfo. Changed BankAccountInfo to not be localized.
StaffingPosition Added PositionDuration to PositionDateRange. Added ExtensionParameters to PositionDateRange. Added InvoiceInfo to StaffingPosition. Changed PositionHeader element to use StaffingPositionHeaderType. StaffingPositionHeader Extended CPO PositionHeader with staffing-relevant information (StaffingPositionHeader): FormattedPositionDescription, ShiftWork, PositionMustEndByInfo, TransitionInfo, OverTimeInfo, HolidayWork, and BusyPeriodInfo.
StaffingShift
StaffingWorkSite Added StructuredTravelDirections. StaffingWorkSiteEnvironment
TimeCardAdditionalData Added Reference Id's to match other SIDES schemas: StaffingSupplierOrgUnitId, StaffingCustomerOrgUnitId, InvoiceId, BillToEntityId and StaffingOrganizationId. FRLocalizations Removed FRBankAccountInfo. This is now part of BankAccountInfo schema. AddedFRContractRequirementsType. JPLocalizations (new schema) Contains JPStaffingPositionInfoType. Contains JPContractRequirementsType. |
|
2007-Apr-15 |
Approved by Consortium |