Treeunfe API home pagelight logo
  1. Eventos de NF-e
  2. Cancelar NF-e
POST
/nfe/{nfeId}/cancel
curl --request POST \
     --url https://api.treeunfe.com.br/api/v1/nfe/{nfeId}/cancel \
     --header 'x-api-key: <api-key>' \
     --header 'x-api-key: <x_api_key>' \
     --header 'Content-Type: application/json' \
     --data '{
  "xJust": "<string>"
}'

Registra o evento de cancelamento de uma NF-e autorizada, dentro do prazo da SEFAZ da UF.

​
Autenticação

x-api-key
required
string

API Key da organization (rawKey).

​
Parâmetros de rota

nfeId
required
string

ID (UUID) da NF-e na Treeunfe.

​
Body

application/json

xJust
required
string

Justificativa do cancelamento (15 a 255 caracteres).

​
Respostas

StatusDescrição
200Evento processado.
400Body inválido (campo obrigatório ausente, formato incorreto ou campo não permitido).
401Credencial ausente, inválida ou expirada.
404Recurso não encontrado.
422Cancelamento rejeitado pela SEFAZ (por exemplo
curl -X POST "https://api.treeunfe.com.br/api/v1/nfe/006f917a-21a5-491d-90b4-f745d96385e7/cancel" \
  -H "x-api-key: RAW_KEY_DA_ORGANIZATION" \
  -H "Content-Type: application/json" \
  -d '{
    "xJust": "Valor incorreto informado na nota"
  }'