Config. Planejamento de Rotas (TMSAC20 - SIGATMS)

CONTEÚDO

IMPORTANTE

A integração TOTVS TMS x TOTVS Planejamento de Rotas (TPR) será descontinuada no próximo release (Outubro/2023).

01. VISÃO GERAL

A funcionalidade Configurador Planejamento de Rotas é a rotina principal para realizar o cadastro e habilitar a integração Totvs Planejamento de Rotas (TPR).
Nessa funcionalidade, deverão ser informadas as chaves de acesso disponibilizadas e também os endereços virtuais (IP) referente a integração.
A rotina irá armazenar as informações referentes ao Totvs Planejamento de Rotas na tabela DLV - Cadastro Roteirizador e será possível incluir/alterar/deletar as informações.

02. EXEMPLO DE UTILIZAÇÃO

Acesse Atualizações → Planejamento de Rotas → Config. Planejamento de Rotas (TMSAC20) ;
Clique no botão INCLUIR;
Informe os campos abaixo:
a. URL Callback: Informar o IP e Porta externa do servidor Rest do Protheus (IP:PORTA + /REST/V1/WSTPRNEOLOG/) para utilização no recebimento dos retornos do Totvs Planejamento de Rotas (TPR) ref. a Roteirização;
b. Bloqueado: Informar 2 - Não;
c. Tipo Retorno: Informar 1- Callback;
d. URL Mapa HTML: Informar o IP e Porta externa do servidor web-service do Protheus (IP:PORTA + /ws/index.html) para utilização no serviço de Mapa do Totvs Planejamento de Rotas (TPR);
e. Roteirizador: Informar 2 - TPR Neolog;
f. URL Token: URL disponibilizada pelo TPR para controle do Token do Totvs Planejamento de Rotas (TPR);
g. URL Roteirização: URL disponibilizada pelo TPR para controle dos serviços de Roteirização do Totvs Planejamento de Rotas (TPR);
h. URL Geocode: URL disponibilizada pelo TPR para controle dos serviços de Geolocalização do Totvs Planejamento de Rotas (TPR);
i. Tempo Exp. : Informe o prazo em horas para que o Totvs Logística Tms Protheus execute a limpeza das Roteirizações pendentes de resposta doTotvs Planejamento de Rotas (TPR).
j. Rota: Informe Rota do serviço de Entrega, cuja região da rota seja igual ao do parâmetro MV_CDRORI (Cidade TMS da Filial em questão). Somente será permitido inserir uma rota com estas características

Exemplo de preenchimento dos campos conforme campos destacados no passo 3 deste Exemplo.
Nota: Os campos Token, Data Token e Hora Token, serão preenchidos automaticamente pelo retorno do Totvs Planejamento de Rotas (TPR)
Confirme a inclusão;
Após realizada a inclusão do registro, clique em Outras Ações → Testar Conexão para obter os dados do Token do Totvs Planejamento de Rotas (TPR) para acesso as funcionalidades de Geolocalização, Roteirização e Plotagem do Mapa.
Para geração do token, é necessário que o Totvs Logistica TMS Protheus já possua as configurações abaixo:
- Ambiente com dicionário de dados atualizado conforme DT DLOGTMS02-17080 Integração SIGATMS x Planejamento de Rotas (TPR)
- Serviço Rest configurado para receber o Callback por parte do Totvs Planejamento de Rotas - TPR;
- Webservice configurado para receber o retorno do Mapa Totvs Planejamento de Rotas - TPR;
- URLS fornecidas pelo sistema Totvs Planejamento de Rotas - TPR deverão ser relacionadas nos campos em questão;
- Parâmetro MV_ROTAINT=.T.

03. BOTÕES TELA PRINCIPAL

Ação	Descrição
INCLUIR	Inclui um registro na rotina
ALTERAR	Altera um registro já existente
Planos TPR	Atalho do sistema que leva o usuário a selecionar um Plano TPR, caso ainda não possua, ou precise renovar o token diretamente pela Totvs Store

Tela Outras Ações

Ação	Descrição
EXCLUIR	Exclui um registro na rotina
Testar Conexão	Realiza o teste de comunicação
Visualizar	Visualiza um registro já existente

04. TELA INCLUIR/ALTERAR

Principais Campos e Parâmetros

Campo	Descrição
Url Callback	Defina a URL utilizada como retorno da API. A URL deverá ser aonde contém o webservice que ficará aguardando o retorno das requisições do Roteirizador.
Token	O token será preenchido automaticamente.
Data Token	A data do token será preenchida automaticamente
Hora Token	O horário do token será preenchido automaticamente.
Tipo Retorno	Esse campo define o tipo de retorno do roteirizador: 1 - Callback - O retorno ocorrerá no WebService criado e o processo irá prosseguir normalmente, para isso ocorrer o webservice Rest deverá estar corretamente configurado. 2 - Aguarda processamento = O SIGATMS irá aguardar o término do processamento do Roteirizador em tela.
URL Mapa Htm	Nesse campo deve ser informado a URL em que o webservice e o arquivo HTML se encontra. Para o correto funcionamento, o arquivo html deve estar na pasta correta e os webservices devidamente configurados.
Authorizatio	Nesse campo deve ser informado a chave do Planejamento de Rotas (TPR)
Roteirizador	Define o tipo de integração: 2=Planejamento Rotas (TPR)
URL Token	Informe a URL do Token (fornecido pelo TPR)
URL Roteiriza	Informe a URL da Roteirização (fornecido pelo TPR)
URL Geocode	Informe a URL da Geolocalização (fornecido pelo TPR)
Tempo Exp.	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)
Rota	Informe a Rota do serviço de entrega que será utilizada para preencher automaticamente na criação da programação de carregamento automática gerado pelo retorno do TPR.

Parâmetros

Parâmetro	Tipo	Conteúdo
MV_ROTAINT	Lógico	.T.

05. TABELAS UTILIZADAS

DLV - Cadastro de Roteirizador
DA8 - Cadastro de Rotas

Árvore de páginas