Logística

API de Consulta de CT-e por Chave de Acesso

XML completo do conhecimento de transporte eletrônico e DACTE em PDF a partir da chave de acesso de 44 dígitos.

JSON CSV XLSX XML
$0,10 por CT-e Cobra só quando o CT-e é encontrado; chave inválida ou não localizada não é cobrada

Não tem conta Apify? Crie grátis aqui.

Como integrar

curl -X POST \
  -H "Authorization: Bearer SEU_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"chaves":["35121268252816000146570010000016161002008470"]}' \
  "https://brasildados--api-consulta-cte-por-chave.apify.actor/check"
Exemplo de resposta
{
  "chave": "35121268252816000146570010000016161002008470",
  "encontrado": true,
  "consultadoEm": "2026-06-03T12:00:00.000Z",
  "referenciaConsulta": "bd-af03c0f94e82",
  "xml": {
    "name": "CTE-35121268252816000146570010000016161002008470.xml",
    "type": "CTE",
    "format": "XML",
    "data": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><cteProc versao=\"1.04\">...</cteProc>"
  },
  "xmlUrl": "https://api.apify.com/v2/key-value-stores/STORE_ID/records/xml-3512...8470?signature=...",
  "dacteUrl": "https://api.apify.com/v2/key-value-stores/STORE_ID/records/dacte-3512...8470?signature=...",
  "erro": null
}

O que esta API retorna

XML completo do CT-e (layout cteProc) em um único campo

Link de download do XML (xmlUrl), clicável e sem token

Link de download do DACTE em PDF (dacteUrl)

Emitente, remetente, destinatário e tomador dentro do XML

Valor da prestação do serviço de transporte (vTPrest)

Status da consulta: chave, encontrado e data/hora

Até 50 chaves por execução, em lote ou em tempo real

Casos de uso

Gestão e auditoria de fretes a partir do XML do CT-e

Conciliação de CT-e com pedidos, notas e faturas de transportadoras

Importação de conhecimentos de transporte para TMS e ERP

Controle de documentos fiscais de carga

Perguntas frequentes

Como baixo o XML e o DACTE do CT-e pela chave de acesso?

Todo CT-e encontrado retorna xmlUrl (download do XML) e dacteUrl (download do DACTE em PDF). São links públicos clicáveis, sem precisar de token. O XML completo também vem inline no campo xml.data.

A API entrega os campos do CT-e já separados em JSON?

Esta versão entrega o XML completo do CT-e em um único campo (xml.data), o que mantém a API estável a mudanças de layout. Você parseia exatamente o que precisar: emitente, remetente, destinatário, tomador e valores da prestação.

Qual a diferença entre CT-e e NF-e?

A NF-e (modelo 55) documenta a venda de mercadorias; o CT-e (modelo 57) documenta a prestação do serviço de transporte dessa carga. Para consultar notas fiscais por chave, use a API de NF-e.

A API cobra se o CT-e não for encontrado?

Não. A cobrança só ocorre quando o CT-e é encontrado (encontrado: true). Chave com dígito verificador inválido falha localmente, e documento não localizado não gera cobrança.

Posso consultar vários CT-e de uma vez?

Sim. Envie até 50 chaves por execução no modo lote, ou consulte em tempo real pela API Standby (POST /check). Cada chave retorna um registro com o XML e os links de download.

APIs relacionadas

Fiscal

API de Consulta de NF-e por Chave de Acesso

XML completo da nota fiscal eletrônica e DANFE em PDF a partir da chave de acesso de 44 dígitos.

$0,10 por nota Ver documentação
Compliance

API de Certidões de Empresas por CNPJ

Emita 8 certidões oficiais de qualquer empresa em tempo real: PGFN, FGTS, trabalhistas, CGU, CNJ, IBAMA e COMEX.

$1,00 por certidão Ver documentação
Mercado

API de Dados Financeiros de Empresas

Balanço, DRE, composição acionária e base de investidores de companhias abertas na B3 por CNPJ.

$0,10 por CNPJ Ver documentação