Importação XML CT-e

O serviço GeraCTeByXML, responsável pela geração de CTe a partir de arquivos XML, será oficialmente descontinuado. Essa alteração tem como objetivo manter a retrocompatibilidade para sistemas legados, ao mesmo tempo em que comunica claramente que o serviço não deve mais ser utilizado.

A partir de agora, o direcionamento passa a ser para o serviço SRVTMSConsCTeXMLDirGeraConheEXP, que é padronizado e alinhado com a arquitetura moderna do TMS.

Essa rotina, possibilita que o cliente mig­re suas implementações para o serviço padrão atualizado, evitando impactos em produção durante a transição.

Para utilizá-la, é necessário habilitar o serviço RBT GeraCTe, com o log ativado. Ao habilitar o serviço, o sistema emitirá uma mensagem informando que o serviço foi descontinuado e que o novo serviço deve ser utilizado para a importação dos dados.

Atualizações Necessárias

Para que a rotina funcione corretamente, é necessário atualizar o RBTSVC.exe para a versão 3.33.01.

Configurações Necessárias

1. Configuração no regedit

   Acesse o regedit e, na conexão com o RBT, consulte o item IMPORTACTE.

   

   Dentro de IMPORTACTE, localize a opção GeraCTe, que deve estar configurada como TRUE.

   

2. Ativar Log Automático

   Dentro do RBT, localize a opção GERALOGATE.

   Clique duas vezes e informe uma data que esteja entre a data atual + 7 dias.

   Mais detalhes sobre essa regra podem ser consultados no manual: Como desativar o Log automaticamente – RBT?

   

3. Iniciar o Serviço do RBT

   No Serviços do Windows, localize o serviço do RBT e clique para Iniciar.

   

Na pasta configurada para a geração dos logs executados pelo RBT, o sistema apresentará a informação ao usuário e não seguirá executando o processo, finalizando o fluxo conforme previsto.

Essa rotina, permite importar automaticamente arquivos XML de CT-e para maior desempenho e estabilidade.

A rotina consiste na criação de um novo serviço específico para importação dos arquivos XML de CT-e.

O processo ocorre da seguinte forma:

• Um diretório deve ser criado e configurado para armazenar os documentos XML a serem importados.
• O arquivo JSON do serviço deve ser configurado conforme as necessidades do cliente.
• Após configurado, o serviço executará automaticamente o processo de importação.

Pré-requisitos

Atualizar o SRVTMSConsCTeXMLDirGeraConheEXP.exe para a versão 3.33.01 ou superior.

Configurações

1. Preparação do Ambiente
   • Criar uma pasta ou diretório para salvar o executável, juntamente com a DLL emlv3.
2. Instalação do Serviço
   1. Abra o Prompt de Comando (cmd) como Administrador.
   2. Execute o comando para instalar o serviço, conforme o diretório onde o executável está salvo:

   C:\GeraCTe> SRVTMSConsCTeXMLDirGeraConheEXP.exe /install

   3. Acesse a tela de Serviços do Windows e clique em Iniciar no serviço instalado.
   4. Na primeira execução, serão criadas as chaves de conexão ao banco no Registro do Windows.

      Importante:

      Como essas chaves ainda não existem, será exibida uma mensagem de erro na primeira execução.

   5. Após isso, verifique na pasta se o arquivo .json foi criado. Este arquivo contém diversas tags utilizadas também por outros serviços.
3. Configuração do arquivo JSON

   O arquivo JSON gerado pode conter várias configurações, mas apenas os principais campos precisam ser ajustados:

   "driver": "banco de dados",

   "server": "descrição do servidor",

   "database": "descrição da base de dados",

   "user": "usuário do BD",

   "pass": "senha do BD",

   "empresa": "código da empresa",

   "dirlog": "diretório que será salvo os logs" (diretórios separados por \\),

   "dirXML": "diretório onde estão salvos os XMLs para importação" (diretórios separados por \\),

   "ativaLog": false ou true,

   "tipoLog": "info" ou "debug",

   "tempoLog": tempo em segundos que deseja que o serviço execute,

   "geraLogAte": "[regra de geração do lote]" - Para detalhes sobre o parâmetro geraLogAte, verifique o manual Como desativar o Log automaticamente – SRV Padrão?

   

   Todos os registros serão armazenados em log, conforme as configurações definidas no arquivo JSON.

