Linha Microsiga Protheus

Árvore de páginas


CONTEÚDO


IMPORTANTE

  • A integração TOTVS TMS x TOTVS Planejamento de Rotas (TPR) será descontinuada no próximo release (Outubro/2023).

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:

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.

 
 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:



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:




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

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

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



 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 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 EXPIRADAS

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



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


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

VISUALIZAR

  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

  • DMR
  • DMS
  • DLU
  • DLV