CT-e

Carta de correção

Registra o evento 110110 (carta de correção) em um CT-e autorizado.

POST/openapi/v2/empresas/{empresaId}/cte/{cteId}/carta-correcao

Requer os cabeçalhos de assinatura token, timestamp e sign, veja Autenticação.

Enviado de forma síncrona; em caso de sucesso o objeto do evento é devolvido. Permitido dentro de 720 horas após a autorização (10017049); a sequência incrementa automaticamente, com limite de 20 cartas (10017044). Depois que uma carta de correção é registrada, o documento não pode mais ser cancelado (10017048 no cancelamento).

Parâmetros

Parâmetros de caminho

empresaIdstringobrigatório
Identificador da empresa (transportadora) devolvido no registro.
Exemplo: 1934811222334455
cteIdstringobrigatório
O id enviado na emissão do CT-e.
Exemplo: CTE-ORD-1

Corpo da requisição

correcoesarrayobrigatório
Itens de correção, de 1 a 100.

Respostas

200

Evento registrado na SEFAZ. O objeto do evento é devolvido de forma síncrona.

chaveAcessostring
Chave de acesso de 44 dígitos do CT-e ao qual o evento foi vinculado.
tipostring
Tipo do evento.
Valores:CancelamentoCartaCorrecaoComprovanteEntregaCancelamentoComprovanteEntregaInsucessoEntregaCancelamentoInsucessoEntregaPrestacaoDesacordoCancelamentoPrestacaoDesacordoEpec
codigostring
Código do evento na SEFAZ (tpEvento): 110111, 110110, 110113, 110180, 110181, 110190, 110191, 610110, 610111.
sequenciainteger
Número sequencial do evento dentro do tipo (a carta de correção incrementa automaticamente).
statusstring
cStat devolvido pela SEFAZ; 135 significa evento registrado e vinculado.
motivostring
xMotivo devolvido pela SEFAZ.
protocolostring
Número de protocolo do evento; use-o como protocoloEvento para cancelar o evento.
datastring
Data e hora do registro do evento, ISO-8601 em UTC.
linkXmlstring
Link de download do XML do evento (procEvento). Veja Download de arquivos.

Erros

Código	HTTP
CTe0001	404	`cteId` não encontrado ou não pertence à empresa. Verifique o id e o `empresaId`.
10003000	404	`empresaId` não encontrado.
10017040	400	O status do documento não permite o evento; o CT-e precisa estar `Autorizada`.
10017042	400	Texto do evento inválido (comprimento fora do intervalo após a sanitização).
10017043	400	A SEFAZ rejeitou o evento; `mensagem` traz o cStat e o motivo.
10017044	400	Limite de sequência da carta de correção atingido (20 por documento).
10017049	400	Carta de correção fora da janela de 720 horas após a autorização.
10001001	400	Falha de validação de campos (uma entrada por campo); corrija conforme `mensagem`.

Sanitização de texto e coordenadas

Os campos de texto são sanitizados (acentos removidos, espaços em branco consolidados) antes da validação de comprimento; um texto que fica fora do intervalo após a sanitização retorna 10017042. As coordenadas são registradas com seis casas decimais.

APP_SECRET='<APP_SECRET>'

API_PATH='/openapi/v2/empresas/{empresaId}/cte/{cteId}/carta-correcao'

TIMESTAMP=$(date +%s)

BODY='{

"correcoes": [

{ "grupo": "compl", "campo": "xObs", "valor": "Entrega no periodo da manha" }

]

SIGN=$(printf '%s%s%s%s' "$APP_SECRET" "$API_PATH" "$(printf '%s' "$BODY" | tr -d '\r\n')" "$TIMESTAMP" | md5sum | cut -d' ' -f1)

curl -sS -X POST "https://api.v2.tffiscal.com${API_PATH}" \

-H "Content-Type: application/json" \

-H "token: $APP_SECRET" -H "timestamp: $TIMESTAMP" -H "sign: $SIGN" \

--data-binary "$BODY"

{

"chaveAcesso": "35260940673061000134570010000000011000000010",

"tipo": "CartaCorrecao",

"codigo": "110110",

"sequencia": 1,

"status": "135",

"motivo": "Evento registrado e vinculado ao CT-e",

"protocolo": "135260000000099",

"data": "2026-09-06T13:00:00Z",

"linkXml": "https://.../openapi/files/xml/12?token=..."

}