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 (SIGATMS) integrará com a solução logística de roteirização de carga fornecida pelo Planejamento de Rotas (TPR), agregando inteligência e otimizando o processo de entregas e coletas dentro do SIGATMS. 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.

...

02. SITUAÇÃO/REQUISITO

A fim de otimizar e reduzir custos das operações de transporte, o módulo 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 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.

03. SOLUÇÃO

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

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.
  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
  ids	SX2,SX3,SIX

  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

  DLV- Cadastro Roteirizador

  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.

  Informe a URL da Geolocalização

  Campo DLV_

  AUTH

  URLTK Tipo Caractere Tamanho

  50

  254 Decimal 0 Formato @! Título

  Authorizatio

  URL Token Descrição

  Chave de Autorização

  URL Token Usado Sim Obrigatório

  Sim

  Não 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

  TMPEXP Tipo Caractere Tamanho

  18

  5 Decimal 0 Formato

  @!

  @R 999:99 Título

  Roteirizador

  Tempo Exp. Descrição

  Roteirizador

  Tempo de Expiraçã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;

  2=Planejamento Rotas (TPR)

  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

  Campo

  DLV_TOKEN

  Tipo

  Caractere

  Tamanho

  254

  Campo

  DLV_URLCAL

  Tipo

  Caractere

  Tamanho

  80

  Campo DLV_

  URLGEO

  ROTA Tipo Caractere Tamanho

  254

  6 Decimal 0 Formato @! Título

  URL Geocode

  Rota Descrição

  URL da Geolocalização

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

  Help

  Informe a URL da Geolocalização

  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. Campo DLV_

  URLROT

  DESROT Tipo Caractere Tamanho

  254

  30 Decimal 0 Formato @! Título

  URL Roteriza

  Praça Princ. Descrição

  URL da Roteirização

  Praça Principal Usado Sim Obrigatório

  Não

  Browse

  Não

  Opções

  When

  Relação

  Não Browse Não Opções When Relação IF(!INCLUI,POSICIONE("DA8",1,XFILIAL("DA8")+DLV->DLV_ROTA,"DA8_DESC"),"")

  Val. Sistema Help

  Informe

  Indica a

  URL da Geolocalização

  Praça Principal da Rota DMR - Roteirização TPR Campo

  DLV

  DMR_

  URLTK

  FILIAL Tipo Caractere Tamanho

  254

  2 Decimal 0 Formato @! Título

  URL Token

  Filial Descrição

  URL Token

  Filial do Sistema Usado

  Sim

  Não Obrigatório

  Não

  Browse

  Não

  Sim Opções When Relação Val. Sistema Help

  Informe a URL da Geolocalização

  DMR - Roteirização TPR

  Indica a Filial do Sistema Campo DMR_

  FILIAL

  FILROT Tipo Caractere Tamanho 2 Decimal 0 Formato @! Título

  Filial

  Fil. Roteir. Descrição Filial

  do Sistema

  Roteirização Usado

  Não

  Sim Obrigatório Sim Browse Sim Opções When Relação Val. Sistema Help

  Indica a

  Filial do

  Sistema

  Identificador da Roteirização Campo DMR_

  FILROT

  IDROT Tipo Caractere Tamanho

  2

  9 Decimal 0 Formato @! Título

  Fil

  Id.Roteir. Descrição

  Filial

  Id. Roteirização Usado Sim Obrigatório Sim Browse Sim Opções When Relação GetSx8Num("DMR","DMR_IDROT") Val. Sistema Help

  Filial do

  Identificador da Roteirização da Integração com o Planejamento de Rotas (TPR) Campo DMR_

  IDROT

  STATUS Tipo Caractere Tamanho

  9

  1 Decimal 0 Formato

  @!

  Título

  Id.Roteir.

  Status Descrição

  Id. Roteirização

  Status Usado Sim Obrigatório Sim Browse

  Sim

  Não Opções 1=Pendente;2=Processado;3=Cancelado When Relação

  GetSx8Num("DMR","DMR_IDROT")

  '1' Val. Sistema Pertence('123') Help

  Identificador

  Status da Roteirização da Integração com o Planejamento de

  Rotas (TPR)

  Rotas (TPR) DMS - Itens Roteirização TPR Campo

  DMR

  DMS_

  STATUS

  FILIAL Tipo Caractere Tamanho

  1

  2 Decimal 0 Formato @! Título

  Status

  Filial Descrição

  Status

  Filial do Sistema Usado

  Sim

  Não Obrigatório

  Sim

  Browse

  Não

  Sim 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)

  When Relação Val. Sistema Help Indica a Filial do Sistema

  DMS - Itens Roteirização TPR

  Campo DMS_

  FILIAL

  FILROT Tipo Caractere Tamanho 2 Decimal 0 Formato @! Título

  Filial

  Fil.Roteir. Descrição Filial

  do Sistema

  Roteirização Usado Não Obrigatório Browse Sim Opções When Relação Val. Sistema Help

  Indica a

  Filial do

  Sistema

  Identificador da Roteirização Campo DMS_

  FILROT

  IDROT Tipo Caractere Tamanho

  2

  9 Decimal 0 Formato @! Título

  Fil

  Id.Roteir. Descrição

  Filial

  Id. Roteirização Usado Não Obrigatório Browse

  Sim

  Opções When Relação Val. Sistema Help

  Filial do Identificador da Roteirização

  Identificador da Roteirização da Integração com o Planejamento de Rotas (TPR) Campo DMS_

  IDROT

  ITEM Tipo Caractere Tamanho

  9

  6 Decimal 0 Formato @! Título

  Id.Roteir.

  Item Descrição

  Id. Roteirização

  Item Usado

  Não

  Sim Obrigatório Sim Browse Sim Opções When Relação Val. Sistema Help

  Identificador da Roteirização da Integração com o Planejamento de Rotas (TPR)

  Identifica o item da roteirização Campo DMS_

  ITEM

  ENTIDA Tipo Caractere Tamanho

  6

  3 Decimal 0 Formato @! Título

  Item

  Entidade Descrição

  Item

  Entidade Usado Sim Obrigatório

  Sim

  Não Browse Sim Opções When Relação Val. Sistema Help

  Identifica o item da roteirização

  Indica a Entidade do Documento. Campo DMS_

  ENTIDA

  INDENT Tipo Caractere Tamanho

  3

  1 Decimal 0 Formato @! Título

  Entidade

  Indice Entid. Descrição Indice Entidade Usado Sim Obrigatório Não Browse Sim Opções When Relação Val. Sistema Help Indica

  a Entidade do Documento.

  o Indice da Entidade a ser utilizado para a pesquisa da Chave da Entidade  Campo DMS_

  INDENT

  CHVENT Tipo Caractere Tamanho

  1

  200 Decimal 0 Formato @! Título

  Indice

  Chave Entid. Descrição

  Indice

  Chave 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 

  Chave que contem os dados do Documento integrados ao Planejamento de Rotas (TPR) Campo DMS_

  CHVENT

  INDEXT Tipo Caractere Tamanho

  200

  1 Decimal 0 Formato @! Título

  Chave Entid

  Ind.Chv.Ext Descrição Indice Chave

  Entidade

  Externa 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)

  Indica o Indice da Entidade a ser utilizado para a pesquisa da Chave Externa Campo DMS_

  INDEXT

  ENTEXT Tipo Caractere Tamanho

  1

  3 Decimal 0 Formato @! Título

  Ind

  Ent.Chv.Ext Descrição

  Indice

  Entidade 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

  a Entidade da Chave Externa Campo DMS_

  ENTEXT

  CHVEXT Tipo Caractere Tamanho

  3

  30 Decimal 0 Formato @! Título

  Ent.

  Chv.

  Ext

  Externa Descrição

  Entidade

  Chave Externa Usado Sim Obrigatório Não

  Browse

  Sim

  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)

  Opções

  When

  Relação

  Val. Sistema

  Help

  Indica a Entidade da Chave Externa

  Campo DMS_

  CHVEXT

  STATUS Tipo Caractere Tamanho

  30

  1 Decimal 0 Formato @! Título

  Chv. Externa

  Status Descrição

  Chave Externa

  Status Usado Sim Obrigatório

  Não

  Sim Browse

  Sim

  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)

  Não Opções 1=Pendente;2=Rejeitado;3=Processado;4=Falha no Processamento When Relação '1' Val. Sistema

  Help

  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_

  STATUS

  MSGERR Tipo

  Caractere

  Memo Tamanho

  1

  50 Decimal 0 Formato

  @!

  Título

  Status

  Msg. Erro Descrição

  Status

  Mensagem Erro Usado Sim Obrigatório

  Sim

  Browse Não Opções

  1=Pendente;2=Rejeitado;3=Processado;4=Falha no Processamento

  When

  Relação

  '1'

  Relação 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.

  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

  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 @E 999,999 Título

  Msg. Erro

  Veloc Máxima Descrição

  Mensagem Erro

  Velocidade Máxima Usado Sim Obrigatório Não Browse Não Opções When Relação Val. Sistema Help

  Mensagem de erro recebida pelo Roteirizador do referido documento

  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>