CT-e

Listar eventos

Devuelve todos los eventos registrados en el CT-e.

GET/openapi/v2/empresas/{empresaId}/cte/{cteId}/eventos

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

Los eventos son las acciones registradas en la SEFAZ después de que el documento ya estaba autorizado: cancelación, carta de corrección, comprobante de entrega, insuceso en la entrega y sus cancelaciones. Este endpoint lista los ya registrados. La misma lista aparece como eventos en la consulta.

Parámetros de ruta

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

* Campo obligatorio

200

Array de objetos de evento; vacío cuando no se registró ningún evento.

`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

`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.

APP_SECRET='<APP_SECRET>'

API_PATH='/openapi/v2/empresas/{empresaId}/cte/{cteId}/eventos'

TIMESTAMP=$(date +%s)

SIGN=$(printf '%s%s%s' "$APP_SECRET" "$API_PATH" "$TIMESTAMP" | md5sum | cut -d' ' -f1)

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

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

[

{

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

}

]

Listar eventos

Parámetros

Parámetros de ruta

Respuestas

Enumeraciones3 tablas

tipoTipo del evento

codigoCódigo del evento

statusCódigo de retorno del registro

Errores2 ítems

`tipo`Tipo del evento

`codigo`Código del evento

`status`Código de retorno del registro