Á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 foram criados novos campos:
    • Momento da Quitação (DEG_REPQUI): Utilizado para definir o Momento da Quitação do Contrato na Repom;
    • Tempo de Espera (DEG_TMPESP): Utilizado para definir o tempo de espera do processamento da inclusão do Contrato na Repom, onde ocorre o retorno do Código do Contrato (DTR_PRCTRA/DM5_PRCTRA) e o Código do CIOT (DTR_CIOT);

  • Os processos de interface utilizados são:

    SIGATMSREPOMDESCRIÇÃO
    MotoristaDriverCadastro de Motorista.
    PrestadorHiredCadastro de Fornecedor.
    VeículosVehicleCadastro de Veículos.
    OperaçãoOperationOperação da Operadora de Frota.
    RoteiroRouteRequestCadastro de Rotas.
    Consultar RoteiroRouteConsulta de Roteiro.
    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 PedágiosVPRViagem.



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ção/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

Código da Filial na Repom

Campo

DEG_USER

Tipo

Caractere

Tamanho

45

Decimal

0

Formato


Título

Nome Usuário

Descrição

Nome de usuário Repom

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When

M->DEG_CODOPE == "01"

Relação


Val. Sistema


Help

Nome de usuário 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

Numérico

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

Criação de índices:

DEK:

Índice

Ordem

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


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