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 obrigatório
Cabeçalho de autenticação Bearer no formato Bearer {{token}} onde {{token}} é o seu token OAuth2.
Escopos requeridos
Path Parameters
notaIdstringobrigatórioQuery Parameters
motivoopcionalconst 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
200200▾
{
"success": true,
"invoiceId": "nf_1788101026585_uqaspo7bn"
}400400 - não autorizada▾
{
"error": {
"message": "Nota fiscal não está autorizada para cancelamento",
"code": "NF_NOT_AUTHORIZED",
"details": null,
"timestamp": "2026-07-14T21:39:36.322Z"
}
}404404▾
{
"error": {
"message": "Nota fiscal não encontrada",
"code": "NOTA_NOT_FOUND",
"details": null,
"timestamp": "2026-07-14T21:39:36.322Z"
}
}