Histórico da Página

CONTEÚDO

1. Visão Geral
2. Exemplo de utilização
3. Tela XXX
   1. Outras Ações / Ações relacionadas
      
4. Tela XXX
   1. Principais Campos e Parâmetros
      
5. Tabelas utilizadas

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 também quais os Documentos e/ou Notas Fiscais enviados e que estão Pendente (aguardando serem processados), Processados e ou Rejeitados: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);
- Excluirtodas as  Roteirizações Pendentes fora do prazo, mediante 'Tempo de Expiração' configurado na rotina Config. Planejamento de Rotas (TMSAC20 - SIGATMS). 

02. 

...

VISUALIZAR

TELA DA ROTINA

...

A tela da rotina

Painel Planejamento de Rotas

...

 (TMSAC19) é dividida em três telas. São elas:

1. Painel Planejamento de Rotas (TPR) - Página superior;
2. Itens da Roteirização - parte inferior direita;
3. Controle da Integração - parte inferior esquerda tela.

Image Added 
 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 

2.1 LEGENDA TELA PAINEL PLANEJAMENTO DE ROTAS (TPR) - PÁGINA SUPERIOR 

Na tela Painel

...

Planejamento de Rotas (TPR

...

), temos nas legendas, o foco principal é o controle do envio x retorno da Roteirização entre os sistemas Totvs Logística TMS x Totvs Planejamento de Rotas.

Opções disponíveis:

1=Pendente (Legenda Amarela);
2=Processado (Legenda Verde);
3=Cancelado (Legenda Cinza Escuro);

Para acionar a legenda, posicione na roteirização desejada desejado e realize um duplo clique no ícone da Legenda, e será aberta a tela com a descrição das legendas, conforme abaixo:

Image Added

2.2 LEGENDA ABA ITENS DA ROTEIRIZAÇÃO - ABA INFERIOR ESQUERDA

Na aba Itens da Roteirização, temos na legenda o status da Roteirização por documento, perante o retorno do Totvs Planejamento de Rotas (TPR). 

Opções disponíveis:

1=Pendente (Legenda Amarela) ;
2=Rejeitado (Legenda Vermelha);
3=Processado (Legenda Verde);
4=Falha no Processamento (Legenda ícone 'X' em vermelho);
5=Cancelado (Legenda Cinza Escuro).

Para acionar a legenda, posicione em um documento desejado e realize um duplo clique no ícone da Legenda, e será aberta a tela com a descrição das legendas, conforme abaixo:

Image Added

2.3 LEGENDA CONTROLE DA INTEGRAÇÃO - ABA INFERIOR DIREITA

Nesta tela, não há legenda, uma vez que sua funcionalidade é apenas consulta da troca de dados da Roteirização entre os sistemas Totvs Logística TMS x Totvs Planejamento de Rotas.

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

Botões Disponíveis

2.3 TELA ITENS DA ROTEIRIZAÇÃO

Botões Disponíveis

2.4 TELA CONTROLE DE INTEGRAÇÃO

Botões Disponíveis

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 ) ;
    b. Id.Roteir -  Código sequencial de registro das Roteirizações, de controle do Totvs Logística TMS;
   Dados da tela Itens da Roteirização:
   a. Fil. Roteir - Filial que enviou o pedido de Roteirização junto ao Totvs Planejamento de Rotas (TPR) ;
   b. idId.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;
   db. Entidade - Código da tabela do documento inserido na Roteirização;
   ec. Indice Entid - Índice da tabela do documento inserido na Roteirização;
   fd. Chave Entid - Dados relacionados do documento inserido na Roteirização;
   g. Chve. 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;
   gh. Ent.Chv.Externa - Código da tabela de Programação de Carregamento;
   hi. Ind.Chv.Externa -Índice da tabela de Programação gerada automaticamente;
   ij.  Seq. Rot. - Sequência de entrega do documento conforme retorno da Roteirização efetivada pelo Totvs Planejamento de Rotas (TPR); Dados da tela Controle de Integração:
   a. Atalho da rotina Controle Integração Planejamento de Rotas (TMSAC23 - SIGATMS), de acordo com a Roteirização posicionada na tela Painel Integração Planejamento de Rotas (TPR) ;
   

...

Image Added
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 'Painel Integração Planejamento de Rotas (TPR)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);
   

...

Image Added
 Exemplo de visualização Mapa por Roteirização completa

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 roteirização com status Pendente (Legenda Amarela).
3. Clique no botão Outras Ações → Cancelar;
   
   Image Added
   

...

1.  Exemplo de localização da funcionalidade
   
   
   
   
   
   
2. 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).
   Image Added
    Exemplo de Roteirização cancelada após utilização funcionalidade

3.4 EXCLUIR ROTEIRIZAÇÕES PENDENTES EXPIRADAS

...

1. Acesse Atualizações → Planejamento de Rotas → Painel Planejamento de Rotas
2. Na tela 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;

...

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

...

1. Caso seja escolhido Não,  o sistema retornará a tela inicial da página 'Painel Integração Planejamento de Rotas (TPR)';
   
   
   Image Added
   

...

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

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

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

...

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

...

1. informações como:
   

...

1. a. Documentos da Roteirização e dados do Cliente de Entrega;
   b. Pedágio;
   c. Dados da Entrega;
   d. Dados da Trip;
   
   
2. Ainda na tela 'Trip' será exibido o Mapa, onde constará a rota específica do documento posicionado, traçada pelo 

1. Totvs Planejamento de Rotas (TPR);
   

...

Image Added
 Exemplo de visualização de plotagem do mapa posicionado apenas para um único documento

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

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

...

VISUALIZAR

1. Acesse Atualizações → Planejamento de Rotas → Painel Planejamento de Rotas;
2. Na tela 'Painel

...

1. Integração Planejamento de Rotas (

...

04. TELA ITENS DA ROTEIRIZAÇÃO

Principais Campos e Parâmetros

...

• Documentos roteirizados;
• Exibição do Mapa com a Rota sugerida pelo Totvs Planejamento de Rotas (TPR);
• Valor de Pedágio;
• Dados da Entrega 

1. TPR)', posicione na roteirização desejada;
2. Clique no item Controle de Integração;
3. Será exibida a tela, contendo as informações Código, APIRoteiriza, Data Envio, Hora Envio, Data Retorno, Hora Retorno, Status; 
4. Clique no botão VISUALIZAR; 
5. 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

• DMR
• DMS
• DLU
• DLV