¶ Planos
Aviso: Esta documentação foi gerada por inteligência artificial e pode conter erros.
O plano é o modelo comercial e técnico usado na contratação de um serviço. Ele não define apenas preço: concentra contas de cobrança, velocidade, tecnologia, fidelidade, divisão fiscal, regras de desconto, tipos de serviço e recursos integrados. Ao adicionar o plano a um contrato, o LHISP cria um serviço contratado com uma cópia dos parâmetros aplicáveis.
Essa distinção é essencial: o plano é o catálogo; o serviço contratado é a condição efetiva do cliente. Salvar uma mudança no plano normalmente não recalcula contratos existentes. Quando a alteração também deve alcançar a base atual, use conscientemente as ferramentas em massa disponíveis no próprio cadastro.
¶ Relações no sistema
- Contratos: recebem plano, valor, quantidade, contas bancárias, fidelidade e regras fiscais.
- Financeiro: a conta de boleto e a conta Pix direcionam mensalidades; uma conta separada pode cobrar instalação.
- Rede e acesso: download, upload, burst, redução de velocidade, tipo de IP, equipamento e tecnologia orientam o provisionamento.
- Fiscal: percentuais SCM, SVA, provedor, ISS e locação detalham a composição usada na geração fiscal.
- OTT/SVA e VoIP: recursos associados ao plano participam da contratação e do ciclo de ativação/cancelamento das integrações.
- Documentos e aceite: o plano pode exigir aceite de um documento antes de determinadas etapas do contrato.
- Filiais: somente filiais vinculadas oferecem o plano nos fluxos correspondentes.
- Hotspot, Intelbras Mibo e módulos: opções aparecem e são aplicadas conforme as integrações/configurações habilitadas para a empresa.
¶ Configuração principal
| Grupo | Impacto |
|---|---|
| Descrição e situação | O nome identifica o plano; inativar retira-o das seleções que filtram planos ativos, sem cancelar serviços já contratados. |
| Cobrança | Define valor, tipo de precificação, descontos máximos e contas bancárias para boleto, Pix e instalação. |
| Instalação e fidelidade | Define preço/desconto da instalação e período de fidelidade sugerido ao contratar. |
| Acesso | Define velocidades, burst, redução por inadimplência, tecnologia, IP e equipamento. |
| Serviços | Habilita acesso, e-mail, VoIP, OTT, hotspot ou Intelbras Mibo conforme disponibilidade. |
| Fiscal | Divide o valor entre SCM, SVA, provedor, ISS e locação; opções podem condicionar SVA/ISS à existência de OTT. |
| Filiais | Controla onde o plano pode ser contratado ou escolhido. Pelo menos uma filial é exigida pela SPA. |
| Integrações | Relaciona gateways/recursos OTT, produtos Mibo, provedor de cartão e módulos do LHISP Manager. |
O backend exige nome, valor não negativo e conta bancária de cobrança válida. A SPA também exige ao menos uma filial e valida configurações de faixa e produtos de integrações antes de salvar.
¶ Tipos de cobrança
| Tipo | Cálculo do serviço contratado |
|---|---|
| Fixo | Cobra o valor do plano; quantidade não altera o preço. |
| Fracionado | Multiplica a quantidade pelo valor unitário do plano. |
| Fracionado por faixa | A quantidade seleciona a faixa e multiplica pelo valor unitário dessa faixa. |
| Escalonado | A quantidade seleciona a faixa, mas o valor da faixa já é o total e não é multiplicado. |
Nas tabelas por faixa, a primeira faixa deve começar em 1, não pode haver lacunas ou sobreposições e somente a última pode ficar sem limite. O valor do plano atua como mínimo em partes do cálculo legado; simule quantidades antes de liberar o plano.
Atenção: alterar uma tabela de faixas não recalcula os serviços contratados. Depois de salvar, use Atualizar valores dos contratos somente se a mudança tiver de ser propagada.
¶ Ferramentas que afetam contratos existentes
As ações abaixo pedem dupla confirmação e são tratadas como irreversíveis pela interface:
- Atualizar valores dos contratos: percorre serviços do plano, ignora cancelados e valores VIP/zerados, recalcula por tipo/quantidade/faixa e registra a alteração. Falhas são isoladas por serviço.
- Atualizar contas bancárias dos contratos: copia as contas de boleto e, quando configurada, Pix para todos os serviços não cancelados do plano.
- Atualizar divisão fiscal dos contratos: copia percentuais e regras fiscais para serviços não cancelados e com valor maior que zero.
- Migrar contratos em massa: por filial, troca serviços ativos, bloqueados ou suspensos para outro plano. Por padrão ignora clientes com valor zero; Listar Clientes VIP inclui esses serviços e mantém valor zero.
Salvar o plano antes dessas ações garante que os valores de origem sejam os recém-configurados. Revise a prévia, especialmente diferenças de preço na migração.
¶ Reajuste
O cadastro armazena a opção Reajuste Automático, tipo percentual ou valor fixo, valor e quantidade de meses de carência. Também existe o fluxo separado Reajuste de Serviços Contratados, que permite selecionar e confirmar a aplicação.
Limitação verificada: nos repositórios revisados foi encontrada a persistência dessas opções e os métodos de aplicação de reajuste, mas não uma tarefa agendada que consuma automaticamente a configuração do plano. Valide o processo operacional implantado antes de depender apenas dessa marcação.
¶ Cadastro seguro
- Defina público, filial, preço e modelo de cobrança.
- Configure contas bancárias e política de instalação/fidelidade.
- Valide velocidades e parâmetros de provisionamento com a equipe de rede.
- Valide a divisão fiscal com o responsável contábil.
- Associe apenas integrações já configuradas e homologadas.
- Salve, faça uma contratação controlada e confira serviço, cobrança, rede e fiscal.
- Só então aplique ferramentas em massa, se necessário.
¶ Exclusão e clonagem
A exclusão é lógica e não cancela contratos nem serviços que já usam o plano. Prefira inativar quando houver histórico ativo. A clonagem cria um novo plano a partir da configuração carregada, com novo nome e novas associações persistidas ao salvar; revise contas, filiais, preços e integrações antes de disponibilizá-lo.
¶ Captura da tela
