Histórico da Página

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 de automatizar a roteirização de entrega das cargas, de forma a organizar a melhor rota de entrega dos pedidos existentes dentro da 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 é uma plataforma focada em conectar e otimizar operações logísticas. 

Para obter mais detalhes sobre a Maplink,  acesse acesse o link: https://developers.maplink.global/pt/Maplink Platform.

As APIs As API's 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: https://developers.maplink.global/documentation/planning/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.

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.