Histórico da Página
...
Produto: |
| ||||||||
---|---|---|---|---|---|---|---|---|---|
Linha de Produto: |
| ||||||||
Segmento: |
| ||||||||
Módulo: | TOTVS Logística TMS | ||||||||
Função: | TMSA050.PRW - Entrada Dc. Cliente TMSA146.PRW - Programação de Carregamento TMSA146A.PRW - Programação de Carregamento x Planejamento de Rotas (Envio) TMSA146B.PRW - Programação de Carregamento x Planejamento de Rotas (Retorno) TMSA153H.PRW - Função genérica TMSA210.PRW - Carregamento de Transporte TMSAC18.PRW - Métodos de Envio - Integração Planejamento de Rotas TMSAC19.PRW - Consulta Planejamento de Rotas TMSAC20.PRW - Configuração Planejamento de Rotas TMSAC21.PRW - Métodos de Retorno - Integração Planejamento de Rotas TMSAC23.PRW - Controle de Integração Planejamento de Rotas TMSAC24.PRW - Montagem e visualização do Mapa TMSAC25.PRW - Montagem e visualização do Mapa TMSAF60.PRW - Viagem Modelo 3 TMSAF62.PRW - Validação Viagem Modelo 3 TMSAF68.PRW - Menu Viagem Modelo 3 TMSAO48´RW - Integração Rota Inteligente TMSAO52.PRW - Cadastro Roteirizador Rota Inteligente TMSO46API.PRW - Métodos CallBack Planejamento de Rotas TMSXFUND.PRW - Função genérica | ||||||||
Ticket: | Não se aplica. | ||||||||
Requisito/Story/Issue (informe o requisito relacionado) : |
DLOGTMS02-17292 a DLOGTMS02-17296 |
02. SITUAÇÃO/REQUISITO
...
A fim de otimizar e reduzir custos das operações de transporte, o módulo Gestão de Transportes (SIGATMS) uniu toda expertise em gestão de transportes com a solução logística de roteirização de carga fornecida pelo Planejamento de Rotas (TPR), agregando inteligência e otimizando o processo de entregas e coletas dentro do SIGATMS. Fazendo com que as coletas/entregas tenham uma melhor disposição e ordem, e dessa maneira além de reduzir o tempo de operação também se reduz custos dentro da operação de transporte, além da obtenção prévia dos valores de pedágio.
O módulo passa a utilizar as APIs fornecidas pelo Planejamento de Rotas (TPR) para solucionar os problemas de ordem de entrega/coleta, melhor trajeto a ser realizado considerando o menor tempo ou menor distância, valores das praças de pedágio, plotagem e visualização do trajeto, coordenadas geográficas dos clientes.
API TPRrouting é o serviço de roteirização para rotas, que se adapta as especificações do veículo e leva em conta as especialidades e restrições do tempo da operação.
API TPRrouting/CallbackURL é o serviço de roteirização
- API GeoCode tem como objetivo encontrar as coordenadas geográficas dos endereços.
03. SOLUÇÃO
Implementado a integração do SIGATMS x Planejamento de Rotas (TPR), que estará disponível a partir da configuração do parâmetro MV_ROTAINT.
- Configuração Planejamento de Rotas (TMSAC20)
Esse cadastro será utilizado para a configuração do Planejamento de Rotas, onde será necessário informar os campos:
URL Roteiriza (DLV_ROTEIRI) - HTTPS://TPR-SERVICE-JXX2HXKO4A-UE.A.RUN.APP/V1/TPR-ROUTING
URL Geocode (DLV_URLGEO) - HTTPS://TPR-SYNC-ADAPTER-JXX2HXKO4A-UE.A.RUN.APP/V1/TPR-GEOLOCATION-SYNC
URL Token (DLV_URLTK) - HTTPS://TPR-PAYWALL-TOKEN-JXX2HXKO4A-UE.A.RUN.APP/TOKEN-INTEGRATION/V1/TPR-TOKEN-CREATION
URL CallBack (DLV_URLCAL) - HTTP://localhost.Porta/REST/V1/WSTPRNEOLOG
URL Mapa (DLV_URLMAP) - http://localhost:Porta/ws/index.html
Authorization (DLV_AUTH) - Token de acesso no Google Cloud Platform
Roteirizador (DLV_ROTERI) - 2
Tipo Retorno (DLV_TIPRET) - 1
...
- Cadastros - Geolocalização
As rotinas Cadastro de Cliente, Sequência de Endereço e Cadastro de Solicitantes foram atualizadas para que ao final da gravação as informações referentes ao endereço sejam enviadas automaticamente para a api tpr-geolocation-sync a fim de obter as coordenadas geográficas do respectivo endereço. As coordenadas geográficas recebidas são gravadas na tabela DAR - Referência Geográficas, e é possível visualiza-las através da rotina Cadastro de Referências Geográficas - TMSAO15.
Envio:
...
- - País;
...
- - Estado;
- Cidade;
- Bairro;
- Rua;
...
- - Numero;
- CEP
...
Retorno:
- Latitude;
- Longitude
...
Programação de Carregamento (TMSA146)
A integração do SIGATMS com o Planejamento de Rotas, ocorrerá a partir da rotina de Programação de Carregamento, através da opção 'Integra TPR'.
- Ao clicar nessa opção, será enviado para o Planejamento de Rotas (TPR) os Documentos selecionados (Notas Cliente, CTe, Solicitação de Coleta) e todos os veículos ativos (DA3).
Para controle dos documentos enviados à roteirização, os dados serão armazenados nas Tabela DMR/DMS, onde será gerado um Identificador da Roteirização (DMR_IDROT) e os documentos serão gravados na Tabela DMR com status 1- Pendente (DMR_STATUS)
- Após o Sistema Planejamento de Rotas receber as informações e efetuar o processamento para roteirização, enviará o resultado ao SIGATMS, através do CallBack de Roteirização.
O SIGATMS automaticamente receberá os dados e armazenará o arquivo de retorno (json) na Tabela DLU (DLU_RETORN) e em seguida irá criar a Programação de Carregamento com base nos documentos e veículo roteirizados.
- Gerado a Programação de Carregamento, o usuário deverá acessar a rotina de Programação de Carregamento, posicionar na em modo alteração, e informar a Rota, Cavalo (se houver), e o Motorista (caso não estiver vinculado ao cadastro do veículo).
- Ao efetivar a programação de carregamento, será gerado a viagem (processo padrão), e havendo um valor de pedágio (tollValue) calculado pela TPR, o valor será gravado no Complemento da Viagem (DTR_VALPDG).
...