Logística - Linha Protheus - OMS - Cancelar Viagem gerada no TOL/TRE, quando integrada ao TOTVS OMS

Tempo aproximado para leitura: 00:03:36 min

Dúvida
Como realizar o Cancelamento de uma Viagem gerada no TOL/TRE, quando integrada ao TOTVS OMS?

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

Solução
Quando a integração do TOTVS OMS  x TOL/TRE estiver ativa, os pedidos de venda gerados no TOTVS OMS poderão ser integrados ao TOL/TRE, transformando-se em Pedidos de Transportes, que resultam em Viagens.

O cancelamento de uma viagem gerada no TOL/TRE, poderá ser realizado acessando o módulo Programação, na rotina Análise, disponível no TOL/TRE. Selecione a viagem, acione o botão viagem, localizado na parte inferior da tela, em seguida pressione a opção Cancelar. Conforme exemplo abaixo:

Apenas viagens em criação, distribuídas, com oferta cancelada ou liberadas podem ser canceladas.

Para que seja possível cancelar as viagens do TOL/TRE é necessário configurar as informações de conexão com o DBAccess diretamente na seção Environment, modificando o arquivo Appserver.ini do TOTVS OMS, conforme exemplo abaixo:

Nome do Ambiente acessado pelo Web Service
[Environment]
SourcePath=C:\Totvs\Protheus\Apo
RootPath=C:\Totvs\Protheus\Data
StartPath=\system\
. . . ; outras chaves
DBDatabase=MSSQL
DBAlias=PLS101
DBServer=192.168.1.20
DBPort=7890

Além da configuração arquivo Appserver.ini do TOTVS OMS, no TOL/TRE, realize os procedimentos abaixo:

• Acesse Configuração/Integração, selecione Fontes de Dados e clique em Inserir ou Alterar caso exista. Digite o código, nome e a descrição.
  Em Serviços para tarefas de integração, no campo URL, digite:
  http://<ip ou nome>:<porta>/neolog/CancelService.APW.
  No campo Tempo Máximo de Espera por Resposta, informe o timeout do serviço, recomendado 30000.
  Clique em Salvar. 
  
  
• Acesse Configuração/Integração, selecione Geral e marque os seguintes itens: 
  Permissão: Permitir o cancelamento de uma viagem liberada.
  Solicitações: Solicitação de cancelamento de viagem ligada.

O processo de cancelamento de viagem gera arquivo XML de comunicação do TOTVS OMS x TOL/TRE na pasta cancelservice. Essa pasta é criada automaticamente, assim que ocorrer o primeiro cancelamento efetuado no ambiente. Para isso é necessário informar o bloco abaixo definido no arquivo Appserver.ini WS do TOTVS OMS:

[NEOLOG]
Debug=1
DebugPath=Neolog

Parâmetros que interferem no Cancelamento:

• MV_CPLESCG: Permite estorno automático da carga ao cancelar ou reprogramar viagem?
  Indica se será permitido efetuar o estorno automático da carga ao cancelar ou reprogramar uma viagem. Quando o usuário do TOL/TRE solicitar o cancelamento ou reprogramação da viagem, caso exista carga montada no TOTVS OMS esta será estornada.
• MV_CPLATVG: Atualiza a viagem no TOL/TRE ao cancelar a integração do pedido?
  Indica se será atualizada a viagem no TOL/TRE ao cancelar a integração no TOTVS OMS. Se esse parâmetro estiver definido como 1-Sim, ao cancelar um item integrado que já encontra-se em uma viagem, será solicitada a alteração da viagem no TOL/TRE para que reflita os ajustes sofridos no TOTVS OMS.

Importante
No quadro abaixo descrevemos os principais resultados ao Cancelar uma Viagem no TOL/TRE:

Saiba mais
Mais informações poderão ser acessadas nos link's:
Logística - Linha Protheus - OMS - Integração Protheus TOTVS OMS x TOL/TRE
Logística - Linha Protheus - OMS - Parâmetros para integrar o TOTVS OMS x TOL/TRE
Logística - Linha Protheus - OMS - Como habilitar geração de arquivo de LOGs na integração do TOTVS OMS x TOL/TRE

Glossário
TOL - TOTVS Otimização Logística
TRE - TOTVS Roteirização e Entrega
TOTVS OMS - Order Management System