Histórico da Página

Image Modified

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 Logística TMS. 

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

• Busca de coordenadas geográficas para obter os dados de Latitude e Longitude de cada empresa enviada na integração.  
• Roteirização de documentos e veículos através da rotina Programação de Carregamento (TMSA146). 
• Visualização de mapa e plotagem das rotas traçadas e calculadas pelo Totvs Configurador Planejamento de Rotas (TMSAC20TPR);Consulta

02.  CONFIGURAÇÕES INICIAIS AMBIENTE

1. Ambiente atualizado conforme DT DLOGTMS02-17080 Integração SIGATMS x Planejamento de Rotas (

...

1. TPR);

...

2. Ambiente configurado com a Viagem Modelo 3

03. PRÉ CONDIÇÕES PROCESSO ROTEIRIZAÇÃO

1. Realize as configurações de comunicação entre os sistemas através da rotina Config. Planejamento de Rotas (

...

1. TMSAC20 - SIGATMS); 

...

1. Realize a busca de coordenadas geográficas

...

1. de ao menos um cliente ou Solicitante. Para gravar as coordenadas geográficas, basta atualizar (ALTERAR) um dos cadastros ;
2. Realize a busca de coordenadas geográficas para os dados da Filial através do Wizard Referência Geográfica (TMSA015 - SIGATMS);
3. No cadastro de veículos configure o campo Veloc.Máxima (DA3_VELOC) para os veículos à utilizar no envio da Roteirização. 

04. Busca de coordenadas geográficas 

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 Referência Geográfica (TMSA015 - SIGATMS)

05. PROCESSO ENVIO DA ROTEIRIZAÇÃO

Na rotina de Programação de Carregamento (TMSA146) é a rotina que será utilizada para realizar o envio das Roteirizações junto ao Totvs Planejamento de Rotas.
Para realizar o envio de uma Roteirização, realize os passos abaixo:

1. Acesse Atualizações → Viagens → Programação de Carregamento (TMSA146);
2. Clique em INCLUIR e preencha as perguntas de filtro dos documentos e veículos;
3. Selecione os documentos desejados para o envio da Roteirização. Será somente possível enviar documentos com tipo de serviço de transporte Coleta ou Entrega.
   

4. Opcional  - Selecione os veículos desejados.
   
   

   Informações

   Caso não seja selecionado nenhum veículo, o sistema enviará todos os veículos filtrados na Grid de Veículos, cujo status do veículo esteja 'Ativo' (DA3_ATIVO=1) e 'Em Filial' (DA3_STATUS=2), e o Totvs Planejamento de Rotas tratará de otimizar os documentos x Veículos informados. Caso seja informado apenas um veículo, mesmo que outros documentos não caibam no mesmo, o Totvs Planejamento de Rotas otimizará a roteirização com o veículo mais ideal para os documentos restantes, porém, é necessário verificar no retorno da Roteirização se a sequencia de entrega trata-se de uma viagem extra (extra trip = true) ou de fato com o caminhão enviado (extra trip = false).

5. Selecione Outras Ações → Enviar Planej. Rotas (TPR)
6. Será apresentada uma tela de parâmetros para que o usuário configure as perguntas de forma desejada a sua operação. 
7. As perguntas são:
   a. Critério de Capacidade - Tipo de roteirização: PESO, VOLUME ou AMBOS.
   b. Planejamento para - Define o instante a partir do qual as viagens podem ser expedidas: "Agora" Inicio das viagens na primeira hora factível a partir do momento da roteirização mais uma hora ou "D+1" Inicio das viagens amanhã no primeiro horário factível de
   carregamento.
   c. Horário de Carregamento - Horário inicial da janela de carregamento dos Documentos.
   d. Considera Retorno - Verifica se é para contabilizar a distância de retorno a origem na roteirização.
   e. Qtd Máxima Carregamento - Quantidade máxima de paradas de carregamento por viagem.
   f. Qtd Máxima Descarregamento -Quantidade máxima de paradas de descarregamento por viagem.
   g. KM Máxima Carregamento - Máxima distância em KM, entre as paradas de carregamento. 
   h. KM Máxima Descarregamento  - Máxima distância em KM, entre as paradas de descarregamento.  

   
   

   Aviso
   O modo que as perguntas são preenchidas define a forma sobre como a Roteirização será calculada e otimizada  junto ao Totvs Planejamento de Rotas (TPR). É de extrema importância neste momento, o usuário conhecer os parâmetros disponibilizados que poderão alterar a forma que a Roteirização será realizada.

