Histórico da Página

Image Modified

CONTEÚDO

01. VISÃO GERAL

A funcionalidade Totvs Planejamento de Rotas (TPR) é uma funcionalidade implementada para otimizar o planejamento e execução das operações de transporte relacionadas às entregas e coletas.

...

• Configurador Planejamento de Rotas (TMSAC20);
• Painel Planejamento de Rotas (TMSAC19);
• Controle de Integração Planejamento de Rotas (TMSAC23);
• Busca de coordenadas geográficas automática nos cadastros: Clientes, Fornecedores, Sequência de Endereço e Solicitantes (Geocode);
• Wizard para obtenção de coordenadas geográficas das filiais (Geocode);
• Roteirização de documentos e veículos através da rotina Programação de Carregamento (Routing);
• Cálculo de valor praças de pedágio (Routing);
• Visualização de mapa e plotagem das rotas (TMSAC24)

1.1 Configurador Planejamento de Rotas

A funcionalidade Configurador Planejamento de Rotas é a rotina principal para realizar o cadastro e habilitar a integração Totvs Planejamento de Rotas (TPR). 

...

Após realizado a inclusão do registro, clique em Outras Ações/ Testar Conexão para obter dados do Token para acesso.

1.2 Programação de Carregamento

Na rotina de Programação de Carregamento (TMSA146),  com a configuração da TPR realizada e ambiente com dados da Viagem Modelo 3, será disponibilizada a opção para envio dos Documentos para Roteirização (TPR).
A Roteirização será somente para documentos com tipo de serviço de transporte Coleta e Entrega.

Após a seleção dos documentos, caso nenhum veículo seja selecionado (mark), o sistema enviará todos os veículos (filtrados na Programação de Carregamento - grid veículos) cujo status seja 'Ativo'  e 'Em Filial'.

Os documentos enviados para Roteirização serão armazenados nas Tabelas DMR/DMS, conforme item 1.3.

1.3 Painel Planejamento de Rotas

A funcionalidade Painel Planejamento de Rotas (TMSAC19) é a rotina que armazenará as informações referentes ao envio de informações para a integração Totvs Planejamento de Rotas (TPR).

...

As informações serão registradas nas tabelas DMR - Roteirização TPR e DMS - Itens Roteirização TPR e para cada roteirização iremos ter um identificador único que ficará registrado no campo Id. Roteiriza - DMR_IDROT.

Através dessa rotina será possível:
- Cancelar a Roteirização:   Opção para cancelar as roteirizações Pendentes, ou seja, roteirização que não houve retorno da TPR (por exemplo:  URL inválida)
Ao efetuar o cancelamento, o status da Roteirização (DMR/DMS) e Controle de Integração (DLU) serão alterados para 'Cancelado'
- Visualizar o Mapa: Opção para visualização do Mapa, após retorno da roteirização realizada  pela TPR.

1.4 Controle de Integração Planejamento de Rotas

A funcionalidade Controle de Integração Planejamento de Rotas (TMSAC23) é a rotina que armazenará as informações enviadas e recebidas. Toda a integração é enviado um arquivo no formato JSON, em que contém as informações referente à veículos, documentos, destinatários, e esse arquivo JSON é armazenado na tabela DLU - Controle Integração Roterizador. 

Através dessa funcionalidade será possível obter informações JSON enviado, JSON recebido, data e hora do envio e recebimento e eventuais erros ou falhas.

1.5 Busca de coordenadas geográficas automática 

As rotinas Cadastro de Cliente, Sequência de Endereço, Cadastro de Solicitantes e Wizard para envio das Filiais, foram atualizadas para que ao final da gravação as informações referentes ao endereço sejam enviadas automaticamente para a api GeoCode ,a fim de obter as coordenadas geográficas do respectivo endereço. As coordenadas geográficas recebidas (Latitude e Longitude) são gravadas na tabela DAR - Referência Geográficas, e é possível visualiza-las através da rotina Cadastro de Referências Geográficas - TMSAO15

1.6 Roteirização de documentos

A funcionalidade Roteirização de Documentos e Veículos (TMSAC21)  é a principal funcionalidade. Nessa rotina que serão recebidos e processadas as informações referente ao cálculo de rotas e carregamento de documentos. A funcionalidade Totvs Planejamento de Rotas irá calcular através de algoritmos qual a melhor disposição de cargas, ordem de carregamento, ordem de descarregamento, sequencia de entrega e melhor rota de acordo com os veículos disponíveis.

A funcionalidade irá receber automaticamente os documentos processados, como também os documentos rejeitados (por exemplo o peso do documento ultrapasse o limite máximo do veiculo).

Para os documentos processados:
-  O sistema irá criar de maneira automática a Programação de Carregamento (TMSA146) com os veículos e documentos calculados, dessa maneira espera-se que tenha um melhor aproveitamento da frota de veículos e também reduza-se os custos operacionais de inclusão de programações de carregamento. 
- Será gravado o status da roteirização do documento como 'Processado' (DMS_STATUS)
- O numero da Programação que fora gerado, será gravado na Chave Externa da DMS (DMS_CHVEXT)
Após gerada a Programação de Carregamento, o usuário deverá alterar a Programação, informando o Código da Rota e o Código do Motorista (caso o mesmo não esteja vinculado ao veículo).
Ao efetivar a Programação de Carregamento, será gerada a viagem, através da rotina automática da Viagem Modelo 3.

Para os documentos rejeitados:
- Será gravado o status da roteirização do documento como 'Rejeitado' (DMS_STATUS)
- No caso de uma NF Cliente (DTC), se a mesma estiver vinculada a um Lote, onde as demais NFs Cliente (DTC) foram processadas com sucesso na mesma roteirização, as NFCs rejeitadas serão vinculadas a um novo lote. O numero do novo Lote será gravado na Chave Externa da DMS (DMS_CHVEXT)

1.6 Cálculo de valor praças de pedágio

A funcionalidade Cálculo de valor de praças de pedágio (TMSAC21) é obtida em conjunto com a Roteirização de documentos e veículos, e será recebida e armazenada até o momento da Efetivação da Programação de Carregamento, no qual ao realizar a efetivação uma Viagem Mod. 3 (TMSAF60) será gerada e o valor do pedágio será incluído automaticamente no Complemento da Viagem (DTR - Complemento da Viagem) no campo DTR_VALPDG. 

1.7 Visualização de mapa e plotagem de rotas

A funcionalidade Visualização de Mapa e Plotagem de Rotas (TMSAC24) é a funcionalidade que permitirá ao usuário visualizar em apenas uma interface qual a rota e sequência de entrega planejada. Nessa funcionalidade também será possível visualizar os Documentos, Praças de pedágio, Quantidade de paradas, Peso transportado, Volume transportado, Início e Fim da operação, Distância total, Documentos rejeitados. 

...

 Importante - Troca de Visões

03. VISUALIZAR DETALHES E EXPORTAR DADOS

04. CONFIGURAÇÕES

Pré-requisitos instalação/implantação/utilização

Para a integração é necessário realizar algumas configurações:

• Parâmetros
  MV_ROTAINT: Habilita rotas inteligentes. Informar .T.
  
  
• Cadastro - Configuração Roteirizador
  
  
• Arquivos
  Verifique se os arquivos index.html e tprchannel.js constam na pasta web conforme PATH configurado (PATH=C:\Bases\environment1\data\web).
  
• Configuração Rest Protheus
• Configuração HTTP
• Configuração Job

05. TABELAS UTILIZADAS

06. ASSUNTOS RELACIONADOS

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>

...