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

🎯 Objetivo

Orientar como habilitar a geração de arquivo de log para apoiar a análise do tráfego de informações e do fluxo de processamento na integração entre TOTVS OMS (SIGAOMS) e TOL/TRE, especialmente nas rotinas OMSXCPL6/OMSXCPL7.

❓ Dúvida

Como gerar e utilizar o arquivo de log na integração TOTVS OMS x TOL/TRE?

🧭 Ambiente

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

✅ Solução

Foi implementada uma funcionalidade para geração de log, permitindo registrar mensagens nas rotinas e funções da integração, com foco em facilitar:

• a análise das informações enviadas e recebidas

• a compreensão do fluxo e da lógica durante o processamento da integração

🧩 Rotinas/funcionalidades mais relacionadas

• OMSXCPL6 — Envio de pedidos

• OMSXCPL7 — Monitor de Cargas

• OMSXCPLB — Validações da integração entre TOL e OMS

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

⚙️ Como habilitar a geração do log

1) Ajuste o Appserver.ini no(s) ambiente(s) necessário(s)

No arquivo Appserver.ini, inclua o parâmetro abaixo na seção do(s) ambiente(s) onde o log deve ser gerado:

LOGCPLOMS=.T.

✅ Para desabilitar o log, você pode:

• remover a linha do Appserver.ini, ou

• alterar para:

LOGCPLOMS=.F.

🧪 Exemplo de utilização na prática

📤 Cenário 1 — OMSXCPL6 (Envio de pedidos)

1. Com o parâmetro LOGCPLOMS=.T. ativo, envie um pedido via OMSXCPL6.

2. Em seguida, confira o arquivo de log gerado e valide as mensagens registradas no processo.

🚚 Cenário 2 — TOL/TRE (Geração e liberação de viagem)

1. No TOL/TRE, selecione o pedido e gere a viagem.

2. Libere a viagem.

3. Acesse o arquivo de log e confira as mensagens emitidas na etapa.

🧭 Cenário 3 — OMSXCPL7 (Monitor de cargas)

1. No Monitor de Cargas (OMSXCPL7), selecione a viagem.

2. Clique em Liberar.

3. Verifique no arquivo de log as mensagens geradas durante a ação.

🔄 Cenário 4 — Reprogramação de viagem

1. No TOL/TRE, selecione a viagem.

2. Clique em Reprogramar.

3. Consulte o arquivo de log para validar o fluxo e mensagens do processo.

✅ Resultado esperado

Com o parâmetro habilitado, o Protheus passa a gerar logs que ajudam a rastrear o processamento, facilitando:

• identificação de falhas no fluxo

• validação de etapas executadas

• análise de comportamento em cenários de integração e performance

❓ FAQ

1) Preciso reiniciar o Appserver após alterar o Appserver.ini?
Sim. Alterações em parâmetros do Appserver.ini normalmente exigem reinício do serviço para aplicação efetiva.

2) Posso habilitar o log apenas temporariamente para análise?
Sim. O recomendado é habilitar durante a análise e depois remover ou ajustar para .F., evitando impacto em ambientes com grande volume.

3) Esse log ajuda a identificar onde o fluxo “quebra” entre OMS e TOL/TRE?
Sim. Ele registra mensagens auxiliares que ajudam a entender em qual etapa e com quais dados o processo estava quando ocorreu o problema.

4) Em quais rotinas esse log é mais útil?
Principalmente em OMSXCPL6 (envio), OMSXCPL7 (monitor), além de suportar validações (OMSXCPLB) e recebimentos via OMSXWS.

5) Se eu tiver mais de um Appserver.ini (ambientes diferentes), preciso configurar todos?
Sim. Configure todos os Appserver.ini dos ambientes envolvidos no tráfego e processamento da integração.

👤 Autor

Fabrizio Augusto Ventavolo — Consultor Especialista TOTVS — Mastersiga Consultoria