|
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.
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)
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:
|
| 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 |
| 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 |
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. |