Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Aviso
titleATENÇÃO
Pickup

Âncora
indice
indice
Índice
maxLevel3
outlinetrue
indent8.1.
stylenone
printablefalse

Integração SIGAOMS Protheus - Rotas InteligentesContexto

O

módulo de Gestão de Distribuição (SIGAOMS), da linha Microsiga Protheus, 

TOTVS 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

 melhor rota com base na carga já criada, apresentando em tela o desenho da trajetória no mapa e os postos de pedágio.

:


O escopo desta integração abrange a ordenação dos pontos de entrega da

carga 

carga (DAI)

e

, com base nas Regras de Entrega (OMSA120) estipuladas no cadastro do TOTVS 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

, bem como

, o tempo que será consumido e o valor dos pedágios.

Não faz parte do escopo

dessa

desta integração:

  • Montar a carga de forma automática.
  • Apresentar e considerar os pedágios existentes no caminho definido.
Informações
titleSobre as Regras de Entrega

No caso de existir cadastros de regras de entrega que se sobrepõe será considerado o cadastro mais completo, ou seja, com maior número de dados preenchidos.

Exemplo

  • Cadastros com código do cliente, loja, grupo de vendas, veículo e grupo de veículos preenchidos serão prioridade. Além disso, não será efetuada a combinação destes cadastros para estipular a janela de entrega.
  • Se existirem problemas na regra de entrega, ou seja, cargas que não podem ser entregues no dia, o Sistema não conseguirá gerar a roteirização.


Integração SIGAOMS Protheus - Rotas InteligentesPré-
  • Protheus versão 12.1.25 ou superior.
  • Configurações de ambiente realizadas de acordo com as instruções abaixo.
