Here is a list of recent breaking changes that you may need to adapt to:

• Resource: Journal Types, Products, Suppliers, Customers

  2025 May

  • Change: The following input fields were removed:
    • accountingEntryTemplateId from JournalTypeCreateGLDtoInput
    • purchaseUnitPrice from ProductCreateGLDtoInput
    • blockDeliveryNoteEnabled, blockInvoiceEnabled, and blockOrderEnabled from both SupplierCreateGLDtoInput and SupplierUpdateGLDtoInput
  • Change: Several fields in the CustomerSortInput and SupplierSortInput input types changed type:
    • countryAcronym from StringOperationFilterInput to SortEnumType
    • documentType from DocumentTypeFilterInput to DocumentTypeSortInput
    • documentTypeId from UuidOperationFilterInput to SortEnumType
    • tradeName from StringOperationFilterInput to SortEnumType
  • Reason:
    • The removed fields were part of a feature that was ultimately not implemented and never made officially available. This is a cleanup of unused elements.
    • The type changes reflect a cleanup and standardization effort: sort inputs should use only sort-compatible types (SortEnumType) and not filtering types.
  • Solution:
    • Ensure that no GraphQL queries rely on the removed fields. Since they were never functional, their removal has no impact on integration.

• Resource: User Profile

  2025 May

  • Change: The fields activeOrganizationId, activeTenantId, and activeLegislationCode now return empty values (GUID.empty for the first two, and null for the last).
  • Reason: These fields have not been meaningful for over a year, following a change in how organizations are authorized for a user, they can now technically belong to different tenants.
    Although these fields were removed from the documentation, they remained in the API to avoid execution errors when querying userProfile.
  • Solution: Remove these fields from the userProfile query. They are no longer relevant and will be permanently removed in a future version.

• Resource: Sales Documents

  2025 Apr

  • Change: The sourceType input field for sales document filters (SalesQuoteFilterInput, SalesOrderFilterInput, SalesInvoiceFilterInput, and SalesDeliveryNoteFilterInput) no longer accepts null.
  • Reason: Previously, sourceType was nullable. Now, it always takes a value: SALES when the document is manually entered, and PUBLIC_API when created through the API.
  • Solution: Update filters to explicitly set sourceType, depending on the origin of the document.

• Resource: Accounting Entries

  2025 Feb

  • Change: The dataloader accountingEntry and the field accountingEntryId were removed from the salesInvoices dataloader, which is accessible from accountingEntries.
  • Reason: While it was technically functional, exposing accountingEntries through this dataloader was redundant, as the query already originated from the accounting entry. Additionally, it introduced a circular reference issue when sales invoices contained advance payment deductions, leading to multiple accounting entries being linked to the same sales invoice.
  • Solution: It remains possible to access the sales invoice header from an accounting entry if it exists.

• Resource: Taxes Treatment

  2025 Feb

  • Change: The types AccountingAccountGLDto and TaxTreatmentGLDto were removed.
  • Reason: The list of Tax Treatments was already available through the dataloader logic, accessible from AccountingAccount. However, the list of Tax Treatments as a standalone entity remained as a DTO, as an exception to the general rule introduced with dataloaders.
    Additionally, TaxTreatmentGLDto contained published fields that were not being used.
  • Solution: If you were using a field from TaxTreatmentGLDto that has been removed due to being unused, simply remove it from your query. No other modifications are required as the Tax Treatment list remains accessible through AccountingAccount.

• Resource: Sales Documents

  2025 Jan

  • Change: Fields xxxx changed type from Int to Decimal.
  • Reason: The January version of Sage Active introduces the ability to handle quantities with decimals in sales documents.
    This results in technical breaking changes as quantities now shift from Int to Decimal. However, this does not impact existing developments because Decimal supports Int.
  • Solution: No modifications are required, as compatibility is maintained.

• Resource: Purchase Invoices

  2024 Dec

  • Change: The input field taxGroupId was removed from the input object type PurchaseInvoiceLineCreateGLDtoInput.
  • Reason: The API schema has been updated to simplify the handling of tax groups, ensuring a more streamlined and consistent data structure for purchase invoice lines.
  • Solution: Remove any references to the taxGroupId field in your Purchase Invoices mutations.

• Resource: Purchase Invoices

  2024 Nov

  • Change: The input field lines was removed from the input object type PurchaseInvoiceCreateGLDtoInput. The input field vatLines of type [PurchaseInvoiceLineCreateGLDtoInput!]! was added instead.
  • Reason: The structure of the purchase invoice creation process has been improved to better handle VAT lines separately, providing more clarity and precision in the data model.
  • Solution: Update your queries and mutations by replacing references to the lines input field with the new vatLines input field.

