Ágil Fiscal
Entrar

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

  1. 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).
  2. Escolha o certificado. Clique em Consultar e escolha o certificado digital do CNPJ que participa do transporte (tomador, remetente, destinatário, expedidor ou recebedor).
  3. 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.
  4. 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.