01. DADOS GERAIS
Produto: | Solucoes_totvs |
---|
Solucao | TOTVS Logística TMS |
---|
|
|
---|
Linha de Produto: | Linhas_totvs |
---|
Segmento | Distribuição |
---|
Region | Construção Projetos |
---|
Linha | Linha Protheus |
---|
|
|
---|
Segmento: | |
---|
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)
|
---|
02. SITUAÇÃO/REQUISITO
A fim de otimizar e reduzir custos das operações de transporte, o módulo Gestão de Transportes 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, além da obtenção prévia dos valores de pedágio.
03. SOLUÇÃO
...
Para que toda a solução funcione perfeitamente é necessário obter as coordenadas geográficas de todos os clientes, de acordo com os respectivos endereços.
As rotinas Cadastro de Cliente, Sequência de Endereço, Wizard Filial e Cadastro de Solicitantes foram atualizadas para que ao final da gravação as informações referentes ao endereço sejam enviadas automaticamente para gelocalização (tpr-geolocation-sync) ,a fim de obter as coordenadas geográficas do respectivo endereço. As coordenadas geográficas recebidas são gravadas na tabela DAR - Referência Geográficas, e é possível visualiza-las através da rotina Cadastro de Referências Geográficas - TMSAO15.
...
Quando todas as etapas da integração citadas acima forem concluídas com sucesso, toda a visualização dos pontos de entrega/coleta, rota e praças de pedágio, estarão disponíveis a partir da funcionalidade do Map Display, disponibilizado no Pianel Planejamento de Rotas (TMSAC19) e ou Programação de Carregamento (TMSA146)
...
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 |
- 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.
Informações |
---|
title | Dados fornecidos pelo Totvs Planejamento de Rotas |
---|
|
|
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 |
---|
| 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 |
---|
| Tabela | Descrição | DMR | Roteirização - TPR | DMS | Itens Roteirização - TPR |
|
|
Foram criadas novas funcionalidades no SIGATMS:
...
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 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.
- Atualize o menu sigatms.xnu.
- Habilite o parâmetro MV_ROTAINT
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
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 |
---|
|
|
SX1Grupo- 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 |
---|
|
Tabela | Descrição |
DMR | Roteirização - TPR |
DMS | Itens Roteirização - TPR |
Totvs custom tabs box items |
---|
|
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 |
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 |
|
|
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_AUTH50254 | Decimal | 0 | Formato | @! | Título |
|
|
AuthorizatioChave de AutorizaçãoURL 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 |
|
|
ROTERIURLROT | Tipo | Caractere | Tamanho |
|
|
18254 | Decimal | 0 | Formato | @! | Título |
|
|
RoteirizadorRoteirizadorURL da Roteirização | Usado | Sim | Obrigatório | Não | Browse | Não | Opções |
|
|
1=Maplink;2=Planejamento Rotas (TPR)Pertence('12')2=Planejamento Rotas (TPR)Define o tipo de integração:
1=Maplink;
Informe a URL da Geolocalização |
|
|
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 | 80URLGEOTMPEXP | Tipo | Caractere | Tamanho |
|
|
254@!URL GeocodeURL da GeolocalizaçãoTempo de Expiração | Usado | Sim | Obrigatório | Não | Browse | Não | Opções |
| When | TMSAC20Whe() | Relação |
| Val. Sistema |
|
|
Help | 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 |
|
|
Informe a URL da GeolocalizaçãoURLROT254URL RoterizaURL da RoteirizaçãoRota de Entrega | Usado | Sim | Obrigatório | Não | Browse | Não | Opções |
| When | TMSAC20Whe() | Relação |
| Val. Sistema |
|
|
Help | | 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. |
|
|
Informe a URL da GeolocalizaçãoURLTKDESROT | Tipo | Caractere | Tamanho |
|
|
25430 | Decimal | 0 | Formato | @! | Título |
|
|
URL TokenURL TokenPraç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 URL 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;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 - SIGAOMSCampo | 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 |
---|
| 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
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>
|