Endpoint utilizado para solicitar o cancelamento de uma nota fiscal.

A chamada utiliza o identificador da nota (id) no endpoint /v3/invoices/{id}/cancel.

Parâmetros da requisição

• cancelOnlyOnAsaas - Quando informado, define se o cancelamento deve ocorrer somente no Asaas.

Funcionamento do cancelamento

Esse endpoint deve ser utilizado quando houver necessidade de desfazer uma nota já emitida, respeitando as regras e a disponibilidade de cancelamento do município.

🚧

Importante

O resultado do cancelamento depende das regras da prefeitura e do estágio atual da nota fiscal.

• Nem todos os municípios permitem cancelamento automático via integração.
• Algumas prefeituras possuem prazo limite ou restrições para cancelamento.

Após a solicitação, a nota pode passar pelos seguintes status:

• PROCESSING_CANCELLATION
• CANCELED
• CANCELLATION_DENIED

📘

Saiba mais

Esse endpoint é especialmente relevante em municípios que suportam cancelamento automático via integração.

• O acompanhamento do resultado pode ser realizado através da consulta da nota fiscal ou via webhooks.
• O status da nota será atualizado conforme o retorno da prefeitura.