Skip to main content

2024-07-01: Xero changes allowed Organisation Class values

· 3 min read
Amy Roberts
Product Manager, Spend Automation

On July 01, 2024, Xero will introduce new pricing plans for their customers. The possible values for Xero's Organisation Classes will change accordingly.

Client impact

Codat doesn't surface Organisation Classes data in its standardized Company profile data model. As a result, this change only impacts Codat customers who:

What's changing?

From July 01, 2024, 3 new pricing plans will become available. To reflect this, Xero’s GET Organisations endpoint will start returning the following additional Organisation Classes values:

  • IGNITE
  • GROW
  • COMPREHENSIVE

Between September 12, 2024 and March 2025, Xero will migrate their existing customers to the new pricing plans and assign new Organisation Classes to their Organisations. During this time, Xero’s GET Organisations endpoint will return both the new and existing values for the Organisation Classes property.

Once the migration is complete, Xero will deprecate all other Organisation Classes in March 2025. As a result, Xero’s GET Organisations endpoint will only return the following Organisation Classes values:

  • IGNITE
  • GROW
  • COMPREHENSIVE
  • ULTIMATE
  • DEMO
  • TRIAL

What do I need to do?

Bank Feeds API customers

If you use the planType property of Bank Feeds API’s Get company information endpoint, update your code to handle the full set of current and new values expected from July 01, 2024.

Supplemental data users

If you have configured supplemental data to enhance Codat’s Company Profile data model with Xero’s Organisation Class data, update your code to support the full set of current and new values expected from July 01, 2024.

Guidance on using Organisation Classes

Xero discourages its customers from using Organisation Classes to determine the Xero functionality available to an organization. They recommend calling the GET Organisation Actions endpoint instead.

We suggest taking this opportunity to deprecate your use of Organisation Classes and implement the GET Organisation Actions endpoint in line with Xero's Accounting API - Organisation guidance.

Expected impact if no action is taken

If no action is taken by July 01, 2024, you will start receiving unhandled Organisation Class values for new Xero Organisations created after this date.

If no action is taken by September 12, 2024, you will start receiving unhandled Organisation Class values for pre-existing Xero Organisations.