Edição das 10h29min de 22 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 valor de venda final ao cliente.

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.

Fluxos alternativos

Fluxo 1:

Fluxos de exceções

Fluxo 1:

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.