Manutenção

Tela t4-hu016-01, no hub Comissionamento do menu Operações de entrada e saída.

Para que serve

Aqui se cadastram os planos de comissão das vendas. Cada plano tem uma vigência e um valor base. As listas do plano reúnem os produtos que usam outro percentual ou outro valor fixo. Produto sem lista usa o valor base do plano vigente na data da venda.

Quando o plano deixar de ser oferecido no relatório, ele é desativado. O histórico permanece: o plano não é apagado. Vendas cuja data cai na vigência continuam usando o plano desativado.

Quem acessa

Quem tem a rotina liberada no acesso a telas. A tela está em teste: em produção ela não aparece.

Como chegar

1. No menu Operações de entrada e saída, abra Comissionamento.
2. Escolha Manutenção.

Para voltar ao hub, use Voltar no cabeçalho da tela.

O que a lista mostra

A lista vem em ordem de descrição. Cada linha traz:

Coluna	O que mostra
Descrição	Nome do plano. Se estiver vazia, aparece um traço.
Início	Primeiro dia da vigência. Se estiver vazio, aparece um traço.
Fim	Último dia da vigência. Se estiver vazio, aparece um traço.
Tipo	Percentual ou valor fixo.
Valor base	No percentual, o número seguido de %. No valor fixo, o valor em R$.
Listas	Quantidade de listas do plano.
Ativo	Indica se o plano está em uso na escolha do relatório.

A lista é paginada. Dá para ver 10, 25 ou 50 planos por página.

Como buscar e filtrar

A busca e a situação ficam na barra Filtros, acima da lista.

• Busca: digite parte da descrição. A lista atualiza sozinha.
• Situação:
  • Ativos — padrão ao abrir a tela. Mostra só os planos em uso.
  • Inativos — mostra só os planos desativados.
  • Todos — mostra ativos e desativados.

Para ver um plano desativado, mude a situação para Inativos ou Todos.

Incluir um plano

1. No cabeçalho, clique em Incluir. Abre o painel Incluir plano.
2. Informe a descrição, o tipo, o valor base, o início e o fim.
3. Escolha como gravar:
   • Incluir e fechar grava o plano e fecha o painel.
   • Incluir e nova grava o plano, limpa os campos e mantém o painel aberto para o próximo.

O plano entra ativo. A mensagem Plano incluído confirma a gravação.

Dois planos não podem ter vigências que se cruzam, nem nas datas das pontas. O fim não pode ser anterior ao início.

Campos do plano

Campo	Obrigatório	Limite	O que informar
Descrição	Sim	100 caracteres	Nome do plano. Sem ela a tela não grava.
Tipo	Sim	Percentual ou valor fixo	Define como o valor base é lido.
Percentual ou valor fixo	Sim	Número maior ou igual a zero	O rótulo muda com o tipo. No percentual, 0,25 equivale a 0,25%. No valor fixo, é o valor da comissão por unidade.
Início	Sim	Data	Primeiro dia em que o plano vale.
Fim	Sim	Data	Último dia em que o plano vale.
Identificador	Não	—	Último painel do formulário. O título do painel é Identificador e o campo não tem rótulo próprio. Na inclusão fica vazio, com o texto Gerado ao gravar. Na alteração mostra o código e o botão de copiar. O valor não pode ser editado.

Editar

1. Na linha do plano, clique em Editar. Abre o painel Editar plano.
2. Ajuste a descrição, o tipo, o valor base ou a vigência. A janela Identificador, no final do painel, mostra o código interno e permite copiá-lo. Esse valor não é editável.
3. Confirme com Salvar. A mensagem Plano atualizado confirma a alteração.

Listas

1. Na linha do plano, clique em Listas. Abre o painel com as listas daquele plano.
2. A grade mostra descrição, tipo, valor e a quantidade de produtos. A última lista incluída aparece primeiro. A busca filtra a descrição. A lista é paginada.
3. Incluir abre Incluir lista. A descrição é obrigatória. Tipo e valor podem ficar vazios: vazios herdam o plano. O texto de ajuda do tipo é: Vazio usa o tipo do plano. O texto de ajuda do valor é: Vazio usa o valor base do plano. No percentual, 0,25 equivale a 0,25%.
4. Incluir e fechar grava e fecha. Incluir e nova grava e limpa os campos. A mensagem Lista incluída confirma.
5. Editar altera a lista. Salvar confirma com a mensagem Lista atualizada.
6. Excluir pede confirmação: A lista e os produtos vinculados saem do plano. Comissões já calculadas permanecem registradas. A mensagem Lista excluída confirma.

Tipo ou valor preenchidos na lista passam a valer para os produtos dela. O que ficar vazio continua o do plano.

Produtos da lista

