Consulta CT-e: como automatizar o download do XML do CT-eConsulta CT-e: como automatizar o download do XML do CT-eConsulta CT-e: como automatizar o download do XML do CT-eConsulta CT-e: como automatizar o download do XML do CT-e
  • Início
  • Categorias
    • Certificado Digital
      • TecnoSign para ERP
      • Tipos de Certificado
    • Decision IT
      • Eventos – Decision IT
    • Documentos Fiscais
      • Documentos Técnicos
        • CTe e CTe OS
        • GNRe
        • MDFe
        • NFCom
        • NFe e NFCe
        • NFSe
        • SAT e MFe
      • Reforma Tributária
      • Regimes Tributários
      • Soluções Fiscais
      • SPED
        • EFD Contribuições
        • EFD – ICMS / IPI
        • EFD – Reinf
        • eSocial
    • Eventos
    • Fintech
      • Boleto
      • Consulta de Crédito
      • Meios de Pagamento
      • Pix
      • Tecnologia Financeira
    • Gestão
    • Inovação
      • Plug4Market
      • PlugMessage
      • PlugSign
      • SpeedChat
    • Institucional
    • Mobile
      • Banco de dados
      • PlugDash
      • Tecnologia Mobile
      • Visualização de Dados
    • Tecnologia
  • Reforma Tributária
  • Sobre Nós
    • Site
    • Institucional
    • Evento TecnoUpdate
  • Soluções
    • Ferramentas Gratuitas
      • Siga as novidades
      • Materiais Ricos
      • Monitor SEFAZ
      • Validador NF-e
      • Visualizador de DANFE/DACTE
      • Cursos Gratuitos
      • Revista TecnoUpdate
    • Documentos Fiscais
    • API Boleto
    • API Pix
    • API Consulta de Crédito
    • API Pagamentos
    • Fintech
    • Dashboard Mobile
    • Certificado Digital
  • CdD
  • Decision IT S.A.

Mais resultados

Generic selectors
Apenas correspondências exatas
Pesquisar no título
Pesquisar no conteúdo
Post Type Selectors
Filtrar por categorias
Academy
Banco de dados
Boleto
Certificado Digital
Consulta de Crédito
CTe e CTe OS
Decision IT
Documentos Fiscais
Documentos Técnicos
EFD - ICMS / IPI
EFD - Reinf
EFD Contribuições
eSocial
Eventos
Eventos - Decision IT
Fintech
Gateway de pagamento
Gestão
GNRe
Inovação
Institucional
Marketing
MDFe
Meios de Pagamento
Mobile
NFCom
NFe e NFCe
NFSe
Pix
Plug4Market
PlugDash
PlugMessage
PlugSign
Reforma Tributária
Regimes Tributários
SAT e MFe
Sem categoria
Soluções Fiscais
SPED
SpeedChat
Tecnologia
Tecnologia Financeira
Tecnologia Mobile
TecnoSign para ERP
Tipos de Certificado
Visualização de Dados

Consulta CT-e: como automatizar o download do XML do CT-e

Publicado por Redação Tecnospeed em 19 de dezembro de 2023
Tempo de Leitura: 3 minutos

Você sabe o que é consulta CT-e? Conheça este recurso da SEFAZ-AN e turbine seu software para facilitar ainda mais a vida do seu cliente.


Existem alguns recursos essenciais para um software de logística. No módulo fiscal, por exemplo, é necessário fornecer todas as rotinas para emissão do Conhecimento de Transporte Eletrônico (CT-e).

No entanto, existem outras funcionalidades relacionadas a documento fiscal eletrônico que podem ser exploradas pelo seu ERP. Uma delas é o módulo de Consulta CT-e, que facilita o controle da transportadora e do cliente dela sobre suas operações.

Você sabe o que é Consulta CT-e? Para que serve? E o mais importante: como implementar no seu software? Vamos descobrir!

Conteúdo ocultar
1. O que é Consulta CT-e?
2. O que é CTeDistribuicaoDFe ?
2.1. Utilizando a DLL CTe TecnoSpeed
2.2. Utilizando a API CTe TecnoSpeed
3. Facilite a implementação do CT-e no seu software

O que é Consulta CT-e?

Primeiramente precisamos entender o que é o CT-e? O CT-e: Conhecimento de Transporte Eletrônico, modelo 57 é um documento fiscal eletrônico, de existência apenas digital que deve ser emitido para acobertar operações de prestação de serviço de transporte de cargas. A obrigação de emitir CT-e abrange transportadoras de diferentes modais de transporte, simplificando as obrigações fiscais do contribuinte e facilitando a fiscalização.

