Staffing Order

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 Staffing Order schema, its expected usage, and the business processes meant to be supported.

 

Table of Contents

1     Overview.. 3

1.1      Objective. 3

1.2      Scope. 3

1.2.1        Major Components. 3

1.2.2        Items Within Scope. 3

2     Business Process. 3

3     Schema Design. 6

3.1      Staffing Order. 6

3.1.1        Schema Diagram.. 6

3.1.2        Data Dictionary. 6

3.2      Staffing Position. 11

3.2.1        Schema Diagram.. 11

3.2.2        Data Dictionary. 11

3.3      Position Header. 16

3.3.1        Schema Diagram.. 16

3.3.2        Data Dictionary. 17

4     Implementation Considerations. 19

4.1      Data Privacy. 19

4.2      LocalStaffingPositionInfo. 20

4.2.1        Japanese Localization. 20

5     Appendix A - Document Version History. 23

6     Appendix B – Related Documents. 23

 


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 section 4 Implementation Considerations or in individual country documentation.  Refer to Appendix A - Document Version History for details.

1.1        Objective

Within the framework of SIDES, the StaffingOrder schema is used to describe the position(s) a staffing customer is requesting be filled by a staffing supplier, either directly or through an intermediary.  The StaffingOrder schema design should be flexible enough to be used by any staffing supplier.

Many of the additions and changes for this version of SIDES are to ensure the global usability of the schema. 

1.2        Scope

1.2.1          Major Components

The Major Components used in the Quote/Order process are listed below.

1.2.2          Items Within Scope

2         Business Process

The StaffingOrder schema moves from the staffing customer to the staffing supplier, sometimes by way of an intermediary.  This transmission marks the beginning of the business process addressed by SIDES.  The Quote/Order process is used to send information describing a customer’s servicing needs, e.g. position description, start and end dates, estimated bill rate.  The Quote/Order process is iterative. The Quote process is optional.  The basic Quote process is described here.

·         The staffing customer submits an XML document to a staffing supplier and/or intermediary with a status that changes for each step leading up to a qualified order.

·         The staffing supplier sends a response to the XML document. Possible status changes are:

·         Unapproved Order (acceptance of unapproved order).

 


Recommendations for Use

It is recommended that the position type, regardless of quantity, remain the same within an order and that the information within the position remains constant. If position elements vary by any substantial degree, it is recommended a different order be created.

 



3         Schema Design

3.1        Staffing Order

3.1.1          Schema Diagram

3.1.2          Data Dictionary

See SIDESReusableModules for details on StaffingContactType.

Elements and Attributes

[Global types listed alphabetically in following table.]

ContentModel*
Data type
Occurrence:
Sequence | Choice | All
(minOccurs/maxOccurs)
Attributes

Definition

/
StaffingOrder

- StaffingOrderType - (1/1)

Transaction used to submit an order or quote from a customer (or intermediary) to a staffing company.

/ StaffingOrder/
OrderId

- EntityIdType - S (1/1)

Unique identifier for a staffing order.

/ StaffingOrder/
ReferenceInformation

