v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB

CTe/CTeOs

Carta de correção

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.

post/cte/{referencia}/carta_correcao

Path parameters

referenciastring required

Referência do CT-e

Request body

correcaostring required

Texto da carta de correção (15 a 1000 caracteres)

data_eventostring date-time

Data do evento (se não informado será usado a data atual)

Example request

{
  "correcao": "Correção do endereço do destinatário"
}

Response

Requisição processada com sucesso

status'autorizado' | 'erro_autorizacao'

Status da carta de correção

status_sefazstring

Status na SEFAZ

mensagem_sefazstring

Mensagem descritiva da SEFAZ

caminho_xml_carta_correcaostring

Caminho para download do XML

caminho_pdf_carta_correcaostring

Caminho para download do PDF

numero_carta_correcaointeger

Número da carta de correção

Example response

{
  "status": "autorizado",
  "status_sefaz": "135",
  "mensagem_sefaz": "Evento registrado e vinculado a NF-e",
  "numero_carta_correcao": 1
}