Melhorias Integração Hedge Moeda

Características do Requisito

Descrição

1. Vincular Trade Slip de Vendas a Trade Slip de Compras

Necessário relacionar um ou mais Trade Slip de compras a um Trade Slip de vendas. O vínculo acontecerá apenas no Trade Slip de Vendas, registrado pela rotina Novos Negócios (GG0103), e poderá vincular um ou mais Trade Slip de Compras. No cadastro da finalidade (GG1034), (ex. Exportação, registro, vendas mercado interno) será identificado como a mesma se comporta com relação ao vínculo: 1 – Não Possui, 2- Opcional ou 3 – Obrigatório. Desta forma, nas vendas de determinada finalidade poderá ser parametrizado para obrigar o vínculo com o contrato de compra.

Validações em cada situação: 1 – Não Possui: Não irá permitir efetuar vínculo com contrato de compras. 2 - Opcional: Permitirá vincular contratos de compras, parcial ou total da quantidade do Trade Slip. Caso não vincular nenhum contrato de compras, irá permitir salvar o Trade Slip.  3 – Obrigatório: Irá obrigar a vincular exatamente a mesma quantidade do Trade Slip de Vendas.

Necessário parametrizar quais componentes devem ser estornados quando estiverem em um Trade Slip de compras vinculado a um Trade Slip de Vendas. Exemplo: FRETE TOTAL, FOBBINGS R$. No cadastro destes componentes (GG1014), deve ter relacionado um outro componente para absorver esses valores e compor a margem de vendas. (Ex.: FRETE COMPRA, FOBBINGS COMPRA).  Estes componentes estarão no Trade Slip de vendas para apurar o impacto na margem. A taxa de cambio para estes componentes de estorno serão as taxas de reversão do Hedge. Caso tenha mais de um contrato de compras vinculado ao Trade Slip de vendas, será efetuado média ponderada das taxas das reversões.

No Trade Slip de Vendas, somente permitir selecionar Trade Slip de Compras, que possua saldo a ser relacionado. Pode permitir parcial em volume, porém no máximo até a quantidade do Trade Slip de Compras. Caso for Obrigatório vincular contratos de compras, conforma a finalidade e não for vinculado quantidade suficiente será apresentada mensagem de validação, impedindo confirmar o Trade Slip:

A vinculação será feita através da pasta “Vinculação”:

Ao acionar a vinculação, será apresentada tela para informar quais contratos de compras serão vinculados, que podem ser localizados através do botão Filtro:

Para selecionar os contratos, utilizando o botão filtro:

Após selecionar os contratos, confirmar as quantidades:

Ao aprovar um Trade Slip de Vendas, com vinculo em Trade Slip de compras, necessário efetuar o estorno do Hedge, ou seja criar uma integração de reversão, dos componentes indicados, nos boletos originais do Trade Slip de compra.

Na integração com sistema de Hedge de Moeda, irá a indicação de reversão por cancelamento.

Na tela de monitor do Hedge, poderá ser feito acompanhamento das reversões, pela transação “Componente Vinculado”.

O Trade Slip original de compra vinculado a venda, não sofrerá nenhuma alteração ou recalculo de margem. O que vai ocorrer é a reversão dos Boletos dos componentes indicados (frete e fobbings) diminuindo o seu saldo.

Considerações após o vínculo do TS de compras com TS de Vendas:

• Ao cancelar um TS de compras que tenha vínculo com TS de Vendas, não será feito nenhuma movimentação nos Boletos de Hedge que foram revertidos (Ex.  FRETE TOTAL, FOBBINGS R$).
• Ao cancelar um TS de vendas que tenha vínculo com TS de Compras, não será feito nenhuma movimentação em relação aos Boletos de Hedge que foram revertidos. (Ex.  FRETE TOTAL, FOBBINGS R$).
• Ao efetuar uma alteração, ou mudança de execução de um TS de Compras que tenha vínculo com TS de Vendas, não será permitido alterar os valores de componentes que possuem vínculo e foram estornados no TS de vendas.
• Ao efetuar uma alteração, ou mudança de execução de um TS de Vendas que tenha vínculo com TS de Compras, não será permitido alterar os valores de componentes que possuem vínculo e foram estornados no TS de vendas.
• Após passar para a situação Banking, as reversões referente o vínculo do TS de Compras com vendas serão demonstradas na tela de Monitor do Hedge (gg0104), bem com no relatório de companhamento (GG4103).

