Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Bandeira Brasil Localização.png

CONTEÚDO

Índice


Aviso
titleIMPORTANTE
  • 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:

...

  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:

Documentos a serem Roteirizados (TPRRoutingOrders)
Campo TPRDescrição TPRSIGATMS
identifierIdentificador do pedido

CTE|DT6|xFilial(DT6)+DT6_FILDOC+DT6_DOC+DT6_SERIE
NFC|DTC|xFilial(DTC)+DTC_FILORI+DTC_LOTNFC+DTC_CLIREM+DTC_LOJREM+DTC_CLIDES+DTC_LOJDES+DTC_SERVIC+DTC_CODPRO+DTC_NUMNFC+DTC_SERNFC
COL|DT5|xFilial(DT5)+DT5_FILDOC+DT5_DOC+DT5_SERIE

weightPeso total

DT6_PESO / DTC_PESO

volumeVolume total  em metros cúbicos

DT6_PESOM3 / DTC_PESOM3

pickupTimeWindowStartInício de carregamento

Parâmetro 02  + Pergunte 03 (Pergunte TMSA146TPR)
Obs: Se Parametro 02 = Agora, a Data de Carregamento será a DataBase 
        Se Parametro 02 = D+1, a Data de Carregamento será a DataBase + 1 

pickupTimeWindowEndFinal de carregamento
deliveryTimeWindowStartInício da entrega


deliveryTimeWindowEndFinal 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
originLocalidade de origem do pedidoLatitude e Longitude do Local de Origem (Transportadora, Cliente Remetente)
destinationLocalidade de destino do pedidoLatitude e Longitude do Cliente Destinatário

...

TPRRoutingOptions, tipo de dado utilizado nas integrações do TPR
Campo TPRDescrição TPRSIGATMS
capacityCriteriaTipos de roteirização: WEIGHT, VOLUME ou BOTHParâ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)

driverRestTimeDescanso 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 

tollCalculationCalculo 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. Nessa rotina que serão recebidos e processadas as informações referente ao cálculo de rotas e carregamento de documentos. 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.

...

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 Viagem Mod. 3.

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

...


07TABELAS UTILIZADAS

  • DLV
  • DAR
  • DLU
  • DMR
  • DMS
  • SA1

  • DUE
  • DUL
  • DF8
  • DD9

...