Árvore de páginas

Versões comparadas

Chave

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

Bandeira Brasil Localização.pngImage Modified

CONTEÚDO

Índice
indent8.1.exclude.*CONTEÚDOstylenone


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:

  • 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

  1. Ambiente atualizado conformDT 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 ClienteSequê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íncronaa 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)

Informações

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:

  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
Dados da Localidade da Origem / Destino do Documento (TPRRoutingLocality)
Campo TPRDescrição TPRSIGATMS
identifierIdentificador da localidade.Codigo Cliente Remetente ou Cliente Destinatario ou Sequencia Endereço ou Codigo da Filial,
countryPaís do endereço.BRA
latitudeLatitude.DAR_LATITUDE
longitudeLongitude.DAR_LONGITUDE
operationFuncionamento simplificado.
UNRESTRICTED  (00:00-23:59 de Dom-Sab)
Dados do Veiculo (TPRRoutingVehicles)
CampoDescriçãoSIGATMS
identifierIdentificador do tipo do veículo;

DA3_COD
weightCapacityCapacidade do veículo em quilos.

DA3_CAPACM

volumeCapacityCapacidade do veículo em metros cúbicos.DA3_VOLMAX
speedDefine a velocidade que dos veículos em uma roteirização.

DA3_VELOC

quantityQuantidade de veículos, semelhantes a este, disponíveis.

1

tollAxesQuantidade de eixos durante a viagem.0
tollReturnAxesQuantidade de eixos durante o retorno para a origem.0
Dados de Restrições (TPRRoutingRestrictions)
Campo TPRDescriçãoSIGATMS
maxLoadingStops

Quantidade máxima de paradas de carregamento por viagem.


Parâmetro 05 (Pergunte TMSA146TPR)
Obs:Se preenchido deverá ser maior que zero

maxUnloadingStopsQuantidade máxima de paradas de descarregamento por viagem.

Parâmetro 06 (Pergunte TMSA146TPR)
Obs:Se preenchido deverá ser maior que zero

allowInterleavingPermite carregamento após descarregamento na mesma viagem. Default: false

False

maxDistanceBetweenLoadStopsMáxima distância, em km, entre paradas de carregamento.Parâmetro 07 (Pergunte TMSA146TPR)
Obs:Se preenchido deverá ser maior que zero
maxDistanceBetweenUnloadStopsMá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 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. 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 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

...

Desta forma, será possível:

  • Identificar através de um painel visual que contém informações, métricas e indicadores da empresa;
  • Acompanhar o desempenho de processos de forma objetiva, por meio de valores claros e fáceis de medir e analisar;
  • Por meio de painéis de controle automatizados, proporcionar muito mais agilidade ao acompanhamento, ajuste e auxílio para os gestores tomarem decisões rapidamente;
  • Validar se há necessidade de ajustar processos para atingir objetivos.

Visões:
As visões são a maneira de agrupar as informações entre Cards e Gráficos.

Cards:
Os cards possuem informações com totalizadores representados com fácil compreensão visual, fazendo com que o usuário tenha informações de maneira rápida.

Gráficos
Os gráficos possuem informações comparativas e/ou detalhes do que foi informado nos cards.

1.1 Dashboard - Visões e Cards

No Dashboard serão apresentadas duas visões e em cada uma delas há cards e gráficos relacionados:

1.2 Monitor docs Eletron(CT-e / MDF-e)

Nesta visão serão apresentados 3 Cards:

  1. CT-es não transmitidos;
  2. MDFes não transmitidos;
  3. XML NFe Sefaz Viagem em Trânsito.

Image Removed

Em cada Card há algumas informações:

  1. CT-es não transmitidos - Será possível identificar relação de documentos não transmitidos, não autorizados e com cancelamento pendente. Referente ao mês corrente.
  2. MDF-es não transmitidos - Será possível identificar relação de documentos não transmitidos, não autorizados, com cancelamento ou encerramento pendente. Referente ao mês corrente.
  3. XML NF-e Sefaz Viagem em Trânsito - Será possível identificar relação de quantidade de documentos coletados, NFs processadas, pendentes e não encontradas (em relação à SEFAZ).

 E abaixo dos cards, serão disponibilizadas as opções de "Detalhes"

Image Removed

Informações
titleObservação:

Para o Card 1.CT-es não transmitidos é importante validar se há o Schedule Cálculo do Frete (TMSA200S - SIGATMS) ativo no ambiente, pois em caso positivo, os valores apresentados podem não ser demonstrados, devido a velocidade de processamento de transmissão/status com a utilização desta configuração (JOB/Schedule).

