CT-e

Consultar CT-e

Devolve status, dados do documento, links de XML / DACTE e a lista de eventos.

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

Requer os cabeçalhos de assinatura token, timestamp e sign, veja Autenticação.

Consulta pelo id enviado na emissão. Os links de download são tokens de curta duração (10 minutos), reemitidos a cada consulta. Um cteId desconhecido retorna HTTP 404 com codigo CTe0001.

Parâmetros

Parâmetros de caminho

empresaIdstringobrigatório
Identificador da empresa (transportadora) devolvido no registro.
Exemplo: 1934811222334455
cteIdstringobrigatório
O id enviado na emissão do CT-e.
Exemplo: CTE-ORD-1

Respostas

200

Documento encontrado.

idstring
Identificador do documento no integrador.
statusstring
Status do documento; veja a tabela de status abaixo.
Valores:PendenteAutorizadaNegadaCanceladaContingenciaFalha
motivoStatusstring
Explicação do status: cStat - xMotivo em Negada, motivo local em Falha; null nos demais.
numerointeger
Número do CT-e.
serieinteger
Série do CT-e.
chaveAcessostring
Chave de acesso de 44 dígitos.
numeroProtocolostring
Protocolo de autorização da SEFAZ.
dataEmissaostring
Data de emissão, ISO-8601 em UTC.
dataAutorizacaostring
Data de autorização, ISO-8601 em UTC.
tipoEmissaostring
Tipo de emissão; mostra a contingência (SVC / EPEC) quando a plataforma a acionou.
Valores:NormalEpecFsdaSvcRsSvcSp
protocoloEpecstring
Protocolo do EPEC quando emitido em contingência EPEC; null caso contrário.
linkXmlstring
XML autorizado (cteProc), o original legal. Veja Download de arquivos.
linkDactestring
PDF do DACTE, renderizado no primeiro download; um renderizador ocupado retorna 503, tente de novo mais tarde.
cteobject
Corpo da requisição de emissão enquanto a tarefa está em andamento; após um estado terminal (Autorizada / Negada / Falha) os parâmetros aceitos são descartados e o campo é null.
eventosarray
Eventos registrados no documento (mesma forma que Listar eventos, sem chaveAcesso).

Erros

Código	HTTP
CTe0001	404	`cteId` não encontrado ou não pertence à empresa. Verifique o id e o `empresaId`.
10003000	404	`empresaId` não encontrado.

Tabela de status

`status`	Significado
`Pendente`	Aceito, na fila ou em envio
`Autorizada`	Autorizado pela SEFAZ (cStat 100); `linkXml` é o original legal cteProc, `linkDacte` o PDF do DACTE
`Negada`	Rejeitado pela SEFAZ; `motivoStatus` é `cStat - xMotivo`
`Cancelada`	Cancelado (110111)
`Contingencia`	Indisponibilidade da SEFAZ, documento aguardando reenvio
`Falha`	Falha terminal da tarefa (parâmetros não interpretáveis, orçamento de retentativas esgotado, ...); `motivoStatus` explica; o mesmo `id` pode ser reenviado

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

]

}