Taxa de câmbio por item

Histórico de Revisões

Data	Quem	Comentários
14/05/2018	Ryvane Maria	Criação do Documento

Necessidade

São comercializados itens em diferentes tipos de moedas, principalmente Euro e Dólar. É necessário que o sistema esteja apto a processar esse tipo de pedido com várias moedas.

Para que isso ocorra, deve-se permitir ao usuário inserir itens com diferentes taxas de cambio, para diferentes tipos de moeda, no momento do cadastro do pedido.

No momento da tiragem do pedido, o sistema deve apresentar o valor total dos produtos, tanto em real, quanto na moeda estrangeira referente aquele item, possibilitando que o usuário visualize os distintos valores, sob aplicação de diferentes taxas de câmbio, para aquele produto, de acordo com a cotação diária daquela moeda.

Solução

Deverão ser cadastradas no ERP as informações de moedas e suas taxas de câmbio. Essas informações serão trazidas para o GeoSales através de integração. Nesse cadastro poderão ser inseridos dados como o nome da moeda, o seu símbolo e a sua taxa de câmbio.

A moeda que definirá o produto será sinalizada através do campo “moeda” na tabela de produtos.

No momento do pedido, na tela da decomposição do produto, o GeoSales irá mostrar o valor em dólar, em euro e em reais, para todos os produtos. O usuário poderá visualizar também a data e a hora da alteração da taxa de câmbio.

Isso permitirá inclusão de outras moedas de forma fácil, colaborando na manutenção dos dados. É importante lembrar que valor final do pedido deve ser dado sempre em Real.

Implementação

- Criação de uma configuração com a finalidade de informar a existência de diferentes moedas:

Será criada configuração para ativar a funcionalidade de cálculo do valor do pedido por taxa de câmbio.

Caso esta configuração esteja ativa, o sistema deverá seguir os passos descritos neste documento.

A configuração, chamada de 'UTILIZA_MOEDA_ESTRANGEIRA', poderá receber os valores 'S', para ativá-la, ou 'N', para desativá-la. O valor default para essa configuração é 'N'.

- Integração das informações de moeda cadastradas no ERP:

No ERP, a tabela SM2 será integrada com a finalidade de atualizar a taxa de câmbio. É desta tabela que o GeoSales irá trazer a informação de taxa de câmbio, para converter os valores emitidos em moeda estrangeira para real.

As informações de taxa de câmbio da tabela SM2 do ERP serão salvas na tabela TIPO_MOEDA do GeoSales.

- Associando a moeda que será utilizada para um produto específico:

A associação produto x moeda deverá ser feita exclusivamente no ERP. É necessário que, na tabela de produto, seja associado, produto a produto uma moeda especificando qual taxa de câmbio será utilizada para este produto específico.

Essa associação será trazida do ERP através do campo XXXXXX da tabela XXXXXX(campo e tabela a definir com o cliente), e salva no ambiente geosales, no campo MOEDA da tabela PRODUTO.

Para viabilizar essa situação, é necessário incluir um campo para associar a moeda a ser utilizada, na tabela PRODUTO.

PRODUTO
Coluna	Tipo	Obrigatório	Chave Primária	Explicação
CD_TIPO_MOEDA	INT	NAO	NAO	Moeda prevalente na venda do produto.

- Tratar a possibilidade de usar de diversas moedas na tiragem do pedido:

No momento da tiragem do pedido, o usuário irá realizar o fluxo usual de cadastro de cabeçalho de pedido e de inserção de itens, porém, ao selecionar um novo item para ser inserido no pedido, e definir a quantidade que será inserida, o sistema deverá realizar os seguintes passos:

1) Verificar a moeda daquele produto(Euro, Dólar, Real, etc) na tabela PRODUTO, através do campo CD_MOEDA;
2) Baseado na moeda definida nesta tabela, deverá ser feita a conversão desta moeda para real. A taxa de câmbio utilizada será integrada da tabela SM2 do ERP e cada moeda será associada a sua taxa de câmbio;
3) Capturando a informação de taxa de câmbio, o sistema deverá realizar essa conversão, pois o valor do pedido será dado em reais, ou seja, antes de adicionar o valor do item ao pedido, este deverá ser convertido para real. 
4) Apesar de ser somado ao valor final do pedido o total em Real dos itens, o usuário irá visualizar, item a item, na tela de pedido, o valor digitado na sua moeda de conversão, seja ela Euro, Dólar, Real ou outra qualquer. 

- Sinalizar a existência de itens com moeda estrangeiras no pedido:

Para sinalizar que aquele pedido possue itens com moeda estrangeira, será criada uma flag, na tabela PEDIDO, chamada ID_MOEDA_ESTRANGEIRA, que será setada com o valor 'S' caso haja itens com moeda estrangeira no pedido, ou 'N' caso não hajam. Esse campo assumirá o valor 'N' no caso de nulidade.

Para viabilizar essa situação, é necessário incluir um campo para salvar essa flag, na tabela PEDIDO.

PEDIDO
Coluna	Tipo	Obrigatório	Chave Primária	Explicação
ID_MOEDA_ESTRANGEIRA	INT	NAO	NAO	Flag que define se o pedido possui moeda estrangeira.

Informado que o pedido contém moeda estrangeira, será enviado através da tabela ITEM_PEDIDO no campo VR_ITEM_MOEDA_ESTRANGEIRA a taxa de câmbio utilizada para realizar a conversão de moeda deste item. (O valor da taxa de câmbio da moeda, trazido da tabela SM2)

Na tela de pedido, pequenos ajustes devem ser feitos de forma a sinalizar a existência de itens com diferentes taxas de câmbios, por exemplo:

Nesta imagem podemos visualizar, através das setas em vermelhos, componentes de texto que irão ser alteradas conforme o símbolo referente a moeda que será utilizada naquele item.

O preço unitário item a item poderá, então, ser dado em diversos tipos de moedas, conforme o cadastro no ERP, e precisará ser definido separadamente para cada item inserido no pedido.

É importante salientar que o valor final do item, com cálculo de impostos será dado em Real, bem como o valor final de pedido e todas as outras informações exibidas no pedido, como pode ser visualizado na imagem abaixo:

Regras de Negócio

RN1 - Um produto só pode ter uma moeda associada a ele.

RN2 - Caso não haja nenhuma moeda vinculada a um determinado produto no ERP será utilizada a moeda padrão local, ou seja, Real.

RN3 - Caso a moeda do produto for a moeda local, ou seja, real, não será necessária realizar a conversão de moeda. (Deixar o cálculo padrão com taxa de câmbio igual a 1 é uma opção)

RN4 - O valor final do final do pedido será calculado sempre na moeda padrão, ou seja, Real.

Aprovação

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

Setor	Aprovado Por	Data	Assinatura
Gerente TI
Gerente Projeto
Gerente Comercial