---
title: "Carta de correção"
method: POST
path: "/cte/{referencia}/carta_correcao"
tags: ["CTe/CTeOs"]
---

# Carta de correção

`POST /cte/{referencia}/carta_correcao`

## Request

- Base URL: `https://api.focusnfe.com.br/v2`
- URL: `https://api.focusnfe.com.br/v2/cte/{referencia}/carta_correcao`
- Auth: HTTP basic

Uma Carta de Correção eletrônica (CCe) pode ser utilizada para corrigir eventuais erros na CTe. As seguintes informações não podem ser corrigidas:

* As variáveis que determinam o valor do imposto tais como: base de cálculo, alíquota, diferença de preço, quantidade e etc...
* A correção de dados cadastrais que implique mudança do remetente ou do destinatário.
* A data de emissão ou de saída.

Não existe prazo especificado para emissão de cartas de correção. É possível enviar até 20 correções diferentes, sendo que será válido somente a última correção enviada.

Este endpoint possui retorno **síncrono**.

Na carta de correção para CT-e é obrigatório informar o campo que será alterado. Você pode utilizar os próprios nomes dos campos da API.

Veja abaixo os campos que podem ser enviados na requisição.

## Path parameters

- `referencia` string, required

## Request body

- CartaCorrecaoRequest
  - `grupo_corrigido` string: Indica o grupo onde se encontra o campo, por exemplo "cargas". Pode ser omitido se não houver grupo relacionado.
  - `campo_corrigido` string, required: Indica o campo a ser corrigido
  - `valor_corrigido` string, required: Indica o novo valor do campo
  - `numero_item_grupo_corrigido` string: Caso o campo pertença a uma lista de itens, o número do item a ser corrigido é informado aqui. O primeiro número começa em 1.
  - `campo_api` string: Se igual a 1 será usado o nome do campo da API nos campos 'grupo_corrigido' e 'campo_corrigido'. Se igual a 0 você deverá informar a tag XML. Valor default é 1.

## Response `200`

Requisição processada com sucesso

- CartaCorrecaoResponse
  - `status` string: Status do CCe
  - `status_sefaz` string: Status da SEFAZ
  - `mensagem_sefaz` string: Mensagem da SEFAZ
  - `caminho_xml` string: Caminho do XML da CCe
  - `numero_carta_correcao` string: Número da CCe

## Other responses

- `400`: Requisição inválida
- `401`: Não autorizado
- `404`: Recurso não encontrado

---

[API](https://skmtc.dev/focusnfe/apis/cte-cteos.md) - [All operations](https://skmtc.dev/focusnfe/apis/cte-cteos/llms.txt) - [OpenAPI document](https://skmtc.dev/focusnfe/apis/cte-cteos/revisions/08b71d5f64bf?raw)
