01. DADOS GERAIS

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 dos parâmetros "MV_VSREPOM = 2.2" e MV_TMSOPDG = 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:

  SIGATMS	REPOM	DESCRIÇÃO
  Motorista	Driver	Este método integra os cadastros de Motoristas do SIGATMS com a base de dados da Repom.
  Fornecedor	Hired	Este método integra os cadastros de Fornecedor do SIGATMS com a base de dados da Repom.
  Veículos	Vehicle	Este método integra os cadastros de Veículos do SIGATMS com a base de dados da Repom.
  Operações da Operadora - Cadastro Operadoras de Frota	Operation	No sistema da Repom, as operações de transporte são um conjunto de configurações para que o sistema se comporte de maneira distinta, de forma a atender aos diferentes tipos de operações. Por exemplo, há operações que contemplam a quebra de peso e quebra de frete. Esse método é utilizado, pois durante a emissão do contrato na base da Repom, é necessário enviar junto dos dados da viagem, qual a operação deseja utilizar.
  Roteiro	Route / RouteRequest	As informações referente ao Roteiro/Percurso da viagem são enviadas no momento da emissão de um contrato na Repom. No SIGATMS, esse método é acionado no momento do Cadastro da Rota. Cada rota do SIGATMS é amarrada a um roteiro/percurso da Repom.
  Emitir Viagem	Shipping	Na Repom, este método é um dos principais componentes da integração, por meio do qual é gerado o contrato no sistema da Repom. No SIGATMS, esse método é acionado no momento do Fechamento da Viagem. Quando ocorrer o estorno do Fechamento da Viagem, é acionado automaticamente o método para cancelamento do contrato na Repom. O cancelamento do contrato na Repom segue regras específicas que podem interferir no seu cancelamento. Caso não seja possível cancelar o contrato na Repom, o estorno do fechamento da viagem não será realizado.
  Quitação	Payment	A quitação do contrato determina o fim do processo de viagem na Repom. Esse método será acionado conforme a configuração do campo DEG_REPQUI (Momento Quitação) do Cadastro de Operadoras de Frotas  (Contrato de Carreteiro, conforme configuração do MV_LIBCTC  e/ou no Encerramento da Viagem) Obs: Na versão 2.2 (RepomFrete) não existe o método de "Autorização de Quitação do contrato" conforme versões anteriores.
  Consulta Contrato	Shipping/StatusProcessing/ByIdentifier	Após a quitação do contrato na Repom, realizamos a consulta do contrato diretamente por este método para conseguir os valores referente a impostos, calculados para pessoas físicas.
  Autorização de Pagamento	PaymentAuthorization	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 como  'CLEARED'
  Cálculo de Pedágio	Route/ByRouteCode	Ao informar os Recursos da Viagem (Operadora de Frota e Veículo)  automaticamente, com base na rota da viagem, é acionado esse método para obter o valor do pedágio. Na Viagem Modelo 3, na Aba Recursos, no campo “Pedágio” é apresentado o valor.
  Movimentação de Valores	Shipping/AddMovement	Depois que o contrato é emitido na Repom, todos os tipos de créditos e débitos que poderão ocorrer durante a viagem recebem o nome de “Movimentações de Valores”.  Esse método é utilizado para que uma movimentação seja inserida e ou excluída dentro do contrato na Repom.

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.
  

DETALHAMENTO DA ATUALIZAÇÃO DE DICIONÁRIO CONFORME ABAS

05. ASSUNTOS RELACIONADOS

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

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