OGX300 - Atualização de Cotações de Moedas e Índices de Mercado (Integração M2M)

Características do Requisito

Descrição

Permitir ter Essa funcionalidade permite que as cotações de moeda e dos índices de mercado sejam atualizados diariamente no protheus Protheus com base nas cotações informadas no sistema Parceiro parceiro M2M, para poder realizar de forma que possam ser realizadas as negociações de venda e compra e geração de relatórios gerencias gerenciais com valores atualizados.

=> Utilizar o conceito de RestAPI para buscar as informações do M2M
=> Localizar o índice de mercado e atualizar sua cotação. 
=> Validar se a conexão está ativa.
=> registrar a data e hora da ultima atualização do índice.
=> Definir periodicidade da atualização (Hora e Diário)
=> a atualização poderá ser para todos os índices ou de um conjunto de índices, conforme parametrizado pelo usuário.

A integração funciona através de requisições HTTP, buscando as informações no Monitor M2M que possui serviços API REST para interagir com seus recursos.

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

Aplique o patch do requisito e execute uma vez a rotina UPDDISTR.

Logo após a execução desta rotina é alterado o dicionário de dados da base, conforme especificações abaixo: 

Parâmetros no arquivo SX6

- Parâmetros

• Moedas-
  Tabelas acessadas: SM2(Tabela que onde atualizamos as cotações), NJ7(Tabela do De\ Para)
   
  Indices-
  Tabelas acessadas: NK1(Tabela que atualizamos os indices), NK0(Tabela do De\ Para)
  MV_OG00200 - Autenticação da URL
  MV_OG00201 - E-mail
  MV_OG00202 - Password
  MV_OG00203 - Autenticação Token PTAX
  MV_OG00204 - Autenticação Token Cotação Futura
  Caso precise de algum dado a mais sobre os parâmentros, deixei documentado o mesmo na Atusx no Projeto da SLC

• Tabela NNW - Alteração de Contrato

Procedimento para Utilização

       1.            No Gestão Agroindústria (SIGAAGR), acesse Atualizações / Originação / Controle Fiscal / Motivo Alter. Ctr. (OGA140)

Cadastre um motivo com a opção <preencher nome do campo> = Sim.

       2.            Acesse Atualizações / Originação / Controle de Venda / Contrato de Venda (OGA290).

                             Cadastre um contrato com o Tipo de Excedente = Permite.

Procedimento para Utilização

Detalhamento do processo:

Autenticação

Todo acesso é feito através de autenticação (HTTP Basic) de um usuário existente no Monitor M2M.

A autenticação é temporária e a integração requisita uma nova a cada interação com o Monitor M2M.

Integração

A integração funciona de duas formas: por demanda ou agendamento automático (schedule). Vejamos:

• • Por Demanda: Nas rotinas OGA280 - Contrato de Compra (Figura 1), OGA290 - Contrato de Venda (Figura 2) e OGA460 - Simulação de Composição de Preço (Figura 3), foi incluída uma opção chamada "Atualizar Taxas". Ao clicar nessa opção, o sistema chama a integração OGX300, passando como parâmetro as moedas e índices da tela, e, após o processamento, mostra os valores atualizados em tela (atualiza as colunas "Cotação" e "Vlr. Índice").

Image Added
Figura 1

Image Added

Figura 2

Image Added

Figura 3

• • Por Agendamento Automático (Schedule): Utilizando o Schedule Protheus, pode ser criado um agendamento para execução do OGX300, informando a recorrência desejada (diária, semanal, mensal, anual ou sempre ativo). 
    
    A configuração da rotina deve ser realizada da seguinte maneira:
    
    Image Added
    
    A recorrência fica a critério da necessidade de cada cliente.
    
    
    

Parametrização para integração

1. Efetuar a configuração nos Parâmetros do Protheus:

