Edição das 10h31min de 23 de dezembro de 2014

Módulos/Sistemas

• Painel Telefonia

Objetivo

• Cadastrar margem mercantil a ser utilizada no cálculo de contas a receber da operadora e contestação.

Introdução

A margem mercantil é o valor concedido ao parceiro da Claro referente à compra ou venda de um aparelho/modem. Ela é única para todos os agentes autorizados e independe da classificação, mas varia de acordo com a condição de pagamento no momento do faturamento do aparelho (a vista ou a prazo) e de acordo com o preço de venda (oficial da operadora).

Tabela exemplo de valores de margem mercantil:

Atores

• ATS Informática

Pré-requisitos

• No projeto da rotina, em confsrc > META-INF > messages > view.properties definir o nome como Margem mercantil. Este nome será utilizado para criar a página no Wiki
• Considerar documento Padrões de desenvolvimento.

Fluxo de eventos

Fluxos principais

Fluxo 1: Usuário acessa Menu -> Cadastro -> Margem mercantil.

• Sistema exibe a tela de pesquisa da rotina conforme regra de negócio RN01.

Fluxo 2: Usuário aciona o botão [Adicionar margem mercantil].

• Sistema exibe a tela de manutenção da rotina conforme regra de negócio RN02.

Fluxo 3: Usuário preenche os dados da margem mercantil e aciona o botão [Salvar].

• Sistema salva os dados no banco de dados e emite ao usuário a seguinte mensagem de informação: Margem mercantil cadastrada com sucesso!

Fluxos alternativos

Fluxo 1: Para uma determinada data de início de vigência o usuário cadastra uma margem mercantil com a faixa de valor idêntica a faixa de valor de uma margem já cadastrada, mas com o tipo de preço diferente.

• Sistema cadastra normalmente a margem mercantil.

Fluxo 2: Para um determinado tipo de preço o usuário cadastra uma margem mercantil com a faixa de valor idêntica a faixa de valor de uma margem já cadastrada, mas com o início da vigência diferente.

• Sistema cadastra normalmente a margem mercantil.

Fluxos de exceções

Fluxo 1: Usuário tenta cadastrar/alterar uma margem mercantil cuja data de início da vigência é menor ou igual à data de início da vigência de outras margens mercantis já cadastradas com a mesma faixa de valor e mesmo tipo de preço.

• Sistema aborta a operação e emite ao usuário a seguinte mensagem de alerta: Já existe uma margem mercantil cadastrada com o início da vigência, faixa de valor e tipo de preço informados.

Fluxo 2: Usuário tenta cadastrar/alterar uma margem mercantil cuja faixa de valor não seja sequencial em relação a última margem cadastrada para o mesmo início de vigência e tipo de preço informados.

• Sistema aborta a operação e emite ao usuário a seguinte mensagem de alerta: A faixa de valor da margem mercantil em questão deve ser sequencial em relação à última margem mercantil cadastrada para o mesmo início de vigência e tipo de preço informados.

Fluxo 2: Usuário tenta cadastrar/alterar uma margem mercantil cujos valores compreendidos na faixa informada já estão compreendidos em uma faixa já cadastrada para o início de vigência e tipo de preço em questão.

• Sistema aborta a operação e emite ao usuário a seguinte mensagem de alerta: Os valores contidos na faixa informada já estão compreendidos em outra margem mercantil já cadastrada para o mesmo início de vigência e tipo de preço.

Fluxo 3: Usuário cadastra/altera uma margem mercantil informando no campo Valor margem mercantil um valor menor ou igual a 0,00.

• Sistema aborta a operação e emite ao usuário a seguinte mensagem de alerta: O valor da margem mercantil deve, obrigatoriamente, ser maior que 0,00.

Regras de negócio

RN01 - Tela de pesquisa

Exibirá as margens já cadastradas em um grid com as seguintes colunas:

• INÍCIO DA VIGÊNCIA
• TIPO DE PREÇO
• DE
• ATÉ
• VALOR

No canto superior esquerdo do grid estará disponível o botão [Adicionar margem mercantil], que quando acionado direcionará o usuário para a tela de manutenção.

RN02 - Tela de manutenção

Permitirá ao usuário incluir, visualizar ou alterar margens através dos seguintes campos:

1. Início da vigência: Campo onde o usuário deverá informar a data em que a margem cadastrada passará a ser utilizada pelo sistema.
2. Tipo de preço: Campo onde o usuário deverá definir o tipo de preço ao qual a margem mercantil será aplicada. As opções serão:
   • À vista (opção padrão)
   • A prazo
3. Faixa de valor Campos onde o usuário deverá informar a faixa de valor (valor inicial e valor final) para qual a margem mercantil será aplicada.
4. Valor margem mercantil: Campo onde o usuário deverá informar o valor da margem mercantil que será repassada ao parceiro.
5. Botão [Salvar]: Verifica/valida os dados informados na tela e salva o registro no banco de dados.
6. Botão [Cancelar]: Aborta a operação atual e retorna à tela de pesquisa.

Validações

Quando incluindo ou alterando uma margem mercantil, quando o botão [Salvar] for acionado o sistema fará as seguintes validações:

1. Início da vigência: A data de início de vigência informada pelo usuário deve ser maior que o início de vigência informado para um registro cuja faixa de valor é igual à faixa do registro em questão.
2. Faixa de valor: Para faixas de valores cuja data de início da vigência é a mesma o sistema verificará se as faixas foram cadastradas de forma progressiva e não estão repetidas. Exemplos:
   • A primeira faixa de valor cadastrada para uma determinada data deverá, obrigatoriamente, começar com 0,01.
   • O valor inicial da segunda faixa cadastrada para uma determinada data deverá, obrigatoriamente, ser maior que o valor final da faixa anterior. Exemplo:
     • Primeira faixa: 0,01 a 149,00
     • Segunda faixa: 150,00 a 249,00.
3. O valor da margem mercantil deverá, obrigatoriamente, ser maior que 0,00.
4. Será permitido cadastrar margens mercantis com mesmo início de vigência e faixa de valor desde que o tipo de preço seja diferente.