Update notices

13 Nov 2026: Clearer failure messages

When an invoice fails for a reason on our side or in your accounting system, the message now says in plain words what happened and what to do. Raw system text no longer appears on the invoice.

OAuth API

Changed

A failed invoice's message is plain, and never carries system text

  • A conversion that fails unexpectedly no longer reads "Conversion to XML raised exception: KeyError('x')". It reads "An unexpected problem stopped this invoice from being prepared for Peppol" and gives a short reference to quote to support.
  • The delivery failure message stays "Failed to send invoice to Peppol", and its `reason` and `reason_code` are unchanged.
  • Failures that are only temporary (a connection problem) now say so and ask you to send the invoice again in a few minutes.
Why we changed this
  • The old text was an internal error message. It told you nothing you could act on, and it could carry data from the system that refused the request.

What to do: Nothing to change if you only show the status to a person. If your code matches the old conversion error text, match the status code (XML_CONVERTED_FAILED) instead.

Invoice statuses →

Breaking change

The user endpoints are removed

  • POST /oauth/users, GET /oauth/users and GET /oauth/users/{user_id} no longer exist. A call to any of them is answered 404.
  • Entities and users made earlier are unchanged, and your app keeps reaching its entities as before.
  • A partner or reseller sees its clients through the partner or reseller endpoints (/oauth/partners/pre-register/clients, /oauth/reseller/pre-register/clients), not through users.
Why we changed this
  • An account must be made by the person it belongs to. An account an app created on their behalf left that person's company owned by an account they had never signed up for.

What to do: Stop calling the /oauth/users endpoints and remove created_by_user_id from your code. Have each customer sign up in the Tax Star E-Invoice application. To list your clients, use the partner or reseller client endpoints.

Partner accounts →Reseller accounts →

New

List the clients that have registered

  • GET /oauth/partners/pre-register/clients/registered and GET /oauth/reseller/pre-register/clients/registered return the clients you pre-registered whose company is now registered.
  • Each client carries its entity_id, entity_created_at and activity. They take search, page and limit.
  • It is the same list as the client list with status=entity_created, which still works.
Why we changed this
  • With the user endpoints gone, this is the one call that answers which of your pre-registered clients have registered.

What to do: Nothing to change. Call it, or subscribe to client.onboarded, to learn who has registered.

Partner accounts →Reseller accounts →

Application

Changed

Failure messages on an invoice say what happened and what to do

  • A failure while checking, preparing or sending an invoice, or while booking a received one into your accounting system, now gives one plain sentence and the next step: reconnect the system, wait a few minutes, or correct the document.
  • When the accounting system refuses a document, only its own validation sentences are shown (for example that an account code is not valid), never its full response.
  • A problem we could not classify shows a short reference. Quote it if you contact support.
  • The Events tab shows a failed validation as a card: what is wrong, what is missing, where to fix it and a link to the entity's details. The original message is one click away.
  • Delivery failures use one wording, "Failed to send invoice to Peppol", in every accounting system.
  • Messages already on invoices are not rewritten; the new wording applies to failures from now on.
Why we changed this
  • Messages used to carry raw error text, which was hard to read and could echo customer data.

What to do: Nothing to do.

Documentation

Documentation

The Users section is removed

  • The Users tab and its endpoint pages are gone, and the OAuth overview, Roles and permissions, Partner and Reseller pages no longer list user endpoints.