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 nas cotações informadas 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.
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.
A integração funciona de duas formas: por demanda ou agendamento automático (schedule).
Vejamos:
* Por Demanda:Nas funcionalidades xxxxxx, foi incluída uma opção de Menu
* Agendamento Automático (Schedule)
Ainda
=> Utilizar o conceito de RestAPI para buscar as informações do M2M
=> Localizar o índice de mercado e atualizar sua cotação.
=> Validar se a conexão está ativa.
=> registrar a data e hora da ultima atualização do índice.
=> Definir periodicidade da atualização (Hora e Diário)
=> a atualização poderá ser para todos os índices ou de um conjunto de índices, conforme parametrizado pelo usuário.
: Utilizando o Schedule Protheus, pode ser criado um agendamento para execução da função OGX300, informando a recorrência desejada (diária, semanal, mensal, anual ou sempre ativo).
Para isso, é necessário efetuar a seguinte 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=)
E também o cadastro DE/PARA.....
|
Criação de Parâmetros no arquivo SX6 – Parâmetros
Criação de Parâmetros no arquivo SX6 – Parâmetros
Tabelas acessadas: NK1(Tabela que atualizamos os indices), NK0(Tabela do De\ Para)- 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