Como podemos ajudar?

Como remover planos / grupos

No sistema, "Planos" e "Grupos" são dois catálogos distintos, usados em telas diferentes, mas que seguem a mesma lógica de remoção. Este artigo explica a diferença entre remover e desabilitar um plano/grupo, o que realmente acontece quando você tenta remover um item que já está em uso, e o passo a passo correto para cada situação.

Do que estamos falando

Cadastro	Onde fica	Usado para
Planos de venda	Tela "Planos de venda" (URL contrato-planovenda)	Pacote comercial vinculado ao contrato do cliente (define valor, serviços incluídos, fidelidade).
Grupos (de velocidade/rede)	Tela "Grupos" (URL groups)	Perfil de velocidade/banda aplicado ao login (PPPoE/rádio) do cliente na rede.

Diferença entre remover e desabilitar

• Desabilitar (campo "Situação", no Plano de venda, ou "Estado", no Grupo, ambos com opções Habilitado/Desabilitado): o registro continua existindo no banco, mantém todo o histórico e os vínculos com contratos/logins que já o usam, mas deixa de aparecer nas telas de seleção para novos cadastros. Confirmando no código: tanto o combo de seleção de Grupo (usado ao configurar o login do cliente) quanto a lista de planos oferecida no assistente de contratação filtram automaticamente os itens desabilitados — eles simplesmente somem das opções para uso futuro, sem quebrar nada do que já existe.
• Remover (ação "Remover"/ícone de lixeira, na listagem): apaga o registro definitivamente do banco de dados.

O que acontece ao tentar remover um plano/grupo em uso — atenção

Diferente do que se poderia esperar, a remoção de um Plano de venda ou de um Grupo não é bloqueada automaticamente pelo sistema quando existem contratos/logins usando aquele registro. Isso foi conferido diretamente na estrutura do banco: não existe restrição de integridade (chave estrangeira) ligando a tabela de contratos ao Plano de venda, nem ligando o login do cliente ao Grupo de rede. Ou seja, tecnicamente o sistema permite excluir o cadastro mesmo com contratos ativos vinculados a ele — só que, ao fazer isso, os contratos/logins que apontavam para aquele plano/grupo passam a referenciar um código que não existe mais, o que pode causar inconsistência em telas, relatórios e integrações que dependem dessa informação (ex.: exibição de detalhes do plano no contrato, sincronização com o concentrador, faturamento por grupo).

Por isso, antes de remover, o próprio sistema disponibiliza uma forma de checar o uso:

• Na listagem de Planos de venda, existe a coluna "Contratos", um link que mostra quantos contratos ativos usam aquele plano (e leva direto para a lista filtrada desses contratos).
• Na listagem de Grupos, existem as colunas "Usuários" (quantidade de logins ativos usando o grupo), "Total mensal" e "Total real" (faturamento associado ao grupo).

Regra prática recomendada: se a coluna de uso mostrar qualquer número maior que zero, não remova — desabilite. Reserve a remoção definitiva para planos/grupos criados por engano, nunca usados, ou já com uso zerado (verificado na própria coluna de uso).

Pré-requisitos

• Permissão de acesso às telas Planos de venda e/ou Grupos, incluindo a permissão específica de "Remover" (evento remover) — sem ela, o botão de exclusão não aparece na listagem.
• Conferir a coluna de uso (Contratos/Usuários) antes de decidir entre remover e desabilitar.

Passo a passo — Desabilitar (recomendado quando há uso)

1. Acesse a tela Planos de venda ou Grupos.
2. Clique para editar o registro desejado.
3. No Plano de venda, altere o campo "Situação" para Desabilitado; no Grupo, altere o campo "Estado" para Desabilitado.
4. Salve o registro.

A partir daí, o item deixa de ser oferecido em novas contratações/configurações de login, mas continua funcionando normalmente para quem já o utiliza.

Passo a passo — Remover definitivamente (somente sem uso)

1. Acesse a tela Planos de venda ou Grupos.
2. Confira a coluna "Contratos" (Planos) ou "Usuários" (Grupos) do registro — deve estar zerada.
3. Na linha do registro, clique no ícone de lixeira ("Remover").
4. Confirme no pop-up "Confirma remoção do registro?", clicando em "Sim".

Erros comuns

• Remover um plano/grupo achando que o sistema vai impedir se estiver em uso: não conte com essa proteção — como não existe vínculo de integridade entre essas tabelas, a exclusão é aceita mesmo com contratos/logins dependentes. Sempre confira a coluna de uso antes.
• Confundir a mensagem genérica de erro ao remover com "está protegido por uso": o sistema exibe uma mensagem padrão ("Problemas ao remover o registro! Verifique se não existe algum registro que depende deste cadastro!") quando o banco recusa a exclusão por chave estrangeira — mas, no caso específico de Planos de venda e Grupos, essa mensagem normalmente não aparece, justamente porque não há essa restrição no banco. Não interpretar a ausência de erro como "está tudo certo, ninguém usa".
• Excluir em vez de desabilitar para "esconder" um plano antigo: se o objetivo é só parar de oferecer o plano/grupo para clientes novos, desabilitar é sempre a opção correta — remover é irreversível e não preserva a referência para contratos antigos/históricos.
• Achar que "Situação" (Plano) e "Estado" (Grupo) têm nomes diferentes por acaso: são campos equivalentes em função (habilitar/desabilitar o uso do item), só com nomenclatura diferente entre as duas telas — não procure por "Estado" na tela de Planos de venda nem por "Situação" na tela de Grupos.