Á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, dispõe de

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

    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><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 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: webArquivos_Pasta_Web.zip

    Caso sua versão do Protheus seja inferior a 12.1.2827 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 SIGAOMS 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.
      ImportantePacote 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

         28/10/2019  10:24:39

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

    SIGAOMS

    Para que a integração seja ativada no SIGAOMS 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 clientidclientid e secret id da licença fornecida pela TOTVS para que seja possível consumir as APIs de roteirizaçãoPara 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),  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.

    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.