Mudanças entre as edições de "Taxa de câmbio por item"

Edição das 14h02min de 21 de maio de 2018

Histórico de Revisões

Data	Quem	Comentários
14/05/2018	Ryvane Maria	Criação do Documento
18/05/2018	Marcus Fábio Salviano	Aprovação Desenvolvimento

Necessidade

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

No momento da tiragem do pedido, o sistema deve apresentar o valor total dos produtos, tanto em real, quanto em outras moedas, 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.

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 de cada moeda.

Isso permitirá inclusão de outras moedas de forma fácil, colaborando na manutenção dos dados.

É importante salientar 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 visualização do valor dos itens 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.

- Tratar a possibilidade de visualizar o valor dos itens em 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) As taxas de câmbio utilizadas serão integradas da tabela SM2 do ERP e cada moeda será associada a sua taxa de câmbio;
2) Deverá ser feita a conversão do valor de cada item, para todas as moedas cadastradas. Com a finalidade de exibir na pop-up de decomposição do preço.
3) Da decomposição de preço, deverão ser criados novos campos que sinalizem o valor daquele item convertido em cadas moeda cadastrada.

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

@@ Linha 31: / Linha 31: @@
 '''- 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.
+Será criada configuração para ativar a funcionalidade de visualização do valor dos itens 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:'''
@@ Linha 43: / Linha 44: @@
 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.
-{| class="wikitable"
-! colspan="5"  | PRODUTO
-|-
-! style="width:150px" |Coluna
-! Tipo
-! style="width:150px" |Obrigatório
-! style="width:150px" |Chave Primária
-! style="width:250px" |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:'''
+'''- Tratar a possibilidade de visualizar o valor dos itens em 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:
-) Verificar a moeda daquele produto(Euro, Dólar, Real, etc) na tabela PRODUTO, através do campo CD_MOEDA;
+) As taxas de câmbio utilizadas serão integradas da tabela SM2 do ERP e cada moeda será associada a sua taxa de câmbio;
-) 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;
+) Deverá ser feita a conversão do valor de cada item, para todas as moedas cadastradas. Com a finalidade de exibir na pop-up de decomposição do preço.
-) 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.
+) Da decomposição de preço, deverão ser criados novos campos que sinalizem o valor daquele item convertido em cadas moeda cadastrada.
-) 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.
-{| class="wikitable"
-! colspan="5"  | PEDIDO
-|-
-! style="width:150px" |Coluna
-! Tipo
-! style="width:150px" |Obrigatório
-! style="width:150px" |Chave Primária
-! style="width:250px" |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:
-[[Arquivo:Pedidos diferentes moedas1.png]]
-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.
-É 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:
-[[Arquivo:Pedidos diferentes moedas2.png]]
-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. Portanto, é necessário excluir a label que informa a moeda padrão da coluna 'preço unitário' (grifada no retângulo vermelho).
 == Regras de Negócio ==