Utilização

Após o serviço estar corretamente configurado e iniciado:

1. O sistema verificará automaticamente os arquivos XML presentes no diretório informado.

   

2. No arquivo de log, é possível acompanhar:
   • A conexão com o banco de dados,
   • O início da importação dos arquivos,
   • A finalização do processo.

   

3. Na pasta onde os XMLs estão salvos, os arquivos serão marcados como processados, indicando que o serviço concluiu a importação.

   

A rotina de importação de XML de CTe foi desenvolvida para mapear automaticamente o tipo de emissão do conhecimento e preencher valores obrigatórios ausentes no arquivo XML, garantindo padronização e evitando retrabalho manual.

Visando:

• Centralizar parâmetros de configuração.
• Automatizar decisões durante a importação.
• Reduzir erros e retrabalho manual.
• Tornar o processo de geração de conhecimento mais rápido e padronizado.

Pré-requisitos

Para utilizar a rotina, é necessário atualizar os seguintes módulos e serviços para a versão 3.33.01 ou superior:

• CAS (execute com data de criação de 28/11/2025)
• CFG
• SRVTMSConsCTeXMLDirGeraConheEXP

Configurações

As configurações devem ser realizadas no módulo CFG, seguindo o caminho:

Utilitários > Configurações > TMS > EXP – Expedição > guia Conhecimento > Opção Importação de XML de CTe

Aqui são exibidos os campos DE-PARA Classificação Tipos Emissão de Conhecimentos.

Guia Geral:

• Código da Natureza de Carga Padrão

  Busca os dados do cadastro de natureza de carga.

• Código da Espécie de Carga Padrão

  Busca os dados do cadastro de espécies de carga.

• Código do Tipo de Transporte Padrão

  Busca os dados do cadastro de tipos de transporte.

• Tipo de Documento Fiscal Padrão

  Busca os dados do cadastro de tipos de documentos fiscais.

• Averbado: (Sim/Não)

  Ao clicar no botão (?) apresenta a descrição: Define CTe importado como averbado.

• Vincular NF-es Automaticamente: (Sim/Não)

Guia Mapeamento de Classificação

• Tipo de CTe

  Opções: normal, complemento valores, anulação e substituto.

• Característica adicional

  Campo descrição.

• Classificação de Tipos de Emissão

  Busca os dados do cadastro de tipos de classificação de emissão de conhecimento.

• Tipo de Emissão

  Campo somente leitura. Busca automaticamente o tipo de emissão, de acordo com a Classificação selecionada.

Funcionalidade e utilização

O processo de importação de XML de CTe realiza:

• Mapeamento do tipo de emissão informado no XML para a classificação interna do sistema.
• Preenchimento automático de campos obrigatórios quando não existirem informações no arquivo.

Após a configuração:

1. O serviço SRVTMSConsCTeXMLDirGeraConheEXP.exe processa os XMLs na pasta definida.
2. Altera a descrição e transfere os arquivos para a pasta processado, caso não haja inconsistências.

   

3. Os dados importados ficam disponíveis na consulta de conhecimentos.

   

Passo a Passo:

1. Realize as configurações no módulo CFG.
2. Coloque os XMLs na pasta do diretório configurado.
3. Inicie o serviço SRVTMSConsCTeXMLDirGeraConheEXP.exe.
4. O sistema processará os arquivos e moverá para a pasta processado.
5. Consulte os conhecimentos para visualizar os dados importados.