Histórico da Página

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

A fim de otimizar e reduzir custos das operações de transporte, o módulo Gestão de Transportes Totvs Logística TMS (SIGATMS) integrará com a solução logística de roteirização de carga fornecida pelo Totvs Planejamento de Rotas (TPR), agregando inteligência e otimizando o processo de entregas e coletas dentro do SIGATMS. Fazendo , fazendo com que as coletas/entregas tenham uma melhor disposição e ordem, e dessa maneira além de reduzir o tempo de operação também se reduz custos dentro da operação de transporte, além da obtenção prévia dos valores de pedágio.

03. SOLUÇÃO

...

Para que toda a solução funcione perfeitamente é necessário obter as coordenadas geográficas de todos os clientes, de acordo com os respectivos endereços.  
As rotinas Cadastro de Cliente, Sequência de Endereço, Wizard Filial e Cadastro de Solicitantes foram atualizadas para que ao final da gravação as informações referentes ao endereço sejam enviadas automaticamente para gelocalização (tpr-geolocation-sync) ,a fim de obter as coordenadas geográficas do respectivo endereço. As coordenadas geográficas recebidas 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.

...

Para atender a solução, foram necessárias novas rotinas para controlar a configuração e gestão das informações entre os sistemas. 
No Totvs Logística TMS (SIGATMS) foram necessárias as ações abaixo:

Criado novo Submenu - 'Atualizações -> Planejamento de Rotas', onde estarão as novas rotinas:

• Config. Planejamento de Rotas (TMSAC20);
  Rotina principal para realizar o cadastro e habilitar a integração Totvs Planejamento de Rotas (TPR). 
  
  
• Controle de Integração Planejamento de Rotas (TMSAC23);
  Rotina que armazenará as informações enviadas e recebidas. Toda a integração é enviado um arquivo no formato JSON e esse arquivo é armazenado na tabela DLU - Controle Integração Roteirizador.
  
  
• Painel Planejamento de Rotas (TMSAC19);
  Rotina que armazenará as informações referentes ao envio de informações para a integração Totvs Planejamento de Rotas (TPR).

04. DEMAIS INFORMAÇÕES

• Para uso desta funcionalidade, se faz necessária atualização do Protheus, de acordo com as informações abaixo:
  
          UPDDISTR

  • Pacote: 009506  - Para atualização de dicionário de dados, criação/alteração  de campos e índices do módulo SIGATMS;
    
  • Pacote: 009880 - Para atualização de dicionário de dados, criação/alteração  de campos e índices do módulo SIGATMS;
    
  • Pacote: 009560 - Para atualização de dicionário de dados, criação/alteração  de campos e índices do módulo SIGAOMS;
  • Pacote: 010930 - Atualização das características do campo DLV_TOKEN  do módulo SIGATMS;
    
    MENU
  • Atualização do menu sigatms.xnu.
    
    
  • PROGRAMAS
    Atualizar o Repositório de objetos do Protheus (RPO) de acordo com a relação de programas relacionados nesta documentação. 
    
    PARÂMETRO

  • Habilite o parâmetro MV_ROTAINT;
    
    

  • CONFIGURAÇÕES REST E WEB SERVICE
    Necessário o ambiente possuir configurações Rest e WebService, de modo a definir os endereços de recebimento dos dados entre os sistemas na nova rotina  Config. Planejamento de Rotas (TMSAC20 - SIGATMS)
    
    

  • ARQUIVOS PARA PLOTAGEM DO MAPA
    Instalar os arquivos index.html e tprchanenl.js na pasta Web/Ws do Protheus, disponível no link.

• DETALHAMENTO DA ATUALIZAÇÃO DE DICIONÁRIO CONFORME ABAS

  
  

  Totvs custom tabs box
  tabs Dicionário SX2, Dicionário SX3, Dicionário SIX, Dicionário SX1 ids SX2,SX3,SIX,SX1
  Totvs custom tabs box items default no referencia SX1 Grupo- TMSA146TPR Pergunta Tipo Tamanho Modo Definição1 Definição2 Definição3 Criterio da Capacidade Caracter 1 Combo Peso Volume Ambos Planejamento para Caracter 1 Combo Agora D+1 Horario de Carregamento Caracter 5 Get Considera Retorno p/ Filial Caracter 1 Combo Sim Não Qtd Maxima Carregamentos Numerico 3 Get Qtd Maxima Descarregamentos Numerico 3 Get KM Maxima Carregamentos Numerico 4 Get KM Maxima Descarregamentos Numerico 4 Get Tempo Mínimo Serviço Caracter 5 Get Tempo Máximo Serviço Caracter 5 Get Totvs custom tabs box items default yes referencia SX2 Tabela Descrição DMR Roteirização - TPR DMS Itens Roteirização - TPR Totvs custom tabs box items default no referencia SX3 Tabela DLU - Controle Integração Roteirização 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

Quando todas as etapas da integração citadas acima forem concluídas com sucesso,  toda a visualização dos pontos de entrega/coleta, rota e praças de pedágio, será exibido a partir da funcionalidade do Map Display, disponibilizado na  Consulta Planejamento de Rotas (TMSAC19).

...

Foram criadas novas funcionalidades no SIGATMS:

...

04. DEMAIS INFORMAÇÕES

• Para uso desta funcionalidade, deve ser utilizado:

• Pacote: 009506 - Para atualização de dicionário de dados, criação/alteração  de campos e índices do módulo SIGATMS
  
