Pickup
O módulo de Gestão de Distribuição (SIGAOMS) da linha Microsiga Protheus dispõe da funcionalidade de planejar as rotas da carga de forma inteligente, através da organização da melhor rota de entrega dos pedidos que compõem a carga. Além de sugerir a melhor rota com base na carga já criada, apresenta em tela o desenho da trajetória no mapa.
Essa funcionalidade é adquirida à parte do módulo OMS, visto que requer a integração com softwares parceiros para possibilitar a roteirização com base na geolocalização de endereços de entrega. |
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_ROTAINT (Habilita Rotas Inteligentes) 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 fornecida pela TOTVS para que seja possível consumir as APIs de roteirização. Para isso, acesse SIGAOMS > Atualizações > Rotas Inteligentes > Configurações e inclua um novo registro informando os campos ID Cliente (DLV_ID) e Client Secret (DLV_SECRET) conforme os dados da licença adquirida.
A roteirização 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 utilização das funcionalidades de Rotas Inteligentes do OMS ocorre após a carga montada, seguindo o seguinte fluxo: