Pickup

Integração OMS Protheus x MaplinkContexto de Negócio (Introdução)

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 melhor rota de entrega dos pedidos que compõem a carga.

Com esta integração, o OMS passa a sugerir a melhor rota de entrega com base em uma carga já criada, apresentando o mapa de entrega da carga.

Exemplo:


Integração OMS Protheus x MaplinkSistemas Envolvidos

TOTVS Gestão de Distribuição (SIGAOMS)

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

Maplink

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

O escopo desta integração abrange a ordenação dos pontos de entrega da carga (DAI) e a visualização do mapa com o caminho mais rápido para a entrega apresentando a quilometragem que será realizada, bem como o tempo que será consumido.

Não faz parte do escopo dessa integração:

  • Montar a carga de forma automática.
  • Apresentar e considerar os pedágios existentes no caminho definido.

Integração OMS Protheus x MaplinkPré-requisitos Instalação / Implantação / Utilização

MapLink

  • Possuir ao uma licença Maplink. Para obter a licença entre em contato com nosso suporte OMS.

Protheus

  • Protheus versão  12.1.23 ou superior.
  • Dicionário de dados atualizados com as tabelas pertencentes à integração.
  • Parâmetros de integração com Maplink configurados conforme orientado nas próximas seções.
  • Não é escopo desse documento descrever a instalação do ERP Protheus, nem suas configurações básicas. 
  • Para utilização da integração, o módulo SIGAOMS  na versão 12.1.23 (ou superior) do Protheus é necessário 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 x MaplinkInstalação/Configuração

Configuração AppServer Protheus 

  • Para que seja possível apresentar a página HTML contendo a apresentação do mapa da rota dentro do Protheus, é necessária algumas configurações no arquivo appserver.ini do ambiente.

;Serviço webserver HTTP
[HTTP]
ENABLE=1
PATH=<Caminho_Cache_imagens>;  exemplo: C:\TOTVS\Prottheus\data\web
PORT=<porta>; exemplo: 8080
INSTANCES=<nInicio>,<nMaximo>; exemplo: 1,10
SESSIONTIMEOUT=60
INSTANCENAME=WS_HTTP
 
 [<ip ou nome>:<porta>/neolog]; exemplo: localhost:8082/oms
ENABLE=1
PATH=<Caminho_Cache_imagens>; deve ser o mesmo caminho do PATH da seção HTTP acima, exemplo: C:\TOTVS\Prottheus\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 erros do tipo Failed Handshake SSL recomenda-se incluir a seguinte configuração no appserver.ini:
[SSLConfigure]
TryProtocols=1
Verbose=1

Armazenar os Arquivo HTML

É 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 dentro da pasta definida na seção HTTP, tag PATH do appserver.ini. Esses arquivos podem ser baixados nesse link: web.zip. 

Atualização do Dicionário de Dados

Caso sua versão do Protheus seja inferior à 12.1.28, 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 o pacote de dicionário Dicionário_OMS_sdfbra.zip através do UPDDISTR para criar os campos da integração referentes ao OMS e Maplink.
  • Aplicar o pacote de dicionário Geolocalizacao_sdfbra.zip através do UPDDISTR para criar os campos da integração referentes à geolocalização dos cadastros de clientes. 
  • Atualizar o menu OMS com o arquivo do link: sigaoms.zip

Parametrização OMS

Para a integração seja ativada no OMS, é necessário alterar o conteúdo do parâmetro MV_MAPLINK (Habilita Integração Maplink) para .T. Para tanto, o programa inicial SIGACFG pode ser utilizado.

Além disso, é necessário cadastrar o client id e secret id da licença Maplink para que seja possível consumir as APIs da integração. Para tanto, Acesse SIGAOMS > Atualizações > Maplink > Cadastro Maplink e inclua um novo registro informando os campos ID Cliente (DLV_ID) e Client Secret (DLV_SECRET), conforme os dados da licença Maplink adquirida. 

Geolocalização dos Endereços de Entrega

A roteirização pela Maplink ocorre com base nas coordenadas (latitude e longitude) dos endereços de entrega, por conta disso, é imprescindível verificar se os clientes (SA1) encontram-se devidamente cadastrados, com as informações de  endereço, bairro, cep, cidade e estado preenchidos.

Além de verificar o cadastro dos clientes é necessário verificar se cadastro da filial também possuí as informações do endereço preenchidas. As coordenadas do endereço da filial será utilizada como referência para o ponto de partida da carga. A verificação do cadastro da filial pode ser realizada através do Configurador (SIGACFG).

A gravação das coordenadas de geolocalização ocorrem nos seguintes pontos do sistema:

  • Ao enviar a carga para planejamento e o cliente ainda não encontrar-se 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 x MaplinkFuncionamento

A integração com do OMS com a Maplink ocorre após a carga montada, seguindo o seguinte fluxo:

  1. Acessar a rotina de Montagem de Carga (OMSA200).
  2. Posicionar em um carga e em Outras Ações > Enviar Roteirização Maplink. 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.
  3. Quando  o Status da Rot. constar como Roteirizada, significa que a carga teve seus pontos de entrega (DAI) organizados conforme o melhor trajeto definido pela Maplink e que o mapa encontra-se pronto para ser visualizado. Então acessar Outras Ações > Visualizar Roteirização Maplink para visualizar o trajeto do mapa.