Cancelar NFe / NFCe

POST/v1/nfe/{id}/cancel

Cancela um documento fiscal já autorizado. Assim como a emissão, o cancelamento é assíncrono: a resposta 202 Accepted só confirma que a solicitação entrou na fila, não que a SEFAZ já aceitou o cancelamento. Consulte GET /v1/nfe/{id} até o status mudar para CANCELADA (ou permanecer AUTORIZADA, se a SEFAZ rejeitar o cancelamento).

Cancelando NFC-e

Se o documento for uma NFC-e, use POST /v1/nfc-e/{id}/cancel em vez de /v1/nfe/{id}/cancel — o restante do contrato é idêntico. O mesmo endpoint de cancelamento existe em todos os namespaces (/v1/cte/{id}/cancel, /v1/mdfe/{id}/cancel, etc.).

Prazo legal

O cancelamento de NF-e/NFC-e/CT-e/MDF-e só é aceito pela SEFAZ dentro do prazo legal — normalmente 24 horas após a autorização (o prazo exato varia por UF e modelo de documento). Fora desse prazo, use a Carta de Correção para ajustes que não alterem valores, tributação, dados cadastrais das partes ou a data de emissão.

Parâmetros do corpo

reasonstringobrigatório

Justificativa do cancelamento (mínimo de caracteres exigido pela SEFAZ, geralmente 15).

Resposta

202 Accepted

messagestring

Confirmação de que a solicitação de cancelamento entrou na fila de processamento.

cURL

curl -X POST https://app.nfe.tenzanlabs.com/v1/nfe/35f0a1b2-.../cancel \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI" \
  -H "Authorization: Bearer nfe_test_SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Erro na descrição do produto"
  }'

Node.js

const resposta = await client.cancel('55', invoiceId, {
  reason: 'Erro na descrição do produto',
});
console.log(resposta.message); // 'Cancelamento enfileirado para processamento'

Python

resposta = client.cancel("55", invoice_id, "Erro na descrição do produto")
print(resposta["message"])  # 'Cancelamento enfileirado para processamento'

Java

AsyncOperationResponse resposta = client.cancel("55", invoiceId, "Erro na descrição do produto");
System.out.println(resposta.message);

Exemplo de resposta

{
  "message": "Cancelamento enfileirado para processamento"
}