capabilities.work

Pro HCM Submit Personnel Change

A 4-step recipe with UKG. We can help you get access.

Recipe · 4 steps

Pro HCM Submit Personnel Change

with UKG

Submit a personnel action change request and branch on its returned status.

  1. Confirm the employee exists and is in a state that can accept a personnel action by reading the detailed record.
  2. Capture the current job assignment so the change request has a documented before-state.
  3. Submit the personnel change request. The API returns a request identifier and a processing status.
  4. Re-read the employee record after an immediately-approved change to confirm the resulting employment status.
What you'll need to have ready
  • employeeId: The employee the personnel action applies to (e.g. EMP001).
  • actionType: The personnel action type, one of Job Change, Pay Change, Status Change, Department Transfer, Termination, or Leave of Absence.
  • effectiveDate: The effective date of the change (YYYY-MM-DD).
  • reason: The reason for the change (e.g. Promotion).
  • newDepartmentId: The new department identifier, for transfers.
  • newJobTitle: The new job title, for job changes.
  • newPayRate: The new pay rate amount, for pay changes.
For your developer

Arazzo workflow ukg:submit-personnel-change, 4 operations: getEmployee → getEmployeeJobs → createPersonnelChangeRequest → getEmployee. Specs on APIs.io.