Como baixar o CT-e pela chave de acesso

Você tem a chave de acesso do CT-e — 44 dígitos — e precisa do documento. A pergunta parece simples, mas a resposta depende de uma coisa que quase nunca é dita: o que você consegue baixar com a chave depende do seu papel na operação e do certificado digital que você tem em mãos.

O que a chave de acesso é

A chave de 44 dígitos não é um código aleatório: ela é composta pelos dados da própria operação. Traz o código da UF, o ano e mês de emissão, o CNPJ do emitente, o modelo do documento (57 para o CT-e, 67 para o CT-e OS), a série, o número, a forma de emissão e um dígito verificador.

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

O XML autenticado vem pelo serviço oficial de Distribuição de DF-e da SEFAZ, acessado com o certificado digital ICP-Brasil (A1 ou A3) da empresa que participa da operação. O serviço entrega os documentos de interesse daquele CNPJ — ou seja, você baixa o que é seu.

• Se você é o TOMADOR do frete, o CT-e está entre os seus documentos e pode ser baixado com o seu certificado.
• Se você é o EMITENTE, o documento também é seu e está disponível.
• Se você não é parte da operação, a chave não dá acesso ao XML — e isso é proteção, não limitação.

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ê pede à SEFAZ todos os documentos emitidos contra o seu CNPJ no período. É 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 de acesso identifica o CT-e e serve para confirmar que ele existe. Para ter o arquivo que vale — o XML assinado —, é preciso certificado digital e ser parte da operação. E quando são muitos documentos, buscar pela chave deixa de ser o método: o correto é baixar tudo o que é destinado ao seu CNPJ de uma vez.