Nota: Não está previsto estorno de reversão, caso seja necessário o cancelamento do TS de Vendas, referente as baixas realizadas nos componentes do TS de compra, pois  não há integração com sistema de Hedge que suporte esta transação. Caso venha a ser desenvolvido um layout para este tipo de integração, será novamente analisada esta situação.

Importante

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

Antes de executar o compatibilizador informe o nome do compatibilizador é imprescindível:

• Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão  11).
• Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
• Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
• Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
• O compatibilizador deve ser executado com a Integridade Referencial desativada*.

1. Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
2. Clique em OK para continuar.
3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
   1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
   2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
   3. Clique em Gravar para salvar o histórico (log) apresentado.
   4. Clique em OK para encerrar o processamento.

Descreva se há algum procedimento necessário após a aplicação do compatibilizador.

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

1. Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
2. No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:

Atualizações do Compatibilizador

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

1. Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:

2.    Criação ou Alteração de tabela no arquivo SX2– Tabelas:

3.  Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:

4.  Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:

• Tabela BGD - Prod x Cob x Proc x Co-Part:

Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

5.  Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:

• Pesquisa B05PLS:

6.  Criação ou Alteração de Índices no arquivo SIX – Índices:

7.  Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:

8.  Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:

• Tabela BD5 – Contas Médicas:

Procedimento para Configuração

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou  rotinas no menu).

CONFIGURAÇÃO DE PARÂMETROS

1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
   (É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

CONFIGURAÇÃO DE MENUS

2.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:

Procedimento para Utilização

• Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
• Localização da rotina no menu;
• Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
• Caso seja necessário ter algum cadastro feito previamente, faça uma observação.

Exemplo:

       1.            No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).

O sistema apresenta a janela de produtos cadastrados.

       2.            Posicione o cursor em um produto e clique em Alterar.

       3.            Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.

       4.            Dê duplo clique no campo TP Prestador (BCW_TIPPRE).

O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.

       5.            Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:

                      Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.

       6.            Confira os dados e confirme.

Vídeo

• Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.

** Canal do youtube e software de vídeoem definição.

2. Alterações na Tela de Trade Slip para Local Embarque

Este item é referente alguns específicos que hoje estão da tela do Trade Slip que a Cofco deixará de utilizar (GG2015 – Compras / GG2027 - Vendas) para alguns produtos. 

 Incluir Novo Campo a ser solicitado no Trade Slip:

      • Emitente de Embarque (validar com cadastro de clientes/fornecedores) Local de Embarque (validar com cadastro de local de entrega)   

      • No campo de fornecedor/cliente do local de embarque, incluir menu para escolha de programa de pesquisa (zoom), permitindo escolher entre o cadastro de clientes/fornecedores ou Locais de Entrega.

      • No Trade Slip de Compras, caso escolher a pesquisa de local de entrega, e for tipo de frete FOB, trazer para o campo de cidade e estado as informações do local de entrega.

      • No Trade Slip de Vendas, estas informações de local de entrega, devem ser solicitadas no produto do Trade Slip.

      • No Trade Slip de Vendas, este local de embarque não é o cliente do pedido de vendas (Destino), e sim o local onde o produto se encontra (Origem). Desta forma, ao informar o local de embarque no primeiro produto, buscar a cidade e estado deste local para trazer esta informação para o TS.

TS Compras:

 Image Added

TS Vendas:

Image Added

Importante: Ao completar um Trade Slip de novo Contrato, é possível alterar o local de embarque, porém deverá ser na mesma Cidade/Estado informado na Inclusão do TS.

