UC00108 - Cadastro de kit

Objetivo

• Manter cadastro de kits.

Atores

• Usuário

Pré-requisitos

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

Resultado esperado

• Cadastrar no sistema Kits de produtos.

Diagrama de classes

Fluxo de eventos

Fluxos principais

Fluxo 1: Usuário acessa Menu > Cadastros > Faturamento > Item > Kit.

• Sistema exibe a tela de pesquisa da rotina em questão conforme regra de negócio RN02.

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

• Sistema exibe a tela de manutenção da rotina em questão conforme layout sugerido e RN01.

Fluxo 3: Usuário informa dados do kit e aciona o botão [Salvar].

• Sistema salva o kit.

Fluxos alternativos

Fluxo 1: Em modo de inclusão ou alteração, usuário marca o parâmetro Este kit é um combo.

• Sistema calcula o valor total de cada item do kit (quantidade * preço unitário) com base na tabela de preço padrão da filial logada, soma os totais dos componentes do kit e exibe o resultado no campo Total do kit na tabela PADRÃO.
• Sistema habilita os campos de desconto e acréscimo em valor e percentual.
• Caso haja desconto ou acréscimo sistema faz o calculo com base no total do kit na tabela padrão e exibe o valor líquido no campo Total líquido do kit.
• Na venda, ao incluir este kit a soma dos componentes do mesmo deverá ser equivalente ao Total líquido do kit exibido em seu cadastro. O desconto deverá ser rateado (e arredondado se necessário) entre os componentes do kit. Já o acréscimo será rateado e embutido sobre o valor unitário de cada componente.

Fluxo 2:

Fluxos de exceção

Fluxo 1:

Regras de negócio

RN01 - Descrição dos campos e funcionalidades da tela (de manutenção)

Cabeçalho do kit

1. Ativo: Parâmetro que define se um determinado kit está ativo para uso ou não. Kits inativos não serão enxergados pelas demais rotinas do sistema.
2. Este kit é um combo: Parâmetro que define que o kit é um combo, habilitando os campos de desconto e acréscimo sobre a soma dos valores dos itens que o compõem. O combo caracteriza-se na compra de determinados produtos que junto tem um preço diferenciado, exemplo: Combo do McDonalds batata, refrigerante e sandwiche, que juntos tem um preço mais em conta do que quando comprados separadamente.
3. Produto pai: Campo onde o usuário deverá informar um produto que caracterizará o kit. Pode ser um produto já existente ou um produto cadastrado especificamente para kit, exemplo:
   • Produto já existente: Usuário seleciona o produto Pneu para ser o pai de um determinado kit que contem como componente o produto válvula e o serviço instalação. Desta forma sempre que o pneu em questão for informado na venda, o sistema entenderá que ele é um kit e quando ele for adicionado no grid, seus componentes serão automaticamente adicionados.
   • Produto cadastrado especificamente para o kit: Usuário cadastra o produto Pague 2 leve 3 e o informa como produto pai de um determinado kit. Sempre que o produto em questão for informado na venda, seus componentes serão automaticamente adicionados, uma vez que o produto pai não é comercializado (opcional via parâmetro), mas sim seus componentes.
4. Faz parte dos itens: Parâmetro que determina se o produto que é pai do kit fará parte dos componentes no ato da venda. Com este parâmetro ativo ao inserir os componentes de um determinado kit na venda o sistema também adicionará no grid o produto pai.
5. Qtde.: Este campo ficará habilitado somente se o parâmetro Faz parte dos itens estiver ativo. Nele o usuário deverá informar a quantidade do produto pai a ser inserida na venda quando o mesmo fizer parte dos itens. Caso item pai não faça parte dos itens, este campo ficará desabilitado com a quantidade padrão 1.
6. Unidade: A exemplo da quantidade, este campo só ficará ativo quando o parâmetro Faz parte dos itens estiver ativo. Quando habilitado ele trará selecionada automaticamente a unidade padrão do produto pai, permitindo que o usuário selecione outra unidade (somente de saída) se desejar. Caso item pai não faça parte dos itens, este campo ficará desabilitado e preenchido com a unidade padrão do mesmo.
7. Total do kit na tabela padrão: Campo somente leitura que terá a funcionalidade invocada somente quando o parâmetro Este kit é um combo estiver ativo. À medida que forem adicionados componentes no kit, o sistema irá somar neste campo os preços de venda dos mesmos com base na quantidade informada e na tabela de preço padrão da filial logada. Caso produto pai faça parte do kit o preço dele também será considerado.
8. Desconto em percentual e em valor: Campos onde o usuário poderá informar desconto em percentual ou em valor a ser aplicado sobre o total do kit na tabela padrão. Se for informado um desconto em valor, o sistema calculará automaticamente o percentual equivalente. Caso seja informado desconto em percentual, o sistema calculará automaticamente o valor equivalente. Na venda, caso haja desconto informado no kit, este será considerado em percentual e aplicado sobre o total dos itens de forma rateada independente da tabela de preço selecionada.
9. Acréscimo em percentual e em valor: Campos onde o usuário poderá informar acréscimo em percentual ou em valor a ser aplicado sobre o total do kit na tabela padrão. Se for informado um desconto em valor, o sistema calculará automaticamente o percentual equivalente. Caso seja informado desconto em percentual, o sistema calculará automaticamente o valor equivalente. Na venda, caso haja acréscimo informado no kit, este será considerado em percentual e aplicado sobre o preço unitário dos itens de forma rateada independente da tabela de preço selecionada.

