Erros

Duas camadas. HTTP (antes da SEFAZ): campo error no JSON — o NFER barra payload inválido. SEFAZ (depois do /send): erro_cstat / erro_motivo na nota. Corrija o campo do body com PUT /v1/nfe/:id e chame /send de novo — mesmo número.

{
  "error": "VALIDATION_ERROR",
  "message": "Invalid request body",
  "details": {}
}

Códigos da API (`error`)

Status da NF-e

Retransmitir nota com erro

Não existe /retransmitir. Corrija com PUT /v1/nfe/:id (mesmo body de POST /v1/nfe) e envie de novo com POST /v1/nfe/:id/send — mesmo id, mesmo número. Vale para erro e rascunho.

1. Ver o motivo da rejeição

   GET notabash

   Copiar

   curl -s "$BASE/v1/nfe/$NFE_ID" -H "X-API-Key: $NFER_KEY" \
     | jq '{status, numero, serie, erro_cstat, erro_motivo}'

2. Corrigir os dados

   No ERP, no painel, ou via PUT /v1/nfe/:id — NCM, CFOP, destinatário, etc., conforme erro_motivo. Mesmo body de POST /v1/nfe (substituição completa). Só rascunho / erro, modelo 55. Não crie outra nota.

   PUT nota (ex.: NCM)bash

   Copiar

   curl -s -X PUT "$BASE/v1/nfe/$NFE_ID" \
     -H "X-API-Key: $NFER_KEY" \
     -H "Content-Type: application/json" \
     -d '{ /* mesmo payload do POST, com ncm/cfop corrigidos */ }'

3. Enviar de novo (mesmo número)

   Resposta 202. Mesmo id, mesmo numero/serie.

   POST sendbash

   Copiar

   curl -s -X POST "$BASE/v1/nfe/$NFE_ID/send" -H "X-API-Key: $NFER_KEY"

No painel: lista → botão Retransmitir (quando status = erro) ou menu ⋯ → Retransmitir para SEFAZ. Prefira Consultar SEFAZ antes se a última mensagem foi consumo indevido.

Rejeições SEFAZ (`cStat`)

Recorte para o ERP — não é o catálogo completo. A coluna Campo é o JSON do POST /v1/nfe (ou equivalente no cadastro). Em 108 / 109 / 584 o NFER tenta SVC sozinho (NF-e 55) — ver Conceitos.

Catálogo oficial: Portal Nacional da NF-e — erros de validação. Um guia por código no blog NFER virá depois; esta tabela é o atalho do integrador.

Tratamento recomendado