A Consulta CT-e é um processo de consulta de informações e download de XML do Conhecimento de Transporte Eletrônico e seus respectivos Eventos do CT-e. É um recurso exclusivo da SEFAZ-AN. A Consulta CT-e permite consultar todos os dados de um conhecimento de transporte eletrônico. Podendo ser consultados os CT-e emitidos em casos de testes de homologação técnica (sem validade jurídica) ou os emitidos por estabelecimentos já credenciados à emissão (com validade jurídica). 

O que é CTeDistribuicaoDFe ? 

Este web service, oficialmente chamado de CTeDistribuicaoDFe, é compartilhado entre todas as Sefaz estaduais. Publicado na Nota Técnica 2015.002, o serviço substitui a Consulta de CT-es Destinados, que foi descontinuada no final de 2015.

Ele permite a consulta, a manifestação e então o download do XML do CT-e ou seus respectivos eventos, na qual o usuário é um dos atores do CT-e, como emitente, tomador, expedidor, destinatário ou terceiro. 

Os documentos fiscais eletrônicos estarão disponíveis para distribuição por até 3 meses após sua recepção pelo Ambiente Nacional do CT-e. A distribuição ocorrerá para os atores que desempenham papéis de emitente, destinatário, remetente, recebedor, expedidor, tomador e terceiros devendo ser informado na tag autXML conforme tabela abaixo:

1 O CT-e estará disponível para terceiros somente cujo CNPJ ou CPF estiverem informados no grupo autXML, sendo que para estes usuários, visando a preservação do sigilo fiscal, todas as chaves de acesso de CT-e e NF-e relacionadas no CT-e distribuído deverão ser alteradas para o literal 99999999999999999999999999999999999999999999, conforme decisão do ENCAT.

Como implementar a Consulta CT-e?

Para realização da Consulta CT-e, o usuário precisa realizar uma comunicação com o web service CTeDistribuicaoDFe, e fornecer suas algumas informações:

  • Código da UF do ator
  • CNPJ ou CPF do interessado
  • NSU (Número Sequencial Único)
  • Tipo do NSU, específico ou último

Essa operação também exige o uso de Certificado Digital  para autenticação do ator dos documentos.

Se você quiser poupar tempo e esforço de implementação, existem bibliotecas e APIs prontas, contendo toda a rotina da consulta CT-e, como o CTe TecnoSpeed.

Utilizando a DLL CTe TecnoSpeed

Se você utilizar a integração via DLL do CTe TecnoSpeed, deverá chamar o método ConsultarDistribuicaoDFe para realizar este processo. Os parâmetros para seu preenchimento são:

  • aCodigoUF (Código da UF do ator)
  • aCNPJCPF (CNPJ ou CPF do interessado no DF-e)
  • aNSU (Número sequencial único a ser consultado)
  • aTipoNSU (Tipo do NSU, específico ou último)
  • nkEspecifico=1 ou nkUltimo=0

Como retorno dessa operação, você receberá um arquivo XML contendo os documentos (compactados em base64) de interesse do ator.

 procedure TFrmExemplo.BtConsultarDfeClick(Sender: TObject);
var
  _returnValue: string;
begin
  try
    _returnValue := CTe.ConsultarDistribuicaoDFe(IntToStr(CTe.ObterCodigoUF(edUF.Text)), edtCNPJ.Text , EdtNsu.text, TNSUKind(RgNsu.ItemIndex));
  except
    raise ;
  end;
end;

Para complementar o método ConsultarDistribuicaoDFe  que retorna o XML contendo os documentos de interesse do ator compactados deve ser utilizado o método  TratarXMLRetornoDFe. 

Esse método recebe o XML de retorno da consulta DFe e faz o tratamento de cada XML compactado e o retorna na pasta definida na propriedade DiretorioXmlTomadorServico .

Seu único parâmetro de utilização é o:

  • aXML (XML de retorno da consulta de DFe)

Como retorno, você obterá os XML solicitados, sem compactação, na pasta definida na propriedade.

  procedure TFrmExemplo.BtConsultarDfeClick(Sender: TObject);
var
  _returnValue: string;
begin
  try
    _returnValue := CTe.ConsultarDistribuicaoDFe(IntToStr(CTe.ObterCodigoUF(edUF.Text)), edtCNPJ.Text , EdtNsu.text, TNSUKind(RgNsu.ItemIndex));
    CTe.TratarXMLRetornoDFe(_returnValue);
  except
    raise ;
  end;
