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 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); 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 (Routing);Cálculo de valor praças de pedágio (Routing);TMSA146). 
• 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). 

Nessa funcionalidade deverão ser informadas as chaves de acesso disponibilizadas e também os endereços virtuais (IP) referente a integração. 

A rotina irá armazenar as informações referentes ao Totvs Planejamento de Rotas na tabela DLV - Cadastro Roteirizador e através da rotina TMSAC20 será possível incluir/alterar/deletar as informações.

 
Image Removed

URL Callback: Informar o IP e Porta externa do servidor do Protheus + /REST/V1/WSTPRNEOLOG/.

URL Mapa HTML: Informar o IP e Porta externa do servidor do Protheus + /ws/index.html.

URL Token: URL disponibilizada pelo TPR. 

URL Geocode: URL disponibilizada pelo TPR.

URL Roteirização: URL disponibilizada pelo TPR. 

...

•  traçadas e calculadas pelo Totvs Planejamento de Rotas (TPR);

02.  CONFIGURAÇÕES INICIAIS AMBIENTE

1. Ambiente atualizado conforme DT DLOGTMS02-17080 Integração SIGATMS x Planejamento de Rotas (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 (TMSAC20 - SIGATMS); 
2. Realize a busca de coordenadas geográficas de ao menos um cliente ou Solicitante. Para gravar as coordenadas geográficas, basta atualizar (ALTERAR) um dos cadastros ;
3. Realize a busca de coordenadas geográficas para os dados da Filial através do Wizard Referência Geográfica (TMSA015 - SIGATMS);
4. 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

...

Bloqueado: Informar 2 - Nã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

...

1. ou Entrega.
   

...

1. Opcional  - Selecione os veículos desejados.
   
   

   Informações
   Caso não seja selecionado nenhum veículo, o sistema enviará todos os veículos

...

1. filtrados na

...

1.3 Painel Planejamento de Rotas

...

1. Grid de Veículos, cujo status do veículo esteja 'Ativo' (DA3_ATIVO=1) e 'Em Filial'

...

1. (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).

2. Selecione Outras Ações → Enviar Planej. Rotas (TPR)
3. Será apresentada uma tela de parâmetros para que o usuário configure as perguntas de forma desejada a sua operação. 
4. 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

1. Totvs Planejamento de Rotas (TPR).

Nessa funcionalidade será possível consultar e verificar o status das Roteirizações e também quais os Documentos e/ou Notas Fiscais enviados e que estão aguardando serem processados. 

...

1. É 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.

2. Após preencher as perguntas, clique no botão OK
3. 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
4. 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;
5. 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;
6. Acompanhe o processamento da Roteirização pelo Totvs Planejamento de Rotas através da rotina Painel Integração Planej. Rotas (TMSAC19 -SIGATMS) ;
7. Após o processamento da Roteirização realizado com sucesso pelo TPR, a programação de carregamento será criada de forma automática. 
8. 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.
9. Efetive a programação de carregamento.;
10. 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

...

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

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)

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

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

...

 Importante - Troca de Visões

03. VISUALIZAR DETALHES E EXPORTAR DADOS

04. CONFIGURAÇÕES

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

...

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

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>

...