CT-e

Query CT-e

Returns status, document data, XML / DACTE download links and the event list.

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

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

Queries by the id sent at issuance. Download links are 10-minute short-lived tokens, re-issued on every query. An unknown cteId returns HTTP 404 with codigo CTe0001.

Parameters

Path parameters

empresaIdstringrequired
Company (carrier) identifier returned at registration.
Example: 1934811222334455
cteIdstringrequired
The id sent at CT-e issuance.
Example: CTE-ORD-1

Responses

200

Document found.

idstring
Integrator document id.
statusstring
Document status; see the status table below.
Values:PendenteAutorizadaNegadaCanceladaContingenciaFalha
motivoStatusstring
Status explanation: cStat - xMotivo for Negada, local reason for Falha; null otherwise.
numerointeger
CT-e number.
serieinteger
CT-e series.
chaveAcessostring
44-digit access key.
numeroProtocolostring
SEFAZ authorization protocol.
dataEmissaostring
Issue date, ISO-8601 in UTC.
dataAutorizacaostring
Authorization date, ISO-8601 in UTC.
tipoEmissaostring
Emission type; shows contingency (SVC / EPEC) when the platform switched to it.
Values:NormalEpecFsdaSvcRsSvcSp
protocoloEpecstring
EPEC protocol when issued under EPEC contingency; null otherwise.
linkXmlstring
Authorized XML (cteProc), the legal original. See File download.
linkDactestring
DACTE PDF, rendered on the first download; a busy renderer returns 503, retry later.
cteobject
The issuance request body while the task is in flight; after a terminal state (Autorizada / Negada / Falha) the accepted parameters are cleared and this field is null.
eventosarray
Events registered on the document (same shape as List events, without chaveAcesso).

Errors

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

Status table

`status`	Meaning
`Pendente`	Accepted, queued or being sent
`Autorizada`	Authorized by SEFAZ (cStat 100); `linkXml` is the cteProc legal original, `linkDacte` the DACTE PDF
`Negada`	Rejected by SEFAZ; `motivoStatus` is `cStat - xMotivo`
`Cancelada`	Cancelled (110111)
`Contingencia`	SEFAZ outage, document pending resubmission
`Falha`	Terminal task failure (unparseable parameters, retry budget exhausted, ...); `motivoStatus` explains; the same `id` may be resubmitted

APP_SECRET='<APP_SECRET>'

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

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"

{

"id": "CTE-ORD-1",

"status": "Autorizada",

"motivoStatus": null,

"numero": 1,

"serie": 1,

"chaveAcesso": "35260940673061000134570010000000011000000010",

"numeroProtocolo": "135260000000001",

"dataEmissao": "2026-09-06T12:00:00Z",

"dataAutorizacao": "2026-09-06T12:00:03Z",

"tipoEmissao": "Normal",

"protocoloEpec": null,

"linkXml": "https://api.v2.tffiscal.com/openapi/files/xml/7?token=...",

"linkDacte": "https://api.v2.tffiscal.com/openapi/files/dacte/35260940673061000134570010000000011000000010?token=...",

"cte": null,

"eventos": [

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

]

}