Á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 OMS Protheus - Rotas InteligentesContexto

O

módulo de Gestão de Distribuição (SIGAOMS) da linha Microsiga Protheus dispõe da funcionalidade de

TOTVS OMS dispõe de uma funcionalidade que permite planejar as rotas da carga de forma inteligente,

através

por intermédio da organização da melhor rota de entrega dos

pedidos

Pedidos que compõem a carga.

Além de sugerir a melhor

Além disso, esta funcionalidade também sugere a melhor rota com base na carga já criada,

apresenta

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)

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

  • Apresentar e considerar os pedágios existentes no caminho definido.
  • 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 OMS Protheus - Rotas InteligentesPré-
    • Protheus versão  versão 12.1.25 ou superior.
    • Configurações de ambiente realizadas conforme 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 OMS Protheus - Rotas InteligentesInstalação
    • A funcionalidade não pode ser executada pelo SmartClient Html (Web App).


    Para o correto funcionamento das Rotas Inteligentes no TOTVS OMS

    Protheus

    , 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 dentro do no Protheus são necessárias algumas configurações no arquivo appserver Appserver.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

    Web (showrota.html, tmsimg32.png e totvstec.js), responsáveis pela projeção do mapa em tela, sejam armazenados

    dentro da

    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.

    • Aplicar Aplique o pacote de dicionário Dicionário_OMS_sdfbra.zip pelo UPDDISTR, para criar gerar os campos da necessários para a roteirização.
      • Após a aplicação, verificar verifique se a tabela DK4 foi criadagerada.
    • Aplicar 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, verificar verifique se o parâmetro MV_ROTAINT foi criadogerado.
    • Aplicar 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, verificar verifique se a tabela DLV foi criadagerada.
    • Atualizar Atualize o menu do TOTVS OMS com o arquivo: sigaoms.zip ou via SIGACFG.
      • Com o arquivo sigamos.zip: Após a atualização, acessar acesse o menu do TOTVS OMS e verificar verifique 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
      • 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 para atualizar os fontes referentes a geolocalização dos endereços, aceitando somente os fontes atualizados.
      Importante!

    • Aplique o pacote conforme sua versão do Sistema.
    • Além das atualizações acima, verifique se as funções abaixo estão com data igual ou superior listadas abaixo:

      • CRM980EventDEFTMS.prw - 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

    . Por conta disso, é imprescindível verificar se os clientes (SA1)

    encontram-se

    estão devidamente cadastrados, com as informações

    de  endereço

    de Endereço,

    bairro

    Bairro,

    cep

    CEP,

    cidade

    Cidade e

    estado preenchidos

    Estado preenchidas.

    Além de verificar o cadastro dos clientes é necessário verificar também se cadastro da

    filial também possuí

    Filial possui as informações do endereço preenchidas. As coordenadas do endereço da

    filial

    Filial serão utilizadas como referência para o ponto de partida da carga.

    A verificação do cadastro da

    filial

    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 OMS 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 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 encontra-se 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.