Í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 :
- Acesse no módulo SIGAAGR: Atualizações >Comercialização>Precificação>Bolsa de Referência;
- Clique em Incluir;
- Informe os dados obrigatórios da bolsa de referência;
- Clique em Confirmar.
Para alterar:
- Acesse no módulo SIGAAGR : Atualizações >Comercialização>Precificação>Bolsa de Referência;
- Posicione na bolsa de referência que deseja alterar.
- Clique em Alterar;
- Modifique os campos desejados;
- Clique em Confirmar.
Para visualizar:
- Acesse no módulo SIGAAGR : Atualizações >Comercialização>Precificação>Bolsa de Referência;
- Posicione na bolsa de referência que deseja visualizar;
- Clique em Visualizar.
Para excluir:
- Acesse no módulo SIGAAGR : Atualizações >Comercialização>Precificação>Bolsa de Referência;
- Posicione na bolsa de referência que deseja excluir;
- Clique em Outras Ações>Excluir;
- Confira os dados;
- Clique em Confirmar.
03. PARÂMETROS/CONFIGURAÇÕES
Nota
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_AGRO200 | URL: Utilizada para realizar a autenticação de integração com a M2M. | |
E-mail para realizar a autenticação para a geração do Token e integração M2M. |
||
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ódigo | Có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ário | Código do usuário. Permite restringir a atualização de índice vinculados a bolsa de referência por usuário. |
Grp. Usuário | Có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 produto | Código produto que estará vinculado a bolsa de referência. |
Unid. Med. | Código da unidade de medida. |
Moeda | Có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
- N8C - Cadastro Bolsa de referência;
- N8U - Índices da bolsa de referência.