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.

La carta de corrección arregla información secundaria de un CT-e ya autorizado sin cancelarlo ni emitir otro documento; no sirve para cambiar importes, participantes o fechas que afecten al impuesto. Enviada de forma síncrona; en caso de éxito se devuelve el objeto del evento. Permitida 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 de ruta

`empresaId*`	string	Identificador de la empresa
`cteId*`	string	Identificador del documento

* Campo obligatorio

Cuerpo de la petición

*

array

Correcciones

* Campo obligatorio

200

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

`chaveAcesso`	string	Clave de acceso
`tipo`	string	Tipo del evento
`codigo`	string	Código del evento
`sequencia`	int	Secuencia
`status`	string	Código de retorno
`motivo`	string	Motivo
`protocolo`	string	Protocolo
`data`	string	Fecha del registro
`linkXml`	string	Enlace del XML del evento

Antes de medir la longitud, la plataforma limpia los campos de texto: se eliminan los acentos y los espacios en blanco repetidos se reducen a uno. Esto ocurre antes de la validación de longitud; un texto que queda fuera del rango tras esa limpieza devuelve 10017042.

`tipo`Tipo del evento

Valores	Significado
Cancelamento	Cancelación del CT-e; código 110111
CartaCorrecao	Carta de corrección; código 110110
Epec	Autorización previa en contingencia EPEC, registrada por la plataforma; código 110113
ComprovanteEntrega	Comprobante de entrega; código 110180
CancelamentoComprovanteEntrega	Cancelación del comprobante de entrega; código 110181
InsucessoEntrega	Insuceso en la entrega; código 110190
CancelamentoInsucessoEntrega	Cancelación del insuceso en la entrega; código 110191
PrestacaoDesacordo	Prestación en desacuerdo; código 610110
CancelamentoPrestacaoDesacordo	Cancelación de la prestación en desacuerdo; código 610111

`codigo`Código del evento

Valores	Significado
110111	Cancelación del CT-e (`Cancelamento`)
110110	Carta de corrección (`CartaCorrecao`)
110113	Autorización previa en contingencia EPEC, registrada por la plataforma (`Epec`)
110180	Comprobante de entrega (`ComprovanteEntrega`)
110181	Cancelación del comprobante de entrega (`CancelamentoComprovanteEntrega`)
110190	Insuceso en la entrega (`InsucessoEntrega`)
110191	Cancelación del insuceso en la entrega (`CancelamentoInsucessoEntrega`)
610110	Prestación en desacuerdo (`PrestacaoDesacordo`)
610111	Cancelación de la prestación en desacuerdo (`CancelamentoPrestacaoDesacordo`)

`status`Código de retorno del registro

La plataforma solo devuelve 200 con uno de estos códigos; cualquier otro retorno de la SEFAZ se convierte en 10017043.

Valores	Significado
134	Evento registrado; la SEFAZ lo trata como éxito
135	Evento registrado y vinculado al CT-e
136	Evento registrado, pero no vinculado al CT-e

Código	HTTP
10017003	404	`cteId` no encontrado o no pertenece a la empresa. Verifique el id y el `empresaId`.
10003000	404	`empresaId` no encontrado.
10017004	400	La empresa no está en condición de emitir: deshabilitada o certificado no disponible. Registrar eventos también exige el certificado; reactive la empresa o vincule un certificado válido.
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 su código de retorno 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`.

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": "35260940673061000134570010000000011000000016",

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

}

Carta de corrección

Parámetros

Parámetros de ruta

Cuerpo de la petición

Respuestas

Sanitización de texto

Enumeraciones3 tablas

tipoTipo del evento

codigoCódigo del evento

statusCódigo de retorno del registro

Errores9 ítems

`tipo`Tipo del evento

`codigo`Código del evento

`status`Código de retorno del registro