CT-e

Consultar CT-e

Devuelve estado, datos del documento, enlaces de XML / DACTE y la lista de eventos.

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

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

Consulta por el id enviado en la emisión. Los enlaces de descarga son tokens de corta duración (10 minutos), reemitidos en cada consulta. Un cteId desconocido devuelve HTTP 404 con codigo CTe0001.

Parámetros

Parámetros de ruta

empresaIdstringobligatorio
Identificador de la empresa (transportista) devuelto en el registro.
Ejemplo: 1934811222334455
cteIdstringobligatorio
El id enviado en la emisión del CT-e.
Ejemplo: CTE-ORD-1

Respuestas

200

Documento encontrado.

idstring
Identificador del documento en el integrador.
statusstring
Estado del documento; vea la tabla de estados más abajo.
Valores:PendenteAutorizadaNegadaCanceladaContingenciaFalha
motivoStatusstring
Explicación del estado: cStat - xMotivo en Negada, motivo local en Falha; null en los demás.
numerointeger
Número del CT-e.
serieinteger
Serie del CT-e.
chaveAcessostring
Clave de acceso de 44 dígitos.
numeroProtocolostring
Protocolo de autorización de la SEFAZ.
dataEmissaostring
Fecha de emisión, ISO-8601 en UTC.
dataAutorizacaostring
Fecha de autorización, ISO-8601 en UTC.
tipoEmissaostring
Tipo de emisión; muestra la contingencia (SVC / EPEC) cuando la plataforma la activó.
Valores:NormalEpecFsdaSvcRsSvcSp
protocoloEpecstring
Protocolo del EPEC cuando se emitió en contingencia EPEC; null en caso contrario.
linkXmlstring
XML autorizado (cteProc), el original legal. Vea Descarga de archivos.
linkDactestring
PDF del DACTE, renderizado en la primera descarga; un renderizador ocupado devuelve 503, reintente más tarde.
cteobject
Cuerpo de la solicitud de emisión mientras la tarea está en curso; tras un estado terminal (Autorizada / Negada / Falha) los parámetros aceptados se descartan y el campo es null.
eventosarray
Eventos registrados en el documento (misma forma que Listar eventos, sin chaveAcesso).

Errores

Código	HTTP
CTe0001	404	`cteId` no encontrado o no pertenece a la empresa. Verifique el id y el `empresaId`.
10003000	404	`empresaId` no encontrado.

Tabla de estados

`status`	Significado
`Pendente`	Aceptado, en cola o en envío
`Autorizada`	Autorizado por la SEFAZ (cStat 100); `linkXml` es el original legal cteProc, `linkDacte` el PDF del DACTE
`Negada`	Rechazado por la SEFAZ; `motivoStatus` es `cStat - xMotivo`
`Cancelada`	Cancelado (110111)
`Contingencia`	Indisponibilidad de la SEFAZ, documento pendiente de reenvío
`Falha`	Fallo terminal de la tarea (parámetros no interpretables, presupuesto de reintentos agotado, ...); `motivoStatus` explica; el mismo `id` puede reenviarse

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

]

}