• Pacote: 009560 - Para atualização de dicionário de dados, criação/alteração  de campos e índices do módulo SIGAOMS.
• Atualize o menu sigatms.xnu.
• Habilite o parâmetro MV_ROTAINT
Documentação Planejamento de Rotas (TPR)
Token - Instalação, configuração e geração do token de acesso no Google Cloud Platform, que é necessário enviar no header para ter acesso aos serviços no Google Cloud Platform - TDN:  https://tdn.totvs.com/x/_1zOJQ
Integração Planejamento de Rotas - Integrações Planejamento de Rotas
Geolocalização - Integração de Geolocalização
Roteirização - Integração de roteirização


DETALHAMENTO DA ATUALIZAÇÃO DE DICIONÁRIO CONFORME ABAS

Totvs custom tabs box

tabs	Dicionário SX2, Dicionário SX3, Dicionário SIX, Dicionário SX1
ids	SX2,SX3,SIX,SX1

Grupo- TMSA146TPR

Pergunta

TipoTamanhoModoDefinição1Definição2

Definição3

Criterio da Capacidade

Caracter1ComboPesoVolume

Ambos

Planejamento paraCaracter1ComboAgoraD+1Horario de CarregamentoCaracter5GetConsidera Retorno p/ FilialCaracter1ComboSimNãoQtd Maxima CarregamentosNumerico3GetQtd Maxima DescarregamentosNumerico3GetKM Maxima CarregamentosNumerico4GetKM Maxima DescarregamentosNumerico4GetTempo Mínimo ServiçoCaracter5GetTempo Máximo ServiçoCaracter5Get Totvs custom tabs box items

default	yes
referencia	SX2

Tabela

Descrição

DMR

Roteirização - TPR

DMS

Itens Roteirização - TPR

Totvs custom tabs box items

default	no
referencia	SX3

Tabela DLU - Controle Integração Roteirização

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)

Informe a URL da Geolocalização Campo DLV_

ROTERI

URLROT Tipo Caractere Tamanho

18

254 Decimal 0 Formato @! Título

Roteirizador

URL Roteriza Descrição

Roteirizador

URL da Roteirização 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;

Informe a URL da Geolocalização

2=Planejamento Rotas (TPR)

Campo DLV_

TOKEN

URLTK Tipo Caractere Tamanho 254

Campo

DLV_URLCAL

Tipo

Caractere

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

Tamanho

80

Campo DLV_

URLGEO

TMPEXP Tipo Caractere Tamanho

254

5 Decimal 0 Formato

@!

@R 999:99 Título

URL Geocode

Tempo Exp. Descrição

URL da Geolocalização

Tempo de Expiração Usado Sim Obrigatório Não Browse Não Opções When TMSAC20Whe() Relação Val. Sistema

TMSAC20Vld() Help Tempo de expiração para o cancelamento automático das Roteirizações Pendentes.                      O cancelamento será efetuado considerando a Data de Envio da Roteirização (DLU_DATENV e DLU_HORENV

Help

Informe a URL da Geolocalização

Campo DLV_

URLROT

ROTA Tipo Caractere Tamanho

254

6 Decimal 0 Formato @! Título

URL Roteriza

Rota Descrição

URL da Roteirização

Rota de Entrega Usado Sim Obrigatório Não Browse Não Opções When TMSAC20Whe() Relação Val. Sistema

Vazio() .Or. TMSAC20Vld() Help Informe uma Rota do Tipo de Transporte Rodoviário e Serviço de Transporte de Entrega, que será utilizado na geração da Programação de Carregamento.

Help

Informe a URL da Geolocalização

Campo DLV_

URLTK

DESROT Tipo Caractere Tamanho

254

30 Decimal 0 Formato @! Título

URL Token

Praça Princ. Descrição

URL Token

Praça Principal Usado Sim Obrigatório Não Browse Não Opções When

Relação IF(!INCLUI,POSICIONE("DA8",1,XFILIAL("DA8")+DLV->DLV_ROTA,"DA8_DESC"),"")

Relação

Val. Sistema Help

Informe

Indica a

URL

Praça Principal da

Geolocalização

Rota 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. 3-Processado - Documento processado no TPR com sucesso. 4- Falha no Processamento - Ocorreu uma falha de processamento do Documento no Protheus. 5- Cancelado 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 abaixo consta no pacote de dicionários 009560 - SIGAOMS Campo DA3_VELOC Tipo Numérico Tamanho 6 Decimal 0 Formato @E 999,999 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 Totvs custom tabs box items default no referencia SIX Criação de índices: DMR Índice Ordem Chave Descrição DMR 1 DMR_FILIAL+DMR_FILROT+DMR_IDROT Fil.Roteir. + Id.Roteir. DMS Índice Ordem Chave Descrição DMS 1 DMS_FILIAL+DMS_FILROT+DMS_IDROT+DMS_ITEM Fil.Roteir. + Id.Roteir. + Item DMS 2 DMS_FILIAL+DMS_ENTIDA+DMS_CHVENT+DMS_STATUS+DMS_FILROT+DMS_IDROT Entidade + Chave Entid + Status + Fil.Roteir. + Id.Roteir. DMS 3 DMS_FILIAL+DMS_ENTEXT+DMS_CHVEXT Ent.Chv.Ext + Chave Externa DMS 4 DMS_FILIAL+DMS_FILROT+DMS_IDROT+DMS_CHVENT+DMS_ENTIDA Fil.Roteir. + Id.Roteir. + Chave Entid + Entidade

05. ASSUNTOS RELACIONADOS

• Integração TMS x Totvs Planejamento de Rotas - TPR (Integrações - SIGATMS)
• https://tdn.totvs.com/display/public/VRPTW/TOTVS+Planejamento+de+Rotas
• 1. Configuração do REST do Protheus
• Configurar Portais e Webservices
• Planejamento de Rotas (SIGATMS)

<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;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>