UCPTL00001 - Cadastro de margem mercantil

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:

FAIXA DE VALOR DE VENDA	À VISTA	PRAZO
0,01 a 149,00	26,00	25,00
150,00 a 249,00	42,00	40,00
250,00 a 449,00	68,00	65,00
450,00 a 649,00	114,00	110,00
650,00 a 849,00	161,00	155,00
850,00 a 1099,00	208,00	200,00
1100,00 a 1299,00	265,00	255,00
1300,00 a 1499,00	312,00	300,00
1500,00 a 1699,00	354,00	340,00
1700,00 a 1899,00	395,00	380,00
>= 1900,00	437,00	420,00

    
    Os valores mercantis para as faixas na tabela acima são apenas exemplos, para cadastrar as margens mercantis é necessário solicitar documentação oficial da operadora.

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 é 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: O campo ‘De’ deve iniciar em‘XXX,XX. Onde XXX,XX equivale ao valor correto.

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: O campo ‘De’ deve iniciar em‘XXX,XX. Onde XXX,XX equivale ao valor correto.

Fluxo 3: 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: O campo ‘De’ deve iniciar em‘XXX,XX. Onde XXX,XX equivale ao valor correto.

Fluxo 4: 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. Onde XXX,XX equivale ao valor correto.

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 ou menor que o início de vigência informado para um registro já cadastrado 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,00.
   • 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,00 a 149,99
     • Segunda faixa: 150,00 a 249,99.
3. 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.