📦 Baixar CT-e em Lote: XML e DACTE em ZIP

Consulte uma ou mais chaves de acesso CT-e (modelo 57), sem necessidade de certificado digital, e receba um único arquivo .zip com os XMLs e os DACTEs (PDF) de todos os conhecimentos de transporte. Ideal para transportadoras, ERPs e rotinas de arquivo fiscal que precisam de vários documentos de uma vez sem fazer uma requisição por CT-e.

🎯 Diferencial: uma única chamada para até 50 chaves; o actor consulta em paralelo, monta o .zip com XMLs + DACTEs e devolve a URL pronta para download - sem precisar gerenciar cada CT-e individualmente.

---

O que retorna

	Campo	Descrição
📦	zipUrl	Link público para download do .zip (válido pela duração do run)
✅	totalEncontradas	Conhecimentos localizados e incluídos no ZIP
❌	totalNaoEncontradas	Chaves válidas sem CT-e no banco
⚠️	totalInvalidas	Chaves com dígito verificador incorreto
🗂️	resultados[]	Status por chave: encontrado, temXml, temDacte, erro

Estrutura interna do ZIP:

cte-lote.zip
├── xmls/
│   └── 35121268...xml    ← XML completo da CT-e
├── dactes/
│   └── 35121268...pdf    ← DACTE em PDF
└── manifest.json         ← array com todos os resultados

---

Por que usar

• 🔄 Lote sem código extra - envie até 50 chaves numa única chamada; sem loop de requisições
• ⚡ 8 consultas em paralelo - todos os conhecimentos são buscados ao mesmo tempo
• 📁 ZIP organizado - XMLs em xmls/, DACTEs em dactes/, manifesto incluso
• 💰 Cobrança justa - paga somente por CT-e encontrada; inválidas e não encontradas não cobram
• 🔗 Integração via API ou Standby - lote assíncrono ou endpoint HTTP síncrono

---

Como usar

1. Cole as chaves de acesso

No campo "Chaves de Acesso CT-e", informe uma ou mais chaves de 44 dígitos (pontuação é ignorada):

{
  "chaves": [
    "35121268252816000146570010000016161002008470",
    "35121268252816000146570010000016171002008477"
  ]
}

2. Execute o actor

Clique em "Save & Start". O actor consulta cada CT-e em paralelo e gera o arquivo .zip.

3. Baixe o ZIP

Na aba Output, clique em Arquivo ZIP (XMLs e DACTEs) para baixar. Ou use a zipUrl retornada para integrar no seu sistema.

---

Precificação

Cobrado por CT-e encontrada - $0.10 por conhecimento localizado (evento consulta-cte-lote).

• Chaves inválidas (dígito verificador errado): sem cobrança
• CTs não encontradas no banco: sem cobrança
• 50 CTs encontradas: $0.10 × 50 = $5.00

---

Exemplo de saída

{
  "zipUrl": "https://api.apify.com/v2/key-value-stores/abc.../records/cte-lote.zip?signature=...",
  "totalChaves": 2,
  "totalEncontradas": 1,
  "totalNaoEncontradas": 1,
  "totalInvalidas": 0,
  "erros": [
    { "chave": "35121268252816000146570010000016171002008477", "erro": "CT-e não encontrado." }
  ],
  "geradoEm": "2026-06-09T10:20:54.324Z",
  "resultados": [
    {
      "chave": "35121268252816000146570010000016161002008470",
      "encontrado": true,
      "consultadoEm": "2026-06-09T10:20:52.955Z",
      "referenciaConsulta": "bd-af03c0f94e82",
      "temXml": true,
      "temDacte": true,
      "erro": null
    },
    {
      "chave": "35121268252816000146570010000016171002008477",
      "encontrado": false,
      "consultadoEm": "2026-06-09T10:20:53.100Z",
      "referenciaConsulta": "bd-c1d2e3f4a5b6",
      "temXml": false,
      "temDacte": false,
      "erro": "CT-e não encontrado."
    }
  ]
}

---

Perguntas frequentes

Quais CTs são suportadas? CT-e modelo 57 (conhecimento de transporte eletrônico). Não inclui NF-e (mercadoria) nem NFS-e (serviços). Para NF-e, use o actor Baixar NF-e em Lote.

Qual o limite de chaves por execução? 50 chaves por run. Para volumes maiores, divida em lotes e execute sequencialmente.

E se o DACTE não estiver disponível? Alguns CTs têm XML mas não têm DACTE disponível no banco. Nesse caso temXml: true e temDacte: false - o ZIP terá o XML mas não o PDF para aquela chave.

O link do ZIP expira? Sim. O link zipUrl fica ativo pelo tempo de retenção do run (padrão Apify: 7 dias em planos pagos). Para arquivo permanente, baixe e guarde o ZIP no seu sistema.

Posso chamar em tempo real (Standby)? Sim. O endpoint POST /export responde de forma síncrona. Veja os exemplos curl abaixo.

---

🔌 Integração via API

Execução em lote:

curl -X POST "https://api.apify.com/v2/acts/brasildados~baixar-ctes-lote-api/run-sync-get-dataset-items?token=SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"chaves":["35121268252816000146570010000016161002008470","35121268252816000146570010000016171002008477"]}'

Standby (POST /export):

curl -X POST "https://brasildados--baixar-ctes-lote-api.apify.actor/export" \
  -H "Authorization: Bearer SEU_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  --compressed \
  -d '{"chaves":["35121268252816000146570010000016161002008470","35121268252816000146570010000016171002008477"]}'

---

Actors relacionados

Actor	Descrição
Baixar NF-e em Lote	Consulta e download de XML e DANFE de NF-e (modelo 55) em lote
Consulta CT-e por Chave	Consulta individual com dados estruturados (transportador, volumes, valores)
CNPJ Enrichment	Dados cadastrais completos por CNPJ (Simples, IE, Suframa, portais)

---

Legal

Este actor acessa informações de CT-e por meio de chave de acesso (dado público por design da SEFAZ para o portador da chave). O usuário é responsável por garantir que possui autorização para acessar os conhecimentos consultados.

---

🇬🇧 English

Query CT-e access keys (Brazilian freight documents, model 57) in parallel and receive a single .zip file with all XMLs and DACTEs (PDFs) — no need to fetch each CT-e individually.

How to use:

{
  "chaves": ["35121268252816000146570010000016161002008470","35121268252816000146570010000016171002008477"]
}

Batch run:

curl -X POST "https://api.apify.com/v2/acts/brasildados~baixar-ctes-lote-api/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"chaves":["35121268252816000146570010000016161002008470","35121268252816000146570010000016171002008477"]}'

Standby (POST /export):

curl -X POST "https://brasildados--baixar-ctes-lote-api.apify.actor/export" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  --compressed \
  -d '{"chaves":["35121268252816000146570010000016161002008470","35121268252816000146570010000016171002008477"]}'

Pricing: $0.10 per found CT-e (event consulta-cte-lote). Invalid keys and not-found documents are not charged.

Related: Individual CT-e lookup (structured data: carrier, volumes, values).

---

Dúvidas ou problemas? contato@brasildados.org | brasildados.org