8. Após preencher as perguntas, clique no botão OK
9. Neste momento, serão enviados os dados de documentos, veículos, e clientes, além dos parâmetros que serão enviados conforme o preenchimento das perguntas
10. Ao selecionar a opção 'Enviar Planejamento Rotas',  os dados serão enviados junto ao Totvs Planejamento de Rotas, e, neste momento, o TPR irá realizar suas validações conforme suas regras de negócio, podendo aceitar ou não um pedido de roteirização;
11. Após receber a mensagem 'Roteirização realizada com sucesso', finalize o processo de inclusão na rotina Programação de Carregamento, pelo botão CANCELAR;
12. Acompanhe o processamento da Roteirização pelo Totvs Planejamento de Rotas através da rotina Painel Integração Planej. Rotas (TMSAC19 -SIGATMS) ;
13. Após o processamento da Roteirização realizado com sucesso pelo TPR, a programação de carregamento será criada de forma automática. 
14. Opcional - Caso a rote esteja configurada no Campo Rota (DLV_ROTA) na rotina Config. Planejamento de Rotas (TMSAC20 - SIGATMS), a programação de carregamento será criada automaticamente com a Rota em questão associada.
15. Efetive a programação de carregamento.;
16. Será criado Viagem Modelo 3 com os dados da programação de carregamento em questão;                   

5.1 RELAÇÃO DOS DADOS JSON DE ENVIO DA ROTEIRIZAÇÃO 

Ao enviar um pedido de Roteirização, o Totvs Logistica TMS enviará o arquivo Json com base nas informações abaixo:

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

5.2 ROTEIRIZAÇÃO DE DOCUMENTOS

A Roteirização de Documentos e Veículos (TMSAC21)  é a principal funcionalidade que processa o retorno da integração. Ou seja, esta funcionalidade ficará a cargo de receber os dados do Totvs Planejamento de Rotas e atualizar os controles de roteirizações realizadas via TMS.
É através dela que serão controladas as Roteirizações recebidas e processadas. 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)

O acompanhamento das Roteirizações pode ser feito através da rotina  Painel Integração Planej. Rotas (TMSAC19 -SIGATMS)

06. VISUALIZAÇÃO E PLOTAGEM DE MAPA

A funcionalidade Visualização de Mapa e Plotagem de Rotas (TMSAC24) 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.

Para maiores informações sobre visualização do Mapa, verifique os exemplos disponíveis em Painel Integração Planej. Rotas (TMSAC19 -SIGATMS)

07. TABELAS UTILIZADAS

• DLV
• DAR
• DLU
• DMR
• DMS

• SA1

• DUE
• DUL
• DF8
• DD9

09. ASSUNTOS RELACIONADOS

• DT DLOGTMS02-17080 Integração SIGATMS x Planejamento de Rotas (TPR)
• Config. Planejamento de Rotas (TMSAC20 - SIGATMS)
• Controle Integração Planejamento de Rotas (TMSAC23 - SIGATMS)
• Painel Integração Planej. Rotas (TMSAC19 -SIGATMS)

...

1.1 Configurador Planejamento de Rotas

1.1 Consulta Planejamento de Rotas

1.1 Controle de Integração Planejamento de Rotas

1.1 Busca de coordenadas geográficas automática

1.1 Wizard para obtenção das coordenadas geográficas das filiais

1.1 Roteirização de documentos e veículos 

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

1.1 Visualização de mapa e plotagem de rotas

A funcionalidade Configurador Planejamento de Rotas é um cadastro 

...

 Importante - Troca de Visões

03. VISUALIZAR DETALHES E EXPORTAR DADOS

04. CONFIGURAÇÕES

Ao acessar a rotina e após o carregamento da tela inicial, poderão ser realizadas configurações no menu lateral esquerdo:

Menu recolhido/expandido:

*

05. TABELAS UTILIZADAS

...

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

...