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

Características do Requisito

Descrição

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

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

Detalhamento do processo:

Autenticação

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

Para isso, é necessário efetuar a seguinte configuração nos Parâmetros do Protheus:

• • • MV_OG00200: informar a URL de autenticação (http://api.affluencia.mark2market.com.br/accounts/authenticate/)
    • MV_OG00201: informar um login de usuário (o parceiro M2M deverá fornecer esse login)
    • MV_OG00202: informar uma senha de usuário (o parceiro M2M deverá fornecer essa senha)
      

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").
      
      
      Figura 1
      
      
      

Figura 2

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:
      

• • • 
      
      (colar aki a imagem da tela de configuração.)
      
      
      A recorrência fica a critério da necessidade de cada cliente.

Parametrização para integração

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

• • MV_OG00203: informar a URL para busca da Taxa de Câmbio PTAX das Moedas (http://api.affluencia.mark2market.com.br/curves/interests/values?token=)
  • MV_OG00204: informar a URL para busca das Curvas Futuras de Moedas e Índices de Mercado (http://api.affluencia.mark2market.com.br/curves/interests/values?token=)

O cadastro DE-PARA também é pré-requisito e precisa ser registrado conforme:

No modulo Gestão Agroindústria (SIGAAGR), acesse Atualizações / Originação / Cadastros Básicos / 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 disponiblize 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

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

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

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

 NJ7 - De/Para Moeda Protheus x Sistema Externo

Criação de Parâmetros no arquivo SX6 – Parâmetros

• 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 

Procedimento para Utilização

        Cadastrar no Schedule ou manualmente no contrato de compra e venda