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 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
- 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 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:
- 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).
Para isso, é necessário efetuar a seguinte
(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
Nome da Variável | MV_OG00200 |
Tipo | c |
Descrição | URL: Utilizada para realizar a autenticação |
Valor Padrão | http://api.affluencia.mark2market.com.br/accounts/authenticate/ |
=> MV_OG00201 - E-mail
Nome da Variável | MV_OG00201 |
---|---|
Tipo | c |
Descrição | URL: Utilização do email |
Valor Padrão | [email protected] |
MV_OG00202 - Password
Nome da Variável | MV_OG00202 |
---|---|
Tipo | c |
Descrição | URL: Password para realizar a autenticação |
Valor Padrão | p3eKES-tARa& |
- MV_OG00203 - Autenticação Token PTAX
Nome da Variável | MV_OG00203 |
Tipo | C |
Descrição | URL: Utilização do token para solicitar a cotação |
Valor Padrão | http://api.affluencia.mark2market.com.br/curves/interests/values?token= |
MV_OG00204 - Autenticação Token Cotação Futura
Campo | MV_OG00204 |
Tipo | C |
Tamanho | URL: Utilização do token para solicitar a cotação |
Decimal | http://api.affluencia.mark2market.com.br/curves/interests/values?token= |
Procedimento para Utilização
Cadastrar no Schedule ou manualmente no contrato de compra e venda