Pular para o conteúdo
FiscalAPI
FiscalAPI
CT-e

Como baixar o XML do CT-e pela chave de acesso

Equipe FiscalAPI 5 min de leitura
CT-eXMLChave de AcessoGuia

Para baixar o XML do CT-e pela chave de acesso, você precisa da chave de 44 dígitos e do certificado digital A1 de quem participa do frete: com os dois, o XML completo e assinado sai no painel ou na API da FiscalAPI. Sem certificado, o caminho é pedir o arquivo à transportadora que emitiu o CT-e.

Em regra, a consulta pública sem certificado mostra só um resumo do CT-e, sem o arquivo. O XML completo, com a assinatura e o protocolo de autorização (o cteProc), fica restrito a quem aparece no documento.

Atualizado em 16 de novembro de 2026.

Os caminhos, lado a lado

CaminhoPrecisa de certificado?O que você recebeCusto
Pedir à transportadora (emitente)NãoO XML oficialR$ 0
Consulta pública resumida, pela chaveNãoDados gerais na tela, sem o XMLR$ 0
Consulta completa nos portais das Secretarias de FazendaEm regra, sim, ou acesso identificado ao portalTodas as informações do CT-e na telaR$ 0
Web service de distribuição do CT-eSim, e um sistema que fale com eleOs CT-e em que você aparece, disponíveis por até 3 mesesR$ 0 mais o custo de desenvolver
Painel ou API da FiscalAPISim, A1 (.pfx ou .p12)O XML completo (cteProc)De R$ 0,05 a R$ 0,36 por XML; 10 grátis por mês no painel

A transportadora é obrigada a encaminhar ou disponibilizar para download o arquivo do CT-e, com o protocolo de autorização, ao tomador do serviço (Ajuste SINIEF 09/07, cláusula oitava, § 9º). Se você é o tomador, pedir é o primeiro passo.

A consulta resumida mostra chave, série, número, data, modal, UF de início e de fim, o emitente e dados básicos do tomador (Manual de Orientação do Contribuinte do CT-e, o MOC). A consulta completa mostra os dados na tela e, em regra, exige que quem consulta se identifique e tenha relação com a operação (Ajuste SINIEF 09/07, cláusula décima oitava, §§ 4º a 6º).

Passo a passo no painel da FiscalAPI

  1. Crie a conta em app.fiscalapi.com.br e confirme o e-mail.
  2. Abra CT-e por Chave no menu do painel.
  3. Envie o certificado A1 (arquivo .pfx ou .p12) e digite a senha. O certificado e a senha são usados só durante a consulta e nunca são guardados.
  4. Cole a chave de acesso. Pode colar com espaços, do jeito que está no DACTE. O painel confere o tamanho e o dígito verificador antes de consultar e mostra se a chave é de CT-e, CT-e OS ou GTV-e.
  5. Clique em Consultar. Quando o XML vem, aparece o botão Baixar XML, que salva o arquivo com o nome da chave.
  6. Guarde o arquivo. A FiscalAPI não mantém cópia do XML: ele vem só na resposta.

O painel consulta uma chave por vez. Para muitas chaves, use a API, uma requisição por chave. Veja como baixar o XML de vários CT-e de uma vez.

De quem precisa ser o certificado

O titular do certificado precisa participar do CT-e como emitente (a transportadora), tomador, remetente, destinatário, expedidor ou recebedor. Se não participar, o XML não vem e a consulta não é cobrada.

O contador pode consultar com o certificado do cliente que participa do frete. Na FiscalAPI, o certificado precisa ser de um desses seis participantes. Certificado A3 (token ou cartão) não serve, porque o arquivo não pode ser enviado.

Onde encontrar a chave de acesso

A chave tem 44 posições e aparece impressa no DACTE, junto do código de barras e do QR Code. Também está no XML, no atributo Id do grupo infCte, precedida de "CTe". O painel e a API aceitam a chave com esse prefixo. Os dígitos 21 e 22 mostram o modelo: 57 é CT-e, 67 é CT-e OS e 64 é GTV-e. Cada posição está explicada em chave de acesso do CT-e: o que significa cada um dos 44 dígitos.

Quanto custa

PlanoCom créditos do planoCom créditos extras
Starter (R$ 50/mês)R$ 0,30 por XMLR$ 0,36 por XML
Pro (R$ 130/mês)R$ 0,195 por XMLR$ 0,255 por XML
Enterprise (R$ 250/mês)R$ 0,05 por XMLR$ 0,05 por XML

Só cobra quando o XML vem. Chave inválida, certificado de quem não participa e CT-e não encontrado não gastam nada. Conta que ainda não assinou plano tem 10 XML grátis por mês no painel, sem cartão. A cota é a mesma do XML da NF-e com certificado: são 10 no total, somando NF-e e CT-e. Detalhes na página do XML do CT-e pela chave.

Quando o XML não vem

O que apareceO que significaÉ cobrado?
Chave inválidaFalta caractere, sobra caractere ou o dígito verificador não confereNão
Chave de NF-eOs dígitos 21 e 22 são 55. Use o XML da NF-e pela chaveNão
O titular do certificado não é participante deste CT-eO certificado é de quem não aparece no documentoNão
Este CT-e não está disponível para downloadO CT-e não foi encontradoNão
Tente novamenteFalha do nosso ladoNão

Perguntas frequentes

Dá para baixar o XML do CT-e sem certificado digital? Na FiscalAPI, não: o XML do CT-e exige o certificado A1 de quem participa do documento. Sem certificado, peça o arquivo à transportadora, que é obrigada a enviá-lo ao tomador.

Baixar o XML do CT-e é grátis? No painel da FiscalAPI, conta que ainda não assinou plano tem 10 XML grátis por mês, somando NF-e e CT-e. Depois disso, cada XML entregue custa de R$ 0,05 a R$ 0,36, conforme o plano.

A FiscalAPI guarda meu certificado ou o XML? Não. O certificado e a senha são descartados ao fim da consulta, e o XML vem só na resposta.

Funciona para CT-e OS e GTV-e? Sim. A consulta aceita os modelos 57 (CT-e), 67 (CT-e OS) e 64 (GTV-e). Veja CT-e OS e GTV-e: o que são e como baixar o XML.

O DACTE em PDF não basta? Para quem emite documentos fiscais eletrônicos, não: o documento é o XML. Veja DACTE ou XML do CT-e.

Fontes

Artigos relacionados


Tem a chave e o A1 de quem participa do frete? Crie sua conta e baixe o XML em CT-e por Chave.

Compartilhar: WhatsApp LinkedIn Twitter

Baixe o XML do CT-e pela chave

XML completo e assinado do CT-e, CT-e OS ou GTV-e, com o certificado A1 de quem participa do frete. Só cobra quando o XML vem.

Ver o XML do CT-e pela chave