Histórico da Página
01. DADOS GERAIS
Produto: |
| ||||||||
---|---|---|---|---|---|---|---|---|---|
Linha de Produto: |
| ||||||||
Segmento: |
| ||||||||
Módulo: | TOTVS Logística TMS | ||||||||
Função: | TMSA050.PRW - Entrada Dc. Cliente TMSA310.PRW - Métodos de Envio - Integração Planejamento de RotasTMSAC19 Fechamento da Viagem Cadastro de RotasSolicitante TMSA450.PRW - Configuração Planejamento deEndereço Solicitante e Cliente Montagem e visualização do Mapa TMSAO48´RW
index.html - Mapa TPR | ||||||||
Ticket: | Ticket: | Não se aplica. | |||||||
Requisito/Story/Issue (informe o requisito relacionado) : |
|
02. SITUAÇÃO/REQUISITO
...
18527 (Epic) |
02. SITUAÇÃO/REQUISITO
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), 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. |
Para uso desta funcionalidade, se faz necessária atualização do Protheus, de acordo com as informações abaixo:
UPDDISTR- Pacote: 009506 - Para atualização de dicionário de dados, criação/alteração de campos e índices do 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 e tprchanenl.js na pasta Web/Ws do Protheus, disponível no link.
- Pacote: 009506 - Para atualização de dicionário de dados, criação/alteração de campos e índices do módulo SIGATMS;
Informações | ||
---|---|---|
| ||
|
DETALHAMENTO DA ATUALIZAÇÃO DE DICIONÁRIO CONFORME ABAS
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 ABASTotvs custom tabs box tabs Dicionário SX2, Dicionário SX3, Dicionário SIX ids SX2,SX3,SIX Totvs custom tabs box items default yes referencia SX2 Tabela
Descrição
DMR
Roteirização - TPR
DMS
Itens Roteirização - TPR
Totvs custom tabs box items default no referencia SX3 Tabela DLU
Campo
DLU_RETENV
Tipo
Caractere
Tamanho
Decimal
0
Formato
Título
Descrição
Usado
Obrigatório
Browse
Totvs custom tabs box tabs Dicionário SX2, Dicionário SX3, Dicionário SIX, Dicionário SX1 ids SX2,SX3,SIX,SX1 Totvs custom tabs box items default no referencia SX1 Grupo- TMSA146TPR
Pergunta
Tipo Tamanho Modo Definição1 Definição2 Definição3
Criterio da Capacidade
Caracter 1 Combo Peso Volume Ambos
Planejamento para Caracter 1 Combo Agora D+1 Horario de Carregamento Caracter 5 Get Considera Retorno p/ Filial Caracter 1 Combo Sim Não Qtd Maxima Carregamentos Numerico 3 Get Qtd Maxima Descarregamentos Numerico 3 Get KM Maxima Carregamentos Numerico 4 Get KM Maxima Descarregamentos Numerico 4 Get Tempo Mínimo Serviço Caracter 5 Get Tempo Máximo Serviço Caracter 5 Get Totvs custom tabs box items default yes referencia SX2 Tabela
Descrição
DMR
Roteirização - TPR
DMS
Itens Roteirização - TPR
Totvs custom tabs box items default no referencia SX3
Tabela DLU - Controle Integração RoteirizaçãoCampo
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
DLUOpções
When
Relação
Val. Sistema
Help
Informe a URL da Geolocalização
Campo
STATUSDLV_
URLROT
Tipo
Caractere
Tamanho
254
Decimal
0
Formato
@! Título
DescriçãoURL Roteriza
Descrição
URL da Roteirização
Tabela DLVUsado
Sim
Obrigatório
Não
Browse
Não
Opções
When
Relação
Val. Sistema
Help
AUTHInforme a URL da Geolocalização
Campo
DLV_
ROTERIURLTK
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
DescriçãoTempo Exp.
Descrição
Tempo de Expiração
HelpUsado
Sim
Obrigatório
Não
Browse
Não
Opções
When
TMSAC20Whe()
Relação
Val. Sistema
TOKENTMSAC20Vld()
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
Tipo
Caractere
Tamanho
6
Decimal
0
Formato
@! Título
Rota
Descrição
Rota de Entrega
Usado
Sim
Obrigatório
Browse
Opções
When
Relação
Val. Sistema
Help
Campo
DLV_URLGEO
Tipo
Caractere
Tamanho
Decimal
0
Não
Browse
Não
Formato
Título
Descrição
Usado
BrowseObrigatório
URLROTOpçõ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
DescriçãoPraça Princ.
Descrição
Praça Principal
Usado
Sim
Obrigatório
Não
Browse
Não
Opções
When
Relação
Val. Sistema
Help
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
DLV_URLTKCampo
DMR - Roteirização TPRTipo
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
FILIALIndica a Filial do Sistema
Campo
DMR_
FilialFILROT
Tipo
Caractere
Tamanho
2
Decimal
0
Formato
@! Título
do SistemaFil. Roteir.
Descrição
Filial
NãoRoteirização
Usado
Indica aSim
Obrigatório
Sim
Browse
Sim
Opções
When
Relação
Val. Sistema
Help
SistemaFilial do
FILROTIdentificador da Roteirização
Campo
DMR_
2IDROT
Tipo
Caractere
Tamanho
Fil9
Decimal
0
Formato
@! Título
FilialId.Roteir.
Descrição
Filial doId. Roteirização
Usado
Sim
Obrigatório
Sim
Browse
Sim
Opções
When
Relação
GetSx8Num("DMR","DMR_IDROT")
Val. Sistema
Help
IDROTIdentificador da Roteirização da Integração com o Planejamento de Rotas (TPR)
Campo
DMR_
9STATUS
Tipo
Caractere
Tamanho
@!1
Decimal
0
Formato
Id.Roteir.Título
Id. RoteirizaçãoStatus
Descrição
Status
Usado
Sim
Obrigatório
Sim
Browse
Não
Opções
1=Pendente;2=Processado;3=Cancelado
OpçõesSim
GetSx8Num("DMR","DMR_IDROT")When
Relação
Identificador'1'
Val. Sistema
Pertence('123')
Help
DMRStatus da Roteirização da Integração com o Planejamento de Rotas (TPR)
DMS - Itens Roteirização TPR
Campo
STATUSDMS_
1FILIAL
Tipo
Caractere
Tamanho
Status2
Decimal
0
Formato
@! Título
StatusFilial
Descrição
SimFilial do Sistema
Usado
SimNão
Obrigatório
NãoBrowse
Sim
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 TPRHelp
Indica a Filial do Sistema
FILIALCampo
DMS_
FilialFILROT
Tipo
Caractere
Tamanho
2
Decimal
0
Formato
@! Título
do SistemaFil.Roteir.
Descrição
Filial
Indica aRoteirização
Usado
Não
Obrigatório
Browse
Sim
Opções
When
Relação
Val. Sistema
Help
SistemaFilial do
FILROTIdentificador da Roteirização
Campo
DMS_
2IDROT
Tipo
Caractere
Tamanho
Fil9
Decimal
0
Formato
@! Título
FilialId.Roteir.
Descrição
Id. Roteirização
Usado
Não
Obrigatório
Browse
Sim
Filial doOpções
When
Relação
Val. Sistema
Help
IDROTIdentificador da Roteirização da Integração com o Planejamento de Rotas (TPR)
Campo
DMS_
9ITEM
Tipo
Caractere
Tamanho
Id.Roteir.6
Decimal
0
Formato
@! Título
Id. RoteirizaçãoItem
Descrição
NãoItem
Usado
Identificador da Roteirização da Integração com o Planejamento de Rotas (TPR)Sim
Obrigatório
Sim
Browse
Sim
Opções
When
Relação
Val. Sistema
Help
ITEMIdentifica o item da roteirização
Campo
DMS_
6ENTIDA
Tipo
Caractere
Tamanho
Item3
Decimal
0
Formato
@! Título
ItemEntidade
Descrição
SimEntidade
Usado
Sim
Obrigatório
Identifica o item da roteirizaçãoNão
Browse
Sim
Opções
When
Relação
Val. Sistema
Help
ENTIDAIndica a Entidade do Documento.
Campo
DMS_
3INDENT
Tipo
Caractere
Tamanho
Entidade1
Decimal
0
Formato
@! Título
a Entidade do Documento.Indice Entid.
Descrição
Indice Entidade
Usado
Sim
Obrigatório
Não
Browse
Sim
Opções
When
Relação
Val. Sistema
Help
Indica
INDENTo Indice da Entidade a ser utilizado para a pesquisa da Chave da Entidade
Campo
DMS_
1CHVENT
Tipo
Caractere
Tamanho
Indice200
Decimal
0
Formato
@! Título
IndiceChave Entid.
Descrição
Indica o Indice da Entidade a ser utilizado para a pesquisa da Chave da EntidadeChave Entidade
Usado
Sim
Obrigatório
Não
Browse
Sim
Opções
When
Relação
Val. Sistema
Help
CHVENTChave que contem os dados do Documento integrados ao Planejamento de Rotas (TPR)
Campo
DMS_
200INDEXT
Tipo
Caractere
Tamanho
Chave Entid1
Decimal
0
Formato
@! Título
EntidadeInd.Chv.Ext
Descrição
Indice Chave
Chave que contem os dados do Documento integrados ao Planejamento de Rotas (TPR)Externa
Usado
Sim
Obrigatório
Não
Browse
Sim
Opções
When
Relação
Val. Sistema
Help
INDEXTIndica o Indice da Entidade a ser utilizado para a pesquisa da Chave Externa
Campo
DMS_
1ENTEXT
Tipo
Caractere
Tamanho
Ind3
Decimal
0
Formato
@! Título
IndiceEnt.Chv.Ext
Descrição
o Indice da Entidade a ser utilizado para a pesquisaEntidade Chave Externa
Usado
Sim
Obrigatório
Não
Browse
Sim
Opções
When
Relação
Val. Sistema
Help
Indica
ENTEXTa Entidade da Chave Externa
Campo
DMS_
3CHVEXT
Tipo
Caractere
Tamanho
Ent.30
Decimal
0
Formato
@! Título
ExtChv.
EntidadeExterna
Descrição
Chave Externa
Usado
Sim
Obrigatório
Não
Browse
Sim
Opções
When
Relação
Val. Sistema
Help
Indica a Entidade da Chave Externa
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
DMS_CHVEXTCampo
30Tipo
Caractere
Tamanho
Chv. Externa1
Decimal
0
Formato
@! Título
Chave ExternaStatus
Descrição
NãoStatus
Usado
Sim
Obrigatório
SimSim
Browse
Não
Opções
1=Pendente;2=Rejeitado;3=Processado;4=Falha no Processamento
When
Relação
'1'
RelaçãoWhen
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)
registro gerado na Integração Protheus x Planejamento de Rotas (TPR)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
STATUSCampo
DMS_
CaractereMSGERR
Tipo
1Memo
Tamanho
@!50
Decimal
0
Formato
StatusTítulo
StatusMsg. Erro
Descrição
Mensagem Erro
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
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 - SIGAOMSCampo
DA3_VELOC
Tipo
Numérico
Tamanho
6
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
50Tamanho
Msg. ErroDecimal
0
Formato
@E 999,999 Título
Mensagem ErroVeloc Máxima
Descrição
Mensagem de erro recebida pelo RoteirizadorVelocidade 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 default no referencia SIX Criação de índices:
DMR
Índice
Ordem
Chave Descrição DMR 1 DMR_FILIAL+DMR_FILROT+DMR_IDROT Fil.Roteir. + Id.Roteir. DMS
Índice
Ordem
Chave Descrição DMS 1 DMS_FILIAL+DMS_FILROT+DMS_IDROT+DMS_ITEM Fil.Roteir. + Id.Roteir. + Item DMS 2 DMS_FILIAL+DMS_ENTIDA+DMS_CHVENT+DMS_STATUS+DMS_FILROT+DMS_IDROT Entidade + Chave Entid + Status + Fil.Roteir. + Id.Roteir. DMS 3 DMS_FILIAL+DMS_ENTEXT+DMS_CHVEXT Ent.Chv.Ext + Chave Externa DMS 4 DMS_FILIAL+DMS_FILROT+DMS_IDROT+DMS_CHVENT+DMS_ENTIDA Fil.Roteir. + Id.Roteir. + Chave Entid + Entidade
05. ASSUNTOS RELACIONADOS
- Integração TMS x Totvs Planejamento de Rotas - TPR (Integrações - SIGATMS)
- https://tdn.totvs.com/display/public/VRPTW/TOTVS+Planejamento+de+Rotas
- 1. Configuração do REST do Protheus
- Configurar Portais e Webservices
- Planejamento de Rotas (SIGATMS)
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> |