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). 

Para utilizar esta rotina, se faz necessário como pré condição a integração Totvs Logistica TMS x Totvs Planejamento de Rotas ter sido efetuada com sucesso 

02. TELA DA ROTINA

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



2.1 LEGENDA TELA SUPERIOR

2.2 LEGENDA ABA ITENS DA ROTEIRIZAÇÃO (ABA INFERIOR ESQUERDA)

2.3 LEGENDA CONTROLE DA INTEGRAÇÃO (ABA INFERIOR DIREITA)


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

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

Botões Disponíveis

AçãoDescrição
Visualizar Verifica informações do registro Posicionado
Visualizar MapaExibe informações como:
  • Documentos roteirizados;
  • Exibição do Mapa com a(s) Rota(s) sugerida(s) pelo Totvs Planejamento de Rotas (TPR);
  • Valor de Pedágio;
  • Dados da Entrega 
Excluir PendentesVerifica a configuração do campo Tempo de Expiração, e caso possua registros que atendam a condição, excluirá do sistema estes controles de Roteirização

2.3 TELA ITENS DA ROTEIRIZAÇÃO

Botões Disponíveis

AçãoDescrição
Visualizar MapaExibe informações como:
  • Documentos roteirizados;
  • Exibição do Mapa com a Rota sugerida pelo Totvs Planejamento de Rotas (TPR);
  • Valor de Pedágio;
  • Dados da Entrega 

2.4 TELA CONTROLE DE INTEGRAÇÃO

Botões Disponíveis

AçãoDescrição
Visualizar Atalho que permite visualizar detalhes da Roteirização registrados na rotina Controle Integração Planejamento de Rotas (TMSAC23 - SIGATMS)

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

3.1 VISUALIZAR

Acesse Atualizações → Planejamento de Rotas → Painel Planejamento de Rotas;

Posicione na Roteirização desejada e clique no botão VISUALIZAR;

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)

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;

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.
 

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;


     Exemplo de localização da funcionalidade





  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).

     Exemplo de Roteirização cancelada após utilização funcionalidade



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)';



     Exemplo de exibição da mensagem ao acionar a opção 'Excluir Pendentes'

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 apresentados na tela Controle de Integração serão exibidos conforme Passo a Passo da rotina Controle Planejamento de Rotas (TMSAC23-SIGATMS)

06. TABELAS UTILIZADAS