Pickup
O TOTVS Logística OMS dispõe de uma funcionalidade que permite planejar as rotas da carga de forma inteligente, por intermédio da organização da melhor rota de entrega dos Pedidos que compõem a carga.
Além disso, esta funcionalidade também sugere a melhor rota com base na carga já criada, apresentando em tela o desenho da trajetória no mapa e os postos de pedágio.
Essa funcionalidade é adquirida separadamente do TOTVS Logística OMS, visto que a mesma requer 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) com base nas Regras de Entrega (OMSA120) estipuladas no cadastro OMS e a visualização do mapa contendo os postos de pedágio e com o caminho mais rápido para a entrega, apresentando a quilometragem que será realizada, o tempo que será consumido e o valor dos pedágios.
Não faz parte do escopo dessa integração:
No caso de existir cadastros de regras de entrega que se sobrepõe será considerado o cadastro mais completo, ou seja, com maior número da dados preenchidos. Exemplo: cadastros com código do cliente, loja, grupo de vendas, veículo e grupo de veículos preenchidos serão prioridade. Além disso, não será feita a combinação desses cadastros para estipular a janela de entrega. |
|
Para o correto funcionamento das Rotas Inteligentes no TOTVS Logística OMS, os seguintes passos devem ser seguidos:
Para que seja possível apresentar a página HTML contendo a apresentação do mapa da rota no 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: 8082 INSTANCES=<nInicio>,<nMaximo>; exemplo: 1,10 SESSIONTIMEOUT=60 INSTANCENAME=WS_HTTP [<ip ou nome>:<porta que deve ser igual à definida para a seção http>/oms]; 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_OMS ONSTART=__WSSTART ONCONNECT=__WSCONNECT PREPAREIN=99,01 SIGAWEB=WS |
[SSLConfigure] TryProtocols=1 Verbose=1 |
Ao final das configurações, reinicie o appserver e verifique se o servidor http foi inicializado. No log do appserver deve constar uma informação semelhante à essa:
Http server is ready.
Root path is C:\TOTVS\Protheus\data\web
Listening port 8082
É 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 na pasta definida na seção HTTP, tag PATH do appserver.ini.
Clique no link para baixar os arquivos: Arquivos_Pasta_Web.zip.
Caso sua versão do Protheus seja inferior a 12.1.27 será necessário a aplicação de alguns pacotes de dicionário para a geração dos novos campos e tabelas da integração.
Caso sua versão do Protheus seja inferior a 12.1.30, também será necessário a aplicação de alguns pacotes de dicionário para a geração dos novos campos e tabelas da integração.
Utilize o pacote Rotas_Inteligentes_OMS_12_1_25.ptm ou Rotas_Inteligentes_OMS_12_1_27.ptm para atualizar as rotinas OMS, aceitando somente os fontes atualizados.
Importante: Aplique o pacote conforme sua versão do sistema.
Após a aplicação do pacote, verifique se os fontes do RPO estão com data igual ou superior ao da lista abaixo:
OMSA200.PRW - data mínima: 15/06/2020 14:21:18
OMSA205A.PRW - data mínima: 28/05/2020 15:19:35
OMSBCAMAPLINKACCESSTOKEN.PRW - data mínima: 07/08/2019 15:49:05
OMSBCAMAPLINKPLANNING.PRW - data mínima: 07/08/2019 15:49:05
OMSBCAMAPLINKTRIP.PRW - data mínima: 28/05/2020 11:56:53
OMSMAPLINK.PRW - data mínima: 08/06/2020 16:04:38
Utilize o pacote Rotas_Inteligentes_Geolocalização.zip para atualizar os fontes referentes a geolocalização dos endereços, aceitando somente os fontes atualizados.
Importante: Pacote compatível para versões de sistema iguais à 12.1.25. Versões superiores não precisam de atualização.
Após a aplicação do pacote, verifique se os fontes do RPO estão com data igual ou superior ao da lista abaixo:
CRM980EventDEFTMS.prw - data mínima: 29/08/2019
TMSAO15.prw - data mínima: 20/08/2019
TMSAO46.prw - data mínima: 26/08/2019
TMSAO47.prw - data mínima: 20/08/2019
TMSAO48.prw - data mínima: 05/09/2019
TMSAO49.prw - data mínima: 24/07/2019
TMSAO50.prw - data mínima: 24/07/2019
TMSAO51.prw - data mínima: 20/08/2019
TMSAO52.prw - data mínima: 24/07/2019
TMSAO53.prw - data mínima: 10/07/2019
MATN030 - data mínima: 02/08/2019
Para que a integração seja ativada no OMS é necessário alterar o conteúdo dos parâmetros MV_ROTAINT e MV_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 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), Client Secret (DLV_SECRET), App ID GeoCo (DLV_APPID), App Code Geo (DLV_APPCOD), de acordo com 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) estão devidamente cadastrados, com as informações de Endereço, Bairro, CEP, Cidade e Estado preenchidas.
Além de verificar o cadastro dos clientes, é necessário verificar também se cadastro da Filial possui 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 tabela responsável por armazenar a geolocalização dos endereços trata-se da DAR (Entidade x Coordenada Geoproc).
A utilização das funcionalidades de Rotas Inteligentes by Maplink do TOTVS Logística OMS ocorre após a carga montada, seguindo o seguinte fluxo:
A integração com a Maplink também gera logs por carga roteirizada, que podem ser consultados no caso de alguma inconsistência no processo.
Esse log é gerado dentro da pasta system do ambiente Protheus, contendo a seguinte nomenclatura: omslogmaplink_carga_númeroDaCarga.log