3. Quantidade de contratos por item e componente

No resumo II, da tela de Trade Slip (GG0103), referente componente da Bolsa é demonstrada a quantidade de contratos. Até antes deste desenvolvimento, o fator para cálculo da quantidade de contratos estava na tela de calendário da bolsa, que é por grupo de estoque.

Pode ocorrer situações onde o grupo de estoque, tenha mais de um item, com fator para cálculo da quantidade de contratos diferente.

Para tratar esta situação, incluir no relacionamento Itens X componentes (GG1014), a informação da quantidade de contratos e com isso permitirá parametrizar fatores diferentes por item, para cada componente. Ex.:

• CBOT para farelo, fator para conversão de Kg para quantidade de contratos é 90.719,4000.
• CBOT para óleo, fator para conversão de Kg para quantidade de contratos 27.215,6000.
• CBOT para soja, fator para conversão de Kg para quantidade de contratos é 136.074,5400. 

  
Image Added

4. Rolagem Parcial

Permitir efetuar uma rolagem parcial do saldo de um Boleto.

Ao efetuar a rolagem, permitir informar um valor, que poderá ser o valor de saldo total ou menor. Nunca poderá ser maior que o valor de saldo. Caso seja parcial, será efetuada uma divisão do Boleto Original, permanecendo uma parte do saldo no Boleto Origem e solicitação de Novo Boleto.  

Caso seja parcial, e o componente seja do tipo Preço Produto, efetuar uma divisão também das previsões de pagamento no Trade Slip e no Contrato.

Assim como na rolagem total, não terá cancelamento da rolagem parcial. Para ajustes é necessário efetuar nova rolagem.

5. Permitir Alterar um Trade Slip que já tenha sofrido outras alterações

Apenas Trade Slips do tipo Novo ou Fixação permitem hoje a inclusão de Trade Slip de Alteração ou Mudança de Execução.

A necessidade é que possa ser feito alterações sobre Trade Slip do tipo Alteração, ou seja efetuar uma nova alteração ou mesmo uma mudança de execução. 

Caso tenha Multa do Trade Slip de origem da alteração, não terá alteração desta Multa, porém poderá ser informado novos valores de Multa, no novo Trade Slip de alteração.

6. Gerar Contrato de Vendas automaticamente através do Trade Slip

Parametrizar na finalidade se deseja gerar automaticamente o contrato de vendas ou compras através do Trade Slip, após a etapa de completar.

      Image Added                 

Desenvolver a opção de gerar o contrato de vendas através do trade slip, semelhante a opção que há no trade slip de compras após completar o mesmo.

 Image Added

7. Alteração Rolagem Rejeitada 

Uma rolagem, feita na tela de Monitor Hedge (GG0104), pode ser rejeitada pelo sistema de Hedge (SBM) devido a nova data para vencimento informada, não ser aceita pelo sistema de Hedge. 

Cria uma opção na tela de monitor de Hedge (GG0104), para quando uma rolagem for rejeitada, permitir alterar a data de vencimento, e submeter novamente a integração. 

Esta nova data, caso seja em componente do tipo Preço Produto, deve atualizar a data de previsão de pagamento no Trade Slip e Contrato. 

Esta opção poderia ser utilizada também para outros Boletos gerados por TS, que foram rejeitados por data inválida, ou seja não apenas para Boletos de rolagem.

8. Vendas Exportação: inicializar data 1ª parcela de pagamento

Em vendas exportação a data da 1ª parcela, não é obrigatória, pois não terá hedge de produto, considerando que o valor da cobrança não será na moeda corrente (reais).

Para não obrigar informar uma data prevista da 1ª parcela, será usado a condição de pagamento para trazer uma data automaticamente a data prevista.  

Importante: a regra para busca da 1ª data de cobrança será conforme os padrões do ERP, e logo o critérios para feriados e finais de semana será conforme o cadastro do fornecedor.

Image Added

