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
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 Planejamento de Rotas (TPR);
02. CONFIGURAÇÕES INICIAIS AMBIENTE
- Ambiente atualizado conforme DT DLOGTMS02-17080 Integração SIGATMS x Planejamento de Rotas (TPR);
- Ambiente configurado com a Viagem Modelo 3
03. PRÉ CONDIÇÕES PROCESSO ROTEIRIZAÇÃO
- Realize as configurações de comunicação entre os sistemas através da rotina Config. Planejamento de Rotas (TMSAC20 - SIGATMS);
- 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 ;
- Realize a busca de coordenadas geográficas para os dados da Filial através do Wizard Referência Geográfica (TMSA015 - SIGATMS);
- 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)
Caso os clientes enviados na Roteirização ainda não possuam coordenadas geográficas cadastradas no Totvs Logística TMS, então durante o processamento de envio da Roteirização, serão enviados pedidos de Geolocalização junto ao Totvs Planejamento de Rotas, e, somente após o cadastramento das coordenadas geográficas é que o pedido de Roteirização será enviado de fato.
Portanto, para uma melhor experiência na usabilidade, recomendamos obter as coordenadas geográficas dos clientes à roteirizar, antes do envio de fato da Roteirização junto ao TPR. Ou seja, realizar a etapa de coordenadas geográficas, antes de realizar as programações de carregamento.
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:
- Acesse Atualizações → Viagens → Programação de Carregamento (TMSA146);
- Clique em INCLUIR e preencha as perguntas de filtro dos documentos e veículos;
- 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.
Opcional - Selecione os veículos desejados.
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).- Selecione Outras Ações → Enviar Planej. Rotas (TPR)
- Será apresentada uma tela de parâmetros para que o usuário configure as perguntas de forma desejada a sua operação.
- 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.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. - Após preencher as perguntas, clique no botão OK
- 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
- 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;
- 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;
- Acompanhe o processamento da Roteirização pelo Totvs Planejamento de Rotas através da rotina Painel Integração Planej. Rotas (TMSAC19 -SIGATMS) ;
- Após o processamento da Roteirização realizado com sucesso pelo TPR, a programação de carregamento será criada de forma automática.
- 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.
- Efetive a programação de carregamento.;
- 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:
| Documentos a serem Roteirizados (TPRRoutingOrders) | ||
|---|---|---|
| Campo TPR | Descrição TPR | SIGATMS |
| identifier | Identificador do pedido | CTE|DT6|xFilial(DT6)+DT6_FILDOC+DT6_DOC+DT6_SERIE |
| weight | Peso total | DT6_PESO / DTC_PESO |
| volume | Volume total em metros cúbicos | DT6_PESOM3 / DTC_PESOM3 |
| pickupTimeWindowStart | Início de carregamento | Parâmetro 02 + Pergunte 03 (Pergunte TMSA146TPR) |
| pickupTimeWindowEnd | Final de carregamento | |
| deliveryTimeWindowStart | Início da entrega | |
| deliveryTimeWindowEnd | Final da entrega | Data do Prazo de Entrega do Documento (DT6_PRZENT/DT5_DATPRV/DTC_PRVENT) |
| serviceLoadDuration | Se não informado, ou menor que 30 minutos serão considerados 30 minutos de serviço | 0 |
| serviceUnloadDuration | Se não informado, ou menor que 30 minutos serão considerados 30 minutos de serviço | 0 |
| origin | Localidade de origem do pedido | Latitude e Longitude do Local de Origem (Transportadora, Cliente Remetente) |
| destination | Localidade de destino do pedido | Latitude e Longitude do Cliente Destinatário |
| Dados da Localidade da Origem / Destino do Documento (TPRRoutingLocality) | ||
|---|---|---|
| Campo TPR | Descrição TPR | SIGATMS |
| identifier | Identificador da localidade. | Codigo Cliente Remetente ou Cliente Destinatario ou Sequencia Endereço ou Codigo da Filial, |
| country | País do endereço. | BRA |
| latitude | Latitude. | DAR_LATITUDE |
| longitude | Longitude. | DAR_LONGITUDE |
| operation | Funcionamento simplificado. | UNRESTRICTED (00:00-23:59 de Dom-Sab) |
| Dados do Veiculo (TPRRoutingVehicles) | ||
|---|---|---|
| Campo | Descrição | SIGATMS |
| identifier | Identificador do tipo do veículo; | DA3_COD |
| weightCapacity | Capacidade do veículo em quilos. | DA3_CAPACM |
| volumeCapacity | Capacidade do veículo em metros cúbicos. | DA3_VOLMAX |
| speed | Define a velocidade que dos veículos em uma roteirização. | DA3_VELOC |
| quantity | Quantidade de veículos, semelhantes a este, disponíveis. | 1 |
| tollAxes | Quantidade de eixos durante a viagem. | 0 |
| tollReturnAxes | Quantidade de eixos durante o retorno para a origem. | 0 |
| Dados de Restrições (TPRRoutingRestrictions) | ||
|---|---|---|
| Campo TPR | Descrição | SIGATMS |
| maxLoadingStops | Quantidade máxima de paradas de carregamento por viagem. | Parâmetro 05 (Pergunte TMSA146TPR) |
| maxUnloadingStops | Quantidade máxima de paradas de descarregamento por viagem. | Parâmetro 06 (Pergunte TMSA146TPR) |
| allowInterleaving | Permite carregamento após descarregamento na mesma viagem. Default: false | False |
| maxDistanceBetweenLoadStops | Máxima distância, em km, entre paradas de carregamento. | Parâmetro 07 (Pergunte TMSA146TPR) Obs:Se preenchido deverá ser maior que zero |
| maxDistanceBetweenUnloadStops | Máxima distância, em km, entre paradas de descarregamento. | Parâmetro 08 (Pergunte TMSA146TPR). Obs:Se preenchido deverá ser maior que zero |
| TPRRoutingOptions, tipo de dado utilizado nas integrações do TPR | ||
|---|---|---|
| Campo TPR | Descrição TPR | SIGATMS |
| capacityCriteria | Tipos de roteirização: WEIGHT, VOLUME ou BOTH | Parâmetro 01 (Pergunte TMSA146TPR) |
| routingInstantType | Define o instante a partir do qual as viagens podem ser expedidas: "Now" Inicio das viagens na primeira hora factível a partir do momento da roteirização mais uma hora. "D+1" Inicio das viagens amanhã no primeiro horário factível de carregamento. | Parâmetro 02 (Pergunte TMSA146TPR) |
| considerReturnDistance | Verifica se é para contabilizar a distância de retorno a origem na roteirização. | Parâmetro 04 (Pergunte TMSA146TPR) |
| minServiceDuration | O montante mínimo do tempo de serviço. | Parâmetro 09 (Pergunte TMSA146TPR) |
| maxServiceDuration | O montante máximo do tempo de serviço. | Parâmetro 10 (Pergunte TMSA146TPR) |
| driverRestTime | Descanso do motorista | DEFAULT: A cada 5 horas dirigidas 1/2 hora de descanso; A cada 24 horas dirigidas 11 horas de descanso e 1 hora de almoço Tempo máximo de direção 8 horas |
| tollCalculation | Calculo do pedágio | True |
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)
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas