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: | OMSA040 - Cadastro de Motorista OMSA060 - Cadastro de Veiculos OMSA100 - Cadastro de Rotas TMSA240 - Complemento de Viagem TMSA250 - Contrato de Carreteiro TMSA251 - Liberação de Contrato TMSA310 - Fechamento de Viagem TMSA340 - Encerramento de Viagem TMSA350 - Operações de Transporte TMSAC15 - Funções Genéricas TMS x Repom TMSAC15A- Funções Genéricas TMS x Repom TMSAC15B- Funções Genéricas TMS x Repom TMSAE60 - Cadastro de Operadoras de Frotas TMSAE65 - Operadoras de Frotas x Ações TMSAF64P - Validações para Operadoras de Frota TMSAF64R - Validações para Operadoras de Frota TMSREPOM- Funções Genéricas TMS TMSXFUNA- Funções Genéricas TMS TMSXFUNB- Funções Genéricas TMS TMSXFUNC - Funções Genéricas TMS TMSXFUNX - Funções Genéricas TMS |
---|
Ticket: | Não se aplica |
---|
Requisito/Story/Issue (informe o requisito relacionado) : | DLOGTMS02-13230 |
---|
02. SITUAÇÃO/REQUISITO
Implementar melhoria no processo de integração entre o módulo SIGATMS e Repom, utilizando a plataforma Repom Frete, que baseia-se na tecnologia Web API* em arquitetura RestFul.
A API de integração da Repom permite a realização de diversas operações contidas no Repom Frete, como manipulação de cadastros (Contratados, Motoristas e Veículos), Roteiros, Viagens e Pagamento.
* Web APÌ - Solução utilizada na integração de sistemas e na comunicação entre diferentes aplicações, utilizando a linguagem universal JSON para tráfego de dados, proporcionando para que sistemas desenvolvidos em plataformas distintas sejam compatíveis.
03. SOLUÇÃO
Implementado a integração TMS com a Repom Frete, que estará disponível a partir da configuração do parâmetro MV_VSREPOM = 2.2
Nesta versão houve algumas mudanças de configuração:
Informações |
---|
|
As alterações de dicionário de dados estarão disponíveis a partir do release 12.1.31. |
04. DEMAIS INFORMAÇÕES
Para uso desta funcionalidade, deve ser utilizado:
- Pacote: 008033 - Para atualização de dicionário de dados, criaçã/alteração de campos e índices.
- Autenticação: BEARER (Token) - Necessário solicitar para a equipe Repom o usuário e senha inicial, a partir desse usuário será possível gerar o Token.
Informações |
---|
|
Configuração:
- Para a funcionalidade da nova integração TMS x Repom, é necessário configurar o parâmetro:
MV_VSREPOM = 2.2
|
DETALHAMENTO DA ATUALIZAÇÃO DE DICIONÁRIO CONFORME ABAS
Totvs custom tabs box |
---|
tabs | Dicionário SX3, Dicionário SIX |
---|
ids | SX3,SIX |
---|
|
Totvs custom tabs box items |
---|
| | Criação de Campos. Tabela DEG (Operadora de Frotas): Campo | DEG_BRANCH | Tipo | Caractere | Tamanho | 6 | Decimal | 0 | Formato | @! | Título | Branch Repom | Descrição | Codigo da filial Repom | Usado | Sim | Obrigatório | Não | Browse | Sim | Opções |
| When | M->DEG_CODOPE == "01" | Relação |
| Val. Sistema |
| Help | Codigo da Filial na Repom |
Campo | DEG_USER | Tipo | Caractere | Tamanho | 45 | Decimal | 0 | Formato |
| Título | Nome Usuario | Descrição | Nome de usuario Repom | Usado | Sim | Obrigatório | Não | Browse | Não | Opções |
| When | M->DEG_CODOPE == "01" | Relação |
| Val. Sistema |
| Help | Nome de usuario utilizado para autenticação no sistema de comunicação REST da REPOM. |
Campo | DEG_SENHA | Tipo | Caractere | Tamanho | 30 | Decimal | 0 | Formato | @* | Título | Senha | Descrição | Senha Usuario | Usado | Sim | Obrigatório | Não | Browse | Não | Opções |
| When | M->DEG_CODOPE == "01" | Relação |
| Val. Sistema |
| Help | Informe a senha do usuário cadastrado para realizar a integração com a REPOM. |
Campo | DEG_TOKEN | Tipo | Memo | Tamanho | 50 | Decimal | 0 | Formato |
| Título | Token | Descrição | Token de Acesso | Usado | Sim | Obrigatório | Não | Browse | Não | Opções |
| When |
| Relação |
| Val. Sistema |
| Help | Token utilizado na integração com REPOM. |
Campo | DEG_DTTOKE | Tipo | Data | Tamanho | 8 | Decimal | 0 | Formato |
| Título | Data Token | Descrição | Data Token | Usado | Sim | Obrigatório | Não | Browse | Não | Opções |
| When |
| Relação |
| Val. Sistema |
| Help | Data de envio do token de acesso ao sistema REPOM. |
Campo | DEG_HRTOKE | Tipo | Caractere | Tamanho | 8 | Decimal | 0 | Formato | 99:99:99 | Título | Hr. Token | Descrição | Hora Token | Usado | Sim | Obrigatório | Não | Browse | Não | Opções |
| When |
| Relação |
| Val. Sistema |
| Help | Hora de envio do token de acesso ao sistema REPOM. |
Campo | DEG_EXPIRE | Tipo | Numerico | Tamanho | 6 | Decimal | 0 | Formato | @E 999,999 | Título | Duração Toke | Descrição | Duração Token | Usado | Sim | Obrigatório | Não | Browse | Não | Opções |
| When |
| Relação |
| Val. Sistema |
| Help | Duração do token em segundos. |
Campo | DEG_TMPESP | Tipo | Caractere | Tamanho | 1 | Decimal | 0 | Formato | @! | Título | Tempo Espera | Descrição | Tempo de Espera | Usado | Sim | Obrigatório | Não | Browse | Não | Opções | 1=10;2=30;3=60;4=120;5=240 | When | TMSAE60Whe('DEG_TMPESP') | Relação | "5" | Val. Sistema | TMSAE60Vld() | Help | Selecione o tempo de espera máximo (em segundos) para o retorno da inclusão do contrato (viagem) na Operadora REPOM. |
Campo | DEG_REPQUI | Tipo | Caractere | Tamanho | 1 | Decimal | 0 | Formato | @! | Título | Mom.Quit.Rep | Descrição | Momento Quitação Repom | Usado | Sim | Obrigatório | Não | Browse | Não | Opções | 0=Não Utiliza;1=Contrato;2=Encerramento Vge | When | TMSAE60Whe('DEG_REPQUI') | Relação | "0" | Val. Sistema | Pertence('012') | Help | Informe o momento da Quitação do Contrato na REPOM. Obs: A quitação do contrato ocorrerá de acordo com a parametrização de geração do título (MV_LIBCTC e DUJ_TITFRE). |
Tabela DA4 (Motorista): |
Totvs custom tabs box items |
---|
| Criação de índices: DEK: Índice | Ordem | Chave | Descrição | DEK | 3 | DEK_FILIAL+DEK_ROTA+DEK_FROVEI+DEK_CODOPE | Rota + Frota + Cod.Operad. |
|
|
05. ASSUNTOS RELACIONADOS
Documento de Referência - Integração TMS x Repom
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-pane.l {
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>
|
Totvs custom tabs box |
---|
tabs | Dicionário SX3, Dicionário SIX |
---|
ids | SX3,SIX |
---|
|
Totvs custom tabs box items |
---|
| Criação de Campos. Tabela DM3 (Documentos da Viagem Mod.3): Campo | DM3_FILIAL | Tipo | Caractere | Tamanho | 2 | Decimal | 0 | Formato | @! | Título | Filial | Descrição | Filial do Sistema | Usado | Não | Obrigatório | Não | Browse | Sim | Opções |
| When |
| Relação |
| Val. Sistema |
| Help | Informe a filial do sistema. |
Campo | DM3_ORIGEM | Tipo | Caracter | Tamanho | 1 | Decimal | 0 | Formato |
| Título | Orig. Carreg | Descrição | Origem do Carregamento | Usado | Sim | Obrigatório | Não | Browse | Não | Opções |
| When |
| Relação | IF(INCLUI,0,POSICIONE("DT6",1,XFILIAL("DT6")+DM3->(DM3_FILDOC+DM3_DOC+DM3_SERIE),"DT6_VALMER")) | Val. Sistema |
| Help | Valor da Mercadoria. |
Tabela DM4 (Planejamento da Viagem Mod.3): Campo | DM4_FILIAL | Tipo | Caracter | Tamanho | 2 | Decimal | 0 | Formato |
| Título | Filial | Descrição | Filial do Sistema | Usado | Não | Obrigatório | Não | Browse | Sim | Opções |
| When |
| Relação |
| Val. Sistema |
| Help | Filial do Sistema. |
Campo | DM4_FILORI | Tipo | Caractere | Tamanho | 2 | Decimal | 0 | Formato |
| Título | Filial | Descrição | Filial de Origem da Viagem | Usado | Não | Obrigatório | Não | Browse | Sim | Opções |
| When |
| Relação |
| Val. Sistema | TMSAF62("DM4") | Help | Informe a filial de Origem da Viagem. |
|
Totvs custom tabs box items |
---|
| Criação de índices: DM3: Índice | Ordem | Chave | Descrição | DM3 | 1 | DM3_FILIAL+DM3_FILDOC+DM3_DOC+DM3_SERIE+DM3_FILORI+DM3_VIAGEM | Fil.Docto. + No.Docto. + Serie Docto. + Fil.Origem + Viagem | DM3 | 2 | DM3_FILIAL+DM3_FILORI+DM3_VIAGEM+DM3_SEQUEN+DM3_FILDOC+DM3_DOC+DM3_SERIE | Fil.Origem + Viagem + Sequencia + Fil.Docto. + No.Docto. + Serie Docto |
|
|