Baixar CT-e pela chave: consulta, XML e DACTE

Para baixar CT-e pela chave, primeiro separe duas tarefas: conferir o documento na consulta pública e obter o XML completo. A chave de 44 caracteres identifica o CT-e, mas o acesso ao XML depende do papel do CNPJ, da autenticação e da disponibilidade no serviço. Se você recebeu apenas o DACTE, peça também o XML à transportadora.

O que a chave de acesso é

A chave de 44 caracteres não é um código aleatório: ela é composta por UF, ano e mês de emissão, CNPJ do emitente, modelo (57 para CT-e, 67 para CT-e OS), série, número, forma de emissão, código numérico e dígito verificador. Com o CNPJ alfanumérico, a chave também pode conter letras.

Por isso a chave identifica o documento de forma única em todo o país, e por isso também um dígito trocado invalida a consulta inteira — não existe "chave parecida".

Consulta pública: o que ela entrega e o que não entrega

O portal nacional do CT-e permite consultar um documento pela chave sem certificado digital. Isso confirma que o CT-e existe, mostra a situação (autorizado, cancelado, denegado) e alguns dados de resumo. É útil para conferência rápida.

O que a consulta pública NÃO faz é entregar o XML completo. E é o XML que a contabilidade precisa: é ele que tem a assinatura digital, os valores, os impostos, a rota e o tomador — tudo o que permite escriturar e tomar crédito.

Regra prática: a consulta pública responde "este CT-e existe?". Só o download autenticado responde "me dê o documento".

Como obter o XML de verdade

Um caminho para obter o XML é o serviço oficial de Distribuição DFe da SEFAZ, acessado com o certificado digital ICP-Brasil do CNPJ contemplado pelas regras de distribuição. O retorno depende do papel da empresa, da disponibilidade temporal e da situação do documento. Também é possível pedir o XML ao emitente.

• Se você é o tomador do frete, consulte o que foi disponibilizado ao seu CNPJ com o certificado correspondente.
• Se você é o emitente, recupere o XML no seu sistema emissor ou acervo: a Distribuição DFe do CT-e não entrega os CT-e emitidos pela própria empresa.
• Se você não é participante autorizado, a chave não dá acesso ao XML completo.

Passo a passo quando você só tem a chave do CT-e

• Confira a chave recebida e consulte a situação no Portal Nacional do CT-e. Compare os dados com o frete que você espera encontrar.
• Identifique o papel da empresa na operação. Ser destinatário da mercadoria e ser tomador do transporte não são necessariamente a mesma coisa.
• Se o CNPJ estiver autorizado, use seu certificado na distribuição do CT-e e procure a chave entre os documentos retornados. A extensão sincroniza o fluxo do CNPJ; não promete baixar qualquer chave avulsa.
• Se o XML não estiver disponível, solicite o arquivo e seus eventos à transportadora. O emitente deve usar seu sistema emissor ou acervo para recuperar o original.
• Com o XML completo, gere o DACTE para leitura e preserve o XML junto dos eventos. O PDF não substitui o documento eletrônico.

O erro mais comum: chave em mãos, documento inacessível

É a situação que mais gera dúvida. A pessoa recebeu a chave por e-mail ou WhatsApp, tenta baixar e não consegue. Na maior parte das vezes não há erro nenhum: o CNPJ do certificado usado simplesmente não é parte daquela operação.

Quando você é parte e ainda assim o documento não aparece, vale checar dois pontos antes de suspeitar da ferramenta: se o certificado está instalado e válido no navegador, e se o documento é recente demais — há uma defasagem entre a autorização na SEFAZ e a disponibilização na Distribuição de DF-e.

Uma chave de cada vez não escala

Consultar pela chave funciona para um documento. Para o volume de um mês, o caminho é o inverso: em vez de perguntar documento por documento, você percorre os documentos disponíveis ao seu CNPJ e filtra o retorno pelo período. A consulta não solicita um arquivo histórico mensal. É exatamente para isso que existe a Distribuição de DF-e, com o cursor de NSU controlando o que já foi entregue.

O NFe/CTe Downloader consulta esse serviço com o seu certificado e devolve, em um único ZIP, os XMLs autenticados de NF-e e CT-e, os PDFs (DANFE e DACTE) e uma planilha com uma linha por documento — sem digitar chave por chave.

Resumo

A chave identifica o CT-e e permite conferir a situação no portal. Para obter o XML, peça-o ao emitente ou consulte a distribuição autenticada quando seu CNPJ estiver entre os destinatários do serviço e o documento ainda estiver disponível. Para muitos documentos, sincronize por NSU e mantenha um acervo próprio.