Skip to main content

Cancelar uma nota fiscal

POST 
/v2/faturamento/notaFiscal/:identificador/cancelar

Realiza o cancelamento fiscal da Nota Fiscal, o que inclui a comunicação com o SEFAZ para efetivar o cancelamento junto à Receita. Não se trata de uma simples alteração da situação interna da nota, como faz o endpoint PUT /v2/site/pedido/{codigoPedido}/notaFiscal/{chave}.

A nota é localizada diretamente no cadastro de Notas Fiscais, portanto o cancelamento não depende de a nota possuir vínculo com um pedido e atende notas originadas por pedidos do site, lançamentos manuais, marketplaces e demais fluxos.

A situação da nota só é atualizada para Cancelada quando o cancelamento fiscal é confirmado pelo SEFAZ. Enquanto o retorno não é processado a resposta é HTTP 202 e a nota permanece em Em Cancelamento (7) ou Inutilização Pendente (11). Utilize GET /v2/faturamento/notaFiscal/{identificador} para acompanhar a situação final. Se o SEFAZ rejeitar o cancelamento, a nota fica em Cancelamento Rejeitado (8) e não é apresentada como cancelada.

Situações que permitem o cancelamento: notas de saída em Digitada (1) ou Autorizada (3), e também Em Cancelamento (7) quando a série utiliza gateway de NFS-e IPM; notas de entrada em Digitada (1), Autorizada (3), Autorização Rejeitada (6) ou Cancelamento Rejeitado (8), e também Fechada (2) quando o CFOP não realiza autorização de entrada.

Request​

Responses​

Operação chegou a um estado final, sem retorno pendente do SEFAZ. A nota fica Cancelada (4) quando houve cancelamento fiscal confirmado, ou Inutilizada (9) quando o documento nunca foi autorizado e a numeração foi inutilizada. Confira o campo cancelamentoConfirmado.