Componentes do kit

1. Item: Campo onde o usuário deverá informar um produto ou serviço que fará parte dos componentes de um determinado kit.
2. Unidade: Campo onde o usuário deverá selecionar a unidade de saída do item informado como componente do kit. Assim que o item for informado o sistema exibirá automaticamente a unidade padrão do mesmo, permitindo que o usuário a altere se desejar.
3. Grade: Caso item informado controle grade este campo ficará habilitado para que o usuário selecione, obrigatoriamente, a grade que fará parte do kit. Caso item não controle grade, este campo ficará desabilitado com o item GRADE PADRÃO selecionado.
4. Qtde.: Campo onde o usuário deverá informar a quantidade do item que será componente do kit.
5. Qtde. Fixa: Este parâmetro define que a quantidade informada para o componente de um determinado kit será invariável, independente da quantidade informada para o produto pai, o componente que tiver quantidade fixa será inserido na venda sempre com a quantidade informada no cadastro do kit. Exemplo:
   • Um determinado kit tem como produto pai o Pneu, que faz parte dos itens na quantidade 1. O kit Pneu tem como componentes a válvula na quantidade 1, o balanceamento na quantidade 1 e o alinhamento na quantidade fixa 1. Na venda o usuário informa para o produto pai do kit a quantidade 4, fazendo com que todos seus componentes tenham a quantidade informada no cadastro do kit multiplicada por 4 antes de serem inseridos no grid, com exceção do alinhamento, que por ter quantidade fixa será incluso no grid na quantidade informada no cadastro do kit.
6. Adicionar: Botão que quando acionado inclui no grid logo abaixo o item cujos dados estão informados nos campos de componente.
7. Grid: Listará os componentes do kit nas seguintes colunas:
   • CÓDIGO: Código do item.
   • DESCRIÇÃO: Descrição do item.
   • UNIDADE: Unidade selecionada para item.
   • GRADE: Grade selecionada para o item.
   • QUANTIDADE: Quantidade informada para o item.
   • ITEM FIXO: Informa se o item tem quantidade fixa ou não.
   • EXCLUIR: Coluna que apresentará para cada registro, o botão [Excluir], que permitirá que o usuário remova itens já adicionados no grid.

RN02 - Descrição dos campos e funcionalidades da tela (de pesquisa)

A tela inicial do cadastro de kit irá dispor do grid com mecanismo de consulta lucene. Neste grid serão listados os kits já cadastrados nas seguintes colunas:

1. ITEM PAI: Código + descrição do produto pai do kit.
2. ATIVO: Informa se um determinado está ativo (SIM ou NÃO).
3. COMBO: Informa se o kit é um combo (SIM ou NÃO).
4. ITEM PAI FAZ PARTE DOS ITENS: Informa se o item pai do kit compõe os componentes do mesmo (SIM ou NÃO).
5. QTDE.: Informa a quantidade do item pai no kit (somente quando faz parte dos itens, caso contrário padrão será 1).
6. UNIDADE: Informa a unidade do item pai no kit, seja ele parte dos itens ou não.

    
    Na pesquisa com lucene a única coluna passível de pesquisa será ITEM PAI, uma vez que as demais colunas não possibilitarão uma filtragem eficiente.

    
    Para visualizar os itens de um determinado kit, será necessário acessar o mesmo em modo de consulta ou alteração.

Layouts sugeridos

• 

  Cadastro de kit tela de manutenção

Quadro de dados

Tela de manutenção

Cabeçalho

NOME	OBRIGATÓRIO	TIPO DE ENTRADA	VALORES POSSÍVEIS	TAMANHO	VALOR PADRÃO	OBSERVAÇÃO
Ativo	Sim	Checkbox	Marcado/Desmarcado		Marcado (somente na inclusão)
Este kit é um combo	Não	Checkbox	Marcado/Desmarcado		Desmarcado	Quando marcado, este parâmetro habilitará os campos de desconto e acréscimo em valor e em percentual, referentes ao cabeçalho do kit.
Item pai	Sim	Input	Produtos ou serviços cadastrados no sistema
Faz parte dos itens	Não	Checkbox	Marcado/Desmarcado		Desmarcado	Quando marcado, este parâmetro habilitará os campos Qtde e Unidade do item pai.
Qtde	Sim	Input	Numéricos		0	Caso item pai não faça parte dos itens, este campo ficará desligado com valor padrão 1.
Unidade	Sim	Combobox	Unidades de saída vinculadas ao item pai		Unidade padrão do item	Este campo ficará desabilitado com a unidade padrão preenchida quando o item pai não fizer parte dos itens.

Itens

NOME	OBRIGATÓRIO	TIPO DE ENTRADA	VALORES POSSÍVEIS	TAMANHO	VALOR PADRÃO	OBSERVAÇÃO
Item	Sim	Input	Produtos ou serviços cadastrados no sistema
Unidade	Sim	Combobox	Unidades de saída vinculadas ao item		Unidade padrão do item
Grade	Sim	Combobox	Grades cadastradas para o item			Quando item não possuir grade, por padrão ficará selecionada a GRADE PADRÃO.
Qtde	Sim	Input	Numéricos		0
Qtde. Fixa	Não	Checkbox	Marcado/Desmarcado		Desmarcado