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.

Por aquí se sigue qué pasó con el documento después del envío. Consulta por el id enviado en la emisión. Los enlaces de descarga son tokens de corta duración, válidos por 10 minutos y reemitidos en cada consulta.

Parámetros de ruta

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

* Campo obligatorio

200

Documento encontrado.

`id`	string	Identificador del documento
`status`	string	Estado del documento
`motivoStatus`	string	Motivo del estado
`numero`	int	Número del documento
`serie`	int	Serie
`chaveAcesso`	string	Clave de acceso
`numeroProtocolo`	string	Protocolo de autorización
`dataEmissao`	string	Momento de la emisión
`dataAutorizacao`	string	Momento de la autorización
`tipoEmissao`	string	Vía de emisión
`protocoloEpec`	string	Protocolo EPEC
`linkXml`	string	Enlace del XML autorizado
`linkDacte`	string	Enlace del DACTE
`cte`	object	Eco de la solicitud
	array	Eventos registrados

`status`Estado del documento

Valores	Significado
Pendente	Aceptado, en cola o en envío
Autorizada	Autorizado por la SEFAZ; `linkXml` es el original legal y `linkDacte` el PDF del DACTE
Negada	Rechazado por la SEFAZ; `motivoStatus` trae el código y el motivo
Cancelada	Cancelado por el evento 110111
Contingencia	SEFAZ no disponible; documento pendiente de reenvío
Falha	Fallo terminal de la tarea; `motivoStatus` explica y el mismo `id` puede reenviarse

`tipoEmissao`Vía de emisión

La plataforma cambia de vía sola cuando el autorizador del estado está caído.

Valores	Significado
Normal	Autorizador del propio estado
Epec	Contingencia EPEC: autorización previa del evento
Fsda	Contingencia FS-DA: formulario de seguridad
SvcRs	Contingencia SVC-RS: autorizador virtual de Rio Grande do Sul
SvcSp	Contingencia SVC-SP: autorizador virtual de São Paulo

`eventos[].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

`eventos[].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`)

`eventos[].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}'

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": "35260940673061000134570010000000011000000016",

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

]

}

Consultar CT-e

Parámetros

Parámetros de ruta

Respuestas

Enumeraciones5 tablas

statusEstado del documento

tipoEmissaoVía de emisión

eventos[].tipoTipo del evento

eventos[].codigoCódigo del evento

eventos[].statusCódigo de retorno del registro

Errores2 ítems

`status`Estado del documento

`tipoEmissao`Vía de emisión

`eventos[].tipo`Tipo del evento

`eventos[].codigo`Código del evento

`eventos[].status`Código de retorno del registro