CT-e

List events

Returns every event registered on the CT-e.

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

Requires the token, timestamp and sign signature headers, see Authentication.

Events are the actions registered with SEFAZ after the document was already authorized: cancellation, correction letter, delivery receipt, delivery failure and their cancellations. This endpoint lists the ones already registered. The same list appears as eventos in the query.

Path parameters

`empresaId*`	string	Company identifier
`cteId*`	string	Document identifier

* Required field

200

Array of event objects; empty when no event has been registered.

`chaveAcesso`	string	Access key
`tipo`	string	Event type
`codigo`	string	Event code
`sequencia`	int	Sequence
`status`	string	Return code
`motivo`	string	Reason
`protocolo`	string	Protocol
`data`	string	Registration time
`linkXml`	string	Event XML link

`tipo`Event type

Values	Meaning
Cancelamento	CT-e cancellation; code 110111
CartaCorrecao	Correction letter; code 110110
Epec	EPEC contingency prior authorization, registered by the platform; code 110113
ComprovanteEntrega	Delivery receipt; code 110180
CancelamentoComprovanteEntrega	Delivery receipt cancellation; code 110181
InsucessoEntrega	Delivery failure; code 110190
CancelamentoInsucessoEntrega	Delivery failure cancellation; code 110191
PrestacaoDesacordo	Service disagreement; code 610110
CancelamentoPrestacaoDesacordo	Service disagreement cancellation; code 610111

`codigo`Event code

Values	Meaning
110111	CT-e cancellation (`Cancelamento`)
110110	Correction letter (`CartaCorrecao`)
110113	EPEC contingency prior authorization, registered by the platform (`Epec`)
110180	Delivery receipt (`ComprovanteEntrega`)
110181	Delivery receipt cancellation (`CancelamentoComprovanteEntrega`)
110190	Delivery failure (`InsucessoEntrega`)
110191	Delivery failure cancellation (`CancelamentoInsucessoEntrega`)
610110	Service disagreement (`PrestacaoDesacordo`)
610111	Service disagreement cancellation (`CancelamentoPrestacaoDesacordo`)

`status`Registration return code

The platform only returns 200 with one of these codes; any other SEFAZ return becomes 10017043.

Values	Meaning
134	Event registered; SEFAZ treats it as success
135	Event registered and linked to the CT-e
136	Event registered but not linked to the CT-e

Code	HTTP
10017003	404	`cteId` not found or not owned by the company. Check the id and the `empresaId`.
10003000	404	`empresaId` not found.

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

}

]

List events

Parameters

Path parameters

Responses

Enumerations3 tables

tipoEvent type

codigoEvent code

statusRegistration return code

Errors2 items

`tipo`Event type

`codigo`Event code

`status`Registration return code