Árvore de páginas


Í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


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.

    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

    • N8C - Cadastro Bolsa de referência;
    • N8U - Índices da bolsa de referência.

    07. CONTEÚDOS RELACIONADOS