DLOGTMS03-7522 DT Rota Inteligente (SIGATMS)

Tempo aproximado para leitura: 10 min

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

O módulo Gestão de Transportes (SIGATMS) com toda expertise em gestão de transportes criou uma solução logística chamada Rota Inteligente, em que foi criada a inteligência para otimizar todo 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.

A solução Rota Inteligente tem como objetivo:

1. Ordenar a melhor sequência e otimizar o processo de entrega e/ou coleta;
2. Sugerir o melhor trajeto a ser realizado considerando o menor tempo ou menor distância;
3. Obter os valores das praças de pedágio;
4. Plotagem e visualização do trajeto em mapa;
5. Obter coordenadas geográficas dos clientes;

03. SOLUÇÃO

Para que toda a solução funcione perfeitamente é necessário obter as coordenadas geográficas de todos os clientes, de acordo com os respectivos endereços. Para isso criamos a api Coordenadas que retorna a latitude e longitude de acordo com o endereço enviado. As informações recebidas são gravadas no Cadastro de Referências Geográficas.

Os documentos serão ordenados na viagem, de acordo com a melhor sequência de entrega/coleta sugerida pela a api Planejamento.

Após obtido a melhor sequência de entrega/coleta a api Rota sugere a melhor rota para o veículo realizar, de acordo com a melhor sequência de entrega/coleta.

De acordo com a rota sugerida, obtém-se os gastos com pedágio de acordo com a quantidade de eixos dos veículos, através da api Pedágio, e os valores de pedágio são atualizados automaticamente dentro da viagem.

Toda a visualização dos pontos de entrega/coleta, rota e praças de pedágio serão exibidas dentro do SIGATMS em um mapa, através da funcionalidade Map Display.

A comunicação com as apis e plataforma Rota Inteligente ocorrerão a partir das rotinas: Cadastro de Clientes, Sequência de Endereço, Cadastro de Solicitantes e Wizard para envio das filiais (Cadastro de referências geográficas) para a api Coordenadas ; e também a partir das Viagens em Aberto para as apis Planejamento, Rotas, Pedagio e MapDisplay (Plotagem de mapas). 

As informações enviadas serão detalhadas abaixo.

Foram criadas novas funcionalidades no SIGATMS para complementar e auxiliar na integração como um todo:

Cadastro Roteirizador:  Foi criado o cadastro para armazenar as informações referente a integração como client_id, client_secret, app_code, chave Javascript, URL Callback, URL Mapa e etc.. Muitos desses dados serão fornecidos pela Rota Inteligente. É possível também definir o tipo de retorno que o serviço Rota Inteligente irá fornecer, pode-se optar pelo retorno por callback (webservice rest), em que o SIGATMS irá aguardar as respostas automaticamente. Ou pode-se realizar a integração via Ações Relacionadas no menu da viagem.

Consulta Histórico de Integração: As informações trafegadas pelas Rota Inteligente serão armazenadas na tabela DLU - Histórico de Integração.

Limpeza do Histórico de Integração: Criado a funcionalidade para eliminar fisicamente as informações referente ao histórico de integração.

Bloqueio de Viagem: Criado o bloqueio RT - Roteirizador, para ser acionado durante o fechamento da viagem, caso as respostas das apis ainda não tenham sido recebidas. 

Webservice REST WSTMSMapLink: Criado webservice REST para subir o serviço que ficará aguardando o retorno da Rota Inteligente.

Cadastro de Referências Geográficas: Criado o Wizard de Filiais para que a api Coordenadas seja acionada a partir dos endereços das filiais do sistema.

Plotagem do mapa: Plota o mapa tmsshowrota.html após o processamento completo das apis: planejamento, rota e pedágio.

Viagem em Aberto: O envio de informações pode ser apenas realizado para viagens cujo status esteja em aberto.

Parametrização:

No Configurador (SIGACFG) altere o conteúdo do parâmetro MV_ROTAINT para .T para que a integração seja ativada.

Como utilizar:

Acesse o módulo SIGATMS: 

Cadastro de Roteirizador

Acesse o menu Cadastro > Roteirizador > Config. Integração ( TMSAO52 )  para acessar o Cadastro de Roteirizador.

• Clique em Incluir;
• No campo ID Cliente informe o client_id fornecido pela Totvs;
• No campo Cliente Secret informe o client_secret fornecido pela Totvs; 
• No campo Tempo Token preencha com o tempo que o token irá expirar;
• Pode-se preencher com 00:59; 
• No campo URL CallBack informe a URL do servidor REST com o endpoint WSTMSMaplink;
• Exemplo: http://localhost:8091/rest/api/tms/v1/wstmsmaplink;
• No campo URL Mapa informe a URL do webservice aonde encontra-se o arquivo tmsshowrota.html;
• Exemplo: http://localhost:8020/ws/tmsshowrota.html; 
• No campo App Code GeoCode informe: totvs;
• No campo Chave JS informa a Chave Javascript informada pela Maplink;
• No campo Tipo de Retorno informe:
• 2=Aguardar retorno roteirizador para o acesso e envio de informações ser realizado apenas via menu;

Limpeza de Histórico

Acesse o menu Diversos > Limpeza Histórico Roteirizador ( TMSAO53 ) para acessar a rotina Limpeza de Histórico.

• Clique em Perguntas para filtrar a limpeza do histórico (DLU) de acordo com o número da viagem;
• Clique em Informações e Executar para excluir fisicamente os registros;

Referências Geográficas

Acesse o menu Logística > Cadastro de Referência Geográfica ( TMSAO15 ) para acessar a rotina Ref. Geográfica.

• Acesse a opção Outras Ações > Wizard (GeoCode);
• Clique em Avançar e selecione as filiais para obter as coordenadas geográficas automaticamente;

Cadastro de Clientes

Acesse o menu Atualizações > Cadastro > Cadastro de Clientes  ( MATA030 ) para acessar a rotina Cadastro de Clientes.

• Efetue alguma operação de inclusão e/ou alteração;
• As coordenadas serão obtidas automaticamente;

Sequência de Endereço

Acesse o menu Atualizações > S.A.C > End. Solic./Cliente  ( TMSA450 ) para acessar a rotina Sequência de Endereços.

• Efetue alguma operação de inclusão e/ou alteração;
• As coordenadas serão obtidas automaticamente;

Cadastro de Solicitantes

Acesse o menu Atualizações > S.A.C > Solicitantes  ( TMSA440 ) para acessar a rotina Solicitantes.

• Efetue alguma operação de inclusão e/ou alteração;
• As coordenadas serão obtidas automaticamente;

Viagens

No módulo SIGATMS, acesse o menu para inclusão de Viagens - ( Viagens > Rodoviário Entrega > Viagem ( TMSA144 ) )

• Clique em Incluir;
• Informe os dados da viagem;
• Salve os dados;
• Caso o Cadastro de Roteirizador esteja configurado com o campo DLU_TIPRET = 1, os dados serão enviados para a api planejamento automaticamente.
• Ainda na tela da viagem acesse o menu Outras Ações > Roteirizador > Integra para integrar os dados da viagem;
• Acesse o menu Outras Ações > Roteirizador > Consulta para consultar o histórico de integração;
• Na tela de histórico de integração acesse Outras Ações > Vis. Mapa para a plotagem do mapa.

04. DEMAIS INFORMAÇÕES

Não há.

05. ASSUNTOS RELACIONADOS

• Não há.