NF-e (Produto)

Cancelar NF-e

Registra o evento de cancelamento da NF-e na SEFAZ dentro do prazo legal. Exige justificativa com no mínimo 15 caracteres.

POST
https://api.nfer.me
/v1/nfe/{id}/cancel

Authorizations

X-API-Key
string
header
required

Chave de API emitida no painel NFER enviada no header da requisição.

Content-Type
string
header
required

application/json

Path Parameters

id
string<uuid>
required

UUID da NF-e autorizada.

Exemplo:b7c2930a-48a1-4fd8-879e-4a671cfbd992

Body

application/json
justificativa
string
required

Motivo do cancelamento (mínimo 15 caracteres).

Exemplo:Cancelamento por desistência de compra pelo cliente

Response

application/json

NF-e cancelada com sucesso na SEFAZ.

id
string<uuid>

Identificador único do recurso.

Exemplo:b7c2930a-48a1-4fd8-879e-4a671cfbd992
status
string

Status atual do processamento da nota.

Exemplo:cancelada
protocolo_cancelamento
string

Exemplo retornado: "141260000789012"

Exemplo:141260000789012
cStat
integer
Exemplo:135
xMotivo
string

Exemplo retornado: "Evento registrado e vinculado a NF-e"

Exemplo:Evento registrado e vinculado a NF-e
cancelada_em
string<date-time>

Exemplo retornado: "2026-09-16T22:32:00.000Z"

Exemplo:2026-09-16T22:32:00.000Z
Cancelar NF-e
curl --request POST \
  --url https://api.nfer.me/v1/nfe/{id}/cancel \
  --header 'X-API-Key: <sua_chave_api>' \
  --header 'Content-Type: application/json' \
  --data '{
  "justificativa": "Cancelamento por desistência de compra pelo cliente"
}'
{
  "id": "b7c2930a-48a1-4fd8-879e-4a671cfbd992",
  "status": "cancelada",
  "protocolo_cancelamento": "141260000789012",
  "cStat": 135,
  "xMotivo": "Evento registrado e vinculado a NF-e",
  "cancelada_em": "2026-09-16T22:32:00.000Z"
}