Á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

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.

:


O escopo desta integração abrange a ordenação dos pontos de entrega da carga (DAI), com base

nas

nas Regras de Entrega (OMSA120)

estipuladas

 estipuladas no cadastro

OMS e

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, 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.
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 da de dados preenchidos.

Exemplo:  cadastros

  • Cadastros com código do cliente, loja, grupo de vendas, veículo e grupo de veículos preenchidos serão prioridade.
  Além
  • Além disso, não será
feita
  • efetuada a combinação
desses
  • 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
  • Sistema não conseguirá gerar a roteirização.


  • 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, do TOTVS Logística OMS  OMS na versão 12.1.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.

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


Para o correto funcionamento das Rotas Inteligentes no TOTVS

Logística

OMS, os seguintes passos devem ser seguidos:

1 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: 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

    , 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
appserver
  • 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
  • Appserver e verifique se o servidor http foi inicializado.

  • No log do

appserver
  • Appserver deve constar uma informação semelhante

à essa
  • a esta:

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

2 Protheus 
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: Arquivos_Pasta_Web.zip

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 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.
  • 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 do TOTVS OMS e verifique se existe o caminho Atualizações> Rotas Inteligentes.
    • 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 criar 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 criadogerado.

          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 pacote Rotas_Inteligentes_OMS_12_1_25.ptm ou Rotas_Inteligentes_OMS_12_1_27.ptm 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.

    • 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: 15/06/2020 14:21:18

      • OMSA205A.PRW - data mínima: 28/07/2020 16:31:05

      • OMSBCAMAPLINKACCESSTOKEN.PRW - data mínima: 07/08/2019 15:49:05

      • OMSBCAMAPLINKPLANNING.PRW - data mínima: 07/08/2019 15:49:05

      • OMSBCAMAPLINKTRIP.PRW - data mínima: 28/05/2020 11:56:53

      • OMSBCCMaplinkGeocode.prw - data mínima: 23/07/2020 18:07:11
      • OMSMAPLINK.PRW - data mínima: 23/07/2020 18:07:11

  • Rotas_Inteligentes_12_04_2021_16_37.ptm
  • Sistema.

  • Utilize o Pacotes de Atualização - TOTVS Logística TMS - Linha Protheus - P12 Utilize o pacote Rotas_Inteligentes_Geolocalização.zip para atualizar os fontes referentes a geolocalização dos endereços, aceitando somente os fontes atualizados.
    ImportantePacote compatível para versões de sistema iguais à 12.1.25. Versões superiores não precisam de atualização.!

  • 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

    •  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 para .T. Para isso, pode ser utilizada a rotina inicial SIGACFG.

Além disso, é necessário cadastrar o clientid e secret idPara 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.

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 sistemaSistema:

  • 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 trata-se da é a DAR (Entidade x Coordenada Geoproc). Para acessar o programa de Geolocalização: Acessar módulo , que é atualizada pela rotina TMSA015, que está localizada no módulo 43 - TMS - Gestão de Transporte.Menu: Transportes > Atualizações > Logística > Ref. Geográfica (TMSAO15).


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

 omslogmaplink_carga_númeroDaCarga.log.

Para isso,

ativar

ative o parâmetro a seguir no seu

appserver

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.