Árvore de páginas

Versões comparadas

Chave

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

...

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 
TMSA141.PRW    - Viagem
TMSA144.PRW    - Viagem Modelo 2
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)
TMSA146C.PRW  - Programação de Carregamento x Planejamento de Rotas (Alteração Veiculo)
TMSA153H.PRW - Função genérica
TMSA210.PRW    - Carregamento de Transporte
TMSA310.PRW    - Fechamento da Viagem
TMSA440.PRW    - Cadastro de Solicitante
TMSA450.PRW    - Endereço Solicitante e Cliente
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   - Montagem e visualização do Mapa
TMSAF60.PRW    - Viagem Modelo 3
TMSAF62.PRW    - Validação Viagem Modelo 3
TMSAF68.PRW    - Menu Viagem Modelo 3
TMSAO15.PRW   - Cadastro Referencia Geográfica
TMSAO48.PRW     - Integração Rota Inteligente
TMSAO52.PRW   - Cadastro Roteirizador Rota Inteligente
TMSO46API.PRW - Métodos CallBack Planejamento de Rotas
TMSXFUND.PRW - Função genérica 

index.html - Mapa TPR
tprchannel.js - Mapa TPR

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


DLOGTMS02-17080 (Epic)
DLOGTMS02-18527 (Epic)


...

  • Config. Planejamento de Rotas (TMSAC20);
    Rotina principal para realizar o cadastro e habilitar a integração Totvs Planejamento de Rotas (TPR). 

  • Controle de Integração Planejamento de Rotas (TMSAC23);
    Rotina que armazenará as informações enviadas e recebidas. Toda a integração é enviado um arquivo no formato JSON e esse arquivo é armazenado na tabela DLU - Controle Integração Roteirizador.

  • Painel Planejamento de Rotas (TMSAC19);
    Rotina que armazenará as informações referentes ao envio de informações para a integração Totvs Planejamento de Rotas (TPR).

04. DEMAIS INFORMAÇÕES

Informações

Prezado cliente, esta Integração fica disponível de forma nativa somente no Release 12.1.2210 do Protheus conforme Ciclo de Vida de Software - TOTVS Linha Protheus
Caso tenha interesse em adquirir esta solução nas Release 12.1.27 ou 12.1.33 do Protheus, por gentileza entre em contato com nosso suporte solicitando as informações a seguir


  • Para uso desta funcionalidade, se faz necessária atualização do Protheus, de acordo com as informações abaixo:

    Para uso desta funcionalidade, se faz necessária atualização do Protheus, de acordo com as informações abaixo:
            UPDDISTR

    • Pacote: 009506 009506  - Para atualização de dicionário de dados, criação/alteração  de campos e índices do módulo SIGATMS;
    • Pacote: 009560 009880 - Para atualização de dicionário de dados, criação/alteração  de campos e índices do módulo SIGATMS;
    • Pacote: 009560 - Para atualização de dicionário de dados, criação/alteração  de campos e índices do módulo SIGAOMS;
    • Pacote: 010930 - Atualização das características do campo DLV_TOKEN  do módulo SIGATMS;

      MENU
    • Atualização do menu sigatms.xnu.

    • PROGRAMAS
      Atualizar o Repositório de objetos do Protheus (RPO) de acordo com a relação de programas relacionados nesta documentação. 

      PARÂMETRO
    • Habilite o parâmetro MV_ROTAINT;

    • CONFIGURAÇÕES REST E WEB SERVICE
      Necessário o ambiente possuir configurações Rest e WebService, de modo a definir os endereços de recebimento dos dados entre os sistemas na nova rotina  Config. Planejamento de Rotas (TMSAC20 - SIGATMS)

    • ARQUIVOS PARA PLOTAGEM DO MAPA
      Instalar os arquivos index.html tprchanenl.js na pasta Web/Ws do Protheus, disponível no link.


Informações
titleDados fornecidos pelo Totvs Planejamento de Rotas

