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

Será criado um CRUD para possibilitar o cadastro das informações de moedas, além disso, esse cadastro poderá ser carregado também através de integração. Nesse cadastro poderão ser inseridos 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. O valor final do pedido será dado sempre em Reais. (Moeda local)

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'.

- Criação de um CRUD com a finalidade de cadastrar as informações de moeda:

Inicialmente, será necessário criar um CRUD, com a finalidade de cadastar as informações de moeda. Neste cadastro poderão ser inseridos o nome da moeda (por exemplo: real), a sua sigla (por exemplo: RE, para real, DL para dólar e etc.) e a sua taxa de câmbio (valor que será utilizado para realizar a conversão de moeda).

É importante salientar que, inserindo as informações de moeda neste cadastro, o valor da taxa de câmbio será fixo e não será atualizado diariamente, da mesma forma que seria caso o dado fosse cadastrado no ERP.

- 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 XXXXXX 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, 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 original, 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 possuem 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)

---

salvar na tabela a taxa de cambio real como se fosse o valor 1

Regras de Negócio

RN1 - O cadastro de uma moeda específica sobrepõe qualquer possível integração dessa informação. Isso significa que, mesmo que este dado tenha sido integrado do ERP, caso seja cadastrada uma moeda no portal, a taxa de câmbio que será utilizada para conversão será a cadastrada pelo usuário.

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

RN3 - Caso não haja nenhuma moeda vinculada a um determinado produto no ERP, ou nenhum cadastro de moeda relacionado a este produto no GeoSales, será utilizada a moeda padrão local, ou seja, real.

RN4 - 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)

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