Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Pickup

Âncora
indice
indice
Índice
maxLevel3
outlinetrue
stylenone
printablefalse

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:

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

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:

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


  • Possuir ao menos uma licença Maplink.
  • Para obter a licença entre em contato com nosso suporte OMS.
  • Protheus versão  12.1.23 ou superior.
  • Dicionário de dados atualizados com as tabelas pertencentes à a integração.
  • Parâmetros de integração com Maplink configurados conforme orientado orientação descrita nas próximas seções.
Informações
iconfalse
titleIMPORTANTE!
  • 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 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.


  • Para que seja possível apresentar a página HTML contendo a apresentação do mapa da rota dentro do Protheus , é necessária são necessárias algumas configurações no arquivo appserver.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\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 inconsistências do tipo Failed Handshake SSL recomendaSSL, recomenda-se incluir a seguinte configuração no appserver.ini:
Bloco de código
languageactionscript3
titleappserver.ini
collapsetrue
[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. Esses arquivos podem ser baixados nesse link

Clique no link para baixar os arquivosweb.zip

Caso sua versão do Protheus seja inferior à 12.1.28, será  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  pelo 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 pelo UPDDISTR, para criar os campos da integração referentes à geolocalização dos cadastros de clientes. 
  • Atualizar o menu OMS com o arquivo do linksigaoms.zip

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 isso, pode ser utilizada a rotina inicial SIGACFG pode ser utilizado.

Além disso, é necessário cadastrar o clientid e secret id da licença Maplink para que seja possível consumir as APIs da integração. Para tantoisso, Acesse acesse SIGAOMS > Atualizações > Maplink > CadastroMaplink 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á utilizada serão utilizadas como referência para o ponto de partida da carga.

A verificação do cadastro da filial pode ser realizada através do pelo 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 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 integração com do OMS com a Maplink ocorre após a carga montada, seguindo o seguinte fluxo:

  1. Acessar Acesse a rotina de Montagem de Carga (OMSA200).
  2. Posicionar Posicione em um uma carga e clique 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  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 e que o mapa encontra-se pronto para ser visualizado. Então acessar , clique em Outras Ações > Visualizar Roteirização Maplink para visualizar o trajeto do mapa.