Como Extrair Dados de Frete do
CT-e Brasileiro para Excel

Por que a Extração de Dados do CT-e é Essencial para o Controle de Custos Logísticos

Uma operação logística brasileira que recebe 500 documentos CT-e por mês — volume típico de um fabricante de médio porte distribuindo pelas regiões Sudeste e Centro-Oeste — gera aproximadamente 7.500 pontos de dados individuais que precisam chegar a um razão de custos de frete ou ERP. Cada CT-e carrega o CNPJ da transportadora, o valor do serviço, o peso bruto, os municípios de origem e destino e a discriminação do ICMS — todos insumos para a alocação de custos de frete, análise de desempenho de transportadoras e recuperação de créditos tributários.

Na prática, esses 7.500 pontos de dados são inseridos manualmente por um analista de frete que abre cada DACTE, localiza o campo e o digita em uma linha de planilha. A aproximadamente 90 segundos por documento para um digitador experiente — escaneando a página em busca de cada campo, verificando problemas de legibilidade, alternando entre o documento e a planilha — 500 documentos CT-e consomem 12,5 horas de entrada de dados por mês. Isso antes de qualquer validação, antes de qualquer correspondência com a nota fiscal de compra correspondente e antes de qualquer investigação das inevitáveis divergências entre o que o XML da transportadora declara e o que o DACTE impresso mostra.

A infraestrutura logística do Brasil lida com mais de 300 milhões de documentos CT-e anualmente, e o número continua crescendo à medida que a SEFAZ expande os requisitos obrigatórios de documentação eletrônica. A automação na etapa de extração — converter os dados visuais do DACTE em linhas de planilha sem digitação manual — é a diferença entre uma equipe logística que rastreia cada custo de frete e uma que rastreia apenas aqueles que conseguiram entrar na planilha.

O que é um CT-e e quais dados ele contém?

O Conhecimento de Transporte Eletrônico (CT-e, modelo 57) é o documento fiscal eletrônico de frete obrigatório no Brasil, gerenciado pelas Secretarias da Fazenda (SEFAZ) estaduais sob o mesmo sistema de autorização digital da NF-e. Introduzido em 2007 e tornado obrigatório para todas as transportadoras de carga até 2013, o CT-e substituiu um sistema em papel de formulários de frete com múltiplas vias, que tornava a fiscalização tributária sobre serviços de transporte praticamente impossível de auditar em escala.

Diferente de um conhecimento de embarque tradicional na maioria dos países, o CT-e não é um documento de título — ele não pode ser endossado ou transferido. Como o escritório de direito marítimo Proinde explica, ele funciona simultaneamente como comprovante do contrato de transporte, recibo de entrega da carga e fatura fiscal de serviços. O consignatário nomeado não entrega o documento em troca das mercadorias, pois o CT-e já identifica o destinatário no momento da emissão, eliminando o risco de entrega equivocada.

O documento físico que acompanha o embarque — e que sua equipe de logística provavelmente mais manuseia — é o DACTE (Documento Auxiliar do Conhecimento de Transporte Eletrônico). Trata-se de um resumo impresso ou em PDF contendo um subconjunto dos dados do XML do CT-e, uma chave de acesso de 44 dígitos e um código QR ou código de barras para autenticação no Portal do CT-e. A função do DACTE é acompanhar as mercadorias para inspeção; ele não é um documento fiscal em si, mas é a fonte de informação com a qual a maioria das equipes de logística trabalha.

Para uma compreensão mais completa de como o CT-e se encaixa no ecossistema de documentos eletrônicos do Brasil — juntamente com a NF-e (fatura de produtos), a NFS-e (fatura de serviços) e o MDF-e (Manifesto Eletrônico de Documentos Fiscais) — consulte o guia para iniciantes sobre a Nota Fiscal Eletrônica (NF-e), que aborda o fluxo de autorização da SEFAZ comum a todos os documentos fiscais brasileiros.

Principais Campos do CT-e que Toda Equipe de Logística Deve Acompanhar

O DACTE carrega entre 30 e 50 pontos de dados visíveis, dependendo da versão do layout da transportadora. Para o rastreamento de custos logísticos, os campos a seguir formam as colunas principais de um livro de fretes:

Estes 14 campos representam o conjunto mínimo viável para um livro de fretes de CT-e. Expandir o conjunto de colunas para incluir colunas calculadas — como "Custo do Frete por Kg (Valor do Serviço ÷ Peso Bruto)" — produz dados de referência que se tornam mais valiosos a cada lote processado.

Como Extrair Dados do CT-e para Excel: Passo a Passo

O fluxo de trabalho a seguir converte PDFs ou imagens do DACTE em linhas de planilha estruturadas usando a Extração de Colunas Personalizadas — você define as colunas desejadas, e a IA localiza cada valor na página impressa entendendo o significado do campo, não sua posição. Este é o mesmo mecanismo descrito no guia de extração de NF-e para Excel, adaptado para documentos de frete do CT-e.

Etapa 1: Faça o upload do DACTE (PDF ou imagem)

Comece com o arquivo DACTE bruto — um anexo PDF fornecido pela transportadora, uma impressão digitalizada ou uma foto do documento que acompanhou a remessa. A ferramenta de extração aceita PDF, JPG, PNG e WebP. Para melhores resultados, use um PDF limpo ou uma digitalização bem iluminada com 300 DPI ou mais. Fotos de documentos DACTE tiradas com pouca luz ou em ângulos oblíquos podem reduzir a precisão em nível de campo — embora o modelo de visão de IA compense por distorções moderadas e variações de iluminação que fariam um template de OCR tradicional falhar completamente.

Fazer upload de vários arquivos DACTE em um único lote é o fluxo de trabalho prático para qualquer equipe que processe mais de alguns embarques por dia. A interface de upload em lote aceita vários arquivos simultaneamente e os enfileira sob o mesmo nome de lote, permitindo que um analista de frete que lida com 40 documentos CT-e faça o upload de todos de uma vez, em vez de abrir uma nova janela de upload para cada um.

Etapa 2: Defina as colunas que deseja extrair

Digite os nomes dos campos que correspondem aos dados do CT-e que você precisa. Eles se tornarão os cabeçalhos das colunas da sua planilha de saída. A IA lê a página do DACTE e localiza cada valor pelo seu significado semântico — "ICMS" será encontrado independentemente de aparecer em uma caixa lateral, uma tabela de rodapé ou uma coluna de item de linha, porque o modelo entende o que é ICMS e o reconhece em qualquer posição do layout.

Um conjunto típico de definições de colunas para rastreamento de frete CT-e:

Essas 14 colunas capturam os pontos mínimos de dados de rastreamento de custos discutidos na seção anterior. Você pode adicionar colunas calculadas diretamente no nome da coluna — por exemplo, Custo do Frete por Kg (Valor do Serviço ÷ Peso Bruto) — para que a IA calcule o custo unitário do frete durante a extração, eliminando a etapa posterior de fórmula no Excel. Este é um dos três modos de Extração de Colunas Personalizadas descritos na documentação do produto: extração direta para campos que existem no documento, coluna inferida para informações que devem ser deduzidas (como a categoria da carga com base nos códigos NCM) e coluna calculada para operações aritméticas sobre valores extraídos.

Etapa 3: Processar e Exportar para Excel

Depois que as colunas são definidas, a extração processa todos os documentos do lote e gera um único arquivo Excel com uma linha por CT-e. Os cabeçalhos da tabela de saída correspondem exatamente às suas definições de coluna — "Valor do Serviço" aparece como nome da coluna, e cada linha contém o valor extraído do DACTE correspondente.

Os dados extraídos podem ser baixados como Excel (XLSX) ou CSV. Para equipes que usam Google Sheets, o mesmo fluxo de extração está disponível através do complemento do Google Sheets, que escreve as linhas diretamente na planilha ativa, eliminando a etapa de download e importação.