9. Vendas Exportação: componentes de preço

Para determinadas finalidades podem não ser necessários todos componentes que existem, como exemplo componentes de Margens e Fretes.

Também pode não ser necessário calculo de Margem. Por padrão, o sistema de Originação exige que tenha pelo menos um componente de margem no TS, que pode não ser listado por padrão, e não ter o seu valor calculado (zero). Outros componentes de totais, e cálculos de margens podem não ser necessários e assim precisam ser restringidos apenas a algumas finalidades.

Para desconsiderar alguns componentes, no cadastro de componente de preço (GG1014) restringir os componentes por finalidade, e assim trazer apenas os componentes que interessam para a finalidade usada na exportação (Registro). Exemplo: CBOT, Premio, Fobbings U$.

A pasta Finalidade, do cadastro GG1014, funciona por exceção, ou seja, caso não tiver nenhum informação será considerado todas as finalidades. Caso tenha informação, o componente será restrito para apenas estas finalidades.

Image Added

Como exemplo do componente acima, que está restrito a algumas finalidades, na finalidade 06 – exportação registro, não será apresentado ou calculado este componente:

 Image Added

10. Vendas Exportação: Unidade de Medida do preço

Nas vendas exportação a unidade de medida de preço (Toneladas) é diferente da originação (Sacas).

Para permitir esta situação, no cadastro de finalidade (GG1014), necessário ter um parâmetro indicando que permite informar a unidade de medida no Trade Slip de vendas.

 Image Added

Com a finalidade parametrizada, ao incluir um novo negócio de vendas (GG0103), poderia ser informa a unidade de medida desejada (toneladas) para o preço a ser fixado. Esta unida

de de medida seria atualizada no contrato quando da geração do mesmo.

 Image Added

Image Added

Atenção: Informar a unidade de medida no TS não é obrigatória, se não for informada a unidade de medida (deixando em branco) ou se a finalidade NÃO permitir alterar a unidade de medida do preço, será considerada a unidade de medida comercial padrão do produto.

Image Added

11.Vendas Exportação: Calcular Preço Produto

A necessidade é que o preço produto venha automaticamente conforme o preço calculado pelos componentes. Exemplo: CBOT (+), Premio (+), Fobbings U$(-).  

Para atender esta necessidade, que já existia no Trade Slip usado antes do projeto Hedge (gg2015/gg2027), no cadastro de finalidade incluir um parâmetro para indicar que deseja replicar o preço calculado sobre o preço proposto.

Parâmetro Cadastro Finalidade:

Image Added

Este novo parâmetro será utilizado no Trade Slip de Compra e Vendas, para indicar que o valor do componente do tipo Preço Proposto a ser fixado, será sugerido com base no componente do tipo Preço Calculado.

Para que esta sugestão ocorra, é necessário que o TS de fixação de preço tenha um componente do tipo Preço Calculado e um componente do tipo Preço Proposto:

Image Added

Image Added

Importante que estes componentes estejam relacionados a finalidade:

Image Added

O valor determinado no componente Preço Calculado será atualizado no componente Preço Proposto. É permitido alterar este preço produto, caso for necessário.

Atenção: o componente do tipo preço calculado é determinado através dos outros componentes do Trade Slip. Há duas formas de calculo que podem ser usadas (uma ou outra):

a)  Pelo tipo de cálculo dos outros componentes do TS:

Quando Custo  (- Diminuir)

Quando Preço  (+ Somar)

Image Added

b) Pelos componentes relacionados:

Se no componente do tipo preço calculado, tiver outros componente relacionado, seguirá o que for determinado neste relacionamento: Somar ou Diminuir.

Image Added

Ao criar um Trade Slip, irá fazer o cálculo do componente do tipo preço calculado e atualizar o resultado (quando for maior que zero) no componente do tipo Preço Proposto.

 Image Added

12. Vendas Exportação: Outras Moedas além do Real e Dolar (Ex,: Euro)

