Skip to content

fix: document OffPayrollWorker value in EmploymentStatus enum - #845

Merged
ryanNexus merged 2 commits into
XeroAPI:masterfrom
mikkelgaub-planday:fix/employmentstatus-offpayrollworker
Sep 3, 2026
Merged

fix: document OffPayrollWorker value in EmploymentStatus enum#845
ryanNexus merged 2 commits into
XeroAPI:masterfrom
mikkelgaub-planday:fix/employmentstatus-offpayrollworker

Conversation

@mikkelgaub-planday

Copy link
Copy Markdown
Contributor

The Payroll UK API already returns OffPayrollWorker as an EmploymentStatus value, but it was omitted from the enum in the spec by oversight. This adds the missing value so generated SDKs can deserialize existing GET responses.

Why this is not a breaking change

  • The isOffPayrollWorker boolean flag already exists on the employee DTO and is how off-payroll workers are created; that behaviour is unchanged.
  • Domain validation already rejects attempts to pass OffPayrollWorker as an EmploymentStatus when creating a payee or adding a contract, so no new request capability is introduced.
  • Consumers cannot currently use this enum value; adding it simply documents existing API behaviour and fixes deserialization of GET responses.

Replaces the approach in #802 (which was flagged as a breaking change). This is a documentation/deserialization fix, not a functional change.

@ryanNexus ryanNexus left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM 🔥

… enum

BREAKING CHANGE: adds a new EmploymentStatus enum value, which is treated as a breaking SDK change for generated clients.
@mikkelgaub-planday
mikkelgaub-planday force-pushed the fix/employmentstatus-offpayrollworker branch from cb17f39 to fc67bd4 Compare September 3, 2026 12:18
@ryanNexus
ryanNexus merged commit f2d3efe into XeroAPI:master Sep 3, 2026
4 of 5 checks passed
@xero-public-bot

Copy link
Copy Markdown

🎉 This PR is included in version 19.0.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants