Árvore de páginas

Versões comparadas

Chave

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


01. DADOS GERAIS

Produto:

Solucoes_totvs
SolucaoTOTVS Logística TMS


Linha de Produto:

Linhas_totvs
SegmentoDistribuição
RegionConstrução Projetos
LinhaLinha Protheus

Segmento:

Segmentos_totvs
SegmentoLogística

Módulo:TOTVS Logística TMS
Função:TMSA050.PRW    - Entrada Dc. Cliente 
TMSA146.PRW    - Programação de Carregamento
TMSA146A.PRW  - Programação de Carregamento x Planejamento de Rotas (Envio)
TMSA146B.PRW  - Programação de Carregamento x Planejamento de Rotas (Retorno)
TMSA153H.PRW - Função genérica
TMSA210.PRW    - Carregamento de Transporte
TMSAC18.PRW    - Métodos de Envio - Integração Planejamento de Rotas 
TMSAC19.PRW    - Consulta Planejamento de Rotas 
TMSAC20.PRW    - Configuração Planejamento de Rotas
TMSAC21.PRW   -  Métodos de Retorno - Integração Planejamento de Rotas 
TMSAC23.PRW   - Controle de Integração Planejamento de Rotas 
TMSAC24.PRW   - Montagem e visualização do Mapa
TMSAC25.PRW   - 
TMSAF60.PRW    - Viagem Modelo 3
TMSAF62.PRW    - Validação Viagem Modelo 3
TMSAF68.PRW    - Menu Viagem Modelo 3
TMSAO48´RW     - Integração Rota Inteligente
TMSAO52.PRW   - Cadastro Roteirizador Rota Inteligente
TMSO46API.PRW - Métodos CallBack Planejamento de Rotas
TMSXFUND.PRW - Função genérica 

 Ticket:Não se aplica.
Requisito/Story/Issue (informe o requisito relacionado) :


DLOGTMS02-17080 (Epic)

DLOGTMS02-17292 a DLOGTMS02-17296
DLOGTMS02-17318 a DLOGTMS02-17334
DLOGTMS02-17421 a DLOGTMS02-17433
DLOGTMS02-17290
DLOGTMS02-17291
DLOGTMS02-18100
DLOGTMS02-18342
DLOGTMS02-18407
DLOGTMS02-18408
DLOGTMS02-18414
DLOGTMS02-18415
DLOGTMS02-18417 a DLOGTMS02-18419
DLOGTMS02-18430
DLOGTMS02-18465
DLOGTMS02-18514
DLOGTMS02-18517

02. SITUAÇÃO/REQUISITO

Implementar nova funcionalidade de integração do SIGATMS x Planejamento de Rotas (TPR - Neolog) para o planejamento de roteiros de entrega.

03. SOLUÇÃO

Na rotina de Programação de Carregamento (TMSA146),  na opção 'Integra TPR', com base nos Documentos (Notas Cliente, CTe, Solicitação de Coleta) selecionados, o sistema Planejamento de Rotas TPR receberá as informações e efetuará o processamento para roteirização.

04. DEMAIS INFORMAÇÕES

  • 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.

    • Token - Documentação explicando com instalar, configurar e gerar o 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


      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_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

05. ASSUNTOS RELACIONADOS

...