Update e-invoice status for a supplier invoice

Applies an electronic invoicing lifecycle transition to a supplier invoice received via the PA.

Invoices arrive with a null e-invoicing status, which means implicitly approved — no action is required to accept them.

Allowed transitions:

  • Dispute (status: "disputed"): allowed when the current e-invoicing status is null, approved, or waiting_for_validation, the invoice is not archived, and it has no linked payments. Requires a reason.
  • Refuse (status: "refused"): allowed when the invoice is not archived and has no linked payments. Requires a reason. This is a terminal action — the invoice will be archived and cannot be disputed or refused again.
  • Undispute (status: "approved"): allowed only when the current e-invoicing status is disputed. Removes the dispute and restores the invoice to approved. No reason required.

Returns 422 if the transition is not allowed given the current status (e.g. undisputing a non-disputed invoice, or disputing/refusing a collected invoice).

ℹ️

This endpoint requires the following scope: supplier_invoices:all

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required
Body Params
string
enum
required
Allowed:
string
enum
required
Headers
string

Numeric ID of the company to act on. Required when authenticating with a firm token. Ignored when the token is already bound to a company.

Responses

414

URI Too Long: the request URL exceeds the maximum length. Shorten the query string, for example by sending fewer values per query parameter and splitting them across several requests.

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json