Histórico da Página
CONTEÚDO
Índice |
---|
Aviso | ||
---|---|---|
| ||
|
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.
...
- 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: Informar2 - Não;
c. Tipo Retorno: Informar 1- Callback;
d. URL Mapa HTML: Informar o IP e Porta externa do servidor do Protheus 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. Authorization: Informe o Token do Google Cloud gerido por Totvs Planejamento de Rotas (TPR);
f. Roteirizador: Informar 2 - TPR Neolog;
gf. URL URL Token: URL disponibilizada pelo TPR para controle do Token do Totvs Planejamento de Rotas (TPR);
hg. URL Roteirização: URL disponibilizada pelo TPR para controle dos serviços de Roteirização do do Totvs Planejamento de Rotas (TPR);
ih. URL Geocode: URL disponibilizada pelo TPR para controle dos serviços de Geolocalização do do Totvs Planejamento de Rotas (TPR);
ji. Tempo Exp. : Informe o prazo em horas para que o Totvs Logistica Tms 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 TPR para acessoToken do Totvs Planejamento de Rotas (TPR) para acesso as funcionalidades de Geolocalização, Roteirização e Plotagem do Mapa.
Aviso 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.
...
Ação | Descrição | |
---|---|---|
INCLUIR | Inclui um registro na rotina | |
ALTERAR | Altera um registro já existente | VISUALIZAR |
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 Visualiza um registro já existente |
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: |
URL Mapa Htm | Nesse campo deve ser informado a URL em que o webservice e o arquivo HTML se encontra. |
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. |
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. |
...
- DLV - Cadastro de Roteirizador
- DA8 - Cadastro de Rotas