Histórico da Página
OGX300 - Atualizar Cotações de Moedas e Índices de Mercado (Integração M2M)
Características do Requisito
Linha de Produto: | Microsiga Protheus | ||||||
Segmento: | Gestão Agroindústria | ||||||
Módulo: | SIGAAGR | ||||||
Rotina: |
| ||||||
Requisito/Story/Issue (informe o requisito relacionado): | DAGROGAP-590 | ||||||
País(es): | Todos | ||||||
Banco(s) de Dados: | Todos | ||||||
Tabelas Utilizadas: | NJ7 - De/Para Moeda Protheus x Sistema Externo NK0 - Índices de Mercado SM2 - Cotações de Moeda NK1 - Cotações de Índices de Mercado | ||||||
Sistema(s) Operacional(is): | Todos |
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 serviços API REST para interagir com seus recursos.
Parâmetros no arquivo SX6 – Parâmetros
Nome da Variável | MV_OG00200 |
Tipo | c |
Descrição | URL utilizada para realizar a autenticação no Monitor M2M |
Valor Padrão | http://api.affluencia.mark2market.com.br/accounts/authenticate/ |
Nome da Variável | MV_OG00201 |
Tipo | c |
Descrição | Login de usuário no Monitor M2M |
Valor Padrão | (o parceiro M2M deverá fornecer esse login) |
Nome da Variável | MV_OG00202 |
Tipo | c |
Descrição | Senha de usuário no Monitor M2M |
Valor Padrão | (o parceiro M2M deverá fornecer essa senha) |
Nome da Variável | MV_OG00203 |
Tipo | C |
Descrição | URL utilizada para busca da Taxa de Câmbio PTAX das Moedas |
Valor Padrão | http://api.affluencia.mark2market.com.br/curves/interests/values?token= |
Campo | MV_OG00204 |
Tipo | C |
Tamanho | URL utilizada para busca das Curvas Futuras de Moedas e Índices de Mercado |
Decimal | http://api.affluencia.mark2market.com.br/curves/values?token= |
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.
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.
- 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).
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/values?token=)
- 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: (Colar aqui tela do OGA011)
- 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: (Colar aqui tela do OGA080)
As cotações de Moedas e Índices de Mercado podem ser consultadas nas rotinas MATA090 e OGA090, respectivamente.