Após o primeiro lote, salve as definições de coluna como um modelo. Cada lote subsequente de documentos CT-e — seja da mesma transportadora ou de uma diferente — reutiliza o mesmo modelo. A IA se adapta automaticamente ao layout do DACTE de cada transportadora, de modo que um CT-e da JSL e um da Braspress, que colocam os dados do ICMS em posições diferentes na tabela, são lidos pelas mesmas definições de coluna. Esta é a implicação prática da extração sem modelo: sem configuração de modelo por transportadora, sem manutenção quando uma transportadora atualiza seu layout DACTE.

Correspondência entre Custos de Frete do CT-e e Custos de Compra da NF-e

O CT-e existe junto com a NF-e — o primeiro documenta o serviço de transporte, o segundo documenta as próprias mercadorias. Para uma visão abrangente do custo total de aquisição, as equipes de logística precisam corresponder o valor do frete de cada CT-e ao valor do produto da NF-e correspondente. Essa correspondência é onde os processos manuais mais frequentemente falham, porque o CT-e e a NF-e chegam por canais diferentes (a transportadora envia o CT-e; o fornecedor envia a NF-e) e, muitas vezes, em momentos diferentes (a NF-e é emitida quando a mercadoria sai; o CT-e pode ser emitido após a entrega).

Na prática, a correspondência é feita usando a chave de acesso da NF-e referenciada pelo CT-e. Todo XML de CT-e carrega a chave de acesso da NF-e que ele transporta (se conhecida no momento da emissão). O DACTE pode mostrar essa referência na seção "Documentos Referenciados". Ao extrair tanto a chave de acesso do próprio CT-e quanto a chave de acesso da NF-e referenciada, um analista de frete pode mesclar os dois conjuntos de dados no Excel usando PROCV ou PROCX na coluna da chave de acesso — criando uma única planilha que mostra, para cada remessa, o valor da mercadoria da NF-e junto com o custo do frete do CT-e.

A chave de acesso é um número de 44 dígitos que segue o mesmo formato UF-AAAA-MMM-XXXXXXXXXXX-XX-XXXXXXXXXXXXX usado pelos documentos NF-e. Como ambos os tipos de documento usam a mesma estrutura de chave de acesso, uma extração combinada — extraindo a chave de acesso tanto dos DACTEs de CT-e quanto de NF-e no mesmo formato de saída — produz um conjunto de dados passível de junção sem referência cruzada manual.

Para equipes que já extraem dados de NF-e para o Excel, adicionar a extração de CT-e ao mesmo fluxo de trabalho é uma questão de definir um segundo conjunto de colunas. As duas planilhas de saída — uma para valores de mercadorias (da NF-e) e outra para custos de frete (do CT-e) — tornam-se entradas para uma análise trimestral de custo de aquisição que inclui cada remessa, não apenas aquelas inseridas manualmente antes do fechamento do mês.

CT-e vs. MDF-e vs. DACTE: Qual Documento Extrair?

O Brasil utiliza três documentos eletrônicos intimamente relacionados para o transporte de cargas, e cada um tem uma finalidade diferente para o rastreamento de custos:

Para detalhamento de custo de frete e ICMS por remessa, o DACTE do CT-e é a fonte de extração correta. O MDF-e abrange cargas que compartilham um veículo e pode confirmar quais CT-e estavam na mesma viagem, mas os itens de custo estão nos CT-e individuais.

Perguntas Frequentes

Posso extrair dados do arquivo XML do CT-e em vez do DACTE?

Sim. Se sua transportadora fornecer o arquivo XML do CT-e (normalmente no schema padrão CT-e 4.0), o XML contém todos os campos estruturados e pode ser analisado programaticamente. A abordagem de extração do DACTE descrita neste artigo foi projetada para o cenário comum em que a equipe de logística recebe um DACTE impresso ou PDF em vez de um arquivo XML. Se você tiver o XML, também pode enviar uma captura de tela ou impressão de sua representação visual — a IA lê da mesma forma. A vantagem da análise do XML é a perda zero de precisão (os dados já estão estruturados); a desvantagem é que nem toda transportadora fornece o XML ao consignatário, e nem todo sistema de logística consegue consumir XML bruto sem um projeto de integração.

Posso usar os dados extraídos do CT-e para recuperação de crédito de ICMS no frete de entrada?

