Histórico da Página

 Contexto de Negócio (Introdução)

O TOTVS Logística OMS dispõe de uma funcionalidade que permite planejar as rotas da carga de forma inteligente, por intermédio da organização da melhor rota de entrega dos Pedidos que compõem a carga.

Além disso, esta funcionalidade também sugere a melhor rota com base na carga já criada, apresentando em tela o desenho da trajetória no mapa e os postos de pedágio.

Exemplo

 Escopo

O escopo desta integração abrange a ordenação dos pontos de entrega da carga (DAI) com base nas Regras de Entrega (OMSA120) estipuladas no cadastro OMS e a visualização do mapa contendo os postos de pedágio e com o caminho mais rápido para a entrega, apresentando a quilometragem que será realizada, o tempo que será consumido e o valor dos pedágios.

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

• Montar a carga de forma automática.

 Pré-requisitos Instalação / Implantação / Utilização

• Protheus versão 12.1.25 ou superior.
• Configurações de ambiente realizadas de acordo com as instruções abaixo.

 Instalação/Configuração

Para o correto funcionamento das Rotas Inteligentes no TOTVS Logística OMS, os seguintes passos devem ser seguidos:

1. Configurações

1.1  Configuração AppServer Protheus

• Para que seja possível apresentar a página HTML contendo a apresentação do mapa da rota no 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: 8082
INSTANCES=<nInicio>,<nMaximo>; exemplo: 1,10
SESSIONTIMEOUT=60
INSTANCENAME=WS_HTTP
 
[<ip ou nome>:<porta que deve ser igual à definida para a seção http>/oms]; exemplo: localhost:8082/oms - Informar o ip do servidor para que seja possível acessar a funcionalidade de outra máquina.
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_OMS
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=99,01
SIGAWEB=WS

• Para evitar inconsistências do tipo Failed Handshake SSL é recomendável incluir a seguinte configuração no appserver.ini, caso a versão seja inferior à 13.1.3.26 e 13.2.3.26:

[SSLConfigure]
TryProtocols=1
Verbose=1

• Atualizar parâmetro TOPMemoMega no appserver:

[environment]
TOPMemoMega=3

• Ao final das configurações, reinicie o appserver e verifique se o servidor http foi inicializado.

• No log do appserver deve constar uma informação semelhante a essa:

Http server is ready.
Root path is C:\TOTVS\Protheus\data\web
Listening port 8082

1.2  Configuração DBAccess Protheus

• Atualizar chave MaxStringSize:

[General]
MaxStringSize=30

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 na pasta definida na seção HTTP, tag PATH do appserver.ini.

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

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

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

• Aplique o pacote de dicionário Dicionário_OMS_sdfbra.zip pelo UPDDISTR, para gerar os campos da necessários a roteirização.
  • Após a aplicação, verifique se a tabela DK4 foi gerada.
• Aplique o pacote de dicionário Parâmetro_OMS_sdfbra.zip, para gerar o parâmetro MV_ROTAINT pertencente a roteirização.
  • Após a aplicação, verifique se o parâmetro MV_ROTAINT foi gerado.
• Aplique o pacote de dicionário Geolocalizacao_sdfbra.zip pelo UPDDISTR, para gerar os campos da integração referentes a geolocalização dos cadastros de clientes. 
  • Após a aplicação, verifique se a tabela DLV foi gerada.
• Atualize o menu do OMS com o arquivo: sigaoms.zip
  • Após a atualização, acesse o menu do OMS e verifique se existe o caminho Atualizações > Rotas Inteligentes.

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

• Aplique o pacote de dicionário Campo_Pedagio.zip pelo UPDDISTR, para gerar o campo necessário para a apresentação de pedágios no mapa.
  • Após a aplicação, verifique se o campo DK4_PDG foi gerado.

4.  Atualização das Rotinas

• Utilize o pacote Rotas_Inteligentes_OMS_12_1_25.zip para atualizar as rotinas OMS, aceitando somente os fontes atualizados.
  Importante!
  Aplique o pacote conforme sua versão do Sistema.

• Após a aplicação do pacote, verifique se os fontes do RPO estão com data igual ou superior ao da lista abaixo:

  • OMSA200.PRW 09/04/2021 08:36:54

  • OMSA205A.PRW 13/04/2021 15:41:23

  • OMSBCAMAPLINKACCESSTOKEN.PRW 13/04/2021 14:30:17

  • OMSBCAMAPLINKPLANNING.PRW 13/04/2021 14:30:18

  • OMSBCAMAPLINKTRIP.PRW 13/04/2021 14:30:32

  • OMSBCCMAPLINKGEOCODE.PRW 13/04/2021 14:37:42

  • OMSMAPLINK.PRW 13/04/2021 14:29:14

• Utilize o pacote Rotas_Inteligentes_Geolocalizacao_12_1_25.zip para atualizar os fontes referentes a geolocalização dos endereços, aceitando somente os fontes atualizados.
  Importante!

• Após a aplicação do pacote, verifique se os fontes do RPO estão com data igual ou superior ao da lista abaixo:

  • CRM980EventDEFTMS.prw - 14/04/2021 17:21:47

  • TMSAO15.prw - 14/04/2021 14:58:49

  • TMSAO46.prw - 14/04/2021 14:58:49

  • TMSAO48.prw - 14/04/2021 14:58:49

  • TMSAO49.prw - 14/04/2021 17:27:02

  • TMSAO50.prw - 14/04/2021 17:27:50

  • TMSAO52.prw - 12/04/2021 15:58:41

  • TMSXFUNA.PRW - 14/04/2021 15:17:25 

  • MATN030.PRX 14/04/2021 17:40:36

5. Parametrização do TOTVS OMS

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

Além disso, é necessário cadastrar o clientid e secret id. 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), de acordo com os dados da licença adquirida.

6. 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) estão devidamente cadastrados, com as informações de Endereço, Bairro, CEP, Cidade e Estado preenchidas.

Além de verificar o cadastro dos clientes é necessário verificar também se cadastro da Filial possui 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.

A tabela responsável por armazenar a geolocalização dos endereços é a DAR (Entidade x Coordenada Geoproc), que é atualizada pela rotina TMSAO15, que está localizada no módulo 43 - TMS - Gestão de Transportes > Atualizações > Logística > Ref. Geográfica

 Funcionamento

A utilização das funcionalidades de Rotas Inteligentes by Maplink do TOTVS Logística 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 está pronto para ser visualizado.
4.  Então, clique em Outras Ações > Visualizar Roteirização para visualizar o trajeto do mapa.

 Logs

A integração com a Maplink também gera logs por carga roteirizada, que podem ser consultados no caso de alguma inconsistência no processo.

Esse log é gerado dentro da pasta system do ambiente Protheus, contendo a seguinte nomenclatura: omslogmaplink_carga_númeroDaCarga.log

Para isso, ativar o parâmetro a seguir no seu appserver.ini:

[environment]
LOGROTOMS=.T.

Recomendamos ativar o log somente quando existir a necessidade de analisar problemas de integração.

Os logs utilizam espaço em disco do ambiente.