Como baixar o XML de CT-e e CT-e OS
Atualizado em · Equipe Ágil Fiscal
A SEFAZ não tem consulta de CT-e por chave de acesso: os CT-e são entregues pela Distribuição DF-e, em lote, para cada CNPJ que participa do transporte. A Ágil Fiscal percorre essa fila com o certificado da empresa, guarda os CT-e no seu navegador e encontra a chave que você colou.
Passo a passo
- Cole a chave do CT-e. Em consulta.agilfiscal.com.br, cole a chave de 44 dígitos do CT-e (modelo 57) ou do CT-e OS (modelo 67).
- Escolha o certificado. Clique em Consultar e escolha o certificado digital do CNPJ que participa do transporte (tomador, remetente, destinatário, expedidor ou recebedor).
- Aguarde a varredura. O site lê os CT-e disponibilizados ao CNPJ na Distribuição DF-e e guarda todos no navegador, para que as próximas consultas sejam imediatas.
- Baixe o XML. Quando a chave é encontrada, clique em Baixar XML.
Por que o CT-e não é consultado pela chave
Na NF-e, a Distribuição DF-e aceita uma consulta direta pela chave. No CT-e, o serviço CTeDistribuicaoDFe só entrega documentos por NSU (número sequencial único): a SEFAZ mantém uma fila de documentos para cada CNPJ e devolve até 50 por chamada, em ordem.
Por isso, a Ágil Fiscal lê a fila do CNPJ até encontrar a chave e guarda tudo o que recebeu no armazenamento local do navegador. Na próxima consulta de outro CT-e da mesma empresa, a busca começa de onde parou.
Limite de uma varredura por hora
Quando a fila chega ao fim, a SEFAZ pede que o sistema aguarde antes de consultar de novo. Se a chave procurada ainda não estava disponível, tente novamente após 1 hora; consultas antes disso são recusadas pela SEFAZ como consumo indevido.
Quem recebe o CT-e na Distribuição DF-e
O CT-e fica disponível para os CNPJ que aparecem no documento, como tomador do serviço, remetente, destinatário, expedidor, recebedor e os autorizados no grupo autXML. Use o certificado de uma dessas partes.
CT-e OS
O CT-e OS (Outros Serviços, modelo 67), usado no transporte de pessoas e valores, segue o mesmo caminho e é identificado automaticamente pelo modelo na chave.
Perguntas frequentes
O site imprime o DACTE?
Ainda não. Para CT-e o site entrega o XML; a visualização para impressão está disponível para NF-e (DANFE) e NFS-e (DANFSe).
Os CT-e ficam salvos em algum servidor?
Não. Os CT-e recebidos ficam apenas no armazenamento local do seu navegador e podem ser apagados limpando os dados do site.