Histórico da Página
CONTEÚDO
Índice |
---|
Aviso | ||
---|---|---|
| ||
|
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 (TMSAC20);
- Painel Planejamento de Rotas (TMSAC19);
- Controle de Integração Planejamento de Rotas (TMSAC23TPR);
- 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);
- Roteirização de documentos e veículos através da rotina Programação de Carregamento (Routing);
- Visualização de mapa e plotagem das rotas (TMSAC24)
1.2 Busca de coordenadas geográficas automática
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
...
1.3 Programação de Carregamento
...
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:
- 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
...
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
...
DT6_PESO / DTC_PESO
...
DT6_PESOM3 / DTC_PESOM3
...
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
...
Data do Prazo de Entrega do Documento (DT6_PRZENT/DT5_DATPRV/DTC_PRVENT)
...
Se não informado, ou menor que 30 minutos serão considerados 30 minutos de serviço
...
Se não informado, ou menor que 30 minutos serão considerados 30 minutos de serviço
...
UNRESTRICTED (00:00-23:59 de Dom-Sab)
...
DA3_CAPACM
...
DA3_VELOC
...
1
...
Quantidade máxima de paradas de carregamento por viagem.
...
Parâmetro 06 (Pergunte TMSA146TPR)
Obs:Se preenchido deverá ser maior que zero
...
False
...
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.
...
Verifica se é para contabilizar a distância de retorno a origem na roteirização.
...
Parâmetro 04 (Pergunte TMSA146TPR)
...
O montante mínimo do tempo de serviço.
...
Parâmetro 09 (Pergunte TMSA146TPR)
...
O montante máximo do tempo de serviço.
...
Parâmetro 10 (Pergunte TMSA146TPR)
...
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
...
True
1.6 Roteirização de documentos
A Roteirização de Documentos e Veículos (TMSAC21) é a principal funcionalidade da integração. Nessa rotina que serão recebidos e processadas as informações referente ao cálculo de rotas e carregamento de documentos. 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.
...
1.8 Visualização de mapa e plotagem de rotas
A funcionalidade Visualização de Mapa e Plotagem de Rotas (TMSAC24) é a funcionalidade que 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.
03. VISUALIZAR DETALHES E EXPORTAR DADOS
04. CONFIGURAÇÕES
Pré-requisitos instalação/implantação/utilização
...
05. TABELAS UTILIZADAS
DETALHAMENTO DA ATUALIZAÇÃO DE DICIONÁRIO CONFORME ABAS
...
tabs | Dicionário SX2, Dicionário SX3, Dicionário SIX, Dicionário SX1 |
---|---|
ids | SX2,SX3,SIX,SX1 |
...
default | no |
---|---|
referencia | SX1 |
Grupo- TMSA146TPR
...
Pergunta
...
Definição3
...
Criterio da Capacidade
...
Ambos
...
default | yes |
---|---|
referencia | SX2 |
...
Tabela
...
Descrição
...
DMR
...
Roteirização - TPR
...
DMS
...
Itens Roteirização - TPR
...
default | no |
---|---|
referencia | SX3 |
...
Campo
...
DLU_RETENV
...
Tipo
...
Memo
...
Tamanho
...
50
...
Decimal
...
0
...
Formato
...
Título
...
Retorno Post
...
Descrição
...
Retorno do Envio do Post
...
Usado
...
Sim
...
Obrigatório
...
Não
...
Browse
...
Não
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Nesse campo deve ser armazenado o JSON que retorna referente ao primeiro envio e/ou requisição.
DLV- Cadastro Roteirizador
...
Campo
...
DLV_AUTH
...
Tipo
...
Caractere
...
Tamanho
...
50
...
Decimal
...
0
...
Formato
...
Título
...
Authorizatio
...
Descrição
...
Chave de Autorização
...
Usado
...
Sim
...
Obrigatório
...
Sim
...
Browse
...
Não
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Nesse campo deve ser informado a chave do Planejamento de Rotas (TPR)
...
Campo
...
DLV_ROTERI
...
Tipo
...
Caractere
...
Tamanho
...
18
...
Decimal
...
0
...
Formato
...
Título
...
Roteirizador
...
Descrição
...
Roteirizador
...
Usado
...
Sim
...
Obrigatório
...
Não
...
Browse
...
Não
...
Opções
...
1=Maplink;2=Planejamento Rotas (TPR)
...
When
...
Relação
...
Val. Sistema
...
Pertence('12')
...
Help
...
Define o tipo de integração:
1=Maplink;
2=Planejamento Rotas (TPR)
...
Campo
...
DLV_TOKEN
...
Tipo
...
Caractere
...
Tamanho
...
254
...
Campo
...
DLV_URLCAL
...
Tipo
...
Caractere
...
Tamanho
...
80
...
Campo
...
DLV_URLGEO
...
Tipo
...
Caractere
...
Tamanho
...
254
...
Decimal
...
0
...
Formato
...
Título
...
URL Geocode
...
Descrição
...
URL da Geolocalização
...
Usado
...
Sim
...
Obrigatório
...
Não
...
Browse
...
Não
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Informe a URL da Geolocalização
...
Campo
...
DLV_URLROT
...
Tipo
...
Caractere
...
Tamanho
...
254
...
Decimal
...
0
...
Formato
...
Título
...
URL Roteriza
...
Descrição
...
URL da Roteirização
...
Usado
...
Sim
...
Obrigatório
...
Não
...
Browse
...
Não
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Informe a URL da Geolocalização
...
Campo
...
DLV_URLTK
...
Tipo
...
Caractere
...
Tamanho
...
254
...
Decimal
...
0
...
Formato
...
Título
...
URL Token
...
Descrição
...
URL Token
...
Usado
...
Sim
...
Obrigatório
...
Não
...
Browse
...
Não
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Informe a URL da Geolocalização
DMR - Roteirização TPR
...
Campo
...
DMR_FILIAL
...
Tipo
...
Caractere
...
Tamanho
...
2
...
Decimal
...
0
...
Formato
...
Título
...
Filial
...
Descrição
...
Filial do Sistema
...
Usado
...
Não
...
Obrigatório
...
Browse
...
Sim
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Indica a Filial do Sistema
...
Campo
...
DMR_FILROT
...
Tipo
...
Caractere
...
Tamanho
...
2
...
Decimal
...
0
...
Formato
...
Título
...
Fil. Roteir.
...
Descrição
...
Filial Roteirização
...
Usado
...
Sim
...
Obrigatório
...
Sim
...
Browse
...
Sim
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Filial do Identificador da Roteirização
...
Campo
...
DMR_IDROT
...
Tipo
...
Caractere
...
Tamanho
...
9
...
Decimal
...
0
...
Formato
...
Título
...
Id.Roteir.
...
Descrição
...
Id. Roteirização
...
Usado
...
Sim
...
Obrigatório
...
Sim
...
Browse
...
Sim
...
Opções
...
When
...
Relação
...
GetSx8Num("DMR","DMR_IDROT")
...
Val. Sistema
...
Help
...
Identificador da Roteirização da Integração com o Planejamento de Rotas (TPR)
...
Campo
...
DMR_STATUS
...
Tipo
...
Caractere
...
Tamanho
...
1
...
Decimal
...
0
...
Formato
...
Título
...
Status
...
Descrição
...
Status
...
Usado
...
Sim
...
Obrigatório
...
Sim
...
Browse
...
Não
...
Opções
...
1=Pendente;2=Processado;3=Cancelado
...
When
...
Relação
...
'1'
...
Val. Sistema
...
Pertence('123')
...
Help
...
Status da Roteirização da Integração com o Planejamento de Rotas (TPR)
DMS - Itens Roteirização TPR
...
Campo
...
DMS_FILIAL
...
Tipo
...
Caractere
...
Tamanho
...
2
...
Decimal
...
0
...
Formato
...
Título
...
Filial
...
Descrição
...
Filial do Sistema
...
Usado
...
Não
...
Obrigatório
...
Browse
...
Sim
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Indica a Filial do Sistema
...
Campo
...
DMS_FILROT
...
Tipo
...
Caractere
...
Tamanho
...
2
...
Decimal
...
0
...
Formato
...
Título
...
Fil.Roteir.
...
Descrição
...
Filial Roteirização
...
Usado
...
Não
...
Obrigatório
...
Browse
...
Sim
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Filial do Identificador da Roteirização
...
Campo
...
DMS_IDROT
...
Tipo
...
Caractere
...
Tamanho
...
9
...
Decimal
...
0
...
Formato
...
Título
...
Id.Roteir.
...
Descrição
...
Id. Roteirização
...
Usado
...
Não
...
Obrigatório
...
Browse
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Identificador da Roteirização da Integração com o Planejamento de Rotas (TPR)
...
Campo
...
DMS_ITEM
...
Tipo
...
Caractere
...
Tamanho
...
6
...
Decimal
...
0
...
Formato
...
Título
...
Item
...
Descrição
...
Item
...
Usado
...
Sim
...
Obrigatório
...
Sim
...
Browse
...
Sim
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Identifica o item da roteirização
...
Campo
...
DMS_ENTIDA
...
Tipo
...
Caractere
...
Tamanho
...
3
...
Decimal
...
0
...
Formato
...
Título
...
Entidade
...
Descrição
...
Entidade
...
Usado
...
Sim
...
Obrigatório
...
Não
...
Browse
...
Sim
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Indica a Entidade do Documento.
...
Campo
...
DMS_INDENT
...
Tipo
...
Caractere
...
Tamanho
...
1
...
Decimal
...
0
...
Formato
...
Título
...
Indice Entid.
...
Descrição
...
Indice Entidade
...
Usado
...
Sim
...
Obrigatório
...
Não
...
Browse
...
Sim
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Indica o Indice da Entidade a ser utilizado para a pesquisa da Chave da Entidade
...
Campo
...
DMS_CHVENT
...
Tipo
...
Caractere
...
Tamanho
...
200
...
Decimal
...
0
...
Formato
...
Título
...
Chave Entid.
...
Descrição
...
Chave Entidade
...
Usado
...
Sim
...
Obrigatório
...
Não
...
Browse
...
Sim
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Chave que contem os dados do Documento integrados ao Planejamento de Rotas (TPR)
...
Campo
...
DMS_INDEXT
...
Tipo
...
Caractere
...
Tamanho
...
1
...
Decimal
...
0
...
Formato
...
Título
...
Ind.Chv.Ext
...
Descrição
...
Indice Chave Externa
...
Usado
...
Sim
...
Obrigatório
...
Não
...
Browse
...
Sim
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Indica o Indice da Entidade a ser utilizado para a pesquisa da Chave Externa
...
Campo
...
DMS_ENTEXT
...
Tipo
...
Caractere
...
Tamanho
...
3
...
Decimal
...
0
...
Formato
...
Título
...
Ent.Chv.Ext
...
Descrição
...
Entidade Chave Externa
...
Usado
...
Sim
...
Obrigatório
...
Não
...
Browse
...
Sim
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Indica a Entidade da Chave Externa
...
Campo
...
DMS_CHVEXT
...
Tipo
...
Caractere
...
Tamanho
...
30
...
Decimal
...
0
...
Formato
...
Título
...
Chv. Externa
...
Descrição
...
Chave Externa
...
Usado
...
Sim
...
Obrigatório
...
Não
...
Browse
...
Sim
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Identifica o registro gerado na Integração Protheus x Planejamento de Rotas (TPR)
Exemplo: Módulo SIGATMS, caso a integração tenha sido realizada pela rotina de Programação de Carregamento, neste campo irá constar o Nro da Programação que o Documento foi vinculado.
(Filial + Fil.Prog + Nro Prog + Seq.Prog)
...
Campo
...
DMS_STATUS
...
Tipo
...
Caractere
...
Tamanho
...
1
...
Decimal
...
0
...
Formato
...
Título
...
Status
...
Descrição
...
Status
...
Usado
...
Sim
...
Obrigatório
...
Sim
...
Browse
...
Não
...
Opções
...
1=Pendente;2=Rejeitado;3=Processado;4=Falha no Processamento
...
When
...
Relação
...
'1'
...
Val. Sistema
...
Pertence("12345")
...
Help
Identifica o status do Documento para Roteirização
1-Pendente - Enviado para o TPR e aguardando retorno.
2-Rejeitado - Documento rejeitado pelo TPR.
...
Campo
...
DMS_MSGERR
...
Tipo
...
Memo
...
Tamanho
...
50
...
Decimal
...
0
...
Formato
...
Título
...
Msg. Erro
...
Descrição
...
Mensagem Erro
...
Usado
...
Sim
...
Obrigatório
...
Browse
...
Não
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Mensagem de erro recebida pelo Roteirizador do referido documento
Tabela DA3 - Veículos
** O campo consta no pacote de dicionários 009560 - SIGAOMS
...
Campo
...
DA3_VELOC
...
Tipo
...
Numérico
...
Tamanho
...
6
...
Decimal
...
0
...
Formato
...
Título
...
Veloc Máxima
...
Descrição
...
Velocidade Máxima
...
Usado
...
Sim
...
Obrigatório
...
Não
...
Browse
...
Não
...
Opções
...
When
...
Relação
...
Val. Sistema
...
Help
...
Informar a velocidade máxima que o veículo pode percorrer
...
default | no |
---|---|
referencia | SIX |
- ou Entrega.
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).- 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.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. - 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)
Criação de índices:
DMR
...
Índice
...
Ordem
...
DMS
...
Índice
...
Ordem
...
06. ASSUNTOS RELACIONADOS
...
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> |
...