Exibir origem

01. DADOS GERAIS

Produto:
Linha de Produto:
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 deiversas operações contidas no Repom Frete, como manipulação de cadastros (Contratados, Motoristas e Veiculos), Roteiros, Viagens e Pagamento.

Implementada melhoria no processo de integração entre o módulo SIGATMS e Repom utilizando modelos denominados pela Repom como integração Financeiro e Contábil - Fase I.

Nesta fase houve, principalmente, uma mudança da arquitetura dos pontos de integração entre Protheus TMS e Repom.

Abaixo seguem detalhes dos métodos de integração com exemplos de utilização.

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. Realizar uma chamada
POST para a interface Post/token informando o usuário e senha cadastrados e no partner
informar o cnpj do tms, um Token será devolvido no resultado da chamada, este token
deverá estar incluso no Header de todas as chamadas.
Implementar a Viagem de Transporte e Coleta-Entrega (Modelo 3) do SIGATMS, proporcionando maior agilidade para os processos de emissão de viagens de entrega, transferência e coleta-entrega.

As definições/conceitos para os processos de viagem transporte e entrega, permanecem os mesmos:

Rodoviário Transporte - A viagem de transporte rodoviário é utilizada para efetuar a transferência de cargas entre as transportadoras que possuem filiais.
Rodoviário Entrega - A viagem entrega é o processo utilizado para se efetuar a distribuição das mercadorias, ou seja, as respectivas entregas no destinatário.

03. SOLUÇÃO

Implementado a nova funcionalidade de integração com a Repom Frete (versao 2.2)

Foram implementadas as seguintes melhorias:

Melhor visualização de documentos embarcados e ocorrências registradas nas viagens efetuadas, permitindo assim que o usuário tenha acesso aos dados rapidamente sem a necessidade de acessá-las via Menu.
Fechamento automático da viagem;

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.

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

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.

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

05. ASSUNTOS RELACIONADOS

Documento de Referência - Viagem Modelo 3

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