Cancelar NFS-e

Cancela a NFS-e autorizada informando código e motivo do cancelamento conforme tabela de eventos da Receita.

POSThttps://api.nfer.me/v1/nfse/:id/cancel

Chave de API (X-API-Key)

<sua_chave_api>

Headers da Requisição

X-API-Keystringobrigatório

Chave de API.

Parâmetros de Rota (Path Parameters)

idstringobrigatório

ID da NFS-e.

Exemplo: dps_55667788

Corpo da Requisição (JSON Body)

motivostringobrigatório

Justificativa do cancelamento.

Exemplo: Serviço cancelado pelo contratante

codigo_cancelamentostringopcionalpadrão: 1

Código SEFIN (padrão: 1 - Erro na emissão).

Cancelar NFS-e

curl --request POST \
  --url https://api.nfer.me/v1/nfse/:id/cancel \
  --header 'X-API-Key: <sua_chave_api>' \
  --header 'Content-Type: application/json' \
  --data '{
  "motivo": "Serviço cancelado pelo contratante",
  "codigo_cancelamento": "1"
}'

{
  "id": "dps_55667788",
  "status": "cancelada",
  "cancelada_em": "2026-09-16T22:36:00.000Z"
}