Consultar CT-e
Baixar XML de CT-e: download em lote pelo CNPJ
Baixe os XML de CT-e modelo 57 disponíveis ao seu CNPJ com certificado A1 ou A3. Reúna os documentos em ZIP, gere DACTE para leitura e confira os fretes em uma planilha com tomador, transportadora, rota e valores.
Alcance da consulta
Antes de assinar, veja os limites da SEFAZ
NF-e: janela de até 90 dias
Contados da recepção no Ambiente Nacional, não da emissão. A distribuição não consulta um arquivo histórico por mês. No início do uso do serviço, a geração de NSU não é retroativa; uma interrupção superior a 60 dias também afeta essa geração.
Consultas têm cota e intervalos
NF-e: consultas por chave e NSU compartilham o limite de 20 por hora por CNPJ. A extensão usa até 18 por segurança. Após uma consulta de distribuição sem documentos ou no fim da fila, aguarde 1 hora. Um bloqueio 656 exige pausa; insistir antes pode renová-lo. Outros sistemas do mesmo CNPJ também podem afetar o acesso.
XML completo depende da disponibilidade
A SEFAZ pode entregar resumo, XML completo ou evento. Resumos não têm todos os itens e não geram DANFE. A extensão não faz manifestação do destinatário. Os dados do Excel e o PDF dependem do conteúdo recebido e das regras de acesso do serviço.
Pro mantém as regras da SEFAZ
O plano remove o limite de sincronizações da extensão durante a vigência; não amplia a janela, a cota ou as permissões da SEFAZ. Documentos emitidos pela própria empresa devem ser obtidos no emissor ou no portal estadual. Portais estaduais e acervos históricos não são integrados aqui.
Na versão 1.4.0, a recuperação por NSU de NF-e permite consultar uma faixa conhecida, com pausa e retomada manual, preservando o ponto da busca normal. O NSU da NFS-e é de outro serviço. “Baixar novamente” só gera arquivos já armazenados neste navegador; não recupera documentos ausentes na SEFAZ.
Fonte: Nota Técnica 2014.002 v1.40 — Distribuição de NF-eResposta direta
Como baixar XML de CT-e pelo CNPJ?
O certificado digital identifica o CNPJ no serviço de Distribuição DFe do CT-e. A consulta percorre os documentos por NSU e recupera os conhecimentos em que a empresa aparece como parte autorizada, incluindo aqueles ligados à contratação de transporte.
Download de XML de CT-e para conferir os fretes
Selecione a empresa e o serviço CT-e na extensão, confirme o certificado e sincronize os documentos disponíveis. Depois, compare as chaves e o valor da prestação com o controle de fretes. Confira também o tomador informado no XML e os eventos recebidos antes de fechar o período.
O lote serve para reunir documentos e identificar pendências. Se um conhecimento não aparecer, verifique o vínculo do CNPJ com a operação, os filtros e a disponibilidade no serviço. Solicite à transportadora o XML e os eventos que continuarem faltando.
Consultar um CT-e pela chave é diferente de baixar o histórico
O Portal do CT-e permite conferir um documento quando você já possui a chave de acesso. Essa consulta é útil para validar uma operação específica, mas não resolve a rotina mensal de localizar dezenas de conhecimentos de transporte.
Com a Distribuição DFe, a empresa consulta o fluxo ligado ao próprio CNPJ. O cursor de NSU é separado do cursor da NF-e, o que permite sincronizar fretes sem misturar os históricos dos dois serviços.
O que existe no XML do CT-e
O CT-e informa transportadora, remetente, destinatário, tomador, origem, destino, modal, tipo de serviço, valor da prestação e dados da carga. Também pode relacionar as chaves das NF-e transportadas, criando uma ponte entre compra, mercadoria e custo de frete.
A exportação organiza esses campos em colunas e inclui peso, produto predominante, ICMS, IBS, CBS e total aproximado de tributos quando presentes no XML.
XML, DACTE e Excel no mesmo fluxo
O XML é o documento eletrônico usado para integração e guarda. O DACTE é a representação em PDF para conferência humana. O Excel consolida vários conhecimentos em uma tabela, facilitando localizar fretes por rota, tomador, transportadora, valor ou documento transportado.
Todos esses arquivos são montados localmente. O certificado continua sob controle do navegador e os documentos fiscais não precisam ser enviados para um servidor intermediário para gerar as saídas.
Quem consegue baixar e até quando?
A Distribuição DFe entrega CT-e aos participantes contemplados pelas regras do serviço, conforme o papel do CNPJ no documento. CT-e emitido pela própria empresa não é recuperado por esse serviço: o emissor deve usar seu sistema ou acervo original. A chave, sozinha, permite consulta pública de situação, mas não garante o XML completo.
O serviço possui janela de disponibilidade e não substitui uma guarda permanente. A documentação nacional descreve a distribuição de documentos recebidos no Ambiente Nacional por até três meses. Sincronize regularmente e confira pendências e eventos antes de fechar o período fiscal.
Como funciona na prática
- 01
Selecione CT-e
Informe o CNPJ e a UF da empresa quando ela ainda não puder ser identificada automaticamente.
- 02
Consulte a SEFAZ
O certificado selecionado no Chrome autentica a conexão com o serviço nacional de CT-e.
- 03
Exporte o lote
Baixe XML, DACTE e Excel com os dados logísticos e fiscais consolidados.
Perguntas sobre este processo
- Download de XML de CT-e e DACTE em PDF são a mesma coisa?
- Não. O XML é o documento eletrônico com os dados da operação; o DACTE é sua representação auxiliar para leitura. A extensão gera o PDF quando possui o XML completo. Ter somente um PDF ou a chave não permite reconstruir o XML original.
- Quem pode consultar o XML completo do CT-e?
- A disponibilidade é definida pela SEFAZ para os participantes autorizados do documento, como tomador e demais atores indicados no CT-e. A autenticação é feita com o certificado da empresa.
- A extensão também relaciona as NF-e transportadas?
- Sim. Quando as chaves estão presentes no XML do CT-e, elas aparecem no Excel para facilitar o cruzamento com as notas fiscais disponíveis localmente.
- Preciso enviar o certificado A1?
- Não. O Chrome usa o certificado instalado no sistema para apresentar a identidade da empresa diretamente à SEFAZ por mTLS.
- Consigo recuperar CT-e que minha empresa emitiu?
- Não pelo serviço CTeDistribuicaoDFe usado pela extensão. O emissor deve recuperar o XML no sistema emissor ou no próprio acervo e manter sua guarda.
- A extensão baixa CT-e OS modelo 67?
- O fluxo documentado e validado da extensão é para CT-e de carga modelo 57. Esta página não promete captura de CT-e OS modelo 67.
NFe/CTe Downloader
Leve a consulta para a sua rotina
Experimente no Chrome do computador. No celular, receba o link para continuar depois.
A extensão funciona no Chrome do computador. Receba o link para abrir por lá.
Chrome no computador · certificado A1/A3 · conta Google
Consultar requisitos e passo a passo