MasterOrderId - EntityIdType - S (0/*)
StaffingCustomerId - EntityIdType - S (0/*)
StaffingCustomerOrgUnitId - EntityIdType - S (0/*)
IntermediaryId - EntityIdType - S (0/*)
StaffingSupplierId - EntityIdType - S (0/*)
BillToEntityId - EntityIdType - S (0/*)
StaffingSupplierOrgUnitId - EntityIdType - S (0/*)
TimeCardId - EntityIdType - S (0/*)
InvoiceId - EntityIdType - S (0/*)
PositionId - EntityIdType - S (0/*)
AssignmentId - EntityIdType - S (0/*)
HumanResourceId - EntityIdType - S (0/*)

StaffingOrganizationId - EntityIdType - S (0/*)
UserArea - [see include/import] - S (0/1)

Contains reference information (a group of id's) regarding other business entities or transactions.

/ StaffingOrder/ ReferenceInformation/
MasterOrderId

- EntityIdType - S (0/*)

Reference to a master order or project. Used to link multiple orders.

/ StaffingOrder/ ReferenceInformation/
StaffingCustomerId

- EntityIdType - S (0/*)

Unique id used to identify the staffing customer.

/ StaffingOrder/ ReferenceInformation/
StaffingCustomerOrgUnitId

- EntityIdType - S (0/*)

Unique id used to identify a particular organizational unit of the staffing customer.

/ StaffingOrder/ ReferenceInformation/
IntermediaryId

- EntityIdType - S (0/*)

Unique identifier for a Vendor Management System or 3rd party responsible for staffing management

/ StaffingOrder/ ReferenceInformation/
StaffingSupplierId

- EntityIdType - S (0/*)

Unique id used to identify the staffing supplier.

/ StaffingOrder/ ReferenceInformation/
BillToEntityId

- EntityIdType - S (0/*)

Unique id used to identify the billing information.

/ StaffingOrder/ ReferenceInformation/
StaffingSupplierOrgUnitId

- EntityIdType - S (0/*)

Unique id used to identify a particular organizational unit of the staffing supplier.

/ StaffingOrder/ ReferenceInformation/
TimeCardId

- EntityIdType - S (0/*)

Unique id used to identify the time card.

/ StaffingOrder/ ReferenceInformation/
InvoiceId

- EntityIdType - S (0/*)

Unique id used to identify the Invoice.

/ StaffingOrder/ ReferenceInformation/
PositionId

- EntityIdType - S (0/*)

Reference to a uniquely identifiable position.

/ StaffingOrder/ ReferenceInformation/
AssignmentId

- EntityIdType - S (0/*)

Identifier of the assignment eventually agreed to by the trading partners.
[BusinessRule(s): SIDES: Post assignment revisions via a HumanResourceDocument ]

/ StaffingOrder/ ReferenceInformation/
HumanResourceId

- EntityIdType - S (0/*)

Reference to a specific HumanResource.

/ StaffingOrder/ ReferenceInformation/
StaffingOrganizationId

- EntityIdType - S (0/*)

Unique id used to identify the staffing organization.

/ StaffingOrder/
OrderClassification

orderType - OrderType - required
orderStatus - OrderStatusType - required

Contains classification information about the order.

/ StaffingOrder/ OrderClassification/
orderType

- OrderType -

Indicator of what type the order is or what stage the order process is in.
[Example(s): Request for Quotation (RFQ), Quote, Unapproved Order ]

/ StaffingOrder/ OrderClassification/
orderStatus

- OrderStatusType -

Indicates the status of the order.
[Example(s): New, Accepted, Cancelled, Reopened, Closed ]

/ StaffingOrder/
BillToAttention

ContactInfo - [see include/import] - S (1/1)

Describes contact information for billing purposes.

/ StaffingOrder/
OrderContact

contactType - StaffingContactType - required
ContactInfo - [see include/import] - S (1/1)

Contains the contact information for the overall order.

/ StaffingOrder/ OrderContact/
contactType

- StaffingContactType -

Describes the relationship of the contact person to the associated element.

[Example(s): placed by: name of staffing supplier employee that provided the temporary employee to fill the position.

placed on behalf of: name of staffing supplier employee that provided the temporary employee to fill the position - used in the case that the person actually sending the record is not the "placed by" contact.

confirm to: The customer employee to whom the name of the temporary employee, and other final order details, should be communicated.

authorized by: The individual (customer or supplier, based on context) that gave permission for the accompanying transaction to take place.

interviewer: The customer employee who will interview the temporary employee prior to hire.

supervisor: The customer employee who will supervise the temporary employee's work.

time approver: The customer employee who will approve time for the temporary employee.

submitted by: The staffing supplier employee that is submitting the temporary employee for consideration.

sent to: The intended receiver of the transaction (could be customer or staffing supplier, based on context).

first day contact: The customer employee to be contacted the first day on the job.

customer complaints: The customer employee to be contacted when the temporary employee has complaints about the job or environment. Usually, HR manager.

supplier manager: The staffing supplier employee to be contacted who is responsible for the contract. Usually, the manager of a staffing branch office.

supplier complaints: The staffing supplier employee to be contacted when the staff has complaints about the job or environment. Usually, the manager of a staffing branch office.

deputy time approver: The person named as an alternate time approver. Responsibility could be granted either through a formal delegation process or as a standard naming of responsibility.

created by: The person who created the record.

/ StaffingOrder/
RequiredResponseDate

- AnyDateTimeNaType - S (0/1)

The date that the staffing supplier must contact the staffing customer with an order status.

/ StaffingOrder/
OrderComments

- xsd:string - S (0/*)

Field for comments about the order.
[Example(s): Response to a bid, Confirmation Order ]

/ StaffingOrder/
PositionQuantity

- xsd:integer - S (1/1)

The number of positions attached to this order.

/ StaffingOrder/
PositionQuantityOpen

- xsd:integer - S (0/1)

The number of positions on the order that still need to be filled.
[Example(s): Level of Recruiting Effort, ]

/ StaffingOrder/
MultiVendorDistribution

- xsd:boolean - S (1/1)

Indicates whether this order was distributed to multiple vendors. Annotation: The MultiVendorDistribution default of false is deprecated and will be removed in a future.

 

Global types
(alphabetically listed)

ContentModel*
Data type
Occurrence:
Sequence | Choice | All
(minOccurs/maxOccurs)
Attributes

Definition

/
[KnownOrderStatus]

xsd:restriction base: xsd:string [Enumerations]: new, revised, reopened, cancelled, closed, accepted, rejected, extension, replacement

Globally scoped data type. See element or attribute declaration for definition.

/
[KnownOrderType]

xsd:restriction base: xsd:string [Enumerations]: quote, order, unapproved order, RFQ

Globally scoped data type. See element or attribute declaration for definition.

/
[OrderStatusType]

- [Union]: KnownOrderStatus,xStringPatternExtensionType

Globally scoped data type. See element or attribute declaration for definition.

/
[OrderType]

- [Union]: KnownOrderType,xsd:string

Globally scoped data type. See element or attribute declaration for definition.

 

 

 

3.2        Staffing Position

3.2.1          Schema Diagram

3.2.2          Data Dictionary

Elements and Attributes

[Global types listed alphabetically in following table.]

ContentModel*
Data type
Occurrence:
Sequence | Choice | All
(minOccurs/maxOccurs)
Attributes

Definition

/
StaffingPosition

- StaffingPositionType - (1/1)

Details about the position(s) attached to the staffing order.

/ StaffingPosition/
PositionHeader

- StaffingPositionHeaderType - S (1/1)

Contains common position information to be used within other HR-XML Schemas.
[BusinessRule(s): When Position elements are used within a Schema, all elements should be wrapped in a Position wrapper and must include the PositionHeader Schema. ]

/ StaffingPosition/
DepartmentName

- xsd:string - S (0/1)

Name of the department for which this position is intended.
[BusinessRule(s): SIDES: This is a customer defined label used for invoicing and reporting ]

/ StaffingPosition/
PositionReason

- xsd:string - S (0/1)

The reason the position is being generated.
[Example(s): Illness, Maternity Coverage, Jury Duty, Open Position ]

/ StaffingPosition/
PositionDateRange

StartDate - AnyDateTimeType - S (1/1)
ExpectedEndDate - AnyDateTimeNkType - S (0/1)
ActualEndDate - AnyDateTimeNaType - S (0/1)
MaxStartDate - FlexibleDatesType - S (0/1)
StartAsSoonAsPossible - xsd:boolean - S (0/1)
MaxNeedEndDate - FlexibleDatesType - S (0/1)
PositionDuration - xsd:decimal - S (0/1)
ExtensionParameters - xsd:decimal - S (0/1)

Container for period of time the assignment is expected to occur.

/ StaffingPosition/ PositionDateRange/
StartDate

- AnyDateTimeType - S (1/1)

The date, period, or interval the event becomes active or begins.
[BusinessRule(s): This date is inclusive. Dates are represented in accordance with ISO 8601. ]

/ StaffingPosition/ PositionDateRange/
ExpectedEndDate

- AnyDateTimeNkType - S (0/1)

The date the assignment is expected to end.
[BusinessRule(s): This date is inclusive. Dates are represented in accordance with ISO 8601. ]

/ StaffingPosition/ PositionDateRange/
ActualEndDate

- AnyDateTimeNaType - S (0/1)

The date that an event actually ends, versus an estimated or projected end date.

/ StaffingPosition/ PositionDateRange/
MaxStartDate

- FlexibleDatesType - S (0/1)

The latest acceptable date for an event to begin.
[Example(s): The latest start date a person can begin work in a particular position. ]

/ StaffingPosition/ PositionDateRange/
StartAsSoonAsPossible

- xsd:boolean - S (0/1)

Indicates an immediate need to have a position filled.

/ StaffingPosition/ PositionDateRange/
MaxNeedEndDate

- FlexibleDatesType - S (0/1)

The maximum date the position, assignment, or contract is expected to end.

/ StaffingPosition/ PositionDateRange/
PositionDuration

xsd:extension base: xsd:decimal
unitOfMeasure - xsd:string - required

Alternate or additional method to describe the length of a position. Expressed as a number in conjunction with a unit of measure. Ex. 3 Days

/ StaffingPosition/ PositionDateRange/ PositionDuration/
unitOfMeasure

- xsd:string -

Unit in which the quantity is measured.
[Example(s): Piece, Liters, Meters ]

/ StaffingPosition/ PositionDateRange/
ExtensionParameters

AllowExtension - xsd:boolean - S (0/1)
ExtensionPeriod - xsd:decimal - S (0/1)
Description - xsd:string - S (0/1)

Contains information describing the possibility of term extension on the position

/ StaffingPosition/ PositionDateRange/ ExtensionParameters/
AllowExtension

- xsd:boolean - S (0/1)

Describes whether term extension is allowed or not.

/ StaffingPosition/ PositionDateRange/ ExtensionParameters/
ExtensionPeriod

xsd:extension base: xsd:decimal
unitOfMeasure - xsd:string - required

Describes the length of a term extension. Expressed as a number in conjunction with a unit of measure. Ex. 3 Days

/ StaffingPosition/ PositionDateRange/ ExtensionParameters/ ExtensionPeriod/
unitOfMeasure

- xsd:string -

Unit in which the quantity is measured.
[Example(s): Piece, Liters, Meters ]

/ StaffingPosition/ PositionDateRange/ ExtensionParameters/
Description

- xsd:string - S (0/1)

Describes the contextual information relating to a specific element.
[Example(s): Description defining an Organization's mission or purpose. Description of stock plan. Description of payment terms and conditions. ]

/ StaffingPosition/
ReportToPerson

ContactInfo - [see include/import] - S (1/1)

Container for the contact information of the person that the assigned staffing resource is to report to.

/ StaffingPosition/
PositionContact

contactType - StaffingContactType - optional
ContactInfo - [see include/import] - S (1/1)

Contains the contact information for the position. May vary from the order or from position to position on the order.

/ StaffingPosition/ PositionContact/
contactType

- StaffingContactType -

Describes the relationship of the contact person to the associated element.


[Example(s): placed by: name of staffing supplier employee that provided the temporary employee to fill the position.

placed on behalf of: name of staffing supplier employee that provided the temporary employee to fill the position - used in the case that the person actually sending the record is not the "placed by" contact.

confirm to: The customer employee to whom the name of the temporary employee, and other final order details, should be communicated.

authorized by: The individual (customer or supplier, based on context) that gave permission for the accompanying transaction to take place.

interviewer: The customer employee who will interview the temporary employee prior to hire.

supervisor: The customer employee who will supervise the temporary employee's work.

time approver: The customer employee who will approve time for the temporary employee.

submitted by: The staffing supplier employee that is submitting the temporary employee for consideration.

sent to: The intended receiver of the transaction (could be customer or staffing supplier, based on context).

first day contact: The customer employee to be contacted the first day on the job.

customer complaints: The customer employee to be contacted when the temporary employee has complaints about the job or environment. Usually, HR manager.

supplier manager: The staffing supplier employee to be contacted who is responsible for the contract. Usually, the manager of a staffing branch office.

supplier complaints: The staffing supplier employee to be contacted when the staff has complaints about the job or environment. Usually, the manager of a staffing branch office.

deputy time approver: The person named as an alternate time approver. Responsibility could be granted either through a formal delegation process or as a standard naming of responsibility.

created by: The person who created the record.

/ StaffingPosition/
WorkSite

- StaffingWorkSiteType - S (1/1)

Contains common Work Site information, including name, address travel directions, and parking instructions.

/ StaffingPosition/
WorkSiteEnvironment

- StaffingWorkSiteEnvironmentType - S (0/*)

Contains common Work Site Environment information, including description, physical considerations, dress code, and safety equipment.

/ StaffingPosition/
PositionRequirements

resumeRequired - xsd:boolean - required
interviewRequired - xsd:boolean - required
Competency - [see include/import] - S (0/*)
ScreeningRequirements - [complexType] - S (0/*)

Details about unique requirements for the position.

/ StaffingPosition/ PositionRequirements/
resumeRequired

- xsd:boolean -

Indicates if a resume is required for this position.

/ StaffingPosition/ PositionRequirements/
interviewRequired

- xsd:boolean -

Indicated if an interview is required for this position.

/ StaffingPosition/ PositionRequirements/
ScreeningRequirements

screeningType - StaffingScreeningType - optional

Container for the various screening checks the customer requires for all staffing resources.

/ StaffingPosition/ PositionRequirements/ ScreeningRequirements/
screeningType

- StaffingScreeningType -

Type of screening required and reported on.

/ StaffingPosition/
InvoiceInfo

Description - xsd:string - S (0/1)
FourHourMinimum - xsd:boolean - S (0/1)
ExpenseReimbursed - xsd:boolean - S (0/1)
InvoiceFrequency - FrequencyType - S (0/*)
TimePeriodClosingDateInfo - DateChoiceType - S (0/*)
ClosingDateInfo - DateChoiceType - S (0/*)
ArrivalDateInfo - DateChoiceType - S (0/*)
PaymentDateInfo - DateChoiceType - S (0/*)

Container to describe the invoicing requirements for the position.

/ StaffingPosition/ InvoiceInfo/
Description

- xsd:string - S (0/1)

Describes the contextual information relating to a specific element.
[Example(s): Description defining an Organization's mission or purpose. Description of stock plan. Description of payment terms and conditions. ]

/ StaffingPosition/ InvoiceInfo/
FourHourMinimum

- xsd:boolean - S (0/1)

Indicates that a minimum charge of four hours will be invoiced for the order.
[BusinessRule(s): In the US, this is also known as a show-up charge: if the temp shows up, even if the customer has changed their mind about the assignment, the temp will be paid and the customer invoiced for a four hours. ]

/ StaffingPosition/ InvoiceInfo/
ExpenseReimbursed

- xsd:boolean - S (0/1)

Indicates if business and travel expenses will be reimbursed.

/ StaffingPosition/ InvoiceInfo/
InvoiceFrequency

- FrequencyType - S (0/*)

Frequency at which invoice is to be produced.
[Example(s): weekly; bi-weekly; monthly ]

/ StaffingPosition/ InvoiceInfo/
TimePeriodClosingDateInfo

- DateChoiceType - S (0/*)

Contains date information describing when the timecards for this order will close.

 

/ StaffingPosition/ InvoiceInfo/ TimePeriodClosingDateInfo/
Date

- xsd:date - C (0/1)

A date within the given context.
[BusinessRule(s): This date is inclusive. Dates are represented in accordance with ISO 8601. ]

/ StaffingPosition/ InvoiceInfo/ TimePeriodClosingDateInfo/
DateString

- xsd:string - C (0/1)

A string describing a non-formatted or partial date.

[Example(s): 15th of month, July 30, 1st and 3rd Tuesday of each month.]

/ StaffingPosition/ InvoiceInfo/
ClosingDateInfo

- DateChoiceType - S (0/*)

Contains date information describing the invoicing period.

 

/ StaffingPosition/ InvoiceInfo/ ClosingDateInfo/
Date

- xsd:date - C (0/1)

A date within the given context.
[BusinessRule(s): This date is inclusive. Dates are represented in accordance with ISO 8601. ]

/ StaffingPosition/ InvoiceInfo/ ClosingDateInfo/
DateString

- xsd:string - C (0/1)

A string describing a non-formatted or partial date.

[Example(s): 15th of month, July 30, 1st and 3rd Tuesday of each month.]

/ StaffingPosition/ InvoiceInfo/
ArrivalDateInfo

- DateChoiceType - S (0/*)

Contains date information describing when the invoice must arrive at the customer site in order to meet on-time terms obligations.

[Example(s): 20th of the month; within 7 days of the InvoiceClosingDate]

/ StaffingPosition/ InvoiceInfo/ ArrivalDateInfo/
Date

- xsd:date - C (0/1)

A date within the given context.
[BusinessRule(s): This date is inclusive. Dates are represented in accordance with ISO 8601. ]

/ StaffingPosition/ InvoiceInfo/ ArrivalDateInfo/
DateString

- xsd:string - C (0/1)

A string describing a non-formatted or partial date.

[Example(s): 15th of month, July 30, 1st and 3rd Tuesday of each month.]

/ StaffingPosition/ InvoiceInfo/
PaymentDateInfo

- DateChoiceType - S (0/*)

Contains date information describing the date of a draft or payment.

/ StaffingPosition/ InvoiceInfo/ PaymentDateInfo/
Date

- xsd:date - C (0/1)

A date within the given context.
[BusinessRule(s): This date is inclusive. Dates are represented in accordance with ISO 8601. ]

/ StaffingPosition/ InvoiceInfo/ PaymentDateInfo/
DateString

- xsd:string - C (0/1)

A string describing a non-formatted or partial date.

[Example(s): 15th of month, July 30, 1st and 3rd Tuesday of each month.]

 

3.3        Position Header

3.3.1          Schema Diagram

3.3.2          Data Dictionary

See CPO's JobPositionHeader documentation for the details on the PositionHeaderType.

Elements and Attributes

[Global types listed alphabetically in following table.]

ContentModel*
Data type
Occurrence:
Sequence | Choice | All
(minOccurs/maxOccurs)
Attributes

Definition

/
StaffingPositionHeader

- StaffingPositionHeaderType - (1/1)

Contains common staffing position information to be used within other HR-XML SIDES Schemas.

/ StaffingPositionHeader/
FormattedPositionDescription

Id - EntityIdType - S (0/1)
Name - xsd:string - S (0/1)
Value - xsd:string - S (1/1)

Specific verbiage used to describe a position, generally in the context of a job advertisement.

/ StaffingPositionHeader/ FormattedPositionDescription/
Id

- EntityIdType - S (0/1)

A unique identifier used to reference the entity. The Id is associated with the higher level element.

/ StaffingPositionHeader/ FormattedPositionDescription/
Name

- xsd:string - S (0/1)

A descriptive identifier within the given context.

/ StaffingPositionHeader/ FormattedPositionDescription/
Value

- xsd:string - S (1/1)

Context definition: Verbatim text used for reproduction or publication. For example, advertising a job posting. This element, in this context, is designed for verbiage, so if graphics or formatting information also needs to be exchanged, it is recommended that the “SupportingMaterials” structure be used.

/ StaffingPositionHeader/
JobCategory

Id - EntityIdType - S (0/1)
Description - xsd:string - S (1/1)

A grouping of jobs under one or more classification schemes that is meaningful to an organization.

/ StaffingPositionHeader/ JobCategory/
Id

- EntityIdType - S (0/1)

A unique identifier used to reference the entity. The Id is associated with the higher level element.

/ StaffingPositionHeader/ JobCategory/
Description

- xsd:string - S (1/1)

Describes the contextual information relating to a specific element.

/ StaffingPositionHeader/
ShiftWork

haveShiftWork - xsd:boolean - required
Description - xsd:string - S (0/1)

Contains information about the shift work.

/ StaffingPositionHeader/ ShiftWork/
haveShiftWork

- xsd:boolean -

Indicates that shift work is available.

/ StaffingPositionHeader/ ShiftWork/
Description

- xsd:string - S (0/1)

Describes the contextual information relating to a specific element.

/ StaffingPositionHeader/
PositionMustEndByInfo

Date - xsd:date - S (1/1)
Description - xsd:string - S (0/1)

Contains information about when the position must end.

/ StaffingPositionHeader/ PositionMustEndByInfo/
Date

- xsd:date - S (1/1)

A date within the given context.
[BusinessRule(s): This date is inclusive. Dates are represented in accordance with ISO 8601.]

/ StaffingPositionHeader/ PositionMustEndByInfo/
Description

- xsd:string - S (0/1)

Describes the contextual information relating to a specific element.

/ StaffingPositionHeader/
TransitionInfo

required - xsd:boolean - required
Duration - xsd:decimal - S (0/1)
Description - xsd:string - S (0/1)

Contains information regarding the transition necessary for work replacement.

/ StaffingPositionHeader/ TransitionInfo/
required

- xsd:boolean -

True/false value used to indicate whether the associated item is required.

/ StaffingPositionHeader/ TransitionInfo/
Duration

xsd:extension base: xsd:decimal
unitOfTime - UnitOfTimeEnumType - required

Specifies the duration of the reported work.

/ StaffingPositionHeader/ TransitionInfo/ Duration/
unitOfTime

- UnitOfTimeEnumType -

Time increment in which the event is measured.
[Example(s): Days, Hours, Minutes ]

/ StaffingPositionHeader/ TransitionInfo/
Description

- xsd:string - S (0/1)

Describes the contextual information relating to a specific element.

/ StaffingPositionHeader/
OvertimeInfo

haveOvertime - xsd:boolean - required
ExpectedTime - xsd:decimal - S (0/1)
ExpectedWithin - xsd:decimal - S (0/1)
Description - xsd:string - S (0/1)

Contains information on overtime requirements for the position.

/ StaffingPositionHeader/ OvertimeInfo/
haveOvertime

- xsd:boolean -

Indicates whether overtime is required.

/ StaffingPositionHeader/ OvertimeInfo/
ExpectedTime

xsd:extension base: xsd:decimal
unitOfTime - UnitOfTimeEnumType - required

Specifies the time expected to work overtime.

/ StaffingPositionHeader/ OvertimeInfo/ ExpectedTime/
unitOfTime

- UnitOfTimeEnumType -

Time increment in which the event is measured.
[Example(s): Days, Hours, Minutes ]

/ StaffingPositionHeader/ OvertimeInfo/
ExpectedWithin

xsd:extension base: xsd:decimal
unitOfTime - UnitOfTimeEnumType - required

Specifies the time period when the overtime will be worked.
[Example(s): week, month ]

/ StaffingPositionHeader/ OvertimeInfo/ ExpectedWithin/
unitOfTime

- UnitOfTimeEnumType -

Time increment in which the event is measured.
[Example(s): Days, Hours, Minutes ]

/ StaffingPositionHeader/ OvertimeInfo/
Description

- xsd:string - S (0/1)

Describes the contextual information relating to a specific element.

/ StaffingPositionHeader/
HolidayWork

haveHolidayWork - xsd:boolean - required
Description - xsd:string - S (0/1)

Contains information about the work expected or required during holidays.

/ StaffingPositionHeader/ HolidayWork/
haveHolidayWork

- xsd:boolean -

Indicates whether holiday work is required.

/ StaffingPositionHeader/ HolidayWork/
Description

- xsd:string - S (0/1)

Describes the contextual information relating to a specific element.

/ StaffingPositionHeader/
BusyPeriodInfo

PeriodString - xsd:string - C (0/*)
StartBusyPeriod - xsd:string - S (0/1)
EndBusyPeriod - xsd:string - S (0/1)
Description - xsd:string - S (0/1)

Contains information about the busy periods of a position.

/ StaffingPositionHeader/ BusyPeriodInfo/
PeriodString

- xsd:string - C (0/*)

A string describing a timeframe, range, or date that is not specific to a year.
[BusinessRule(s): This does not use the ISO8601 date format. ]
[Example(s): every month-end, Monday, every other week-end, 15th of the month, June 30 ]

/ StaffingPositionHeader/ BusyPeriodInfo/
StartBusyPeriod

- xsd:string - S (0/1)

Specifies when the busy period or season starts.
[BusinessRule(s): If using a date, the date must be in ISO 8601 format ]
[Example(s): June 1, 2006-11-01 ]

/ StaffingPositionHeader/ BusyPeriodInfo/
EndBusyPeriod

- xsd:string - S (0/1)

Specifies when the busy period or season ends.
[BusinessRule(s): If using a date, the date must be in ISO 8601 format ]

/ StaffingPositionHeader/ BusyPeriodInfo/
Description

- xsd:string - S (0/1)

Describes the contextual information relating to a specific element.

/ StaffingPositionHeader/
LocalStaffingPositionInfo

- LocalStaffingPositionInfoType - S (0/1)

Contains localized staffing position information.

 

/
[UnitOfTimeEnumType]

xsd:restriction base: xsd:string [Enumerations]: second, minute, hour, day, week, month, year

Globally scoped data type. See element or attribute declaration for definition.

 

4         Implementation Considerations

4.1        Data Privacy

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).

4.2        LocalStaffingPositionInfo

This localization is available for exchanging Staffing Position data necessary for a particular government’s laws.

4.2.1          Japanese Localization

The Temporary Services Law in Japan currently does not necessarily allow limitless contract terms for all job categories.  The maximum service term for industrial services for example is one year.  However, if certain conditions specified in the Temporary Services Law are met, unlimited contract terms are allowed.  The NoLimitStaffing subtree was therefore prepared in the StaffingPositionHeader for storing the relevant information listed below.

1.  JobCategoryByOrdinance

2.  ProjectWithPeriod

3.  WorkWithPeriod

4.  MaternityLeave

5.  CaringLeave

6.  SpecialCases

If the need arises for additional specifications to StaffingPositionHeader in the future, the elements can be added alongside NoLimitStaffing.

In NoLimitStaffing, the conditions under which contract terms can be limitless are indicated by the type attribute.  Acceptable values are listed in [NoLimitStaffingEnumType].  The details for each condition are listed in the ProjectWithPeriod, WorkWithPeriod, Leave, and SpecialCases subtrees.  Information for either MaternityLeave or CaringLeave is specified in the Leave subtree.  As for JobCategoryByOrdinance, there is no additional information in this subtree.  If necessary, StaffingPositionHeader/JobCategory can be referred to.

Data Dictionary

Elements and Attributes

[Global types listed alphabetically in following table.]

ContentModel*
Data type
Occurrence:
Sequence | Choice | All
(minOccurs/maxOccurs)
Attributes

Definition

/
NoLimitStaffing

- NoLimitStaffingType - S (0/1)

type - NoLimitStaffingEnumType - required
ProjectWithPeriod - ProjectWithPeriodType - C (1/1)
WorkWithPeriod - WorkWithPeriodType - C (1/1)
Leave - AnyLeaveType - C (1/1)
SpecialCases - SpecialCasesType - C (1/1)

Contains information for work with limitless contract term.
[BusinessRule(s): Japanese Localization ]

/ [NoLimitStaffingType] /
type

- NoLimitStaffingEnumType -

Further defines the associated element in the context provided.
[Contextual: Describes the type of limitless service term.]

/ NoLimitStaffing/
ProjectWithPeriod

- ProjectWithPeriodType - C (1/1)

Information for fixed-term project of within three years.
[BusinessRule(s): Japanese Localization ]

/ NoLimitStaffing/ ProjectWithPeriod/
ProjectDetail

- xsd:string - S (1/1)

Detailed information for fixed-term project.
[BusinessRule(s): Japanese Localization ]

/ NoLimitStaffing/ ProjectWithPeriod/
ProjectPeriod

- xsd:string - S (1/1)

Term of fixed-term project.
[BusinessRule(s): Japanese Localization ]

/ NoLimitStaffing/
WorkWithPeriod

- WorkWithPeriodType - C (1/1)

Information for work where the number of working days in a month is less than half the number of regular working days and where it is up to 10 days.
[BusinessRule(s): Japanese Localization ]

/ NoLimitStaffing/ WorkWithPeriod/
DaysPerMonth

- xsd:decimal - S (1/1)

Working days per month.
[BusinessRule(s): Japanese Localization ]

/ NoLimitStaffing/ WorkWithPeriod/
OrdinaryDaysPerMonth

- xsd:decimal - S (1/1)

The ordinary or regular days per month.
[BusinessRule(s): Japanese Localization ]

/ NoLimitStaffing/
Leave

- AnyLeaveType - C (1/1)

Specifies maternity or caring leave information.
[BusinessRule(s): Japanese Localization ]

/ NoLimitStaffing/ Leave/
ReplacedPerson

- xsd:string - S (1/1)

Indicates a specific person whom the contracted worker will replace. [2] Specific person whom the contracted worker will replace.
[BusinessRule(s): Japanese Localization ]

/ NoLimitStaffing/ Leave/
WorkContents

- xsd:string - S (1/1)

Content of work to be replaced.
[BusinessRule(s): Japanese Localization ]

/ NoLimitStaffing/ Leave/
StartDate

- xsd:date - S (1/1)

The date, period, or interval the event becomes active or begins.
[BusinessRule(s): This date is inclusive. Dates are represented in accordance with ISO 8601. ]

/ NoLimitStaffing/ Leave/
ExpectedEndDate

- xsd:date - S (1/1)

The date, period, or interval the event is expected to end.
[BusinessRule(s): This date is inclusive. Dates are represented in accordance with ISO 8601. ]

/ NoLimitStaffing/
SpecialCases

- SpecialCasesType - C (1/1)

Special legal requirements.
[BusinessRule(s): Japanese Localization ]

/ NoLimitStaffing/ SpecialCases/
Description

- xsd:string - S (1/1)

Describes the contextual information relating to a specific element.

/
[NoLimitStaffingEnumType]

xsd:restriction base: xsd:string [Enumerations]: JobCategoryByOrdinance, ProjectWithPeriod, WorkWithPeriod, MaternityLeave, CaringLeave, SpecialCases

Globally scoped data type. See element or attribute declaration for definition.

Sample XML

             <JPStaffingPositionInfo>

               <NoLimitStaffing type="CaringLeave">

                  <Leave>

                    <ReplacedPerson>Taro Yamada</ReplacedPerson>

                    <WorkContents> Machinery/Precision Instrument Inspection</WorkContents>

                    <StartDate>2006-04-20</StartDate>

                    <ExpectedEndDate>2008-04-20</ExpectedEndDate>

                  </Leave>

               </NoLimitStaffing>

             </JPStaffingPositionInfo>

5         Appendix A - Document Version History

Date

Description

2004-03-01

Initial Draft

2004-03-29

Updated definitions

2004-06-08

Deprecated ‘false’ default for MulitVendorDistribution.

2004-Aug-02

Approved by membership.

2006-Feb-28

Approved by Consortium

2006-Jun-01

StaffingOrder:

·         Added Reference Id's to match other SIDES schemas: TimeCardId, InvoiceId, PositionId, AssignmentId, HumanResourceId and StaffingOrganizationId.

·         Added 'extension' and 'replacement' enumerations to OrderStatus.

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.

  • Added Japanese extension (LocalStaffingPositionInfo) to StaffingPositionHeader.

2007-Apr-15

Approved by Consortium

6         Appendix B – Related Documents

Reference

Link

SIDES Documentation

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/SIDES.html

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/Assignment.html

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/HumanResource.html

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingAction.html

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingOrder.html

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingOrganization.html

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/SIDESReusableModules.html

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingInvoice.html

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingWorkSite.html

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/ExtendedTimeCard.html

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/JP/SIDESJPLocalizations.html

SIDES schemas

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/Assignment.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/BankAccountInfo.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/ContactInfo.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/CustomerReportingRequirements.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/HumanResource.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/Invoice.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/Localizations.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/Rates.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/ResourceScreening.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingAction.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingContactType.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingOrder.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingOrganization.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingPosition.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingPositionHeader.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingShift.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingWorkSite.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingWorkSiteEnvironment.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/TimeCardAdditionalData.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/JP/JPLocalizations.xsd

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/FR/FRLocalizations.xsd

SIDES reference  examples

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/Assignment.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/ContactInfo.xml   

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/EntityContactInfo.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/CustomerReportingRequirements.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/HumanResource.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/HumanResource_SocialInsurance.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/Invoice.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/Rates.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/ResourceScreening.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingAction.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingOrder.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingOrganization.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingOrganization_TaxEval.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingShift.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingWorkSite.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/StaffingWorkSiteEnvironment.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/TimeCardAdditionalData.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/JP/Assignment_ContractRequirements.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/JP/StaffingPositionHeader_NoLimitStaffing.xml

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/NL/ExtendedTimeCard_1.xml

OAGIS Invoice and instance

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/Invoice.xsd

(a stand alone version - see http://www.openapplications.org/ for the original)

http://ns.hr-xml.org/2_5/HR-XML-2_5/SIDES/Invoice.xml

User Area

http://ns.hr-xml.org/2_5/HR-XML-2_5/CPO/HRXMLExtension.html

http://ns.hr-xml.org/2_5/HR-XML-2_5/CPO/UserArea.xsd

DateTimeDataTypes

http://ns.hr-xml.org/2_5/HR-XML-2_5/CPO/DateTimeDataTypes.html

http://ns.hr-xml.org/2_5/HR-XML-2_5/CPO/DateTimeDataTypes.xsd