NF-e

Cancelar NF-e

Cancela uma nota autorizada dentro de 24 horas da autorização.

DELETE/openapi/v2/empresas/{empresaId}/nf-e/{nfeId}

Requer os cabeçalhos de assinatura token, timestamp e sign, veja Autenticação.

Cancela uma nota autorizada; o sucesso é HTTP 200 sem corpo e a consulta passa a retornar Cancelada. Erros de autenticação (10009xxx) estão em Autenticação.

Parâmetros

Parâmetros de caminho

empresaIdstringobrigatório
Identificador da empresa devolvido em Registrar empresa.
Exemplo: 1934811222334455
nfeIdstringobrigatório
O id enviado na emissão.
Exemplo: NFe-000014553

Respostas

200

Cancelamento registrado na SEFAZ; sem corpo.

Sem corpo de resposta

Erros

Código	HTTP
NFe0001	404	O `nfeId` não existe. Verifique o id enviado na emissão e o `empresaId`.
10003000	404	`empresaId` não existe ou não pertence a esta aplicação.
10004012	400	A nota não está em status autorizado. Consulte para confirmar o status.
10004013	400	Fora da janela de 24 horas. Emita uma nota de devolução em vez disso.
10004014	400	Recusado pela SEFAZ (código de status e motivo anexados). Atue conforme o motivo da SEFAZ.

Regras

Somente notas Autorizada podem ser canceladas; outros status retornam 10004012.
Dentro de 24 horas da autorização (alguns estados permitem mais, conforme configuração da plataforma); fora da janela retorna 10004013, e só resta emitir uma nota de devolução.
Uma recusa da SEFAZ retorna 10004014 com o código de status e o motivo da SEFAZ.
nfeId desconhecido retorna HTTP 404 + NFe0001.
Cartas de correção já registradas continuam consultáveis depois do cancelamento, veja Listar cartas de correção.