NFC-e
Cancelar por substituição
Cancela a NFC-e normal que ficou duplicada com uma NFC-e de contingência offline da mesma venda.
POST
/openapi/v2/empresas/{empresaId}/nfce/{nfceId}/cancelar-substituicaoRequer os cabeçalhos de assinatura
token, timestamp e sign, veja Autenticação.Caso típico: a nota normal foi enviada, a SEFAZ não respondeu e o caixa emitiu uma nota offline; depois as duas ficaram válidas. Este endpoint cancela a nota normal identificada por nfceId e aponta a nota offline que a substitui. A plataforma já resolve a maior parte desses casos sozinha quando a SEFAZ volta; use este endpoint para casos especiais. Prazo: 168 horas após a autorização.
Parâmetros de caminho
empresaId* | string | Identificador da empresa emitente |
nfceId* | string | Identificador da NFC-e |
* Campo obrigatório
Corpo da requisição
chaveAcessoSubstituta* | string | Chave da nota substituta |
justificativa* | string | Motivo do cancelamento |
* Campo obrigatório
200
Aceito; sem corpo. O resultado chega por webhook e aparece na consulta.
Sem corpo de resposta
| Código | HTTP | |
|---|---|---|
| 10022006 | 404 | nfceId não encontrado nesta empresa. |
| 10003000 | 404 | empresaId não encontrado. |
| 10022008 | 400 | O status não permite: a nota não está Autorizada, ou já há um cancelamento em andamento. |
| 10022004 | 400 | A nota de nfceId não é normal, ou a chave substituta não é uma NFC-e offline da mesma empresa. |
| 10022007 | 400 | Prazo de 168 horas expirado. |
| 10001001 | 400 | Validação de campo; mensagem aponta o campo. |