Histórico da Página

Pickup

Integração OMS Protheus - Rotas InteligentesContexto de Negócio (Introdução)

O módulo de Gestão de Distribuição (SIGAOMS) da linha Microsiga Protheus dispõe da possibilidade funcionalidade de planejar as rotas da carga de forma inteligente, sendo possível organizar a através da organização da melhor rota de entrega dos pedidos que compõem a carga. Essa funcionalidade possibilita a sugestão da melhor rota de entrega Além de sugerir a melhor rota com base na carga já criada e, por fim, o mapa é apresentando , apresenta em tela com o desenho da trajetória destacadano mapa.

Exemplo:

Integração OMS Protheus - Rotas InteligentesEscopo

O escopo desta integração abrange a ordenação dos pontos de entrega da carga (DAI) e a visualização do mapa com o caminho mais rápido para a entrega apresentando a quilometragem que será realizada, bem como, o tempo que será consumido.

Não faz parte do escopo dessa integração:

• Montar a carga de forma automática.
• Apresentar e considerar os pedágios existentes no caminho definido.

Integração OMS Protheus - Rotas InteligentesPré-requisitos Instalação / Implantação / Utilização

• Protheus versão  12.1.23 ou superior.
• Dicionário de dados atualizados com as tabelas pertencentes a integração.
• Parâmetros de utilização das Rotas Inteligentes configurados conforme orientação descrita nas próximas seçõesConfigurações de ambiente realizadas conforme as instruções abaixo.

Integração OMS Protheus - Rotas InteligentesInstalação/Configuração

Para o funcionamento das Rotas Inteligentes no OMS Protheus, os seguintes passos devem ser seguidos:

1. Configuração AppServer Protheus 

• Para que seja possível apresentar a página HTML contendo a apresentação do mapa da rota dentro do Protheus são necessárias algumas configurações no arquivo appserver.ini do ambiente.

;Serviço webserver HTTP
[HTTP]
ENABLE=1
PATH=<Caminho_Cache_imagens>;  exemplo: C:\TOTVS\Protheus\data\web
PORT=<porta>; exemplo: 8080
INSTANCES=<nInicio>,<nMaximo>; exemplo: 1,10
SESSIONTIMEOUT=60
INSTANCENAME=WS_HTTP
 
 [<ip ou nome>:<porta>/neolog]; exemplo: localhost:8082/oms
ENABLE=1
PATH=<Caminho_Cache_imagens>; deve ser o mesmo caminho do PATH da seção HTTP acima, exemplo: C:\TOTVS\Protheus\data\web
ENVIRONMENT=<ambiente>
INSTANCENAME=WS_OMSCARGA
RESPONSEJOB=JOB_WS_OMS
DEFAULTPAGE=wsindex.apw

[JOB_WS_OMS]
TYPE=WEBEX
ENVIRONMENT=<ambiente>
INSTANCES=<nInicio>,<nMaximo>; exemplo: 1,10
INSTANCENAME=JOB_WS_NEOLOG_OMS
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=99,01
SIGAWEB=WS

• Para evitar inconsistências do tipo Failed Handshake SSL, recomenda-se incluir a seguinte configuração no appserver.ini:

[SSLConfigure]
TryProtocols=1
Verbose=1

2.Armazenar os Arquivo HTML

É necessário que os arquivos para a apresentação web (showrota.html, tmsimg32.png e totvstec.js) responsáveis pela projeção do mapa em tela, sejam armazenados dentro da pasta definida na seção HTTP, tag PATH do appserver.ini.

Clique no link para baixar os arquivos: web.zip. 

3.Atualização do Dicionário de Dados

Caso sua versão do Protheus seja inferior a 12.1.28 será necessário a aplicação de alguns pacotes de dicionário para a geração dos novos campos e tabelas da integração.

• Aplicar o pacote de dicionário Dicionário_OMS_sdfbra.zip pelo UPDDISTR, para criar os campos da necessários para a roteirização.
• Aplicar o pacote de dicionário Parâmetro_OMS_sdfbra.zip, para criar o parâmetro MV_ROTAINT pertencente à roteirização.
• Aplicar o pacote de dicionário Geolocalizacao_sdfbra.zip pelo UPDDISTR, para criar os campos da integração referentes à geolocalização dos cadastros de clientes. 
• Atualizar o menu OMS com o arquivo: sigaoms.zip

4.Atualização das Rotinas

• Utilizar o pacote Rotas_Inteligentes_OMS.zip para atualizar seu ambiente, aceitar somente fontes atualizados.  Obs.: Pacote compatível para versões iguais ou superiores à 12.1.23. 

5.Parametrização OMS

Para a integração seja ativada no OMS é necessário alterar o conteúdo do parâmetro MV_ROTAINT (Habilita Rotas Inteligentes) para .T.  Para isso, pode ser utilizada a rotina inicial SIGACFG.

Além disso, é necessário cadastrar o clientid e secret id da licença fornecida pela TOTVS para que seja possível consumir as APIs de roteirização. Para isso, acesse SIGAOMS > Atualizações > Rotas Inteligentes > Configurações e inclua um novo registro informando os campos ID Cliente (DLV_ID) e Client Secret (DLV_SECRET) , conforme os dados da licença adquirida. 

6.Geolocalização dos Endereços de Entrega

A roteirização ocorre com base nas coordenadas (latitude e longitude) dos endereços de entrega, por conta disso, é imprescindível verificar se os clientes (SA1) encontram-se devidamente cadastrados, com as informações de  endereço, bairro, cep, cidade e estado preenchidos.

Além de verificar o cadastro dos clientes é necessário verificar se cadastro da filial também possuí as informações do endereço preenchidas. As coordenadas do endereço da filial serão utilizadas como referência para o ponto de partida da carga.

A verificação do cadastro da filial pode ser realizada pelo Configurador (SIGACFG).

A gravação das coordenadas de geolocalização ocorrem nos seguintes pontos do sistema:

• Ao enviar a carga para planejamento e o cliente ainda não está geolocalizado.
• Ao alterar um cadastro de cliente.
• Ao incluir um cadastro de cliente.

Portanto, se um cliente sofrer mudança de endereço, na alteração do cadastro a geolocalização será atualizada.

Integração OMS Protheus - Rotas InteligentesFuncionamento

A utilização das funcionalidades de Rotas Inteligentes do OMS ocorre após a carga montada, seguindo o seguinte fluxo:

1. Acesse a rotina de Montagem de Carga (OMSA200).
2. Posicione em uma carga e clique em Outras Ações > Planejar Roteirização. Neste momento a carga será planejada, portanto, o Status da Rot. (campo encontrado no browse) passará de Não integrada para roteirização para Aguardando planejamento.
3. Quando o Status da Rot. constar como Roteirizada, significa que a carga teve seus pontos de entrega (DAI) organizados conforme o melhor trajeto definido pelo roteirizador e que o mapa encontra-se pronto para ser visualizado. Então, clique em Outras Ações > Visualizar Roteirização para visualizar o trajeto do mapa.