CONTEÚDO

01. VISÃO GERAL

O Painel Planejamento de Rotas (TMSAC19) é a rotina onde será acompanhado o rastreio das informações referentes ao envio das Roteirizações para o Totvs Planejamento de Rotas (TPR).

Nessa funcionalidade será possível :
- Visualizar as Roteirizações e Itens da Roteirização, com o objetivo de obter maiores detalhes sobre o envio de determinado pedido de Roteirização junto ao Totvs Planejamento de Rotas (TPR)
- Visualizar Mapa após a Roteirização ter sido processada pelo Totvs Planejamento de Rotas (TPR), fica disponível a visualização do Mapa pelas telas Totvs Planejamento de Rotas (TPR) ou Itens da Roteirização;
- Cancelar as Roteirizações Pendentes, ou seja, roteirização que não houve retorno da TPR (por exemplo:  URL do Callback de comunicação inválida para recebimento do retorno das informações);
- Excluir Roteirizações Pendentes fora do prazo, mediante 'Tempo de Expiração' configurado na rotina Config. Planejamento de Rotas (TMSAC20 - SIGATMS). 

02. TELA DA ROTINA

A tela da rotina Painel Planejamento de Rotas (TMSAC19) é dividida em três telas. São elas:

• Painel Planejamento de Rotas (TPR) - Página principal;
• Itens da Roteirização - parte inferior da tela;
• Controle da Integração - parte inferior da tela.
  
   
   Exemplo de exibição da tela abertura da rotina, onde na parte superior, temos a tela Painel Integração Planejamento de Rotas (TPR), e na parte inferior da tela, temos os Itens da Roteirização e o Controle de Integração 
  
  

Vejamos a seguir as ações e opções disponíveis conforme abaixo

TELA PAINEL INTEGRAÇÃO PLANEJAMENTO DE ROTAS (TPR)

Ações disponíveis/Outras Ações

TELA ITENS DA ROTEIRIZAÇÃO

Ações disponíveis/Outras Ações

TELA CONTROLE DE INTEGRAÇÃO

Ações disponíveis/Outras Ações

03. EXEMPLOS DE UTILIZAÇÃO - TELA PAINEL INTEGRAÇÃO PLANEJAMENTO DE ROTAS (TPR)

3.1 VISUALIZAR

1. Acesse Atualizações → Planejamento de Rotas → Painel Planejamento de Rotas;
2. Posicione na Roteirização desejada e clique no botão VISUALIZAR;
3. Será exibia a tela 'Roteirização Tpr - VISUALIZAR', onde está será divida entre os dados da Roteirização (DMR) na parte superior da tela, e os documentos roteirizados como itens da Roteirização (DMS)
4. Na parte superior da tela, teremos os campos:
   a. Fil Roteir - Filial que enviou o pedido de Roteirização junto ao Totvs Planejamento de Rotas (TPR) ;
   b. Id.Roteir -  Código sequencial de registro das Roteirizações, de controle do Totvs Logística TMS;
   c. Status -  Situação da Roteirização perante ao Totvs Planejamento de Rotas (TPR). Opções disponíveis: 1=Pendente;2=Processado;3=Cancelado;
   
   
5. Na parte inferior da tela, constarão os documentos do Totvs Logística TMS previamente enviados a um pedido de Roteirização junto ao Totvs Planejamento de Rotas (TPR), e nos itens, temos os detalhes de cada documento.
    
6. Dados da tela Itens da Roteirização:
   a. Item - Controla a sequência de documentos inseridos em uma mesma Roteirização;
   b. Entidade - Código da tabela do documento inserido na Roteirização;
   c. Indice Entid - Índice da tabela do documento inserido na Roteirização;
   d. Chave Entid - Dados relacionados do documento inserido na Roteirização;
   e. Status - Situação de Roteirização de cada documento perante ao Totvs Planejamento de Rotas (TPR). Opções disponíveis: 1=Pendente;2=Rejeitado;3=Processado;4=Falha no Processamento;5=Cancelado ; 
   f.  Msg Erro - Campo pode ou não possuir conteúdo. Será alimentado quando um documento tiver sua roteirização rejeitada pelo Totvs Planejamento de Rotas (TPR) conforme suas regras de negócio;
   g. Chv. Externa - Número da Programação de Carregamento gerada;
   h. Ent.Chv.Externa - Código da tabela de Programação de Carregamento;
   i. Ind.Chv.Externa -Índice da tabela de Programação gerada automaticamente 
   j.  Seq. Rot. - Sequência de entrega do documento conforme retorno da Roteirização efetivada pelo Totvs Planejamento de Rotas (TPR);
   
   
   Exemplo de Visualização de uma Roteirização processada 

