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

TMSAO48´RW 

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

18527 (Epic)


02. SITUAÇÃO/REQUISITO

Implementar nova funcionalidade de integração do SIGATMS x A fim de otimizar e reduzir custos das operações de transporte, o módulo Totvs Logística TMS (SIGATMS) integrará com a solução logística de roteirização de carga fornecida pelo Totvs Planejamento de Rotas (TPR - Neolog) para o planejamento de roteiros de entrega), agregando inteligência e otimizando o processo de entregas e coletas dentro do SIGATMS, fazendo com que as coletas/entregas tenham uma melhor disposição e ordem, e dessa maneira além de reduzir o tempo de operação também se reduz custos dentro da operação de transporte.


03. SOLUÇÃO

...

Para atender a solução, foram necessárias novas rotinas para controlar a configuração e gestão das informações entre os sistemas. 
No Totvs Logística TMS (SIGATMS) foram necessárias as ações abaixo:

Criado novo Submenu
- 'Atualizações -> Planejamento de Rotas', onde estarão as novas rotinas:

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

    deve ser utilizado:

    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 .
      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/_1zOJQdo módulo SIGATMS;
    • Pacote: 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


    Nome de usuário Repom
    Totvs custom tabs box
    tabsDicionário SX2, Dicionário SX3, Dicionário SIX, Dicionário SX1
    idsDicionário SX2,SX3, Dicionário SIX,SX1
    Totvs custom tabs box items
    defaultno
    referenciaSX1

    Grupo- TMSA146TPR

    Pergunta

    yes
    referenciasx3
    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

    DEG_USER
    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



    Campo

    DLV_TMPEXP

    Tipo

    Caractere

    Tamanho

    5

    Decimal

    0

    Formato

    @R 999:99

    Título

    Tempo Exp.

    Descrição

    Tempo de Expiração

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Opções


    When

    TMSAC20Whe()

    Relação


    Val. Sistema

    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

    Campo

    DLV_ROTA

    Tabela DEG (Operadora de Frotas):

    Campo

    Tipo

    Caractere

    Tamanho

    45

    6

    Decimal

    0

    Formato

    @!

    Título

    Nome Usuário

    Descrição

    Rota

    Descrição

    Rota de Entrega

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Opções


    When

    TMSAC20Whe()

    Relação


    Val. Sistema

    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_DESROT

Tipo

Caractere

Tamanho

30

Decimal

0

Formato

@!

Título

Praça Princ.

Descrição

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

Indica a Praça Principal da 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

M->DEG_CODOPE == "01"


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

Nome de usuário utilizado para autenticação no sistema de comunicação REST da REPOM.

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

05. ASSUNTOS RELACIONADOS


Templatedocumentos


HTML
<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>