DT DLOGTMS02-17080 Integração SIGATMS x Planejamento de Rotas (TPR)

01. DADOS GERAIS

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

  
  

  • Dicionário SX2
  • Dicionário SX3
  • Dicionário SIX
  • Dicionário 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

  Tabela	Descrição
  DMR	Roteirização - TPR
  DMS	Itens Roteirização - TPR

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

  
  

  
  

  Campo	DLV_TMPEXP
  Tipo	Caractere
  Tamanho	5
  Decimal	0
  Formato	@R 999:99
  Título	Tempo Exp.
  Descriçã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

  Campo	DLV_ROTA
  Tipo	Caractere
  Tamanho	6
  Decimal	0
  Formato	@!
  Título	Rota
  Descriçã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.

  Campo	DLV_DESROT
  Tipo	Caractere
  Tamanho	30
  Decimal	0
  Formato	@!
  Título	Praça Princ.
  Descrição	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"),"")
  Val. Sistema
  Help	Indica a Praça Principal da 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

  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)