end;

Utilizando a API CTe TecnoSpeed

Se você utiliza a integração via API do CTe TecnoSpeed, deverá utilizar a rota /consultadfe para obtenção do CT-e

https://managersaas.tecnospeed.com.br:8081/ManagerAPIWeb/cte/consultadfe

A SEFAZ disponibiliza as consultas por lotes de até 50 CT-es. Ao realizar a consulta, o CTe TecnoSpeed retorna todos os lotes localizados nos 15 dias anteriores à consulta, caso não seja passado nenhum parâmetro na consulta.

A Querystring deve ser realizada assim:

 Nome Descrição
 Grupo Nome do grupo
 CNPJ CNPJ que está vinculado ao grupo que será usado para realizar a consulta, apenas números
 TipoNSU 0 – Até a ultima NSU encontrada

1 – Somente a NSU específica

 NSU Número que indica a primeira NSU a ser consultada. Caso seja informado com zero, ou com um NSU muito antigo, a consulta retornará unicamente os CT-e’s que tenham sido recepcionados nos últimos 15 dias

Como retorno desta requisição, você obterá uma mensagem semelhante a essa:

"cStatus", "xMotivo", "ultNSU", "maxNSU"

138, Documento localizado, 000000000001234, 000000000005678

Facilite a implementação do CT-e no seu software

A Consulta de CT-e através do web service CTeDistribuicaoDFe é apenas um dos muitos processos que o CTe TecnoSpeed pode te ajudar a implementar no seu sistema. Integrável via DLL ou API, você ainda conta com uma equipe de consultoria técnica e tributária.

Economize tempo e esforço no desenvolvimento do módulo fiscal do seu ERP de logística. Deixe com quem entende de documentos fiscais eletrônicos!

Saiba mais

Redação Tecnospeed
Redação Tecnospeed
Perfil da Equipe de Redação da TecnoSpeed.

Posts relacionados

15 de maio de 2025

Informe Técnico RT 2024.001 – Tabela de Código de Classificação Tributária do IBS e da CBS – cClassTrib


Leia +
13 de maio de 2025

19 recursos do PlugNotas para potencializar o módulo fiscal do seu software


Leia +
8 de maio de 2025

CT-e OS: tudo sobre o Conhecimento de Transporte Eletrônico para Outros Serviços


Leia +

Comments are closed.

Pesquisar artigos

Mais resultados

Generic selectors
Apenas correspondências exatas
Pesquisar no título
Pesquisar no conteúdo
Post Type Selectors
Filtrar por categorias
Academy
Banco de dados
Boleto
Certificado Digital
Consulta de Crédito
CTe e CTe OS
Decision IT
Documentos Fiscais
Documentos Técnicos
EFD - ICMS / IPI
EFD - Reinf
EFD Contribuições
eSocial
Eventos
Eventos - Decision IT
Fintech
Gateway de pagamento
Gestão
GNRe
Inovação
Institucional
Marketing
MDFe
Meios de Pagamento
Mobile
NFCom
NFe e NFCe
NFSe
Pix
Plug4Market
PlugDash
PlugMessage
PlugSign
Reforma Tributária
Regimes Tributários
SAT e MFe
Sem categoria
Soluções Fiscais
SPED
SpeedChat
Tecnologia
Tecnologia Financeira
Tecnologia Mobile
TecnoSign para ERP
Tipos de Certificado
Visualização de Dados

Acompanhe nosso videocast:

Categorias

Novos artigos

  • 0
    Informe Técnico RT 2024.001 – Tabela de Código de Classificação Tributária do IBS e da CBS – cClassTrib
    15 de maio de 2025
  • Análise de Crédito: Entenda para que serve e como integrá-la no seu software
    14 de maio de 2025
  • 19 recursos do PlugNotas para potencializar o módulo fiscal do seu software
    13 de maio de 2025

Compartilhe:

Facebook
Facebook
fb-share-icon
LinkedIn
LinkedIn
Share
Instagram
Siga nossa página no Google Notícias

Newsletter

Receba conteúdo para Software Houses no seu e-mail!

Vamos juntos fortalecer o Desenvolvimento de Software no Brasil?
Conheça mais sobre a Casa do Desenvolvedor da TecnoSpeed 🚀

Desenvolvido com muito  e  pela TecnoSpeed.
Conheça nossa política de privacidade