Pickup
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.
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:
As mensagens de comunicação podem ser visualizadas no link: Planning API.
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:
|
Para que seja possível apresentar a página HTML contendo a apresentação do mapa da rota dentro do Protheus são necessárias algumas configurações no arquivo appserver.ini do ambiente.
;Serviço webserver HTTP [HTTP] ENABLE=1 PATH=<Caminho_Cache_imagens>; exemplo: C:\TOTVS\Protheus\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\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 |
[SSLConfigure] TryProtocols=1 Verbose=1 |
É 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.
Clique no link para baixar os arquivos: web.zip.
Caso sua versão do Protheus seja inferior a 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.
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 isso, pode ser utilizada a rotina inicial SIGACFG.
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 isso, 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.
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ã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 sistema:
Portanto, se um cliente sofrer mudança de endereço, na alteração do cadastro a geolocalização será atualizada.
A integração do OMS com a Maplink ocorre após a carga montada, seguindo o seguinte fluxo: