Notas Fiscais
Cancelar Nota Fiscal
Cancela na prefeitura uma nota fiscal já autorizada. O identificador é o invoiceId da listagem.
O motivo vai na query string, e não no corpo: parte dos clientes HTTP descarta body em requisições DELETE.
Só é possível cancelar notas da própria conta e que estejam autorizadas. O status é reconferido antes do cancelamento: nota em processamento ou já cancelada é recusada com NF_NOT_AUTHORIZED.
O prazo de cancelamento é definido pela prefeitura do município emissor. Passada essa janela, o cancelamento é recusado com NF_CANCEL_FAILED e a correção passa a exigir substituição da nota.
Case de uso:
Como prestador, quero cancelar uma nota emitida com valor errado, dentro do prazo permitido pelo município.
/v1/invoices/notas/:notaidhttps://api.validapay.com.brhttps://sandbox.validapay.com.brAuthorizations
Authorization
string · header · required
Cabeçalho de autenticação Bearer no formato Bearer {{token}} onde {{token}} é o seu token OAuth2.
Escopos requeridos
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| notaid | string | Required | Notaid |
Query Parameters
| Name | Type | Value | Required | Description |
|---|---|---|---|---|
| motivo | - | Valor do servico informado incorretamente | Optional | Justificativa enviada à prefeitura - required |
const url = 'https://sandbox.validapay.com.br/v1/invoices/notas/{{notaId}}?motivo=Valor do servico informado incorretamente?motivo=Valor%20do%20servico%20informado%20incorretamente';
const options = {
method: 'DELETE',
headers: {
'Authorization': 'Bearer {{token}}'
},
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));Response Examples
{
"success": true,
"invoiceId": "nf_1788101026585_uqaspo7bn"
}{
"error": {
"message": "Nota fiscal não está autorizada para cancelamento",
"code": "NF_NOT_AUTHORIZED",
"details": null,
"timestamp": "2026-07-14T21:39:36.322Z"
}
}{
"error": {
"message": "Nota fiscal não encontrada",
"code": "NOTA_NOT_FOUND",
"details": null,
"timestamp": "2026-07-14T21:39:36.322Z"
}
}