1. Na linha da lista, clique em Produtos.
2. A grade mostra código e descrição. O que acabou de ser incluído aparece primeiro. Num mesmo prefixo ou fornecedor, os códigos ficam em ordem. A busca aceita código ou descrição. A lista é paginada.
3. Incluir abre o painel Incluir produto. O campo Incluir por define o que entra:
   • Produto: pesquisa um produto ativo pelo código ou pela descrição. A busca pede pelo menos dois caracteres. O texto de ajuda é: Código ou descrição de um produto ativo. A busca pede pelo menos dois caracteres. A mensagem Produto incluído confirma.
   • Prefixo do código: inclui os produtos ativos cujo código começa com o texto. O texto de ajuda é: Inclui os produtos ativos cujo código começa com este texto. Pelo menos dois caracteres. Quem já está em uma lista deste plano fica de fora.
   • Fornecedor: pesquisa o fornecedor pelo nome ou pelo documento e inclui os produtos ativos dele. A busca pede pelo menos dois caracteres. O texto de ajuda é: Inclui os produtos ativos deste fornecedor. A busca pede pelo menos dois caracteres. Quem já está em uma lista deste plano fica de fora.
4. No prefixo e no fornecedor, a mensagem informa quantos produtos entraram, por exemplo 12 produtos incluídos. Se algum já estava no plano, o aviso completa, por exemplo 3 produtos já estavam em uma lista deste plano.
5. Incluir e fechar grava e fecha. Incluir e nova grava, limpa o produto, o prefixo ou o fornecedor e mantém a forma escolhida.
6. Excluir, na linha, pede confirmação: O produto deixa de usar esta lista. Nas próximas vendas, se nenhuma outra lista o tiver, vale o valor base do plano. A mensagem Produto excluído confirma.
7. Marque os produtos e clique em Excluir selecionados. A caixa do cabeçalho marca todos os produtos da busca, em todas as páginas. A confirmação diz: Os produtos marcados deixam de usar esta lista. Nas próximas vendas, se nenhuma outra lista os tiver, vale o valor base do plano. A mensagem informa a quantidade, por exemplo 3 produtos excluídos.
8. Excluir todos tira todos os produtos da lista, mesmo os de outras páginas e os que a busca não está mostrando. A confirmação diz: Todos os produtos desta lista saem do plano, inclusive os de outras páginas e os que a busca não está mostrando. Nas próximas vendas, se nenhuma outra lista os tiver, vale o valor base do plano.

O mesmo produto não entra em duas listas do mesmo plano.

Desativar e reativar

• Plano em uso: a linha mostra Desativar. A tela pede confirmação e avisa que o plano sai da escolha do relatório, mas vendas na vigência continuam usando este plano. A mensagem Plano desativado confirma. O plano sai da lista de ativos.
• Plano desativado: a linha mostra Reativar. A mensagem Plano reativado confirma.

Não há exclusão do plano nesta tela.

O que a tela bloqueia

Situação	O que acontece
Descrição do plano em branco ou com mais de 100 caracteres	A gravação é bloqueada com a mensagem Informe a descrição do plano.
Tipo do plano em branco	A gravação é bloqueada com a mensagem Informe o tipo do plano.
Valor base em branco	A gravação é bloqueada com a mensagem Informe o valor base.
Valor base negativo ou inválido	A gravação é bloqueada com a mensagem Informe um valor base igual ou maior que zero.
Início em branco	A gravação é bloqueada com a mensagem Informe a data de início.
Fim em branco	A gravação é bloqueada com a mensagem Informe a data de fim.
Fim anterior ao início	A gravação é bloqueada com a mensagem A data de fim não pode ser anterior à data de início.
Vigência que cruza outro plano	A gravação é bloqueada e a mensagem cita a descrição desse plano. Se ele estiver desativado, a mensagem inclui (desativado).
Descrição da lista em branco ou com mais de 100 caracteres	A gravação é bloqueada com a mensagem Informe a descrição da lista.
Tipo da lista inválido	A gravação é bloqueada com a mensagem Informe um tipo válido.
Valor da lista negativo ou inválido	A gravação é bloqueada com a mensagem Informe um valor igual ou maior que zero.
Produto em branco	A inclusão é bloqueada com a mensagem Informe o produto.
Produto inativo ou inexistente	A inclusão é bloqueada com a mensagem Este produto não está ativo.
Produto que já está em uma lista do mesmo plano	A inclusão é bloqueada com a mensagem Este produto já está em uma lista deste plano.
Prefixo em branco	A inclusão é bloqueada com a mensagem Informe o prefixo do código.
Prefixo com menos de dois caracteres	A inclusão é bloqueada com a mensagem Informe um prefixo com pelo menos dois caracteres.
Prefixo com mais de 60 caracteres	A inclusão é bloqueada com a mensagem O prefixo pode ter no máximo 60 caracteres.
Prefixo sem produto ativo	A inclusão é bloqueada com a mensagem Nenhum produto ativo começa com este prefixo.
Fornecedor em branco	A inclusão é bloqueada com a mensagem Informe o fornecedor.
Fornecedor inexistente	A inclusão é bloqueada com a mensagem Fornecedor não encontrado.
Fornecedor sem produto ativo	A inclusão é bloqueada com a mensagem Nenhum produto ativo deste fornecedor.
Prefixo ou fornecedor em que todos os produtos já estão no plano	A inclusão é bloqueada com a mensagem Estes produtos já estão em uma lista deste plano.
Excluir selecionados sem nenhum produto marcado	A exclusão é bloqueada com a mensagem Selecione ao menos um produto.
Excluir todos em uma lista sem produtos	A exclusão é bloqueada com a mensagem Esta lista não tem produtos.