...

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


    SX2,SX3,SIX,SX1

    DLV- Cadastro Roteirizador

    totvs-custom-tabs-box-tabs-box
    tabsDicionário SX2, Dicionário SX3, Dicionário SIX, Dicionário SX1
    idsSX2,SX3,SIX,SX1
    Totvs custom tabs box items
    defaultno
    referenciaSX1

    Grupo- TMSA146TPR

    Pergunta

    TipoTamanhoModoDefinição1Definição2

    Definição3

    Criterio da Capacidade

    Caracter1ComboPesoVolume

    Ambos

    Planejamento paraCaracter1ComboAgoraD+1
    Horario de CarregamentoCaracter5Get


    Considera Retorno p/ FilialCaracter1ComboSimNão
    Qtd Maxima CarregamentosNumerico3Get


    Qtd Maxima DescarregamentosNumerico3Get


    KM Maxima CarregamentosNumerico4Get


    KM Maxima DescarregamentosNumerico4Get


    Tempo Mínimo ServiçoCaracter5Get


    Tempo Máximo ServiçoCaracter5Get


    Totvs custom tabs box items
    defaultyes
    referenciaSX2

    Tabela

    Descrição

    DMR

    Roteirização - TPR

    DMS

    Itens Roteirização - TPR

    tabsDicionário SX2, Dicionário SX3, Dicionário SIX, Dicionário SX1
    ids

    Definição2
    Totvs custom tabs box items
    defaultno
    referenciaSX1SX3


    Tabela DLU - Controle Integração Roteirização

    Campo

    DLU_RETENV

    Grupo- TMSA146TPR

    Pergunta

    Tipo

    Memo

    Tamanho

    Modo

    50

    Definição1

    Decimal

    Definição3

    0

    Criterio da Capacidade

    Formato

    Caracter

    Título

    1

    Retorno Post

    ComboPesoVolume

    Ambos

    Planejamento paraCaracter1ComboAgoraD+1Horario de CarregamentoCaracter5GetConsidera Retorno p/ FilialCaracter1ComboSimNãoQtd Maxima CarregamentosNumerico3GetQtd Maxima DescarregamentosNumerico3GetKM Maxima CarregamentosNumerico4GetKM Maxima DescarregamentosNumerico4GetTempo Mínimo ServiçoCaracter5GetTempo Máximo ServiçoCaracter5Get
    Totvs custom tabs box items
    defaultyes
    referenciaSX2

    Tabela

    Descrição

    DMR

    Roteirização - TPR

    DMS

    Itens Roteirização - TPR

    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

    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.

    Campo

    DLV_AUTH

    Tipo

    Caractere

    Tamanho

    50254

    Decimal

    0

    Formato

    @!

    TítuloAuthorizatio

    URL Geocode

    DescriçãoChave de Autorização

    URL da Geolocalização

    Usado

    Sim

    Obrigatório

    SimNão

    Browse

    Não

    Opções


    When


    Relação


    Val. Sistema


    Help

    Nesse campo deve ser informado a chave do Planejamento de Rotas (TPR)Informe a URL da Geolocalização



Campo

DLV_ROTERIURLROT

Tipo

Caractere

Tamanho

18254

Decimal

0

Formato

@!

TítuloRoteirizador

URL Roteriza

DescriçãoRoteirizador

URL da Roteirização

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

Informe a URL da Geolocalização

Help

Define o tipo de integração:

1=Maplink;

2=Planejamento Rotas (TPR)



Campo

DLV_TOKENURLTK

Tipo

Caractere

Tamanho

254

Campo

DLV_URLCAL

Tipo

Caractere

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

Tamanho

80



Campo

DLV_

URLGEO

TMPEXP

Tipo

Caractere

Tamanho

254

5

Decimal

0

Formato

@!
@R 999:99

Título

URL Geocode

Tempo Exp.

Descrição

URL da Geolocalização

Tempo de Expiração

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When

TMSAC20Whe()

Relação


Val. Sistema

Help

Informe a URL

TMSAC20Vld()

Help

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

da Geolocalização

Campo

DLV_

URLROT

ROTA

Tipo

Caractere

Tamanho

254

6

Decimal

0

Formato

@!

Título

URL Roteriza

Rota

Descrição

URL da Roteirização

Rota de Entrega

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When

TMSAC20Whe()

Relação


Val. Sistema

Help

Informe a URL da Geolocalização

Vazio() .Or. TMSAC20Vld()

Help

Informe uma Rota do Tipo de Transporte Rodoviário e Serviço de Transporte de Entrega, que será utilizado na geração da Programação de Carregamento.

Campo

DLV_

URLTK

DESROT

Tipo

Caractere

Tamanho

254

30

Decimal

0

Formato

@!

Título

URL Token

Praça Princ.

Descrição

URL Token

Praça Principal

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When


Relação

IF(!INCLUI,POSICIONE("DA8",1,XFILIAL("DA8")+DLV->DLV_ROTA,"DA8_DESC"),"")

Val. Sistema


Help

Informe

Indica a

URL

Praça Principal da

Geolocalização

Rota


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;3=Cancelado

When


Relação

'1'

Val. Sistema

Pertence('123')

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

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.

5- Cancelado



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 do referido documento



Tabela DA3 - Veículos 
** O campo abaixo consta no pacote de dicionários 009560 - SIGAOMS

Campo

DA3_VELOC

Tipo

Numérico

Tamanho

6

Decimal

0

Formato

@E 999,999

Título

Veloc Máxima

Descrição

Velocidade Máxima

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When


Relação


Val. Sistema


Help

Informar a velocidade máxima que o veículo pode percorrer

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

...

...