CT-e

Carta de corrección

Registra el evento 110110 (carta de corrección) en un CT-e autorizado.

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

Requiere las cabeceras de firma token, timestamp y sign, vea Autenticación.

Enviado de forma síncrona; en caso de éxito se devuelve el objeto del evento. Permitido dentro de 720 horas tras la autorización (10017049); la secuencia se incrementa automáticamente, con un límite de 20 cartas (10017044). Una vez registrada una carta de corrección, el documento ya no puede cancelarse (10017048 en la cancelación).

Parámetros

Parámetros de ruta

empresaIdstringobligatorio
Identificador de la empresa (transportista) devuelto en el registro.
Ejemplo: 1934811222334455
cteIdstringobligatorio
El id enviado en la emisión del CT-e.
Ejemplo: CTE-ORD-1

Cuerpo de la petición

correcoesarrayobligatorio
Elementos de corrección, de 1 a 100.

Respuestas

200

Evento registrado en la SEFAZ. El objeto del evento se devuelve de forma síncrona.

chaveAcessostring
Clave de acceso de 44 dígitos del CT-e al que se vinculó el evento.
tipostring
Tipo del evento.
Valores:CancelamentoCartaCorrecaoComprovanteEntregaCancelamentoComprovanteEntregaInsucessoEntregaCancelamentoInsucessoEntregaPrestacaoDesacordoCancelamentoPrestacaoDesacordoEpec
codigostring
Código del evento en la SEFAZ (tpEvento): 110111, 110110, 110113, 110180, 110181, 110190, 110191, 610110, 610111.
sequenciainteger
Número secuencial del evento dentro de su tipo (la carta de corrección se incrementa automáticamente).
statusstring
cStat devuelto por la SEFAZ; 135 significa evento registrado y vinculado.
motivostring
xMotivo devuelto por la SEFAZ.
protocolostring
Número de protocolo del evento; úselo como protocoloEvento para cancelar el evento.
datastring
Fecha y hora del registro del evento, ISO-8601 en UTC.
linkXmlstring
Enlace de descarga del XML del evento (procEvento). Vea Descarga de archivos.

Errores

Código	HTTP
CTe0001	404	`cteId` no encontrado o no pertenece a la empresa. Verifique el id y el `empresaId`.
10003000	404	`empresaId` no encontrado.
10017040	400	El estado del documento no permite el evento; el CT-e debe estar `Autorizada`.
10017042	400	Texto del evento inválido (longitud fuera del rango tras la sanitización).
10017043	400	La SEFAZ rechazó el evento; `mensagem` trae el cStat y el motivo.
10017044	400	Límite de secuencia de la carta de corrección alcanzado (20 por documento).
10017049	400	Carta de corrección fuera de la ventana de 720 horas tras la autorización.
10001001	400	Falló la validación de campos (una entrada por campo); corrija según `mensagem`.

Sanitización de texto y coordenadas

Los campos de texto se sanitizan (acentos eliminados, espacios en blanco consolidados) antes de la validación de longitud; un texto que queda fuera del rango tras la sanitización devuelve 10017042. Las coordenadas se registran con seis decimales.

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=..."

}