Necessidade de informar preço produto em outras moedas.

Na exportação, quando utiliza uma moeda para o preço, que não seja a moeda da Margem (Exemplo: Dolar), e que também não é a moeda corrente (reais), o sistema acaba precisando duas cotações (Euro -> reais, reais -> Dolar) para permitir concluir o Trade Slip, pois todos valores de componentes precisam ser  convertidos para a Moeda da Margem (U$).

Para que os valores sejam apresentados corretamente, não será obrigatório digitar a cotação da moeda da Margem (ex. dólar). Como é uma exigência do Trade Slip, passar a utilizar a cotação diária da moeda da margem, cadastrada no sistema para fazer esta conversão.

Nesta situação, de ter duas moedas estrangeiras envolvidas no mesmo Trade Slip, será utilizado o cadastro de cotações diárias, do dia que estiver cadastrando o Trade Slip:

Image Added

Ao registrar o Trade Slip, será solicitado a cotação da moeda do Preço (ex. Euro):

Image Added

Após informar a cotação da moeda do Preço (E$), será feito o cálculo do preço calculado, e caso a finalidade estiver replicando o preço para o produto, será apresentado:

Image Added

Preço Produto será sugerido, se a finalidade indicar, conforme o cálculo:

(CBOT + Premio – Elevação) = U$ 412,19694/TN   /* fórmula Preço Calculado GG1014 */

Preço Produto = 412,19694 * 3,12 / 3,3 = E$ 389,71347/TN

Sendo que: 3,12 cotação do dia para moeda dólar e 3,3 cotação euro informada no Trade Slip.

13. Vendas Exportação: Moeda geração de pedidos de exportação

Os pedidos de vendas exportação, devem ser gerados na moeda do contrato. Hoje já existe no sistema, parâmetro (GG1107- Parâmetros grãos por estabelecimento) que permite indicar para gerar o pedido na moeda do contrato. Este parâmetro é único para vendas Mercado interno e externo.

Para não depender deste parâmetro, será solicitado no TS de Vendas, um novo campo Moeda Pedido de Vendas. Este campo será inicializado com a informação da moeda do Trade Slip, e somente poderá ser alterada, quando a moeda do Trade Slip for diferente de moeda corrente.

Ao registrar um contrato novo de vendas é informado a moeda do contrato:

Image Added

Ao completar o TS, é informada a moeda do pedido de vendas, que por padrão será sempre igual a moeda do contrato, mas poderá ser alterada:

Image Added

Ao gerar o pedido de vendas, irá obedecer a moeda informada no TS.

14. Vendas Exportação: Portador Financeiro   

Conforme a moeda do pedido, o sistema exige um portador que esteja parametrizado para a mesma. Hoje é utilizado os parâmetros de grãos (GG1005), onde há apenas um portador para moeda estrangeira, que pode ou não estar apto a receber o pedido de venda em uma ou mais moedas.

No Trade Slip de vendas exportação, permitir informar o portador para pedido de vendas, para quando tiver exceções (como o caso do Euro), permitir informar o portador financeiro que a empresa trabalha.

Caso não seja informado um portador no Trade Slip, ao confirmar a etapa de completar, será atualizado o Trade Slip e também o contrato com o portador padrão o informado nos parâmetros de grãos. Caso não tiver informação nos parâmetros de grãos, será atualizado como padrão o portador do cadastro de clientes (CD0704).

Image Added

Nos detalhes do contrato de vendas (GG1090) será possível consultar e também alterar o portador para o pedido, quando o contrato estiver na situação “Em Negociação”.

Image Added

Com o portador compatível com a moeda do pedido, o mesmo será gerado ao fechar o contrato:

Image Added

Ponto de Entrada

Exemplo:

#Include 'Protheus.ch'

User Function CN120ALT()

Local aCab:= PARAMIXB[1]

Local cTipo:= PARAMIXB[2]

If cTipo == '1'

    aCab[4][2]:= 'NF' //Validações do usuário

EndIf