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

🎯 Objetivo

Habilitar o log de integração entre o TOTVS OMS (SIGAOMS) e os módulos TOL/TRE, facilitando a análise das informações enviadas e recebidas no processo de integração.

❓ Dúvida

Como habilitar o LOG de integração do TOTVS OMS e TOL/TRE?

🧭 Ambiente

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

✅ Solução

Para auxiliar na análise da integração TOTVS OMS ↔ TOL/TRE, existe uma funcionalidade que gera mensagens auxiliares, queries e conteúdos de variáveis no Console.log do Protheus (ou em arquivo, se parametrizado).

1) Ajuste os parâmetros no Appserver.ini do(s) ambiente(s) envolvidos

No arquivo Appserver.ini, adicione os três parâmetros abaixo na seção do ambiente em que você loga e também no ambiente que executa a integração:

LOGCPLOMS=.T.
FWFRAME_TRACELOG=1
LOGTIPOMS=CONSOLE

📌 Entendendo o parâmetro LOGTIPOMS

O parâmetro LOGTIPOMS define a forma de saída das mensagens:

• CONSOLE (recomendado para implantação e análise): escreve no Console.log

• ARQUIVO: grava em arquivo omscpl.log dentro da pasta \system

Recomendação: em ambientes com grande volume de dados, evitar LOGTIPOMS=ARQUIVO, pois pode causar lentidão no processo de integração.

2) Habilite o Console.log na seção [General]

Na seção [General], inclua/ajuste as linhas abaixo:

• ConsoleLog=1 → habilita geração do Console.log

• ConsoleFile=... → define o caminho do arquivo de log

• ConsoleMaxSize=... → define o tamanho máximo do log

Exemplo:

[General]
CHECKSPECIALKEY=0
CONSOLELOG=1
InstalPath=C:\Protheus
buildkillusers=1
ConsoleFile=C:\Protheus\log\console_p12.log
ConsoleMaxSize=524288
MAXSTRINGSIZE=5

3) Exemplo completo com ambientes de integração

Abaixo um exemplo de Appserver.ini com as seções de ambiente contendo os parâmetros:

[Protheus12]
SourcePath=C:\Protheus\apo\prd
RootPath=C:\Protheus\data
StartPath=\system\
RpoDB=TOP
RpoLanguage=Portuguese
RpoVersion=120
LocalFiles=ADS
SpecialKey=P12_DL
LocalDBExtension=.dbf
PictFormat=DEFAULT
DateFormat=DEFAULT
RegionalLanguage=BRA
FWFRAME_TRACELOG=1
TDSView=1
TOPMEMOMEGA=1
DBDataBase=MSSQL
DBServer=localhost
DBPort=8060
DBALIAS=Totvs12
LOGCPLOMS=.T.
LOGTIPOMS=CONSOLE

[Protheus12WEB]
SourcePath=C:\Protheus\apo\prd
RootPath=C:\Protheus\data
StartPath=\system\
RpoDB=TOP
RpoLanguage=Portuguese
RpoVersion=120
LocalFiles=ADS
SpecialKey=P12_DL
LocalDBExtension=.dbf
PictFormat=DEFAULT
DateFormat=DEFAULT
RegionalLanguage=BRA
FWFRAME_TRACELOG=1
TDSView=1
TOPMEMOMEGA=1
DBDataBase=MSSQL
DBServer=localhost
DBPort=8060
DBALIAS=Totvs12
LOGCPLOMS=.T.
LOGTIPOMS=CONSOLE

🧾 Resultado esperado

Com as configurações aplicadas, o Protheus passará a gerar o Console.log contendo mensagens da integração entre TOTVS OMS e TOL/TRE, permitindo rastrear o fluxo de comunicação e apoiar diagnósticos.

⚠️ Importante

Se você utiliza mais de um ambiente (e portanto pode ter mais de um Appserver.ini), garanta que todas as instâncias envolvidas na integração contenham as configurações acima.

📚 Glossário

• TOL — TOTVS Otimização Logística

• TRE — TOTVS Roteirização e Entrega

• TOTVS OMS — Order Management System

❓ FAQ

1) Preciso configurar no ambiente que acessa (login) e no que integra?
Sim. A orientação é habilitar os parâmetros no ambiente onde você se conecta e no ambiente responsável pela integração.

2) Qual a melhor opção do LOGTIPOMS para implantação?
Em geral, LOGTIPOMS=CONSOLE é a melhor opção para implantação e análise, por ser mais leve e centralizado no Console.log.

3) Posso usar LOGTIPOMS=ARQUIVO em produção?
Pode, mas não é recomendado em ambientes com alto volume de integrações, pois pode gerar impacto de desempenho.

4) Onde encontro o log quando LOGTIPOMS=CONSOLE?
No arquivo definido em [General] → ConsoleFile (ex.: C:\Protheus\log\console_p12.log).

5) Onde fica o log quando LOGTIPOMS=ARQUIVO?
O sistema grava um arquivo chamado omscpl.log dentro da pasta \system do ambiente.

👤 Autor

Fabrizio Augusto Ventavolo — Consultor Especialista TOTVS — Mastersiga Consultoria