Árvore de páginas

Versões comparadas

Chave

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

...


Configuração Planejamento de Rotas (TMSAC20)
Esse cadastro será utilizado para a configuração do Planejamento de Rotas, onde será necessário informar os campos:

URL Roteiriza (DLV_ROTEIRI)  - HTTPS://TPR-SERVICE-JXX2HXKO4A-UE.A.RUN.APP/V1/TPR-ROUTING  
URL Geocode (DLV_URLGEO) - HTTPS://TPR-SYNC-ADAPTER-JXX2HXKO4A-UE.A.RUN.APP/V1/TPR-GEOLOCATION-SYNC
URL Token (DLV_URLTK)  - HTTPS://TPR-PAYWALL-TOKEN-JXX2HXKO4A-UE.A.RUN.APP/TOKEN-INTEGRATION/V1/TPR-TOKEN-CREATION
URL CallBack (DLV_URLCAL)  - HTTP://localhost.Porta/REST/V1/WSTPRNEOLOG  
URL Mapa (DLV_URLMAP) - http://localhost:Porta/ws/index.html
Authorization (DLV_AUTH) - Token de acesso no Google Cloud Platform
Roteirizador (DLV_ROTERI) - 2
Tipo Retorno (DLV_TIPRET) - 1

Cadastro de Clientes / Solicitantes



Programação de Carregamento (TMSA146)
A integração com do SIGATMS com o Planejamento de Rotas, ocorrerá a partir da rotina de Programação de Carregamento, através da opção 'Integra TPR'. 
- Ao clicar nessa opção, será enviado para o Planejamento de Rotas (TPR) os Documentos selecionados (Notas Cliente, CTe, Solicitação de Coleta) e todos os veículos ativos (DA3). 
- Será    Para controle dos documentos enviados à roteirização, os dados serão armazenados nas Tabela DMR/DMS, onde será gerado um Identificador da Roteirização (DMR_IDROT) e os documentos enviados serão armazenados gravados na Tabela DMS DMR com status 1- Pendente .
O (DMR_STATUS)

- Após o Sistema Planejamento de Rotas TPR receberá receber as informações e efetuará efetuar o processamento para roteirização.A TPR processando a Roteirização, enviará o resultado ao ProtheusSIGATMS, através do CallBack de Roteirização. O  
   O SIGATMS automaticamente receberá os dados e armazenará o arquivo de retorno (json) na Tabela DLU (DLU_RETORN) e em seguida irá criar a Programação de Carregamento com base nos documentos e veículo roteirizados.
Após gerado
- Gerado a programação Programação de carregamentoCarregamento, o usuário deverá acessar a rotina de Programação geradade Carregamento, posicionar na em modo alteração, e informar a Rota, Cavalo (se houver), e o Motorista (caso não estiver vinculado ao cadastro do veículo).

- Ao efetivar a programação de carregamento, será gerado a viagem (processo padrão), e havendo um valor de pedágio (tollValue) no arquivo de retorno (json), calculado pela TPR, o valor será gravado no Complemento da Viagem (DTR_VALPDG).



...

  • Para uso desta funcionalidade, deve ser utilizado:

    • Pacote: 009506 - Para atualização de dicionário de dados, criação/alteração  de campos e índices.

    • Documentação Planejamento de Rotas (TPR)
      Token -
       Instalação, configuração e geração do token de acesso no Google Cloud Platform, que é necessário enviar no header para ter acesso aos serviços no Google Cloud Platform - TDN:  https://tdn.totvs.com/x/_1zOJQ

      Integração Planejamento de Rotas - Integrações Planejamento de Rotas
      Geolocalização - Integração de Geolocalização
      Roteirização - Integração de roteirização


      DETALHAMENTO DA ATUALIZAÇÃO DE DICIONÁRIO CONFORME ABAS


      Totvs custom tabs box
      tabsDicionário SX2, Dicionário SX3, Dicionário SIX
      idsSX2,SX3,SIX
      Totvs custom tabs box items
      defaultyes
      referenciaSX2

      Tabela

      Descrição

      DMR

      Roteirização - TPR

      DMS

      Itens Roteirização - TPR

      Totvs custom tabs box items
      defaultno
      referenciaSX3


      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


      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

      When


      Relação

      '1'

      Val. Sistema

      Pertence('12')

      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("1234")

      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.

      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

      Totvs custom tabs box items
      defaultno
      referenciaSIX

      Criação de índices:

      DMR

      Índice

      Ordem

      ChaveDescrição
      DMR1DMR_FILIAL+DMR_FILROT+DMR_IDROTFil.Roteir. + Id.Roteir.


      DMS

      Índice

      Ordem

      ChaveDescrição
      DMS1DMS_FILIAL+DMS_FILROT+DMS_IDROT+DMS_ITEMFil.Roteir. + Id.Roteir. + Item
      DMS2DMS_FILIAL+DMS_ENTIDA+DMS_CHVENT+DMS_STATUS+DMS_FILROT+DMS_IDROTEntidade + Chave Entid + Status + Fil.Roteir. + Id.Roteir.
      DMS3DMS_FILIAL+DMS_ENTEXT+DMS_CHVEXTEnt.Chv.Ext + Chave Externa
      DMS4DMS_FILIAL+DMS_FILROT+DMS_IDROT+DMS_CHVENT+DMS_ENTIDAFil.Roteir. + Id.Roteir. + Chave Entid + Entidade

...