Staffing Organization
Recommendation, 2006 Feb 28
Editors:
Kim Bartkus, HR-XML Consortium
Kathi Dolan, Manpower
Gail Bubsey, Kelly Services
Tara Ryan, Adecco
Barbara Johnson, Adecco
Contributors:
Bruno Alcotte (Manpower), Ian Anson (Vedior), Rémy Bailly (Randstad), Kim Bartkus (HR-XML Consortium), Yves Berdah (VidiorBis), PJ Brunyks (Randstadt), Gail Bubsey (Kelly Services ), Georges Chaboud (Adia), Kathi Dolan (Manpower), Serguei Dounaevetski (Manpower), Anne-Cécile Fénech (Adecco), Barbara Johnson (Adecco), Paul Kiel (HR-XML Consortium), Ronald Kruegel (Adecco), Magali Munoz (Manpower), Nicolas Poujols (Kelly Services), Tara Ryan (Adecco), Don Simonson (Robert Half International), Jean-Philippe Umber (Adecco), Morgan Vernoux (Adecco)
Copyright statement
©2006 HR-XML. All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of the publisher.
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 Staffing Organization schema, its expected usage, and the business processes meant to be supported.
Status of this Document
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.
Table of Contents
4 Implementation Considerations
4.3 Associating Information to an Organization
5 Appendix A - Document Version History
6 Appendix B – Related Documents
7 Appendix C - Reference Example
A detailed analysis of the Sides 1.0 modules and Cross Process Objects was conducted by a coalition of Staffing Companies in France. The purpose of the analysis was to take a regional implementation perspective and to evaluate how closely the global specifications met localized requirements. Module by module feedback was documented and requests for additions or cardinality changes were structured based on the need for backward compatibility.
These feedback documents were sent to the global Sides development team for evaluation of the applicability of the requested changes. If a requested change could be used in more than one country, then it was considered to be eligible for the global specification. It was found that at least 90% of what was requested by the French team was indeed, more widely applicable and so formed the basis of this Sides 1.1 release. The elements and/or attributes that were only applicable in France, will be documented locally and handled through HR-XML’s localization architecture.
Within the framework of SIDES, the StaffingCustomer and StaffingSupplier modules have now been replaced by a new structure called StaffingOrganization. StaffingCustomer and StaffingSupplier will be included in the release for backwards compatibility, but have been deprecated for any new development. The Staffing Organization schema, like its predecessors is used to describe the staffing supplier (company), staffing customer, or intermediary organization.
StaffingOrganization is not required to implement the core processes enabled by SIDES. However, this schema may be useful to trading partners in setting up front or back office systems or otherwise in setting up trading partner arrangements, order routing or distribution transactions.
Also, initial implementations have revealed a desire to enable some levels of electronic payment functionality. This specification will provide improved global use of the standard, and better integration points with back office systems.
New schema to replace StaffingCustomer and StaffingSupplier, consisting of:
· StaffingOrganizationType with extensible enumerations of Customer, Supplier and Intermediary. This would be the primary way to distinguish the nature of the organization being sent
· A new global type called “StaffingReferenceIdInfo” that contains the full complement of SIDES related ids. It is necessary to create a new structure at the global level, to avoid conflicts with the variety of local “ReferenceInformation” elements used throughout SIDES. They will still all be EntityIdType, so ids that were established in a 1.0 environment can still be referenced.
· An include of the CPO Organization schema, which includes Worksite and WorksiteEnvironment
· PaymentInfo which is a new module based on requirements to include an organization’s banking and financial detail (depending on the business process).
· Ability to capture detailed hierarchical and organizational structure and contact information about a staffing supplier, customer or intermediary, primarily for the purpose of setup, qualification and reporting among trading partners.
· BankAccountInfo was specifically designed for the French market. However, it could be designed for other markets in a future version.
· Capturing details about contractual terms and conditions between a staffing supplier and another staffing supplier, staffing customer or intermediary.
· Capturing customer-specific workflow data (approval, authorization structure, etc.)
· Capturing details about contractual terms and conditions between a staffing customer and staffing supplier or intermediary.
The following scenarios show some of the ways that the StaffingOrganization schema may be used:
· A staffing supplier may send the XML document to one or more of its own branches or subsidiaries to facilitate efficient and consistent setup in their front or back office system.
· A staffing supplier may send the XML document to an intermediary or job board to facilitate initial setup as a new trading partner.
· A staffing supplier may send the XML document to an intermediary, staffing customer or other staffing supplier to streamline the distribution of orders in need of filling.
· An intermediary may use the data from the StaffingSupplier schema to identify whom payment should be remitted to.
· A staffing supplier sends the document to one or more of its own branches or subsidiaries to facilitate efficient and consistent setup in their front or back office system.
· A staffing customer sends the document to a staffing supplier or intermediary to facilitate the quote or credit approval process.
· A staffing customer sends the document to a staffing manager (job advertising entity) as a part of a job posting document.

