OGX300 -

Atualização de 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 nas cotações informadas no sistema Parceiro 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 serviços API REST para interagir com seus recursos.

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:

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

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

1. 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_
OG00203
• • • AGRO203: informar a URL para busca da
Taxa
• • •  Taxa de Câmbio PTAX
das
• • •  das Moedas (http://api.affluencia.mark2market.com.br/curves/interests/values?token=)
    • MV_
OG00204
• • • AGRO204: informar a URL para busca
das
• • • das Curvas Futuras
de
• • •  de Moedas e Índices de Mercado (http://api.affluencia.mark2market.com.br/curves/
interests/
• • • 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:

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 

Image Added

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

Procedimento para Utilização

        Cadastrar no Schedule ou manualmente no contrato de compra e venda