Sim, com condições. O ICMS sobre frete de entrada — ICMS pago em serviços de frete para matérias-primas ou mercadorias destinadas à revenda — pode ser creditável sob o regime de ICMS não cumulativo do Brasil. O valor do ICMS extraído (vICMS) do CT-e fornece o número base para este cálculo. No entanto, a creditabilidade depende do regime tributário da empresa receptora (Lucro Real vs. Lucro Presumido), do código CFOP da transação e da natureza das mercadorias. A extração fornece os valores de ICMS; sua equipe fiscal determina quais são recuperáveis. Um caso de uso comum é extrair tanto o ICMS do CT-e quanto o ICMS da NF-e no mesmo razão de custos e, em seguida, aplicar diferentes percentuais de recuperação por código CFOP no Excel.

Preciso de um modelo de extração diferente para cada layout de DACTE de transportadora?

Não. A IA lê pelo significado semântico, não pela posição no layout. Um CT-e da JSL coloca o CNPJ da transportadora em um bloco diferente do que um da Rodonaves, mas como o modelo entende o que "CNPJ do Emitente" significa no contexto de um documento de frete, ele encontra o valor correto independentemente da posição. Esta é a diferença fundamental entre a extração sem modelo e o OCR baseado em modelo: você define um conjunto de colunas para documentos CT-e, e a mesma definição funciona em qualquer layout de DACTE de transportadora.

E se meu DACTE tiver anotações ou correções manuscritas?

O modelo de visão de IA lê manuscritos da mesma forma que lê textos impressos — compreendendo o conteúdo visual contextualmente, sem depender da correspondência de formatos de caracteres. Anotações manuscritas em um DACTE (como um endereço de entrega revisado, um peso corrigido ou uma assinatura) são extraídas junto com os dados impressos. A precisão na leitura de manuscritos depende da legibilidade: anotações em letras de forma com caneta em um fundo limpo são extraídas de forma confiável; anotações borradas a lápis sobre texto impresso podem ser menos precisas. A abordagem prática é usar os campos impressos extraídos como fonte de dados principal e tratar as anotações manuscritas como informações suplementares que devem ser verificadas em relação ao XML oficial da transportadora.

Quantos documentos CT-e posso processar em um único lote?

Não há limite por lote para o número de arquivos. A restrição prática é o tamanho do upload e a cota total de páginas do plano. Um único DACTE de CT-e geralmente tem de 1 a 2 páginas. Uma equipe processando 500 documentos CT-e por mês no plano Pro (1.500 páginas/mês) ainda tem capacidade para outros tipos de documento. A saída do lote mescla todos os documentos processados em um único arquivo Excel — uma linha por CT-e —, portanto, escalar de 50 para 500 documentos por lote altera o tempo total de processamento, mas não as etapas do fluxo de trabalho.

Como faço para corresponder os custos de frete do CT-e aos valores de compra da NF-e correspondente?

Use a chave de acesso da NF-e referenciada no CT-e. A maioria dos documentos CT-e lista a chave de acesso da NF-e que transportam em uma seção de "documentos referenciados". Extraia a chave de acesso referenciada de cada CT-e e a chave de acesso de cada NF-e como colunas separadas na sua saída de extração. Em seguida, realize um PROCX ou PROCV entre as duas planilhas usando a chave de acesso como identificador comum. Isso produz uma visão combinada mostrando tanto o valor da mercadoria (da NF-e) quanto o custo do frete (do CT-e) para cada remessa — que é o seu custo total de aquisição por unidade.

Posso usar nomes de colunas em inglês para extrair dados de documentos DACTE em português?

Sim. Você pode definir os nomes das suas colunas em inglês — "Carrier CNPJ," "Service Value," "Gross Weight (kg)" — e a IA encontrará os valores correspondentes em português no DACTE. O modelo de extração entende documentos multilíngues e mapeia a semântica das colunas para o idioma do conteúdo do documento. Os cabeçalhos da planilha de saída ficarão em inglês (os nomes das suas colunas), enquanto os valores extraídos permanecem no formato original do documento. Isso é particularmente útil para equipes de logística internacionais onde o livro de custos é mantido em inglês, mas os documentos de origem estão em português.