Á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 x MaplinkContexto A integração entre o módulo Gestão de Distribuição (SIGAOMS) da linha Microsiga Protheus com a plataforma Maplink tem como objetivo automatizar a roteirização de entrega das cargas, de forma a organizar a

O 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

Pedidos que compõem a carga.

Com esta integração, o OMS passa a sugerir a melhor rota de entrega com base em uma

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

de entrega da carga

e os postos de pedágio.

Image Removed

A sigla OMS significa Order Management System, ou seja, gerenciamento de pedidos e serviços que compreende as fases de captação, validação, avaliação, formação de carga e geração de mapa de separação ou, como é também conhecido, lista de separação.

Para obter mais detalhes sobre o OMS TOTVS, acesse a página no TDN: Gestão de Distribuição (SIGAOMS).

A Maplink Platform.é uma plataforma focada em conectar e otimizar operações logísticas.

As APIs consumidas no escopo desta integração são:

  • Planning para o planejamento da carga;
  • Trip: para a definição da melhor rota.

As mensagens de comunicação podem ser visualizadas no link: Planning API.


Integração OMS Protheus x MaplinkEscopo


Integração OMS Protheus x MaplinkPréPossuir ao menos uma licença Maplink.
  • Protheus versão  Protheus versão 12.1.23 25 ou superior.
  • Dicionário de dados atualizados com as tabelas pertencentes a integração.
  • Parâmetros de integração com Maplink configurados conforme orientação descrita nas próximas seções.
  • 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.

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


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

Configuração AppServer Protheus 
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 integração referentes ao OMS e Maplink.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 Aplicar 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 gerada.
  • Atualize Atualizar 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 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

do parâmetro

dos parâmetros MV_

MAPLINK (Habilita Integração Maplink)

ROTAINT 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 Maplink para que seja possível consumir as APIs da integração. e

Para isso, acesse SIGAOMS > Atualizações >

Maplink > CadastroMaplink

Rotas Inteligentes > Configurações e inclua um novo registro informando os campos ID Cliente (DLV_ID)

e

Client Secret (DLV_SECRET),

conforme

 de acordo com os dados da licença

Maplink

adquirida.

 

Geolocalização dos

A roteirização

pela Maplink

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.

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

A integração do OMS com a Maplink

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 > Enviar Planejar Roteirização Maplink. Neste
     Neste momento a carga será planejada pela Maplink, 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 pela Maplink 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 Maplink 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.