• • • MV_AGRO200: informar a URL de autenticação (http://api.affluencia.mark2market.com.br/accounts/authenticate/)
    • MV_AGRO201: informar um login de usuário (o parceiro M2M deverá fornecer esse login)
    • MV_AGRO202: informar uma senha de usuário (o parceiro M2M deverá fornecer essa senha)
      
    • MV_AGRO203: informar a URL para busca da Taxa de Câmbio PTAX das Moedas (http://api.affluencia.mark2market.com.br/curves/interests/values?token=)
    • MV_AGRO204: informar a URL para busca das Curvas Futuras de Moedas e Índices de Mercado (http://api.affluencia.mark2market.com.br/curves/values?token=)
      
      
    2. Realizar o cadastro De/Para para Moedas e Índices, conforme:

• No módulo Gestão Agroindústria (SIGAAGR), acesse o cadastro Moedas Protheus x Externo (OGA011). 

Exclusivamente para Moedas, nesse programa devem ser registrados os códigos externos que irão corresponder ao recurso específico que deverá ser requisitado ao Monitor M2M, para que o mesmo disponibilize as respectivas cotações.

Cada moeda existente no Protheus, poderá ter seu respectivo Código Externo no M2M.

Atualmente a M2M disponibiliza os seguintes arquivos:

Para Curva Futura:

BMF\BRLUSD:CURVE = Curva Futura BRL/USD (Reais/dólares)-  BMF

BMF\BRLEUR:CURVE = Curva Futura BRL/EUR (Reais/Euros)- BMF

Para PTAX:

BCB\BRLUSDBUY:CUREX -> BRL x USD (BCB) PTAX Compra 
BCB\BRLUSD:CUREX -> BRL x USD (BCB) PTAX Venda 
BCB\BRLEURBUY:CUREX -> BRL x EUR (BCB) PTAX Compra 
BCB\BRLEUR:CUREX -> BRL x EUR (BCB) PTAX Venda

Exemplo de cadastramento: 

Image Added

• No módulo Gestão Agroindústria (SIGAAGR), acesse o cadastro de Índices de Mercado (OGA080). 

Exclusivamente para Índices de Mercado, nesse programa devem ser registrados os códigos externos que irão corresponder ao recurso específico que deverá ser requisitado ao Monitor M2M, para que o mesmo disponibilize as respectivas cotações.

Cada índice existente no Protheus, poderá ter seu respectivo Código Externo no M2M.

Atualmente a M2M disponibiliza os seguintes arquivos:

Para Curva Futura:

BMF\SJC:CURVE = Curva Futuro de Soja BM&F

CBOT\SOYBEAN:CURVE = Curva Futuro de Soja CBOT

CBOT\SOYBEANMEAL:CURVE = Curva Futuro de Farelo de Soja CBOT

CBOT\CORN:CURVE = Curva Futuro de Milho CBOT

BMF\CCMSAZ:CURVE = Curva Futuro de Milho BM&F

CBOT\WHEAT:CURVE = Curva Futura Trigo CBOT

ICE\COTTON:CURVE = Curva Futura Algodão

Exemplo de cadastramento:

Image Added

As cotações de Moedas e Índices de Mercado podem ser consultadas nas rotinas  MATA090 e OGA090, respectivamente.

       3.            Acesse Atualizações / Originação / Comercialização / Romaneio com Pesagem (OGA250)

                             Informe um romaneio cuja quantidade seja superior à quantidade do saldo do contrato. Efetue a pesagem e atualização do romaneio.

                             Será criado uma alteração do tipo Adição para o contrato e o romaneio será atualizado com sucesso.

       4.            Acesse Atualizações / Originação / Comercialização / Alteração Contrato (OGA335)

                             Clicar em Visualizar para consultar o registro de Aditação gerado para o contrato, cujo valor será a diferença entre a quantidade do romaneio e o saldo do contrato.

                             Na tela de visualização, clicar em Ações Relacionadas > Consultar Romaneio para visualizar o romaneio que gerou o excedente.

1. Opção "Excedente" 3 - Percentual:

Image Removed