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 funcionalidade de planejar as rotas da carga de forma inteligente, através da organização da melhor rota de entrega dos pedidos que compõem a carga. Além de sugerir a melhor rota com base na carga já criada, apresenta em tela o desenho da trajetória no mapa.

Exemplo:


Essa funcionalidade é adquirida à parte do módulo OMS, visto que requer a integração com softwares parceiros para possibilitar a roteirização com base na geolocalização de endereços de entrega. 

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.25 ou superior.
  • Configurações de ambiente realizadas conforme as instruções abaixo.
  • Não é escopo desse documento descrever a instalação do ERP Protheus, nem suas configurações básicas. 
  • Para utilização da integração, o módulo SIGAOMS  na versão 12.1.23 (ou superior) do Protheus deve estar com o ambiente atualizado com a última versão de RPO e o dicionário disponível na Central de Downloads TOTVS.
  • Para obter mais informações sobre como atualizar o dicionário de dados do Protheus 12, clique aqui.


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.
    • Após a aplicação, verificar se a tabela DK4 foi criada.
  • Aplicar o pacote de dicionário Parâmetro_OMS_sdfbra.zip, para criar o parâmetro MV_ROTAINT pertencente à roteirização.
    • Após a aplicação, verificar se o parâmetro MV_ROTAINT foi criado.
  • 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. 
    • Após a aplicação, verificar se a tabela DLV foi criada.
  • Atualizar o menu OMS com o arquivo: sigaoms.zip
    • Após a atualização, acessar o menu OMS e verificar se existe o caminho Atualizações > Rotas Inteligentes.

4.Atualização das Rotinas

  • Utilizar o pacote Rotas_Inteligentes_OMS.zip para atualizar as rotinas OMS, aceitar somente fontes atualizados.  Obs.: Pacote compatível para versões iguais ou superiores à 12.1.25. 
    • Após a aplicação do pacote, verificar se o rpo encontra-se com os fontes com data igual ou superior à lista abaixo:
      • OMSA200.prw - data mínima: 23/09/2019
      • OMSA205A.prw- data mínima: 07/08/2019
      • OMSBCAMapLinkAccessToken.prw- data mínima: 07/08/2019
      • OMSBCAMapLinkPlanning.prw- data mínima: 07/08/2019
      • OMSBCAMapLinkTrip.prw- data mínima: 07/08/2019
      • OmsMapLink.prw- data mínima: 23/09/2019
  • Utilizar o pacote Rotas_Inteligentes_Geolocalização.zip para atualizar os fontes referentes à geolocalização dos endereços, aceitar somente fontes atualizados. Obs.: Pacote compatível para versões iguais ou superiores à 12.1.25. 
    • Após a aplicação do pacote, verificar se o rpo encontra-se com os fontes com data igual ou superior à lista abaixo:
      • CRM980EventDEFTMS.prw - data mínima: 29/08/2019
      • TMSAO15.prw - data mínima: 20/08/2019
      • TMSAO46.prw - data mínima: 26/08/2019
      • TMSAO47.prw - data mínima: 20/08/2019
      • TMSAO48.prw - data mínima: 05/09/2019
      • TMSAO49.prw - data mínima: 24/07/2019
      • TMSAO50.prw - data mínima: 24/07/2019
      • TMSAO51.prw - data mínima: 20/08/2019
      • TMSAO52.prw - data mínima: 24/07/2019
      • TMSAO53.prw - data mínima: 10/07/2019
      • MATN030 - data mínima: 02/08/2019

5.Parametrização OMS

Para a integração seja ativada no OMS é necessário alterar o conteúdo dos parâmetros MV_ROTAINT e MV_MAPLINK para .T. Para isso, pode ser utilizada a rotina inicial SIGACFG.

Além disso, é necessário cadastrar o client id 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.