Guia CT-e

Consultar CT-e pela chave: situação e acesso ao XML

Como consultar a situação de um CT-e pela chave no portal oficial e distinguir essa verificação do acesso autorizado ao XML e da distribuição por NSU.

Publicado pela FideFlow. Revisado em .

Tags XML envolvidas:

<chCTe> <infCte> <protCTe> <cStat> <nProt>

Para consultar CT-e pela chave, localize a chave de acesso no DACTE ou no XML e utilize o Portal Nacional do CT-e ou o serviço da SEFAZ responsável. Confira a identificação da prestação e a situação apresentada. Consultar uma situação, obter o XML e organizar documentos recebidos são tarefas diferentes; a chave não concede acesso irrestrito aos arquivos de qualquer empresa.

Copie a chave completa, sem confundi-la com o número do CT-e, o protocolo ou uma chave de NF-e. Confira o modelo e o ambiente do documento. Uma consulta que não localiza o CT-e exige verificar os dados informados e, quando necessário, solicitar esclarecimentos e o protocolo à transportadora. Não conclua que houve fraude ou cancelamento apenas porque uma tentativa não trouxe resultado.

A consulta pública ajuda a conferir a existência e a autorização do documento. Para guardar ou importar o arquivo, solicite o XML ao emitente pelo meio combinado entre as partes ou use uma integração autorizada. Uma tela de consulta, um PDF ou um DACTE não são o próprio XML. Não envie certificado e senha a uma ferramenta só porque ela promete consulta gratuita pela chave.

A distribuição CTeDistribuicaoDFe utiliza certificado e regras de acesso por interessado. A NT 2015.002 v1.05 descreve consultas por NSU, não um download universal por chave. Documentos ficam disponíveis por até três meses após recepção pelo Ambiente Nacional. O emitente não recupera seu próprio CT-e por esse fluxo; deve preservar o arquivo de emissão. Para terceiros autXML, chaves de documentos relacionados podem vir mascaradas.

Na distribuição, 137 significa que nenhum documento foi localizado nessa solicitação; 138 indica documentos localizados. Esses códigos não são a situação fiscal de cada CT-e. Quando ultNSU alcança maxNSU, a nota técnica orienta aguardar ao menos uma hora. Buscas sucessivas por registros já disponibilizados podem gerar 656, consumo indevido. Coordene os sistemas que consultam o mesmo interessado e evite reiniciar a busca repetidamente.

Leia o retorno no contexto do serviço utilizado. O protocolo original de autorização não elimina a necessidade de conferir eventos posteriores. O MOC 4.00 retirou a denegação do fluxo atual; códigos históricos não devem ser apresentados como resultados esperados de toda consulta nova. O fragmento abaixo serve apenas para reconhecer campos: não é um retorno real nem comprova a situação de qualquer documento.

Depois da conferência fiscal, compare a prestação com contrato, cotação, entrega e cobrança. Um CT-e autorizado não demonstra sozinho que o valor deve ser pago; um cancelamento também não resolve por si só toda obrigação comercial. Divergências precisam ser examinadas pelas equipes responsáveis. Não registre desacordo nem outro evento apenas porque um valor parece diferente, sem conferir fatos e requisitos.

No Flow Fiscal, avalie os recursos para organizar CT-e recebido, os requisitos de conexão e os limites do plano. A consulta pública por chave pode atender à verificação pontual; a captura exige configuração e documentos disponíveis à empresa. A prévia do FideFlow ERP continua em desenvolvimento. Este guia não promete emissão liberada, histórico integral, sincronização instantânea nem substituição da conferência humana.

Quadro-resumo

CampoDetalhe
Consulta pública Verificação por chave no portal oficial
Arquivo fiscal XML obtido do emitente ou por acesso autorizado
Distribuição por NSU Documentos disponíveis ao interessado; não consulta irrestrita
Conferência comercial Prestação, contrato e cobrança avaliados separadamente

Exemplo de XML para conferência

<!-- Exemplo didático incompleto; não é resposta real da SEFAZ. -->
<retConsSitCTe>
  <cStat>100</cStat>
  <xMotivo>Autorizado o uso do CT-e</xMotivo>
</retConsSitCTe>

Passo a passo

1

Localize a chave

Use o DACTE ou o XML. Confira o documento e não confunda chave, número e protocolo.

2

Abra a consulta oficial

Acesse o Portal CT-e, informe os dados pedidos e confira a identificação da prestação.

3

Leia a situação e os eventos

Examine o resultado atual. Uma cópia antiga do protocolo não descreve necessariamente todos os eventos posteriores.

4

Obtenha o arquivo quando necessário

Combine o envio do XML com a transportadora ou utilize uma integração autorizada, respeitando seu escopo.

5

Concilie antes de decidir

Compare documento, prestação e cobrança com os responsáveis. Preserve arquivos e eventos conforme as obrigações aplicáveis.

Perguntas frequentes

Onde encontro a chave do CT-e?

No DACTE ou no XML do documento. Use a chave completa de 44 posições e confira se corresponde ao CT-e pretendido, em vez do número do documento ou do protocolo.

Consultar CT-e pela chave é o mesmo que baixar XML?

Não. A consulta verifica informações do documento. Para obter o XML, combine o envio com o emitente ou use um acesso autorizado que atenda ao seu caso.

DistDFe entrega qualquer CT-e que eu informar?

Não. O acesso depende do interessado, do certificado e dos documentos disponíveis. A distribuição por NSU não é uma consulta irrestrita por chave.

Nenhum documento localizado significa CT-e cancelado?

Não. Na distribuição, 137 descreve o resultado da solicitação, não um cancelamento. Verifique a situação do CT-e no serviço apropriado.

Como tratar consumo indevido 656?

Interrompa repetições automáticas e examine a sequência das consultas e o motivo retornado. Não tente resolver reiniciando continuamente o NSU.

Posso pagar o frete só porque o CT-e está autorizado?

A autorização fiscal não substitui a conferência da prestação, do contrato e da cobrança. Encaminhe divergências aos responsáveis antes de decidir.

Fontes e escopo do produto

Outros guias de CT-e

Receber CT-e no FideFlow Baixar XML de CT-e CT-e OS modelo 67 Obrigatoriedade do MDF-e como emitir CT-e cancelar CT-e carta de correção CT-e tomador do CT-e desacordo CT-e CT-e complementar CT-e vs MDF-e

Conferência de CT-e no Flow Fiscal

Capture CT-e da SEFAZ, vincule às NF-e da carga e registre desacordo no prazo — no mesmo inbox da NF-e e da NFS-e.

Testar Flow Fiscal grátis por 10 dias corridos