ÍNDICE

01. VISÃO GERAL

Este programa permite incluir e manutenir as bolsas de referência. A bolsa de referência é a representação no sistema de uma bolsa de valor de mercado e permite realizar integração com sistema de terceiro para atualização de índices. Quando essa integração está devidamente configurada, os índices são cadastrados/atualizados automaticamente no programa Índices de Mercado.

É possível também informar a quantidade de contratos futuros que permite realizar o controle de cobertura de hedge quando sistema está configurado para gestão de risco (MV_AGRO041).

02. PROCEDIMENTOS

Para Incluir : 

  1. Acesse no módulo SIGAAGR: Atualizações >Comercialização>Precificação>Bolsa de Referência;
  2. Clique em Incluir;
  3. Informe os dados obrigatórios da bolsa de referência;
  4. Clique em Confirmar.

Para alterar:

  1. Acesse no módulo SIGAAGR : Atualizações >Comercialização>Precificação>Bolsa de Referência;
  2. Posicione na bolsa de referência que deseja alterar.
  3. Clique em Alterar;
  4. Modifique os campos desejados;
  5. Clique em Confirmar.

Para visualizar:

  1. Acesse no módulo SIGAAGR : Atualizações >Comercialização>Precificação>Bolsa de Referência;
  2. Posicione na bolsa de referência que deseja visualizar;
  3. Clique em Visualizar.

Para excluir:

  1. Acesse no módulo SIGAAGR : Atualizações >Comercialização>Precificação>Bolsa de Referência;
  2. Posicione na bolsa de referência que deseja excluir;
  3. Clique em Outras Ações>Excluir;
  4. Confira os dados;
  5. Clique em Confirmar.

03. PARÂMETROS/CONFIGURAÇÕES


O conteúdo dos parâmetros pode ser alterado na rotina Parâmetros do módulo Configurador.

Parâmetro

Descrição

Conteúdo padrão

MV_AGRO200URL: Utilizada para realizar a autenticação de integração com a M2M.

MV_AGRO201

E-mail para realizar a autenticação para a geração do Token e integração M2M.  


MV_AGRO202

Password para realizar a autenticação para a geração do Token e integração M2M.  


04. PRINCIPAIS CAMPOS

Abaixo são apresentados os principais campos do cadastro da Bolsa de Referência. Alguns campos são exclusivo para integração com sistema de terceiro e que auxiliam no cadastro automático dos índices  servindo como valores de inicialização para os respectivos campos no cadastro de Índices de Mercado. Exemplos: (Código de Usuário, Grp. Usuário, Código futuro, Código do produto, Unid. Medida, Moeda e Tp Índice).

Campo

Descrição

CódigoCódigo da bolsa de referência.
Bolsa de ref.Descrição da bolsa de referência.
Preço bolsa

Indica se o preço para a bolsa é fixado ou oriunda de um índice. Caso seja índice, não permitirá a fixação de preço manualmente. Os valores aceitos são:

1 - Fixação;

2 - Índice.

URL Integração

URL de integração com API externa para atualização do índice de commodity de bolsa de referência.

Para obter essa funcionalidade é necessário ter os parâmetros MV_AGRO200, MV_AGRO201, MV_AGRO202 devidamente configurados para gerar o token de acesso e conseguir consumir a URL informada neste campo.

Código de UsuárioCódigo do usuário. Permite restringir a atualização de índice vinculados a bolsa de referência por usuário.
Grp. UsuárioCódigo do grupo de usuários. Permite restringir a atualização de índice vinculados a bolsa de referência por grupo de usuário.
Código futuro

Código do índice de commodity do sistema externo. Será utilizado para buscar o valores futuros para o índice, atualizando a cotação do índice no Protheus para as respectivas datas.

Código do produtoCódigo produto que estará vinculado a bolsa de referência.
Unid. Med.Código da unidade de medida.
MoedaCódigo da moeda.
Tp Índice

Define a regra que será utilizada para busca dos valores do índice. Os valores aceitos são:

D - Diário (Considera o índice do dia para pesquisa. Caso não encontre para a data específica, o valor do índice é zero);

A - Mais atual (Considera o índice com a data mais próxima com a data que foi passada para pesquisa);

F - Fórmula (Defina-se uma fórmula para busca);

T - Tabelas (Indica que a busca será feita em uma tabela de preço previamente cadastrada).

A bolsa de referência é utilizada como meio de integração para inclusão e atualização dos índices automaticamente. Dessa forma, este apenas é utilizado como valor inicial para o campo Tipo de Índice do programa Índices de Mercado na inclusão automática. Quando o tipo for fórmula, a mesma pode ser defina no cadastro de índices de mercado.

Integração

Indicador da situação da integração. Os valores aceitos são:

1 - Ativo;

2 - Inativo.

Form. Índice

Formato do código do índice. Na integração com a API será retornado um código de índice para ser gravado, porém o usuário poderá formatar este código do índice. 

Neste campo use apenas números(0-9), vírgula(,) e hífen(-). 

Os números representam a posição do caracter, e inicia na posição 1. A vírgula separa as posições dos caracter. O hífen representa uma sequencia de uma posição de um caracter até a posição de outro.

Por exemplo, considere que a API retornou o código 'CTD08M2018'. O usuário quer somente os 5 primeiros dígitos, então deverá informar: 1-5 ou 1,2,3,4,5 assim será salvo o índice CTD08.

Caso o usuário queira os 5 primeiros dígitos e os 2 últimos, então deverá informar: 1-5,9-10 ou 1-5,9,10 ou

1,2,3,4,5,9,10.

Qtd. p/ Ctr Futuro

Indica a quantidade que cada contrato deverá conter. Esta quantidade deve ser expressa na unidade de medida para o contrato.

Exemplo:

1 Contrato = 24 TN ou 1 Contrato = 24000 Kg

Unid. Med. Ctr

Unidade de medida para a quantidade do contrato.

05. OUTRAS AÇÕES

No browse principal, na opção de menu Outras Ações, está disponível a funcionalidade Atualizar Índice de Bolsa. Essa opção permite realizar a conexão com sistema de terceiro para atualizar os índices da bolsa de referência em que está posicionada.

06. TABELAS UTILIZADAS

07. CONTEÚDOS RELACIONADOS



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