Histórico da Página
OGX300 -
AtualizarAtualização de 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 NK8 - Produtos X Componentes de Preço | |
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 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
Nome da Variável | MV_AGRO200 |
Tipo | c |
Descrição | URL utilizada para realizar a autenticação no Monitor M2M |
Valor Padrão |
Nome da Variável | MV_AGRO201 |
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_AGRO202 |
Tipo | c |
Descrição | Senha de usuário no Monitor M2M |
Valor Padrão | (o parceiro M2M deverá fornecer essa senha) |
Link Doc | Parâmetro MV_AGRO202 - Informar Senha de acesso a integração M2M |
Nome da Variável | MV_AGRO203 |
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= |
Link Doc | Parâmetro MV_AGRO203 - Informar URL para buscar Taxa de Câmbio PTAX das Moedas |
Nome da Variável | MV_AGRO204 |
Tipo | C |
Descrição | URL utilizada para busca das Curvas Futuras de Moedas e Índices de Mercado |
Valor Padrão | http://api.affluencia.mark2market.com.br/curves/values?token= |
Link Doc | Parâmetro MV_AGRO204 - Informar a URL para buscar Curva Futura de Moedas e Índices de Mercado |
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
oo 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:
A recorrência fica a critério da necessidade de cada cliente.
Parametrização para integração
- Efetuar a
Para isso, é necessário efetuar a seguinte
- 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 - 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/
- 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:
- 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
aoao Monitor M2M, para que o mesmo
disponiblizedisponibilize as respectivas cotações.
Cada índice
de mercadoexistente no Protheus, poderá ter seu respectivo Código Externo
nono 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
cadastrocadastramento:
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= |
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