Data de publicação: 11/02/2026

🎯 Objetivo

Orientar a correção/alternativa para casos em que a geração de log via arquivo na integração TOTVS OMS x TOL fica muito lenta ou não pode ser habilitada para alguns usuários, adotando a emissão do log no Console.log via LogMsg().

❓ Dúvida

O log da integração OMS x TOL/TRE está divergente, muito lento quando gerado em arquivo, ou não habilita para alguns usuários. Como ajustar?

🧭 Ambiente

TOTVS Logística — TOTVS OMS (Linha Protheus) — Gestão de Distribuição (SIGAOMS) — Todas as versões

✅ Solução

🧩 Componentes envolvidos

As rotinas/funções abaixo estão relacionadas ao fluxo de integração e ao ponto de log:

• OMSXCPL — Regras de Integração OMS x TOL

• OMSXCPLWS — Web Service Client de envio de informações para o TOL

• OMSXWS — Web Service Server para recebimento de informações

• TMSXWS — Estruturas de WebServices

🐢 Problema identificado

A geração de log via arquivo pode ficar muito lenta e, em alguns cenários/usuários, não é possível habilitar esse tipo de saída.

🛠️ Ajuste aplicado

Foi realizada uma alteração na função OsLogCPL para que o log seja gerado no Console.log utilizando LogMsg().

✅ Importante: a exibição/geração do log continua controlada pelo parâmetro LOGCPLOMS no AppServer.ini.

⚙️ Como habilitar na prática

1) Habilite o parâmetro de log da integração no AppServer.ini

No AppServer.ini, na seção do ambiente que executa a integração, adicione/garanta:

LOGCPLOMS=.T.

2) Garanta a geração do Console.log do Protheus

Na seção [General], habilite e direcione o arquivo de console:

[General]
CONSOLELOG=1
ConsoleFile=C:\Protheus\log\console_p12.log
ConsoleMaxSize=524288

Ajuste o caminho do ConsoleFile conforme o padrão do seu ambiente.

3) O que esperar no Console.log

Com a correção ativa e o LOGCPLOMS=.T., as mensagens passarão a ser registradas no Console.log por meio do LogMsg(), reduzindo o impacto que ocorria no log via arquivo.

🧪 Exemplo de validação

• Execute o processo completo da integração (por exemplo, o fluxo no TOL/TRE e o retorno ao OMS).

• Verifique o Console.log informado em ConsoleFile para confirmar as mensagens da integração.

✅ Resultado esperado

• Log de integração mais estável e com melhor desempenho ao registrar no Console.log.

• Redução de cenários onde o log “não habilita” quando o modo anterior era dependente de geração via arquivo.

❓ FAQ

1) Ainda preciso do parâmetro LOGCPLOMS para ver o log?
Sim. A emissão do log continua condicionada ao LOGCPLOMS=.T. no AppServer.ini.

2) O que muda com a alteração na OsLogCPL?
O log passa a ser registrado via LogMsg() no Console.log, evitando a lentidão típica de geração via arquivo em alguns ambientes.

3) Preciso reiniciar o AppServer após alterar o AppServer.ini?
Sim. Para aplicar parâmetros do AppServer.ini, é recomendado reiniciar o serviço do AppServer.

4) Onde eu valido se o log está sendo gerado?
No caminho configurado em ConsoleFile (seção [General]), dentro do Console.log.

5) Quais rotinas são mais impactadas/relacionadas?
Principalmente OMSXCPL, além das camadas de comunicação OMSXCPLWS/OMSXWS e estruturas TMSXWS.

👤 Autor

Fabrizio Augusto Ventavolo — Consultor Especialista TOTVS — Mastersiga Consultoria