Informações
iconfalse
titleIMPORTANTE!
  • Não é escopo desse documento descrever a instalação do ERP Protheus, nem as suas configurações básicas. 

  • Para utilização da integração,

    o módulo SIGAOMS 

    do TOTVS OMS na versão 12.1.

    23

    25 (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 SIGAOMS Protheus - Rotas InteligentesInstalação
  • .

  • A funcionalidade não pode ser executada pelo SmartClient Html (Web App).


Para o correto funcionamento das Rotas Inteligentes no

SIGAOMS Protheus

TOTVS OMS, os seguintes passos devem ser seguidos:

 Configuração 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 appserverAppserver.ini do ambiente.

Bloco de código
languageactionscript3
titleappserver.ini
collapsetrue
;Serviço webserver HTTP
[HTTP]
ENABLE=1
PATH=<Caminho_Cache_imagens>;  exemplo: C:\TOTVS\Protheus\data\web
PORT=<porta>; exemplo: 80808082
INSTANCES=<nInicio>,<nMaximo>; exemplo: 1,10
SESSIONTIMEOUT=60
INSTANCENAME=WS_HTTP
 
 [<ip ou nome>:<porta>/neolog<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_NEOLOG_OMS
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=99,01
SIGAWEB=WS
  • Para evitar inconsistências do

    tipo

    tipo Failed Handshake SSL

    , recomenda-se incluir

    é recomendável incluir a seguinte configuração no

    appserver

    Appserver.ini, caso a versão seja inferior à 13.1.3.26 e 13.2.3.26:

Bloco de código
languageactionscript3
titleappserver.ini
collapsetrue
[SSLConfigure]
TryProtocols=1
Verbose=1
  • Atualizar parâmetro TOPMemoMega no Appserver e inserir parâmetro com ip e porta do serviço criado:
Bloco de código
titleappserver.ini
collapsetrue
[environment]
TOPMemoMega=3
IPPORTROT=localhost:8082 [<ip ou nome>:<porta que deve ser igual à definida para a seção http>/oms] Informar somente o ip e porta.
  • 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 esta:

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

Bloco de código
titledbaccess.ini
collapsetrue
[General]
MaxStringSize=30

É 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

 Appserver.ini.

Clique no link para baixar os arquivos: 

web

Arquivos_Pasta_Web.zip

Caso sua versão do Protheus seja inferior a 12.1.

28

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 criar gerar os campos da necessários à a roteirização.
    • Após a aplicação, verifique se a tabela DK4 foi criadagerada.
  • Aplique o pacote de dicionário Parâmetro_OMS_sdfbra.zip, para criar gerar o parâmetro MV_ROTAINT pertencente a roteirização.
    • Após a aplicação, verifique se o parâmetro MV_ROTAINT foi criadogerado.
  • Aplique o pacote de dicionário Geolocalizacao_sdfbra.zip pelo UPDDISTR, para criar 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 criadagerada.
  • Atualizeo menu SIGAOMS Atualize o menu do TOTVS OMS com o arquivo: sigaoms.zip ou via SIGACFG.
    • Com o arquivo sigamos.zip: Após a atualização, acesse o menu SIGAOMS do TOTVS OMS e verifique se existe o caminho Atualizações > Rotas Inteligentes.

4. Atualização das Rotinas

    • Via SIGACFG: Ambiente > Cadastros > Menus. Marcar apenas o menu TOTVS OMS.
      Crie a estrutura: Atualizações > Rotas Inteligentes.
      Em Rotas Inteligentes, inclua a rotina TMSAO52 (Configurações).
  • 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.

          Caso sua versão do Protheus seja inferior a 12.1.33 será necessário a aplicação do pacote de dicionário referente a funcionalidade de quantidade de eixos ida e volta:

  • Aplique o pacote CamposEixos.zip e verifique se os campos DAK_QTEIXI e DAK_QTEIXV foram criados.
  • Utilize o Pacotes de Atualização - TOTVS OMS - P12 para atualizar as rotinas do TOTVS OMS, aceitando somente os fontes atualizados.
    Importante!
    Aplique o pacote conforme sua versão do Sistema.

  • Utilize o Pacotes de Atualização - TOTVS Logística TMS - Linha Protheus - P12

  • Utilize o pacote Rotas_Inteligentes_OMS.zip para atualizar as rotinas OMS, aceitando somente os fontes atualizados.
    Importante: Pacote compatível para versões iguais ou superiores à 12.1.25. 

    • 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 - 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

  • Utilize o pacote Rotas_Inteligentes_Geolocalização.zip para atualizar os fontes referentes a geolocalização dos endereços, aceitando somente os fontes atualizados.
    Importante: Pacote compatível para versões iguais ou superiores à 12.1.25. !

  • Aplique o pacote conforme sua versão do Sistema.
  • Além das atualizações acima, verifique se as funções abaixo

    Após a aplicação do pacote, verifique se os fontes do RPO

    estão com data igual ou superior

    ao da lista

    listadas 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 do SIGAOMS

Para a integração seja ativada no SIGAOMS
    •  28/10/2019  10:24:39

    • MATN030.PRX 15/04/2021 10:02:38

Para que a integração seja ativada no TOTVS 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

clientid

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)

Client Secret (DLV_SECRET),

App ID GeoCo (DLV_APPID), App Code Geo (DLV_APPCOD) conforme

 de acordo com os dados da licença adquirida.

 

Geolocalização dos

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

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 SIGAOMS Protheus - Rotas InteligentesFuncionamento

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


A utilização das funcionalidades de Rotas Inteligentes by Maplink do

SIGAOMS

TOTVS OMS ocorre após a carga montada, seguindo o seguinte fluxo:

  1. Acesse  Acesse a rotina de Montagem de Carga (OMSA200).
  2.  Se desejar informar a quantidade de eixos e na ida e volta, posicione na carga e clique Outras Ações > Qtd. de Eixos Roteirização. Caso não seja informado, para cálculo de pedágio serão considerados os eixos no cadastro do veículo.
  3. Para iniciar o planejamento da rota, com a carga posicionada, Posicione em uma carga e clique em Outras Ações > Planejar Roteirização.
    Neste  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.
  4. Quando  Quando 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.Então
  5.  Então, clique em Outras Ações > Visualizar Roteirização para visualizar o trajeto do mapa.

         Caso tenha solicitado uma zona de restrição específica, informar no parâmetro ROTRESTZON do appserver.


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, ative 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.