Histórico da Página

...

O módulo de Gestão de Agronegócio possui a opção de integração via API REST com o parceiro externo M2M para buscar e atualizar a cotação de moedas(atual e futura), índices de mercado e índices de commodities de Bolsa de ReferenciaReferência, de forma que possam ser realizadas as negociações de venda e compra e geração de relatórios gerenciais com valores atualizados.

...

Pré-requisitos:

• Parâmetros Parâmetros MV_AGRO200, MV_AGRO201,MV_AGRO202 , MV_AGRO203 e MV_AGRO204 configurados.
• Possuir nas rotinas os campos de integração devidamente configurados. 

...

03. INTEGRAÇÃO COTAÇÃO DE MOEDAS VIA ROTINA MOEDAS PROTHEUS X EXTERNO(OGA011)

Necessário configurar os

...

parâmetros MV_AGRO200, MV_AGRO201, MV_AGRO202, MV_AGRO203 e MV_AGRO204.

No módulo de Gestão de Agronegócio, acesse no menu Atualizações → Comercialização → Cadastros Básicos→ Moeda Protheus x Externo.

Exclusivamente para Moedas, nesse programa devem ser informados os códigos externos correspondente a moeda que deverá ser requisitado ao parceiro M2M, para que o mesmo disponibilize as respectivas cotações. 

Na imagem abaixo é apresentado um exemplo do cadastro da Moeda Protheus x Externo.

Image Modified

Para a integração e atualização da cotação atual da moeda (do dia) é necessário preencher o campo "Cod Atual" com o código externo que o parceiro M2M disponibiliza.

Para a integração e atualização da cotação futura da moeda é necessário preencher o campo "Cod Futuro" com o código externo que o parceiro M2M disponibiliza.

Para realizar a integração por demanda da cotação da moeda, acessar no menu em Outras Ações → Atualizar Cotação.

Image Modified

Para

...

conferência, a cotação da moeda poderá ser verificada na rotina Moedas (MATA090).

04. INTEGRAÇÃO COTAÇÃO DE ÍNDICES VIA ROTINA ÍNDICES DE MERCADO(OGA080)

Necessário configurar os

...

parâmetros MV_AGRO200, MV_AGRO201, MV_AGRO202, MV_AGRO203 e MV_AGRO204.

No módulo de Gestão de Agronegócio, acesse no menu Atualizações → Comercialização → Precificação →  Índices de Mercado

Neste programa há duas formas de integração de índice.

1. Cadastro de Índice com campo código futuro preenchido 

No cadastro do índice de mercado, deve ser informado no campo "Cod Futuro" o código externo correspondente ao índice que deverá ser requisitado ao parceiro M2M, para que o mesmo disponibilize as respectivas cotações. 

Na imagem abaixo é apresentado um exemplo do cadastro de um índice de mercado com campo "Cod Futuro" preenchido.

Image Modified

2. Cadastro de Índice com Bolsa de ReferenciaReferência.

Os cadastros de Índices com campo "Cod Bolsa" preenchido, são criados automaticamente pela integração da rotina Bolsa de

...

Referência (OGA720), que será visto no tópico 05 mais abaixo.

Para realizar a integração por demanda dos índice de mercado, acessar no menu em Outras Ações → Atualizar Cotação.

Image Modified

Caso o índice selecionado seja com bolsa de

...

referência, na opção "Atualizar Cotação" a integração irá atualizar todos os índices da bolsa de

...

referência.

Para conferencia a cotação do índice poderá ser verificada na rotina Cotação de Índice(OGA090).

05. INTEGRAÇÃO COTAÇÃO DE ÍNDICES VIA ROTINA BOLSA DE

...

REFERÊNCIA(OGA720)

Necessário configurar os

...

parâmetros MV_AGRO200, MV_AGRO201, MV_AGRO202.

No módulo de Gestão de Agronegócio, acesse no menu Atualizações → Comercialização → Precificação →  Bolsa de Referência

No cadastro de bolsa de

...

referência deve ser informado no campo "URL Integra" a URL de integração correspondente a bolsa de mercado(CBOT, BMF, ESALQ, etc) que deverá ser requisitado ao parceiro M2M, e na

...

tabela de Índices de commodities no campo "Cod Futuro" deverá ser informado o código externo correspondente ao índice da bolsa para que o mesmo disponibilize as respectivas cotações. 

Cada bolsa poderá ter um ou mais índices de commodities cadastrado. Na imagem abaixo é apresentado dois exemplos do cadastro de Bolsa de Referência.

Image Modified

Image Modified

Para realizar a integração por demanda dos índice da Bolsa de

...

Referência, acessar no menu em Outras Ações → Atualizar Índices Bolsa.

Image Modified

Ao realizar a integração, o sistema verifica se os índices retornados pela API REST estão cadastrados, caso não, será incluído o índice no sistema, assim como sua cotação será incluída ou atualizada.

Para

...

conferência poderá ser verificado na rotina de Índices de Mercado (OGA080) os índices incluído, estes estarão com o campo "Cod Bolsa" preenchido. E a cotação poderá ser verificada na rotina Cotação de Índice (OGA090).

06. INTEGRAÇÃO VIA AGENDAMENTO AUTOMÁTICO(SCHEDULE)

Utilizando o Schedule Protheus, pode ser criado um agendamento para execução da rotina OGX300, que realiza a integração com o API REST do parceiro M2M para atualização das moedas e índices de mercado, possibilitando informar a recorrência desejada (diária, semanal, mensal, anual ou sempre ativo) a critério da necessidade de cada cliente.

Para correta integração via Schedule, é necessário configurar os

...

parâmetros MV_AGRO200, MV_AGRO201, MV_AGRO202, MV_AGRO203 e MV_AGRO204 e nas rotinas de cadastro já mencionados nos tópicos acima, realizar o preenchimentos dos campos para a integração.

Na imagem abaixo é apresentado um exemplo de cadastro no Schedule para a rotina OGX300 de integração.

Image Modified

07. CONTEÚDOS RELACIONADOS

• Moeda Protheus x Externa;
• Índices de mercado;
• Cotação de índices;
• Bolsa de Referência;.

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>