CONTEÚDO

01. VISÃO GERAL

A integração Totvs Logística TMS x  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. 
Através da integração, o Totvs Planejamento de Rotas (TPR) calculará através de algoritmos, a melhor disposição de entregas e coletas, levando em consideração os veículos disponíveis, localidade de entrega/coleta, informações de tráfego e melhor rota, e retornará as informações junto ao Totvs Logistica TMS. 

Dentre as funcionalidades que englobam a solução, destacam-se:

• Busca de coordenadas geográficas
• Roteirização de documentos e veículos através da rotina Programação de Carregamento ;
• Visualização de mapa e plotagem das rotas traçadas e calculadas pelo Totvs Planejamento de Rotas (TPR);

02.  CADASTROS NECESSÁRIOS

2.2 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 de Geolocalização Síncrona, 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

Importante: Para que toda a solução funcione perfeitamente é necessário obter as coordenadas geográficas de todos os clientes, de acordo com os respectivos endereços.

1.3 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 integração com o Planejamento de Rotas (TPR).
Através da seleção dos documentos e seleção 'opcional' dos veículos (caso não seja selecionado nenhum veículo, o sistema enviará todos os veículos filtrados na Grid de Veículos, cujo status esteja 'Ativo' e 'Em Filial'), será possível enviar os dados para Roteirização.  
Ao selecionar a opção 'Enviar Planejamento Rotas',  será apresentada uma tela de parâmetros para que o usuário configure os campos necessários para integração.
As informações referente aos documentos enviados para TPR, serão registradas nas tabelas DMR - Roteirização TPR e DMS - Itens Roteirização TPR.   Para cada roteirização iremos ter um identificador único que ficará registrado no campo Id. Roteiriza (DMR_IDROT) e com Status (DMR_STATUS / DMS_STATUS) 'Pendente'.

Importante: A Roteirização será somente para documentos com tipo de serviço de transporte Coleta e Entrega.

Dados do Layout para Integração TMS x TPR

UNRESTRICTED  (00:00-23:59 de Dom-Sab)

1.6 Roteirização de documentos

A Roteirização de Documentos e Veículos (TMSAC21)  é a principal funcionalidade da integração. Nessa rotina que serão recebidos e processadas as informações referente ao cálculo de rotas e carregamento de documentos. O Planejamento de Rotas (TPR) irá calcular 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), atualizando o status da Roteirização (DMR_STATUS) para 'Processado'.

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.  O numero da Programação de Carregamento gerado, será registrado no campo Chave Externa (DMS_CHVEXT)
- O status do Item da Roteirização será atualizado para 'Processado' (DMS_STATUS)

Após gerada a Programação de Carregamento, o usuário deverá alterar a Programação de Carregamento, 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. A sequencia para inclusão dos documentos na viagem, serão de acordo com a sequencia de descarregamento recebido da TPR.

Documentos Rejeitados:
-  O status do Item da Roteirização será atualizado para '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.8 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. 

A rotina trabalhará em conjunto com a rotina de Roteirização de documentos e veículos, e poderá ser acessada à partir das rotinas: Painel Planejamento de Rotas, Programação de Carregamento e Viagem Mod. 3.

03. VISUALIZAR DETALHES E EXPORTAR DADOS

04. CONFIGURAÇÕES

05. TABELAS UTILIZADAS

• DLV
• DAR
• DLU
• DMR
• DMS

• SA1

• DUE
• DUL
• DF8
• DD9

06. ASSUNTOS RELACIONADOS

• Documentação Planejamento de Rotas (TPR)
  Token - Instalação, configuração e geração do token de acesso no Google Cloud Platform, que é necessário enviar no header para ter acesso aos serviços no Google Cloud Platform - TDN:  https://tdn.totvs.com/x/_1zOJQ
  Integração Planejamento de Rotas - Integrações Planejamento de Rotas
  Geolocalização - Integração de Geolocalização
  Roteirização - Integração de roteirização

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