• Resource: Organizations

  2024 Oct

  • Change: The status field of organizations is no longer relevant and should not be used to check the status of organizations.
  • Reason: Access permission management for an organization now depends on business management, which allows, for example, the termination of a business’s use. Additionally, the status field always returns the value READY, making it meaningless for determining an organization’s status.
  • Solution: Either remove the status field if it was referenced in queries on organization, or, if kept, ensure that its returned value is no longer taken into account.

• Resource: SalesInvoice Post Sales Invoice, Sales Open Items settlement

  2024 Oct

  • Change: The Id field in response use by PostSalesInvoice service and SalesOpentItemSettlment service is removed and change by accountingEntryId.
  • Reason: accountingEntryIdindicates that it is the ID of the accountingEntry and not Id of SalesInvoice.
  • Solution: Simply replace the Id field by the accountingEntryId field when it was referenced in actions on PostSalesInvoice or SalesOpenItemSettlement.

• Resource: Userprofile

  2024 Sept

  • Change: The expirationDate field is removed from userprofile.
  • Reason: Access permission management for users now depends on business management, which allows, for example, managing the role of a user.
  • Solution: Simply remove the expirationDate field if it is referenced in queries on userprofile.

• Resource: Products

  2024 May

  • Change: The comments field length has been reduced from 65536 characters to 250.
  • Reason: This change was implemented to mitigate performance impact risks if large volumes are added.
  • Solution: Ensure during the creation and modification of products that the length of comment values does not exceed 250 characters. Replace overly lengthy content with a hyperlink that leads to a page displaying detailed comments.

  

• Resource: Sales Documents

  2024 May

  • Change: The mainAddress and deliveryAddress for salesDocuments were previously exposed as arrays. Now, they are presented in a simple format.
  • Reason: These objects contained only one element, and simplifying their structure facilitates filtering, such as retrieving sales quotes from clients in Brussels.
  • Solution: When retrieving data, remove the index [0].
    For example, use salesQuoteNode.mainAddress instead of salesQuoteNode.mainAddress[0].

  

• Resource: Sales Documents

  2024 May

  • Change: The id field has been removed from mainAddress and deliveryAddress in salesDocuments because it contained a non-significant value.
  • Reason: This change was made to streamline the data structure, as the id was not providing useful information.
  • Solution: Remove the id field from queries involving mainAddress and deliveryAddress.

  

• Resources: Customers, Suppliers

  2024 May

  • Change: The defaultAccountingAccountId field in Customers and Suppliers is no longer filterable or sortable.
  • Reason: The introduction of dataloaders has currently prevented filtering on this field, which was possible in previous versions. A solution is being studied for a future version.
  • Solution: Remove the filter or sort from the query and perform local filtering on the response data.

  

• Resource: All Resources

  2024 May

  • Change: In the syntax of queries using fragments, the DTO used to qualify fragment fields is no longer compatible due to the transition to data loaders.
  • Reason: This update is part of a move to simplify query writing and to enhance performance with the use of data loaders.
  • Solution: Replace the DTO name in the fragment syntax with the name of the resource in singular form, starting with a capital letter.
    Example for a query users, fragment UserProps on UserGLDto becomes fragment UserProps on User.

• Resource: Other removed fields

  2024 May

  • Changes: All of these fields are REMOVEDThis feature has been removed and will cause a compatibility break if it was previously in use.
    • salesQuotes -> action
    • salesOrders -> action
    • salesDeliveryNotes -> action
    • salesInvoices -> action
    • salesTariffs -> calculationBase
    • suppliers / thirdCollectorName
    • paymentMeans -> inactive
    • paymentMeans -> paymentMethodId
    • paymentMeans -> paymentMethodReferenceName
    • organizations -> isDefaultDeliveryAddress
    • organizations -> isDeliveryAddress
    • organizations -> isMainAddress
    • zipcode -> code
  • Reason: These fields were historically present but became inconsistent with the developments in Sage Active. They have been removed to avoid the implication that they may contain incoherent data.
  • Solution: Remove these fields from queries and modify the code responsible for retrieving data from the affected queries.

• Resource: User Profile

  2024 April

  • Change: The activeOrganizationId field no longer returns the current user’s active organization in Sage Active, but instead returns the first organization assigned to the user.
  • Reason: The information returned was no longer relevant, leading to its removal from the documentation, though the field still exists to prevent query errors.
  • Solution: Manage the current user’s organization in a local cache to retrieve it upon the user’s next login.