3.2 VISUALIZAR MAPA

1. Acesse Atualizações → Planejamento de Rotas → Painel Planejamento de Rotas
2. Na tela 'Itens da Roteirização' , posicione na Roteirização desejada e clique no botão Outras Ações → Visualizar Mapa;
3. Será aberta a tela 'Trip', onde constarão informações como:
   a. Documentos da Roteirização e dados do Cliente de Entrega;
   b. Pedágio;
   c. Dados da Entrega;
   d. Dados da Trip;
   
   
4. Ainda na tela 'Trip' será exibido o Mapa, onde constarão as rotas traçadas de todas as sequências da Roteirização(Trip), conforme otimização realizada pelo Totvs Planejamento de Rotas (TPR);
   

<print tela após mudança para o Here>

3.3 CANCELAR ROTEIRIZAÇÃO PENDENTE

1. Acesse Atualizações → Planejamento de Rotas → Painel Planejamento de Rotas
2. Na tela 'Painel Integração Planejamento de Rotas (TPR)' , posicione na roteirização com status Pendente (Legenda Amarela).
3. Clique no botão Outras Ações → Cancelar;
   
   
   
   
   
4. A roteirização e todos os documentos inseridos (Itens da Roteirização) serão cancelados, e a legenda será atualizada para 'Cancelado' (Legenda Cinza escuro).
   

3.4 EXCLUIR ROTEIRIZAÇÕES PENDENTES

1. Acesse Atualizações → Planejamento de Rotas → Painel Planejamento de Rotas
2. Na página 'Painel Integração Planejamento de Rotas (TPR)' , clique no botão Outras Ações → Excluir Pendentes;
3. Será exibida a mensagem abaixo:
   
   'TOTVS -
   Deseja excluir todas Roteirizações pendentes Expiradas?
   Sim / Não'
   
   
4. Ao clicar em Sim, o sistema buscará todas as Roteirizações com status 'Pendente', e, mediante a configuração do campo Tempo Exp. (DLV_TEMPEXP) da rotina Config. Planejamento de Rotas (TMSAC20 - SIGATMS) , o sistema excluirá estes registros;
5. Caso seja escolhido Não,  o sistema retornará a tela inicial da página 'Painel Integração Planejamento de Rotas (TPR)' ;

04.  EXEMPLOS DE UTILIZAÇÃO - TELA ITENS DA ROTEIRIZAÇÃO

VISUALIZAR MAPA

1. Acesse Atualizações → Planejamento de Rotas → Painel Planejamento de Rotas;
2. Na tela 'Painel Integração Planejamento de Rotas (TPR)', posicione na roteirização desejada;
3. Na tela 'Itens da Roteirização, posicione em um dos documentos desejado e clique no botão Visualizar Mapa ;
4. Será aberta uma nova página chamada 'Trip', onde constarão informações como:
   a. Documentos da Roteirização e dados do Cliente de Entrega;
   b. Pedágio;
   c. Dados da Entrega;
   d. Dados da Trip;
   
   
5. Ainda na tela 'Trip' será exibido o Mapa, onde constará a rota específica do documento posicionado, traçada pelo Totvs Planejamento de Rotas (TPR);
   

<print tela após mudança para o Here>

05. EXEMPLOS DE UTILIZAÇÃO - TELA CONTROLE DE INTEGRAÇÃO

1. Acesse Atualizações → Planejamento de Rotas → Painel Planejamento de Rotas;
2. Na tela 'Painel Integração Planejamento de Rotas (TPR)', posicione na roteirização desejada;
3. Clique no item Controle de Integração;
4. Será exibida a tela, contendo as informações Código, APIRoteiriza, Data Envio, Hora Envio, Data Retorno, Hora Retorno, Status; 
5. Clique no botão VISUALIZAR; 
6. Dados da tela Controle de Integração: Serão exibidos conforme Passo a Passo da rotina Controle Planejamento de Rotas (TMSAC23-SIGATMS)
   
   

06. TABELAS UTILIZADAS

• DMR
• DMS
• DLU
• DLV