Cancel an invoice

Requests the cancellation of a Service Invoice (NFS-e).

Cancellation with the city hall depends on the municipality's rules and the current status of the invoice. Before the operation, check supportsCancellation in List municipal configurations to verify whether the city hall allows automatic cancellation via integration.

When cancelOnlyOnAsaas is sent as true in the request body, the invoice is canceled only in Asaas, without requesting the cancellation from the city hall.

📘

Cancellation processing

When the cancellation depends on the city hall, the request may remain in processing before being completed or denied.

Track the result through the INVOICE_PROCESSING_CANCELLATION, INVOICE_CANCELED and INVOICE_CANCELLATION_DENIED events.

See the events for invoices.

Related content

Guides

Webhooks

Path Params
string
required

Unique invoice identifier in Asaas

Body Params
boolean

Cancel invoice only on Asaas

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