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 →