Baixar CTEs em Lote: XML + DACTE em ZIP API / Scraper

O Baixar CT-e em Lote consulta chaves de acesso de CT-e modelo 57 e entrega um único arquivo ZIP com os documentos encontrados. Envie várias chaves em uma execução, receba XMLs e DACTEs organizados e acompanhe um resumo simples no Dataset. O fluxo não exige certificado digital e foi pensado para transportadoras, equipes fiscais, ERPs, conciliações e rotinas de arquivamento eletrônico.

🎯 Diferencial: uma única chamada para até 50 chaves. O Actor consulta em paralelo, monta o ZIP com XMLs e DACTEs e devolve a URL pronta para download.

---

O que faz o Baixar CT-e em Lote?

O Dataset padrão recebe exatamente uma linha de resumo por execução. O campo zipUrl aponta para o arquivo ZIP da execução, que contém os documentos disponíveis e o manifest.json com o detalhe de cada chave processada.

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 o Baixar CT-e em Lote?

• 🔄 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 - execução em lote, com o ZIP pronto na própria resposta

---

Como usar o Baixar CT-e em Lote

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.

---

Cobrança

Cobrado por cada CT-e encontrada e baixada. Chaves inválidas e CT-es não encontradas não geram cobrança.

• Chaves inválidas (dígito verificador errado): sem cobrança
• CTs não encontradas no banco: sem cobrança
• Cada CT-e encontrada e baixada gera um evento de cobrança; chaves inválidas e não encontradas não geram cobrança.

---

Output

O Actor entrega um único resumo na aba Output. Use o campo zipUrl desse resumo para baixar o ZIP, que contém os documentos, detalhes por chave e manifest.json.

Exemplo de saída

O Dataset recebe somente uma linha de resumo, em campos simples, com o link do ZIP e as contagens:

{
  "zipUrl": "https://api.apify.com/v2/key-value-stores/abc.../records/cte-lote.zip",
  "totalChaves": 2,
  "totalEncontradas": 1,
  "totalNaoEncontradas": 1,
  "totalInvalidas": 0,
  "geradoEm": "2026-06-09T10:20:54.324Z"
}

Detalhe por chave, inclusive inválidas e não encontradas, fica no manifest.json dentro do próprio ZIP:

{
  "chave": "35121268252816000146570010000016161002008470",
  "encontrado": true,
  "consultadoEm": "2026-06-09T10:20:52.955Z",
  "referenciaConsulta": "bd-af03c0f94e82",
  "temXml": true,
  "temDacte": true,
  "erro": null
}

---

Campos retornados

Campo	Tipo	Significado
zipUrl	texto	URL para baixar o ZIP da execução.
totalChaves	inteiro	Quantidade de chaves processadas, válidas e inválidas.
totalEncontradas	inteiro	Quantidade de CT-es localizadas e baixadas.
totalNaoEncontradas	inteiro	Quantidade de chaves válidas sem CT-e localizada.
totalInvalidas	inteiro	Quantidade de chaves rejeitadas por formato ou dígito verificador.
geradoEm	data e hora	Momento de geração do ZIP, no formato ISO 8601.

Os campos encontrado, temXml, temDacte, consultadoEm, referenciaConsulta e erro pertencem aos registros do manifest.json.

Tips / Dicas

• ✅ Envie até 50 chaves por execução para manter o processamento previsível.
• 🧹 Normalize espaços e pontuação no seu sistema, embora o Actor também faça essa normalização.
• 📁 Baixe o ZIP logo após a execução, respeitando a retenção configurada na Apify.
• 🔍 Use o manifesto para reconciliação detalhada por chave.
• 💳 Somente CT-es encontradas e baixadas geram cobrança. Chaves inválidas e documentos não encontrados não geram cobrança.

FAQ, avisos e suporte

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.

---

🔌 Integração via API

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

O token vai no header Authorization: Bearer, nunca na URL.

---

Outros Actors do BrasilDados

Este scraper compartilha o motor de busca com o Consulta CT-e por Chave, da Brasil Dados. Mais fontes de dados públicos brasileiros em brasildados.org.

Actor	Quando usar
Consulta CT-e por Chave	Consulta individual com dados estruturados (transportador, volumes, valores)
Baixar NF-e em Lote	Download de XML e DANFE de NF-e (mercadoria) em lote
CNPJ Enrichment	Dados cadastrais completos por CNPJ (Simples, IE, Suframa, portais)

---

Este Actor acessa informações de CT-e por meio da chave de acesso. Você é responsável por garantir autorização para consultar, baixar, armazenar e tratar os documentos, de acordo com a legislação aplicável e as políticas da sua organização.

---

🇬🇧 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). Maximum 50 keys per run — no need to fetch each CT-e individually.

How to use:

{
  "chaves": ["35121268252816000146570010000016161002008470"]
}

Run via API:

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

Put the token in the Authorization: Bearer header, never in the URL.

Billing is based on each CT-e found and downloaded. Invalid keys and not-found documents are not charged.

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

🛒 Todos os Actors: apify.com/brasildados

---

📧 contato@brasildados.org · 🌐 brasildados.org · 🛒 BrasilDados na Apify Store