Cancel an invoice

Endpoint used to request the cancellation of an invoice.

The request uses the invoice identifier (id) in the /v3/invoices/{id}/cancel endpoint.

Request parameters

  • cancelOnlyOnAsaas - When informed, defines whether the cancellation should occur only within Asaas.

How cancellation works

This endpoint should be used when there is a need to reverse an already issued invoice, respecting the municipality rules and cancellation availability.

🚧

Important

The cancellation result depends on the municipality rules and the current stage of the invoice.

  • Not all municipalities allow automatic cancellation through integration.
  • Some municipalities have deadline restrictions or limitations for cancellation.

After the request is made, the invoice may go through the following statuses:

  • PROCESSING_CANCELLATION
  • CANCELED
  • CANCELLATION_DENIED
📘

Learn more

This endpoint is especially relevant in municipalities that support automatic cancellation through integration.

  • The result can be monitored through invoice queries or webhooks.
  • The invoice status will be updated according to the municipality response.
Path Params
string
required
Body Params
boolean
Responses

404

Not found

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