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

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:

  • Parâmetro MV_ENREPOM descontinuado, porém o Fechamento da viagem continua o "start" (Abertura do Contrato) entre a integração Protheus TMS e Repom.
  • No cadastro de Operadora de Frotas, é configurado o Momento da Quitação (DEG_REPQUI): Contrato de Carreteiro (conforme regras do MV_LIBCTC) ou Encerramento da Viagem.
  • Os processos de interface utilizados são:

    MotoristaDriverCadastro de Motorista
    PrestadorHiredCadastro de Fornecedor
    VeículosVehicleCadastro de Veiculos
    OperaçãoOperationOperação da Operadora de Frota
    RoteiroRouteRequestCadastro de Rotas
    Consultar RoteiroRoute
    Emitir ViagemShippingOcorre no Fechamento da Viagem 

    Prestar ContasPaymentCreatePode ocorrer no Contrato de Carreteiro, conforme configuração do MV_LIBCTC  e ou no Encerramento da Viagem.
    AutorizarAuth

    O processo de autorização é configurado no Sistema REPOM.

    Portanto, o TMS somente enviará a autorização quando o Status do Contrato na REPOM estiver diferente de  'PAID'

    Vale PedagioVPRViagem



Informações
titleImportante

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


Configuração:

  1. 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
tabsDicionário SX3, Dicionário SIX
idsSX3,SIX



Totvs custom tabs box items
defaultno
referenciaSX3
|

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

Campo

DA4_PAIS

Usado

Sim

Campo

DA4_DDD

Usado

Sim



Totvs custom tabs box items
defaultno
referenciaSIX

Criação de índices:

DEK:

Índice

Ordem

ChaveDescrição
DEK3DEK_FILIAL+DEK_ROTA+DEK_FROVEI+DEK_CODOPERota + Frota + Cod.Operad.

05. ASSUNTOS RELACIONADOS

Documento de Referência - Integração TMS x Repom


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-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
tabsDicionário SX3, Dicionário SIX
idsSX3,SIX



Totvs custom tabs box items
defaultno
referenciaSX3

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

Criação de índices:

DM3:

Índice

Ordem

ChaveDescrição
DM31DM3_FILIAL+DM3_FILDOC+DM3_DOC+DM3_SERIE+DM3_FILORI+DM3_VIAGEMFil.Docto. + No.Docto. + Serie Docto. + Fil.Origem + Viagem
DM32DM3_FILIAL+DM3_FILORI+DM3_VIAGEM+DM3_SEQUEN+DM3_FILDOC+DM3_DOC+DM3_SERIEFil.Origem + Viagem + Sequencia + Fil.Docto. + No.Docto. + Serie Docto