Articles on: API

Shift Assignment API

The Shift Assignment API in XperienceHR provides an interface for assigning work calendars and shifts to employees, enabling seamless integration with external systems for workforce scheduling and management.


This API supports XML & JSON format for structured data exchange and requires authentication via an API key.


By integrating the Shift Assignment API, organizations can efficiently manage employee schedules, ensuring accurate shift assignments and calendar synchronization.


Overview


API Type: REST
Supported Formats: XML
API Key: ** **Generated in the app configuration
Method: POST


Shift Assignment


Functionality:

  • Assign Work Calendar to employee
  • Assign Shift


Parameter

Min

Max

Required

Description

Login

Valid XPHR value

Date

Current Date

Valid Date

Date format = YYYY-MM-DD

Work Calendar Code

Valid XPHR value

Project Name

Valid XPHR value

Activity Name

Valid XPHR value

Approval Type

1

3

Approval Type


Approval Types: 1 = Line Manager Approval - Employee Notification, 2 = Line Manager Approval - Customer Notification, 3 = Customer Approval - Line Manager Notification


Endpoint


Error Handling


Common errors help in debugging and correcting API usage issues.


Example 1: Date Before Other Assignment


Example 2: Unknown Approval Type


Example 3: User Not Found


HTTP Response Codes

  • **2XX Success ** - Operation completed successfully.
  • **4XX Client Error ** - Likely an issue with the request, such as incorrect parameters or insufficient permissions. Returns an error message in text or XML format.
  • **5XX Server Error ** - Indicates a server issue. Report this error if encountered.


Updated on: 16/03/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!