1.3 TMS - Documentos x Viagens

Nesta visão serão apresentados 5 Cards:

  1. Solicitação de Coletas Pendentes; 
  2. Status das Viagens;
  3. Documentos em Trânsito;
  4. Solicitação de Coletas em Trânsito;
  5. Prazo dos Documentos em Trânsito.

Image Removed

Em cada Card há algumas informações:

  1. Solicitação de Coletas Pendentes -  Será possível identificar relação de documentos com status em aberto e bloqueado, bem como a coleta mais antiga com status em aberto.
  2. Status das Viagens -  Será possível identificar relação das viagens com status em aberto, trânsito, fechada e com chegada em filial.
  3. Documentos em Trânsito -  Será possível identificar relação de total de documentos, documentos não entregues, percentual de entregas realizadas e não realizadas.
  4. Solicitação de Coletas em Trânsito  -  Será possível identificar relação de total de documentos do tipo coleta em trânsito e coletas não efetuadas.
  5. Prazo dos Documentos em Trânsito -  Será possível identificar relação de documentos com prazo de entrega vencidos e à vencer à partir do dia da consulta ao Dashboard.

 E abaixo dos cards, serão disponibilizadas as opções de "Detalhes"

Image Removed

(aviso) Importante - Troca de Visões

No momento para a troca de Visões no Dashboard, será necessário seguir o seguinte processo:

  1. Na seleção de "Visão", clicar na caixa;
  2. Apagar o conteúdo;
  3. Após isso as visões disponíveis serão apresentadas novamente.

*Clique na imagem para ampliar e visualizar corretamente.
Image Removed
  
2. Dashboard - Gráficos

No Dashboard serão apresentados também gráficos, logo abaixo dos cards.

2.1 Monitor docs Eletron(CT-e / MDF-e)

Nesta visão serão apresentados 3 Gráficos:

  • Gráfico CT-es;

  • Gráfico MDF-es;

  • Gráfico XML NF-e Sefaz Viagem em Trânsito.

*Clique na imagem para ampliar.

...

Image Removed

Gráfico 1

...

Image Removed

Gráfico 2

...

Image Removed

Gráfico 3

2.2 TMS - Documentos x Viagens

Nesta visão serão apresentados 4 Gráficos:

  • Gráfico Viagens;
  • Gráfico Documentos em Trânsito;
  • Gráfico Documentos X Prazos de Entrega - Vencidos;
  • Gráfico Documentos X Prazos de Entrega -  À vencer.

*Clique na imagem para ampliar.

...

Image Removed

Gráfico 1

...

Image Removed

Gráfico 2

...

Image Removed

Gráfico 3

...

Image Removed

Gráfico 4

(aviso) Importante - Ocultar Colunas no Gráfico

É possível ocultar determinadas colunas nos gráficos.

Para isso, basta clicar sobre o item da legenda a ser ocultada, após isso a legenda passará a ficar riscada e a coluna será removido da visão.

*Clique na imagem para ampliar e visualizar corretamente.

Image Removed

03. VISUALIZAR DETALHES E EXPORTAR DADOS

Como mencionado anteriormente, abaixo de cada Card e Gráfico há possibilidade de verificar "Detalhes" dos itens demonstrados.

Ao clicar na opção "Detalhes", uma nova janela será apresentada e no canto superior esquerdo haverá a possibilidade de exportar e salvar o arquivo para melhor análise, de forma total ou parcial, conforme imagens:

*Clique na imagem para ampliar e visualizar corretamente.

Image Removed

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:

*Clique na imagem para ampliar e visualizar corretamente.

Image Removed

...

Sair
Finaliza o acesso à rotina de Dashboard.

05. TABELAS UTILIZADAS

A1N - Tipos de Card

A1P -  Tipos de Chart

A1O - Cards Dashboards

A1Q - Charts Dashboards

A1R -  Visões

DMH - NFe Conferência de Coleta

DTC - Doc Cliente para Transporte

DT5 - Solicitação de Coleta

DT6 - Documentos de Transporte

DTQ - Viagem

DTX - Manifesto

DUD - Movimento de Viagens

DYN - Manifesto Eletrônico Cancelado

06. ASSUNTOS RELACIONADOS

Dashboard Backoffice - Guia de Referência - P12

Cockpit de Clientes (TMSA510)

...



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

...