---
title: "Registra uma carta de correção (CC-e)"
method: POST
path: "/v1/nfe/{id}/cartas-correcao"
tags: ["Emissão de NF-e"]
---

# Registra uma carta de correção (CC-e)

`POST /v1/nfe/{id}/cartas-correcao`

## Request

- Base URL: `https://api.sudrel.com.br/api`
- URL: `https://api.sudrel.com.br/api/v1/nfe/{id}/cartas-correcao`
- Auth: HTTP bearer

Evento 110110, até 20 por nota, numeradas em sequência; cada uma substitui
a anterior, então mande o texto completo de tudo o que corrige. A condição
de uso oficial vai no evento. A resposta traz `aviso`
`carta_correcao_limites` com o que a carta não pode corrigir: a Sudrel não
lê o texto e não bloqueia.

## Path parameters

- `id` string, required

## Query parameters

- `empresa_id` string

## Request body

- object
  - `correcao` string, required

## Response `200`

Registrada. A carta aparece em `cartas_correcao`.

- object
  - `id` string
  - `referencia` string, nullable
  - `status` 'transmitindo' | 'aguardando_confirmacao' | 'autorizada' | 'rejeitada' | 'denegada' | 'cancelada' | 'descartada' | 'contingencia_epec'
  - `empresa_id` string
  - `ambiente` 'sandbox' | 'producao'
  - `simulacao` string, nullable
  - `modo` 'informado' | 'calcular' | 'conferir'
  - `modelo` 55
  - `serie` integer
  - `numero` integer
  - `chave_acesso` string
  - `chaves_anteriores` string[]: Chaves que a nota teve antes de uma correção num mês seguinte.
  - `chave_referenciada` string, nullable: Chave da NF-e de origem referenciada (devolução, complementar); null quando a nota não referencia nenhuma.
  - `protocolo` string, nullable
  - `emitida_em` string, date-time, nullable
  - `autorizada_em` string, date-time, nullable
  - `valor_total` string, nullable
  - `sefaz` object, nullable
    - `cstat` string
    - `motivo` string
  - `rejeicao` NfeRecusa, nullable
    - `codigo_oficial` string: cStat da SEFAZ.
    - `mensagem` string: xMotivo da SEFAZ.
    - `explicacao` object, nullable
      - `codigo` string
      - `campo` string, nullable
      - `correcao` string
  - `denegacao` NfeRecusa, nullable
    - `codigo_oficial` string: cStat da SEFAZ.
    - `mensagem` string: xMotivo da SEFAZ.
    - `explicacao` object, nullable
      - `codigo` string
      - `campo` string, nullable
      - `correcao` string
  - `falha_envio` object, nullable: Nota em `transmitindo` que ainda não chegou à SEFAZ por uma falha antes do envio. Com `certificado_recusado_pela_sefaz`, a SEFAZ recusou o certificado sem processar a nota (nenhuma NF-e foi criada lá): a Sudrel tenta de novo em `proxima_tentativa`, e a prontidão mostra o item `certificado_sefaz`. Com `envio_pausado`, a recusa se repetiu (3 vezes, por padrão) e a Sudrel parou de tentar (webhook `NFE_ENVIO_PAUSADO`): a nota volta sozinha quando o certificado passar no teste da prontidão (um certificado novo, ou o mesmo uma hora depois).
    - `motivo` 'certificado_recusado_pela_sefaz' | 'envio_pausado' | 'uf_indisponivel' | 'falha_antes_do_envio'
    - `mensagem` string
    - `desde` string, date-time, nullable
    - `proxima_tentativa` string, date-time, nullable
    - `pausado_em` string, date-time, nullable
  - `contingencia` object, nullable: A nota entrou em contingência (veja Contingência da NF-e). Nulo na emissão normal.
    - `modo` 'svc_an' | 'svc_rs' | 'epec'
    - `tp_emis` 4 | 6 | 7
    - `situacao` 'em_contingencia' | 'autorizada_em_contingencia' | 'epec_registrado' | 'epec_prazo_proximo' | 'epec_rejeitado' | 'duplicata_cancelada' | 'duplicata_nao_cancelada' | 'duplicata_original_denegada'
    - `motivo` string: A justificativa (xJust) impressa no DANFE.
    - `desde` string, date-time
    - `chave_original` string: A chave tpEmis 1, que nunca foi transmitida.
    - `chave_original_transmitida` false
    - `epec` object, nullable
      - `protocolo` string
      - `registrado_em` string, date-time
      - `prazo_transmissao` string, date-time: 168 horas depois do EPEC.
      - `correcao` string, nullable
    - `reconciliacao` object, nullable
      - `em` string, date-time
      - `resultado` 'original_inexistente' | 'duplicata_cancelada' | 'duplicata_nao_cancelada' | 'duplicata_original_denegada'
  - `confirmacao` object, nullable
    - `motivo` string
    - `desde` string, date-time, nullable
    - `mensagem` string
    - `correcao` string
  - `descarte` object, nullable
    - `em` string, date-time
    - `automatico` boolean
    - `motivo` string, nullable
  - `cancelamento` object, nullable
    - `em` string, date-time
    - `protocolo` string
    - `justificativa` string
  - `cartas_correcao` object[]
    - `sequencia` integer
    - `texto` string
    - `status` 'transmitindo' | 'registrada' | 'rejeitada'
    - `protocolo` string, nullable
    - `sefaz` object, nullable
      - `cstat` string
      - `motivo` string
    - `em` string, date-time
  - `ajustes` object[]
    - `campo` string
    - `acao` 'preenchido' | 'derivado' | 'exigido' | 'omitido' | 'calculado' | 'divergente'
    - `motivo` string
    - `regra` string
    - `valor` unknown
    - `versao` string: Versão da regra, tabela ou calculadora.
    - `fonte` string: Fonte legal do valor.
  - `eventos` object[]
    - `tipo` string
    - `em` string, date-time
    - `detalhe` object
  - `regras_versao` string
  - `criada_em` string, date-time
  - `atualizada_em` string, date-time
  - `links` object
    - `self` string
    - `xml` string
    - `danfe` string
  - `aviso` object
    - `codigo` string
    - `mensagem` string
    - `sequencia` integer

## Other responses

- `202`: A resposta da SEFAZ não chegou; a Sudrel consulta e conclui sozinha (webhook `NFE_CARTA_CORRECAO_REGISTRADA`).
- `401`: `nao_autenticado`: chave de API ausente, inválida ou revogada.
- `404`: `nfe_nao_encontrada`: nenhuma NF-e com esse id, referência ou chave de acesso nesta conta e neste ambiente.
- `409`: `nfe_nao_aceita_carta_correcao` (só nota `autorizada`) ou `carta_correcao_em_andamento` (espere a anterior terminar).
- `422`: `evento_invalido` (texto de 15 a 1.000 caracteres), `limite_cartas_correcao` (as 20 cartas já foram usadas) ou `carta_correcao_recusada` (a SEFAZ recusou; o `cStat` vem em `codigo_oficial` e a nota inteira em `nfe`).

---

[API](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e.md) · [All operations](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/llms.txt) · [OpenAPI document](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/revisions/efd7baba9e37?raw)