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.

Como descobrir quem é o tomador do frete em um CT-e?

O XML devolvido pela API traz o emitente, o remetente, o destinatário e o tomador do serviço, que é quem paga o frete. Com a chave de acesso em mãos, dá para identificar o tomador sem abrir o documento no portal e conferir se a cobrança chegou para a empresa certa.

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

Sim. Envie até 50 chaves por execução: a resposta chega em uma única chamada, com um registro por chave, cada um com o XML e os links de download.

Como conferir o frete e o ICMS de um conhecimento de transporte?

Com a chave de acesso de 44 dígitos, a API devolve o CT-e já estruturado: remetente, destinatário, origem e destino, valor do frete, base e valor do ICMS, dados da carga e as NF-es vinculadas, sem precisar abrir o XML na mão.

API de CT-e: Consulta 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

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/actors/brasildados~api-consulta-cte-por-chave/run-sync-get-dataset-items" \
  -H "Authorization: Bearer SEU_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"chaves":["CTe35121268252816000146570010000016161002008470","3512 1268 2528 1600 0146 5700 1000 0016 1610 0200 8470"]}'

{
  "chaves": [
    "CTe35121268252816000146570010000016161002008470",
    "3512 1268 2528 1600 0146 5700 1000 0016 1610 0200 8470"
  ]
}

import requests

res = requests.post(
    "https://api.apify.com/v2/actors/brasildados~api-consulta-cte-por-chave/run-sync-get-dataset-items",
    headers={"Authorization": "Bearer SEU_APIFY_TOKEN"},
    json={
      "chaves": [
        "CTe35121268252816000146570010000016161002008470",
        "3512 1268 2528 1600 0146 5700 1000 0016 1610 0200 8470"
      ]
    },
)
for item in res.json():
    print(item)

const res = await fetch(
  "https://api.apify.com/v2/actors/brasildados~api-consulta-cte-por-chave/run-sync-get-dataset-items",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer SEU_APIFY_TOKEN",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      "chaves": [
        "CTe35121268252816000146570010000016161002008470",
        "3512 1268 2528 1600 0146 5700 1000 0016 1610 0200 8470"
      ]
    }),
  }
);
const items = await res.json();
console.log(items);

<?php
$ch = curl_init("https://api.apify.com/v2/actors/brasildados~api-consulta-cte-por-chave/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":["CTe35121268252816000146570010000016161002008470","3512 1268 2528 1600 0146 5700 1000 0016 1610 0200 8470"]}',
]);
$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/actors/brasildados~api-consulta-cte-por-chave/run-sync-get-dataset-items"))
    .header("Authorization", "Bearer SEU_APIFY_TOKEN")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"chaves\":[\"CTe35121268252816000146570010000016161002008470\",\"3512 1268 2528 1600 0146 5700 1000 0016 1610 0200 8470\"]}"))
    .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\":[\"CTe35121268252816000146570010000016161002008470\",\"3512 1268 2528 1600 0146 5700 1000 0016 1610 0200 8470\"]}",
    Encoding.UTF8,
    "application/json");
