Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

OGX300 - Atualizaçã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:

Rotina

Nome Técnico

OGX300

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



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 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.

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

http://api.affluencia.mark2market.com.br/accounts/authenticate/

Link DocParâmetro MV_AGRO200 - Recurso para realizar a autenticação/Token no Monitor M2M

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)


Link DocParâmetro MV_AGRO201 - Informar o Login de acesso a integração M2M

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 DocParâ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 DocParâ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 DocParâ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 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:




      A recorrência fica a critério da necessidade de cada cliente.


Parametrização para integração

  1. Efetuar a configuração nos Parâmetros do Protheus:
  • 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 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:



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