What Are Integration IDs in Workday?
Integration IDs are unique identifiers used to reference Workday objects (e.g., employees, organizations, positions, cost centers) in integrations with external systems (e.g., payroll, ERP, HRIS, or financial systems). They ensure accurate data mapping and synchronization between Workday and third-party applications.
Why Are They Important?
-Prevent data mismatches (e.g., sending payroll data for the wrong employee).
-Enable real-time updates between Workday and external platforms.
-Support hybrid environments (e.g., when migrating from legacy systems).
Types of Integration IDs in Workday
1) Workday Integration ID Types
WID (Workday Identifier)
Generated by: Workday (system-assigned).
Format: 128-bit UUID (e.g., b3d8a3f7-1a2b-4c5d-8e9f-0a1b2c3d4e5f).
Editable?: ❌ No (immutable).
Purpose: Unique internal identifier for all objects.
Mandatory: ✅ Yes (all integrations rely on WID).
2) Reference ID
Generated by: System or user-defined (via ID Definitions).
Format: Configurable (text, number, etc.).
Editable?: ✅ Yes (properties can be modified).
Purpose: Used in APIs to reference objects (e.g., <wd:Employee_Reference>).
Mandatory: ✅ Yes (for API-based integrations).
3) External Reference ID
Generated by: User (manually maintained).
Format: Free-form (matches external system needs).
Editable?: ✅ Yes.
Purpose: Maps Workday objects to external system IDs (e.g., SAP_Employee_Code).
Mandatory: ❌ No (optional for integrations).
Key Clarifications
WID = Workday’s universal backbone (never changes).
Reference ID = Flexible pointers for APIs/web services.
External ID = Bridge for external systems (e.g., payroll providers).
Example:
An employee has:
Reference ID = Flexible pointers for APIs/web services.
External ID = Bridge for external systems (e.g., payroll providers).
Example:
An employee has:
WID: b3d8a3f7... (system-generated, immutable).
Reference ID: EMP_10025 (used in API calls).
External ID: ADP_789 (matches payroll system).
Reference ID: EMP_10025 (used in API calls).
External ID: ADP_789 (matches payroll system).
How It Works:
When querying an employee via API, Workday returns a Reference_ID instead of the raw UUID.
Example API snippet:
xml
<wd:Employee_Reference>
<wd:ID wd:type="Employee_ID">b3d8a3f7-1a2b...</wd:ID>
</wd:Employee_Reference>
When querying an employee via API, Workday returns a Reference_ID instead of the raw UUID.
Example API snippet:
xml
<wd:Employee_Reference>
<wd:ID wd:type="Employee_ID">b3d8a3f7-1a2b...</wd:ID>
</wd:Employee_Reference>
No comments:
Post a Comment