Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

CONTEÚDO

Índice

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

  1. Acesse Atualizações → Planejamento de Rotas → Config. Planejamento de Rotas (TMSAC20) ;
  2. Clique no botão INCLUIR;
  3. Informe os campos abaixo:

    a. URL Callback: Informar o IP e Porta externa do servidor do Protheus + /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 do Protheus + /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;
    g. URL Token: URL disponibilizada pelo TPR para controle do Token do Totvs Planejamento de Rotas (TPR);
    h. URL Roteirização: URL disponibilizada pelo TPR para controle dos serviços de Roteirização do Totvs Planejamento de Rotas (TPR);
    i. URL Geocode: URL disponibilizada pelo TPR para controle dos serviços de Geolocalização do Totvs Planejamento de Rotas (TPR);
    j. Tempo Exp. : Informe o prazo em horas para que o Totvs Logistica Tms Protheus execute a limpeza das Roteirizações pendentes de resposta do Totvs Planejamento de Rotas (TPR). 



    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)

  4. Confirme a inclusão;
  5. Após realizada a inclusão do registro, clique em Outras Ações → Testar Conexão para obter os dados do Token TPR para acesso.

    Aviso

    Para geração do token, é necessário que o Totvs Logistica TMS Protheus já possua as configurações abaixo:

03. BOTÕES TELA PRINCIPAL

AçãoDescrição
INCLUIRInclui um registro na rotina
ALTERARAltera um registro já existente
VISUALIZARVisualiza um registro já existente

Tela Outras Ações

AçãoDescrição
EXCLUIRExclui um registro na rotina
Testar ConexãoRealiza o teste de comunicação

04. TELA INCLUIR/ALTERAR

Principais Campos e Parâmetros

CampoDescrição
Url CallbackDefina 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)



Parâmetros

ParâmetroTipoConteúdo
MV_ROTAINTLógico.T.


05. TABELAS UTILIZADAS

  • DLV - Cadastro de Roteirizador