Como baixar vários CT-e de uma vez pela chave de acesso?

Envie um array com até 50 chaves de 44 dígitos em uma requisição. A API consulta em paralelo e devolve uma URL única com o ZIP contendo os XMLs e os DACTEs.

Preciso de certificado digital para baixar o XML do CT-e?

Não. A consulta parte da chave de acesso, sem e-CNPJ, sem captcha e sem instalação. Serve para quem recebeu a chave do transportador mas não recebeu o arquivo.

O que é o DACTE e por que preciso dele?

O DACTE é a representação impressa do conhecimento de transporte eletrônico, o documento que acompanha a carga. Ele é exigido em fiscalização de trânsito e costuma ser pedido na conferência do frete.

Qual a diferença para a API de consulta de CT-e por chave?

A de consulta devolve o conhecimento interpretado em JSON, com frete, ICMS e carga separados, para integrar em sistema. Esta é para arquivo em volume: você quer os XMLs e os PDFs empacotados.

A API cobra pelas chaves que não forem encontradas?

Não. Só há cobrança por CT-e efetivamente baixado, então lista com chave errada ou antiga não gera custo pelas que falharem.

Quantos conhecimentos dá para baixar por execução?

Até 50 chaves por execução, cada uma virando um arquivo dentro do ZIP. Para volumes maiores, divida em execuções sucessivas.

API para Baixar CT-e em Lote (XML e DACTE)

Envie até 50 chaves de conhecimento de transporte e receba um ZIP com todos os XMLs e DACTEs, sem certificado digital.

JSON CSV XLSX XML

$0,04 por CT-e

Cobrado por conhecimento efetivamente baixado. Chave inexistente não gera custo.

Testar grátis na Apify Todas as APIs

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

Como integrar

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","35121268252816000146570010000016171002008477"]}'

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

import requests

res = requests.post(
    "https://api.apify.com/v2/acts/brasildados~baixar-ctes-lote-api/run-sync-get-dataset-items",
    headers={"Authorization": "Bearer SEU_APIFY_TOKEN"},
    json={
      "chaves": [
        "35121268252816000146570010000016161002008470",
        "35121268252816000146570010000016171002008477"
      ]
    },
)
for item in res.json():
    print(item)

const res = await fetch(
  "https://api.apify.com/v2/acts/brasildados~baixar-ctes-lote-api/run-sync-get-dataset-items",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer SEU_APIFY_TOKEN",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      "chaves": [
        "35121268252816000146570010000016161002008470",
        "35121268252816000146570010000016171002008477"
      ]
    }),
  }
);
const items = await res.json();
console.log(items);

<?php
$ch = curl_init("https://api.apify.com/v2/acts/brasildados~baixar-ctes-lote-api/run-sync-get-dataset-items");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer SEU_APIFY_TOKEN",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => '{"chaves":["35121268252816000146570010000016161002008470","35121268252816000146570010000016171002008477"]}',
]);
$items = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($items);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.apify.com/v2/acts/brasildados~baixar-ctes-lote-api/run-sync-get-dataset-items"))
    .header("Authorization", "Bearer SEU_APIFY_TOKEN")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"chaves\":[\"35121268252816000146570010000016161002008470\",\"35121268252816000146570010000016171002008477\"]}"))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using System.Net.Http;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer SEU_APIFY_TOKEN");
var content = new StringContent(
    "{\"chaves\":[\"35121268252816000146570010000016161002008470\",\"35121268252816000146570010000016171002008477\"]}",
    Encoding.UTF8,
    "application/json");
var response = await client.PostAsync("https://api.apify.com/v2/acts/brasildados~baixar-ctes-lote-api/run-sync-get-dataset-items", content);
Console.WriteLine(await response.Content.ReadAsStringAsync());

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	body := bytes.NewBufferString(`{"chaves":["35121268252816000146570010000016161002008470","35121268252816000146570010000016171002008477"]}`)
	req, _ := http.NewRequest("POST", "https://api.apify.com/v2/acts/brasildados~baixar-ctes-lote-api/run-sync-get-dataset-items", body)
	req.Header.Set("Authorization", "Bearer SEU_APIFY_TOKEN")
	req.Header.Set("Content-Type", "application/json")
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

Exemplo de resposta

{
  "chave": "35121268252816000146570010000016161002008470",
  "encontrado": true,
  "consultadoEm": "2026-09-10T02:21:07.346Z",
  "referenciaConsulta": "bd-9b08f97eefcc",
  "temXml": true,
  "temDacte": true,
  "erro": null,
  "zipUrl": "https://api.apify.com/v2/key-value-stores/mKEGQhuVHHUWYX4M5/records/cte-lote.zip?signature=bXMBirX5T6rb3Xe0PYnMj"
}

O que a API de download de CT-e em lote retorna

URL de download do ZIP com todos os arquivos
XML individual de cada CT-e encontrado
DACTE em PDF de cada conhecimento
Status por chave: encontrada ou não
Motivo do erro quando a chave falha
Contagem de sucessos e falhas da execução
Referência da consulta para conciliação

API para Baixar CT-e em Lote (XML e DACTE)

Envie até 50 chaves de conhecimento de transporte e receba um ZIP com todos os XMLs e DACTEs, sem certificado digital.

Cobrado por conhecimento efetivamente baixado. Chave inexistente não gera custo.

O que a API de download de CT-e em lote retorna

URL de download do ZIP com todos os arquivos

XML individual de cada CT-e encontrado

DACTE em PDF de cada conhecimento

Status por chave: encontrada ou não

Motivo do erro quando a chave falha

Contagem de sucessos e falhas da execução

Referência da consulta para conciliação

Casos de uso da API de download de CT-e em lote

Arquivamento fiscal de documentos de transporte

Conciliação de frete com o contratante

Auditoria de custo logístico por rota

Importação de CT-e para o sistema de gestão de transporte

Perguntas frequentes sobre download de CT-e em lote

APIs relacionadas a download de CT-e em lote

CT-e: Consulta por Chave de Acesso

Baixar NF-e em Lote (XML e DANFE)

Consulta de NF-e por Chave de Acesso