Lançar carta de correção (CC-e)

A Carta de Correção Eletrônica (CC-e) permite corrigir erros não-críticos em uma NFe já autorizada, sem cancelar e re-emitir. Use para erros de descrição, observação, endereço, etc.

Pré-requisitos

NFe autorizada (status: "004").
Chave de acesso da NFe (44 caracteres).
Texto da correção entre 15 e 255 caracteres.

Fluxo

Enviar a CC-e

curl -X POST $BASE/nfe/correcao \
  -H "Authorization: Token $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "chave": "35260512345678000199550010000000011000000010",
    "motivo": "Correção da descrição do item 3 — modelo correto: XYZ-2."
  }'

Resposta:

{
  "status": "001",
  "descricao": "Evento registrado com sucesso.",
  "data": { "recibo": "rec_correcao_001" }
}

Consultar o resultado

Polling com intervalo mínimo de 2 segundos:

curl $BASE/nfe/correcao/rec_correcao_001 \
  -H "Authorization: Token $TOKEN"

Quando aceita pela SEFAZ:

{
  "status": "004",
  "descricao": "Evento emitido com sucesso.",
  "data": { ... }
}

Limites do `motivo` (texto da correção)

Regra	Valor
Tamanho mínimo	15 caracteres
Tamanho máximo	255 caracteres
Quebras de linha	Substituídas por espaço

Exemplos de motivos válidos

✅ "Correção da descrição do item 3 — modelo correto: XYZ-2."
✅ "Correção do endereço de entrega: rua correta é Av. das Flores, 1000."
✅ "Acréscimo de informação complementar: pedido referente à OC 12345."
✅ "Correção do nome fantasia do destinatário."

Múltiplas CC-e

A SEFAZ permite até 20 CC-e por NFe. Cada nova correção substitui a anterior (é cumulativa) — o texto deve sempre representar o estado final correto, não apenas o que mudou desde a última.

Diferença entre cancelamento e CC-e

Cenário	Usar
Valor errado, item errado, destinatário errado	Cancelamento + nova nota
Descrição imprecisa, observação esquecida, endereço incorreto	CC-e
Erro de digitação na razão social	CC-e
Mudança de CFOP / CST	Cancelamento + nova nota

Erros comuns

Mensagem	Causa
`Campo nfe@chave deve ter 44 caracteres.`	Chave incorreta
`Campo nfe@motivo deve ter entre 15 e 255 caracteres.`	Texto curto ou longo demais
`status: "900"` (rejeição SEFAZ)	Tentou corrigir campo vedado, NFe não pertence à empresa, ou prazo excedido

Próximos passos

Cancelar uma NFe — quando CC-e não resolve.
Códigos de status — para tratar todas as respostas.