var response = await client.PostAsync("https://api.apify.com/v2/actors/brasildados~api-consulta-cte-por-chave/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":["CTe35121268252816000146570010000016161002008470","3512 1268 2528 1600 0146 5700 1000 0016 1610 0200 8470"]}`)
	req, _ := http.NewRequest("POST", "https://api.apify.com/v2/actors/brasildados~api-consulta-cte-por-chave/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-10T01:43:21.144Z",
  "referenciaConsulta": "bd-9b08f97eefcc",
  "dados": {
    "identificacao": {
      "chave": "35121268252816000146570010000016161002008470",
      "modelo": "57",
      "serie": "1",
      "numero": "1616",
      "cfop": "5353",
      "naturezaOperacao": "PREST. DE SERV. TRANSPORTE A ESTAB. COMERCIAL",
      "dataEmissao": "2012-12-01T15:01:00",
      "tipoCte": "normal",
      "tipoServico": "normal",
      "modal": "rodoviário",
      "tomador": "remetente",
      "formaPagamento": "pago",
      "ambiente": "produção",
      "digitoVerificador": "0"
    },
    "origem": {
      "codigoMunicipio": "3512209",
      "municipio": "Conchal",
      "uf": "SP"
    },
    "destino": {
      "codigoMunicipio": "3524402",
      "municipio": "Jacarei",
      "uf": "SP"
    },
    "emitente": {
      "cnpjCpf": "68252816000146",
      "razaoSocial": "Friozer Comercio, Distribuicao e Logistica Ltda",
      "nomeFantasia": null,
      "inscricaoEstadual": "392242719111",
      "regimeTributario": null,
      "email": null,
      "endereco": {
        "logradouro": "Industrial",
        "numero": "697",
        "complemento": null,
        "bairro": "Jardim Emilia",
        "codigoMunicipio": "3524402",
        "municipio": "Jacarei",
        "uf": "SP",
        "cep": "12321500",
        "pais": null,
        "telefone": "1239515344"
      }
    },
    "remetente": {
      "cnpjCpf": "85782878000855",
      "razaoSocial": "Frigorifico Riosulense s a",
      "nomeFantasia": "Pamplona Conchal",
      "inscricaoEstadual": "270020518119",
      "regimeTributario": null,
      "email": null,
      "endereco": {
        "logradouro": "Av Prefeito Nelson Cunha",
        "numero": "798",
        "complemento": "Sala c",
        "bairro": "sao Joaoda Figueira",
        "codigoMunicipio": "3512209",
        "municipio": "Conchal",
        "uf": "SP",
        "cep": "13835000",
        "pais": "BRASIL",
        "telefone": null
      }
    },
    "destinatario": {
      "cnpjCpf": "68252816000146",
      "razaoSocial": "Friozer Comercio, Distribuicao e Logistica Ltda",
      "nomeFantasia": null,
      "inscricaoEstadual": "392242719111",
      "regimeTributario": null,
      "email": null,
      "endereco": {
        "logradouro": "Industrial",
        "numero": "697",
        "complemento": null,
        "bairro": "Jardim Emilia",
        "codigoMunicipio": "3524402",
        "municipio": "Jacarei",
        "uf": "SP",
        "cep": "12321500",
        "pais": "BRASIL",
        "telefone": null
      }
    },
    "expedidor": null,
    "recebedor": null,
    "prestacao": {
      "valorTotal": 1118.35,
      "valorReceber": 1118.35,
      "componentes": [
        {
          "nome": "84, 2 - COLETA",
          "valor": 1118.35
        }
      ]
    },
    "impostos": {
      "icms": {
        "cst": "00",
        "baseCalculo": 1118.35,
        "aliquota": 12,
        "valor": 134.2,
        "percentualReducao": null,
        "valorICMSST": null
      },
      "valorTributosAproximado": null
    },
    "carga": {
      "valorCarga": 1,
      "produtoPredominante": "suinos",
      "outrasCaracteristicas": null,
      "quantidades": [
        {
          "unidade": "03",
          "tipoMedida": "VOLUMES",
          "quantidade": 463
        },
        {
          "unidade": "01",
          "tipoMedida": "VOLUMES-PL",
          "quantidade": 6713.64
        }
      ]
    },
    "modal": {
      "tipo": "rodoviário",
      "rntrc": "44501745"
    },
    "documentos": {
      "notasFiscais": [
        "35121185782878000855550010000002211151664026",
        "35121185782878000855550010000002641607831237"
      ]
    },
    "protocolo": {
      "numero": "135120069193967",
      "dataAutorizacao": "2012-12-01T15:07:36",
      "status": "100",
      "motivo": "Autorizado o uso do CT-e",
      "ambiente": "produção",
      "situacao": "autorizado"
    },
    "informacoesAdicionais": {
      "fisco": null,
      "complementares": null
    }
  },
  "xml": {
    "name": "CTE-35121268252816000146570010000016161002008470.xml",
    "type": "CTE",
    "format": "XML",
    "data": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><cteProc versao=\"1.04\" xmlns=\"http://www.portalfiscal.inf.br/cte\"><CTe xmlns=\"http://www.portalfiscal.inf.br/cte\"><infCte Id=\"CTe35121268252816000146570010000016161002008470\" versao=\"1.04\"><ide><cUF>..."
  },
  "xmlUrl": "https://api.apify.com/v2/key-value-stores/*****/records/xml-35121268252816000146570010000016161002008470?signature=*****",
  "dacteUrl": "https://api.apify.com/v2/key-value-stores/*****/records/dacte-35121268252816000146570010000016161002008470?signature=*****",
  "erro": null
}

O que a API de consulta de CT-e por chave de acesso 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

API de CT-e: Consulta 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.

O que a API de consulta de CT-e por chave de acesso 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 da API de consulta de CT-e por chave de acesso

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 sobre consulta de CT-e por chave de acesso

APIs relacionadas a consulta de CT-e por chave de acesso

Consulta de NF-e por Chave de Acesso

Baixar CT-e em Lote (XML e DACTE)

Dados Financeiros de Empresas