|
Global
types |
ContentModel* |
Definition |
|
/ |
typeOfOrganization - TypeOfOrganization - required |
Globally scoped data type. |
|
/
[StaffingOrganizationType] / |
- TypeOfOrganization - |
Specifies
the role or context of the organization in the transaction. |
|
- OrganizationType - S (1/*) |
Contains information about the organization. |
|
|
/ [StaffingOrganizationType]/ |
- PaymentInfoType - S (0/*) |
A collection of information about the financial entities and accounts necessary to enable the electronic payment of one or more invoices. |
|
/
[StaffingOrganizationType]/ |
- StaffingReferenceIdType - S (0/*) |
[Definition
In Review: A group of identifiers used to reference specific HR-XML
documents that relate to the transaction. ] |
|
/ |
xsd:restriction base: xsd:string [Enumerations]: Customer, Supplier, Intermediary |
Globally scoped data type. See element or attribute declaration for definition. |
|
/ |
- [Union]: StaffingOrganizationTypes, xStringPatternExtensionType |
Globally scoped data type. See element or attribute declaration for definition. |

|
/ |
OrganizationId - EntityIdType - S (0/1) |
Globally scoped data type. See element or attribute declaration for definition. |
|
/ [PaymentInfoType]/ |
- EntityIdType - S (0/1) |
Unique identifier for the organization. It may be an internal identifier assigned by the sender. |
|
/ [PaymentInfoType]/ |
- EntityIdType - S (0/1) |
Unique identifier for the organizational unit. This may be an internal identifier assigned by the sender. |
|
/ [PaymentInfoType]/ |
- xsd:decimal - S (0/1) |
Value Added Tax rate. Standard
tax rate applicable to most consumer goods in many Western European counties.
|
|
/ [PaymentInfoType]/ |
Structured - [complexType] - S (0/1) |
Contains information about the terms expected for payment of a related outstanding debt. |
|
/ [PaymentInfoType]/
PaymentCondition/ |
PaymentMode - xsd:string - S (1/1) |
Contains specific detail about payment terms. |
|
/ [PaymentInfoType]/
PaymentCondition/ Structured/ |
- xsd:string - S (1/1) |
Specifies the method of payment. |
|
/ [PaymentInfoType]/
PaymentCondition/ Structured/ |
- xsd:decimal - S (1/1) |
Specifies the amount of time
allowed, generally from the invoice date, for the payment to be received
before being considered late. |
|
/ [PaymentInfoType]/
PaymentCondition/ Structured/ |
- xsd:string - S (1/1) |
Identifies the particular time or
calendar event to which the payment is associated. |
|
/ [PaymentInfoType]/
PaymentCondition/ Structured/ |
- xsd:decimal - S (1/1) |
Indicates the specific day that
the payment is due. |
|
/ [PaymentInfoType]/
PaymentCondition/ |
- xsd:string - S (0/1) |
Describes the contextual
information relating to a specific element. |
|
/ [PaymentInfoType]/ |
- BankAccountInfoType - S (0/1) |
Contains information about the bank account of the person or organization being referenced in the transaction. |
|
/ [PaymentInfoType]/ |
xsd:extension base: xsd:decimal |
Money available for the start of the business endeavor. |
|
/ [PaymentInfoType]/ Capital/ |
- CurrencyCodeType - |
A three-letter code identifying
the currency of a monetary amount. |
|
/ [PaymentInfoType]/ |
Name - xsd:string
- S (0/1) |
Contains information about the
insurer and the amount through which an organization has an insurance. |
|
/ [PaymentInfoType]/
FinancialGuarantee/ |
- xsd:string - S (0/1) |
A descriptive identifier within
the given context. |
|
/ [PaymentInfoType]/
FinancialGuarantee/ |
xsd:extension base: xsd:string |
The monetary value of the
associated item. [2] Information required to determine the amount of the
deduction or benefit. |
|
/ [PaymentInfoType]/
FinancialGuarantee/ Amount/ |
- CurrencyCodeType - |
A three-letter code identifying
the currency of a monetary amount. |
|
/ [PaymentInfoType]/ |
- xsd:string - S (0/1) |
A formal agreement between the employers’ organization and employees within that organization. |
|
Global
types |
ContentModel* |
Definition |
|
/ |
xsd:extension base: FRBankAccountInfoType |
Globally scoped data type. See element or attribute declaration for definition. |
|
/ |
BankInfoByJurisdiction - [complexType] - S (0/*) |
This metadata was designed as a standard extension based on the French jurisdiction.
|
|
/ [FRBankAccountInfoType]/ |
bankJurisdiction - xsd:string
- required |
Contains identifying information about a particular bank account associated with a particular branch, governed by the laws for a particular regulatory area (jurisdiction). |
|
/ [FRBankAccountInfoType]/
BankInfoByJurisdiction/ |
- xsd:string - |
Indicates the jurisdiction that
governs the regulatory requirements of a particular bank account. |
|
/ [FRBankAccountInfoType]/
BankInfoByJurisdiction/ |
- xsd:string - S (1/1) |
A unique identifier for the specific financial institution that is considered to be primary in relation to a particular account. |
|
/ [FRBankAccountInfoType]/
BankInfoByJurisdiction/ |
- xsd:string - S (1/1) |
A unique identifier for a
particular teller or counter (referred to as window) in conjunction with a
particular bank branch location. |
|
/ [FRBankAccountInfoType]/
BankInfoByJurisdiction/ |
- xsd:string - S (1/1) |
Indicates the number of a bank account. |
|
/ [FRBankAccountInfoType]/
BankInfoByJurisdiction/ |
- xsd:string - S (1/1) |
A collection of the separate parts of a bank number. This control key is also referred to as an RIB (Repository in a Box) key. |
|
/ [FRBankAccountInfoType]/ |
- xsd:string - S (0/1) |
Used to reference bank account information for a bank that resides outside of local jurisdiction in the context of the transaction. Also referred to as IBAN (International Bank Account Number). |

|
Global
types |
ContentModel* |
Definition |
|
/ |
StaffingCustomerId - EntityIdType - S (0/*) |
Globally scoped data type. See element or attribute declaration for definition. |
|
/ [StaffingReferenceIdType]/ |
- EntityIdType - S (0/*) |
Unique id used to identify the staffing customer. |
|
/ [StaffingReferenceIdType]/ |
- EntityIdType - S (0/*) |
Unique id used to identify a particular organizational unit of the staffing customer. |
|
/ [StaffingReferenceIdType]/ |
- EntityIdType - S (0/*) |
Unique id used to identify the staffing supplier. |
|
/ [StaffingReferenceIdType]/ |
- EntityIdType - S (0/*) |
Unique id used to identify a particular organizational unit of the staffing supplier. |
|
/ [StaffingReferenceIdType]/ |
- EntityIdType - S (0/*) |
Unique identifier for a staffing order. |
|
/ [StaffingReferenceIdType]/ |
- EntityIdType - S (0/*) |
Reference to a specific HumanResource. |
|
/ [StaffingReferenceIdType]/ |
- EntityIdType - S (0/*) |
Unique identifier for a Vendor Management System or 3rd party responsible for staffing management |
|
/ [StaffingReferenceIdType]/ |
- EntityIdType - S (0/*) |
Reference to a uniquely identifiable position. |
|
/ [StaffingReferenceIdType]/ |
- EntityIdType - S (0/*) |
Unique id used to identify the billing information. |
|
/ [StaffingReferenceIdType]/ |
- EntityIdType - S (0/*) |
Identifier of the assignment
eventually agreed to by the trading partners. |
|
/ [StaffingReferenceIdType]/ |
- EntityIdType - S (0/*) |
Unique id used to identify the time card. |
|
/ [StaffingReferenceIdType]/ |
- EntityIdType - S (0/*) |
Unique id used to identify the Invoice. |
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).
In many countries, financial institutions use groupings of numbers to indicate particular branches and account numbers. Different countries use different quantities of groupings, but most range between 2-5 groups of identification/routing numbers. In every day use, terms like BankWindow and BankAccountKey as stand alone fields are not well known. It is more likely that each country would think in terms of Bank Account Number Group 1, Group 2, Group 3, etc.
Examples of this "by country" variance include:
Group One (in France: Bank Code, in the US: Bank routing number), Group Two: (In France the branch number (BankWindow), in the US a personal account number, etc. In a future version, these terms will likely be genericized more, but they can still be used flexibly in the interim, or you can elect not to use the BankAccountInfo module and build to suit in the UserArea.
BankAccountInfo and its children are localized for the French market. This metadata was designed as a standard extension based on the French jurisdiction.
When transmitting staffing organization information, multiple organizations may be exchanged within one instance as long as they are of the same organization type (supplier, customer, intermediary, etc). Since multiple payment information and reference information is also allowed in a single instance, the following recommendations are made to associate the payment and reference information with the correct organization or organizational unit.
The following example illustrates how to associate a reference identifier to a specific organization. The example includes two supplier organizations, Merry Staffing and Perfect People. The first reference Id connects an assignment to Merry Staffing. The second reference id ties a timecard to Perfect People.
<StaffingOrganization typeOfOrganization="Supplier">
<OrganizationName>Merry Staffing</OrganizationName>
<OrganizationId>
<IdValue>845</IdValue>
</OrganizationId>
</Organization>
<Organization>
<OrganizationName>Perfect People</OrganizationName>
<OrganizationId>
<IdValue>200156</IdValue>
</OrganizationId>
</Organization>
<ReferenceIdInfo>
<StaffingSupplierId>
<IdValue>845</IdValue>
</StaffingSupplierId>
<AssignmentId>
<IdValue>1244876</IdValue>
</AssignmentId>
</ReferenceIdInfo>
<ReferenceIdInfo>
<StaffingSupplierId>
<IdValue>200156</IdValue>
</StaffingSupplierId>
<TimeCardId>
<IdValue>20041015-1819</IdValue>
</TimeCardId>
</ReferenceIdInfo>
</StaffingOrganization>
The following example illustrates how to associate payment information to a specific organization and an organizational unit. The example includes one customer organization (Polycorp Distributor) and its business unit (Macco Warehouse). Polycorp Distributor pays by bank draft due on receipt of invoice. Macco Warehouse’s payment method is by credit card due on the 30th of each month.
<StaffingOrganization typeOfOrganization="Customer">
<Organization>
<OrganizationName>Polycorp Distributor</OrganizationName>
<OrganizationId>
<IdValue>24-1819</IdValue>
</OrganizationId>
<OrganizationalUnit typeOfGroup="BusinessUnit" hierarchicalRole="Logical">
<OrganizationalUnitName>Macco Warehouse</OrganizationalUnitName>
<OrganizationalUnitId>
<IdValue>122-233</IdValue>
</OrganizationalUnitId>
</OrganizationalUnit>
</Organization>
<PaymentInfo>
<OrganizationId>
<IdValue>24-1819</IdValue>
</OrganizationId>
<PaymentCondition>
<Structured>
<PaymentMode>Bank Draft</PaymentMode>
<PaymentTimeAllowed>0</PaymentTimeAllowed>
<PaymentEvent>on receipt</PaymentEvent>
<PaymentDay>1</PaymentDay>
</Structured>
</PaymentCondition>
<BankAccountInfo>
<BankInfoByJurisdiction bankJurisdiction="NY">
<BankCode>123456</BankCode>
<BankWindow>789</BankWindow>
<BankAccountNumber>11223344</BankAccountNumber>
<BankAccountKey>556677</BankAccountKey>
</BankInfoByJurisdiction>
</BankAccountInfo>
</PaymentInfo>
<PaymentInfo>
<OrganizationId>
<IdValue>122-233</IdValue>
</OrganizationId>
<PaymentCondition>
<Structured>
<PaymentMode>Credit Card</PaymentMode>
<PaymentTimeAllowed>15</PaymentTimeAllowed>
<PaymentEvent>end of month</PaymentEvent>
<PaymentDay>30</PaymentDay>
</Structured>
</PaymentCondition>
<BankAccountInfo>
<BankInfoByJurisdiction bankJurisdiction="CA">
<BankCode>112233</BankCode>
<BankWindow>456789</BankWindow>
<BankAccountNumber>01020304</BankAccountNumber>
<BankAccountKey>98567</BankAccountKey>
</BankInfoByJurisdiction>
</BankAccountInfo>
</PaymentInfo>
</StaffingOrganization>
|
Date |
Description |
|
2004-03-01 |
Initial Draft |
|
2004-03-29 |
Updated definitions |
|
2004-05-13 |
Added implementation guideline (banking). |
|
2004-05-27 |
Updated example |
|
2003-06-15 |
Changed bankaccountinfo to be localized. This didn’t affect the instance. Moved payment info to be a peer of organization and added org ids. Changed referenceidinfo to multiple occurrence. These modifications allow the payment info and reference id’s to be associated with a particular organization. |
|
2003-06-16 |
Updated section 4.3 examples. Clarified use of localized BankAccountInfo. |
|
2004-Aug-02 |
Approved by membership. |
|
2006-Feb-28 |
Approved by Consortium |
<StaffingOrganization typeOfOrganization="Customer" xml:lang="en-us">
<Organization>
<OrganizationName>Joe Ricci Restaurant</OrganizationName>
<OrganizationId>
<IdValue>333-99-1234</IdValue>
</OrganizationId>
<TaxId>
<IdValue>333-88-5678</IdValue>
</TaxId>
<DunsNumber dunsNumberType="standard Duns">911780201</DunsNumber>
<InternetDomainName primaryIndicator="true">pizzacorp.com</InternetDomainName>
<InternetDomainName primaryIndicator="false">joespizza.com</InternetDomainName>
<DoingBusinessAs>Joe's Pizza</DoingBusinessAs>
<LegalClassification countryCode="US" ownership="Public">Franchise</LegalClassification>
<IndustryCode primaryIndicator="true" classificationName="NAICS">722110</IndustryCode>
<Headcount>21</Headcount>
<Description>Joe's Pizza was formerly known as Joe Ricci Restaurant until it was sold to Pizza Corp in 1992.</Description>
<ContactInfo purpose="x:Owner">
<ContactName>
<FormattedName>Joe Ricci</FormattedName>
</ContactName>
</ContactInfo>
<RelatedOrganization relationship="Parent">
<OrganizationName>Pizza Corp.</OrganizationName>
<TaxId>
<IdValue>444-91-1010</IdValue>
</TaxId>
<DunsNumber dunsNumberType="standard Duns">911780201</DunsNumber>
<InternetDomainName primaryIndicator="true">pizzacorp.com</InternetDomainName>
<LegalClassification countryCode="US" ownership="Public">Corporation</LegalClassification>
<IndustryCode primaryIndicator="true" classificationName="NAICS">722110</IndustryCode>
<Headcount>8653</Headcount>
<Description>Pizza Corp. was founded in 1978 and operates 63 franchises.</Description>
<ContactInfo purpose="x:Owner">
<ContactName>
<FormattedName>Susan Marriott</FormattedName>
</ContactName>
</ContactInfo>
</RelatedOrganization>
<OrganizationalUnit typeOfGroup="Division" hierarchicalRole="Logical">
<OrganizationalUnitName>Chicago</OrganizationalUnitName>
<Description>Sales and inventory of the north and south divisions may be combined in some cases. </Description>
<AccountingCode>333991234CHI</AccountingCode>
</OrganizationalUnit>
<OrganizationalUnit typeOfGroup="Team" hierarchicalRole="Functional">
<OrganizationalUnitName>Wait Staff</OrganizationalUnitName>
<Description>Wait staff for Joe's Pizza</Description>
<WorkSite>
<WorkSiteName>Restaurant</WorkSiteName>
<ParkingInstructions>Park behind restaurant.</ParkingInstructions>
<WorkSiteEnvironment>
<EnvironmentName>Dining Area</EnvironmentName>
<Considerations>
<DressCode suppliedByOrganization="true">x:Apron</DressCode>
<DressCode suppliedByOrganization="false">x:Long Hair Pulled Back</DressCode>
</Considerations>
</WorkSiteEnvironment>
</WorkSite>
<PersonMember>
<PersonName>
<FormattedName>Mary Smith</FormattedName>
</PersonName>
<PersonRole leader="true">
<RoleName>Evening Shift Supervisor</RoleName>
</PersonRole>
</PersonMember>
</OrganizationalUnit>
</Organization>
<PaymentInfo>
<OrganizationId>
<IdValue>333-99-1234</IdValue>
</OrganizationId>
<VATRate>3.14</VATRate>
<PaymentCondition>
<Structured>
<PaymentMode>Credit Card</PaymentMode>
<PaymentTimeAllowed>30</PaymentTimeAllowed>
<PaymentEvent>end of month</PaymentEvent>
<PaymentDay>60</PaymentDay>
</Structured>
</PaymentCondition>
<BankAccountInfo>
<BankInfoByJurisdiction bankJurisdiction="NY">
<BankCode>4525266</BankCode>
<BankWindow>456</BankWindow>
<BankAccountNumber>12245644</BankAccountNumber>
<BankAccountKey>7558596</BankAccountKey>
</BankInfoByJurisdiction>
<BankAccountForeign>466566</BankAccountForeign>
</BankAccountInfo>
<Capital>100000.00</Capital>
<FinancialGuarantee>
<Name>FDIC</Name>
<Amount>150000</Amount>
</FinancialGuarantee>
<CollectiveAgreement>national</CollectiveAgreement>
</PaymentInfo>
<ReferenceIdInfo>
<StaffingCustomerId idOwner="supplier">
<IdValue>11111</IdValue>
</StaffingCustomerId>
<StaffingCustomerOrgUnitId idOwner="supplier">
<IdValue>22222</IdValue>
</StaffingCustomerOrgUnitId>
<StaffingSupplierId idOwner="supplier">
<IdValue>78588</IdValue>
</StaffingSupplierId>
</ReferenceIdInfo>
</StaffingOrganization>