Smart Price para WHMCS

Módulo addon para o WHMCS que agenda reajustes de preço de serviços e addons dos clientes. O administrador define um aumento (percentual ou valor fixo) e uma data de efetivação; no dia marcado, o cron diário do WHMCS aplica o novo valor recorrente ao serviço/addon e registra o histórico. Também pode disparar um e-mail avisando o cliente do reajuste, com antecedência configurável.

Útil para reajuste anual de carteira: você agenda tudo de uma vez (por cliente, por produto ou por addon) e o sistema aplica na data certa.

Requisitos

• WHMCS 8.0 ou superior
• PHP 8.0+

Instalação

1. Copie a pasta modules/addons/nx_smartprice para dentro da sua instalação do WHMCS, mantendo o caminho modules/addons/nx_smartprice.
2. No admin, vá em Configurações → Módulos Complementares (System Settings → Addon Modules).
3. Localize Smart Price e clique em Ativar. As tabelas nx_smartprice_adjustments e nx_smartprice_settings são criadas na ativação.
4. Em Acesso, marque os grupos de administradores que poderão usar o módulo e salve.

Configuração

Abra o módulo em Complementos → Smart Price, aba Config.:

• Destacar Registros: destaca, nas telas de agendamento, os serviços que já receberam ajuste nos últimos X dias (evita agendar em duplicidade).
• Assunto do E-mail e Mensagem do E-mail: conteúdo do aviso enviado ao cliente. A mensagem aceita os campos de mesclagem listados abaixo do editor (dados do serviço, do cliente e do próprio reajuste, como {$smartprice_new_amount}).

Agendando reajustes

Use uma das abas conforme o recorte desejado:

• Clientes: escolha um cliente e agende o reajuste de cada serviço/addon dele.
• Produtos/Serviços: escolha um produto e agende o reajuste para todos os clientes que o têm.
• Addons: escolha um addon e agende o reajuste para todos os serviços que o utilizam.

Para cada item você informa o tipo (Porcentagem ou Fixo), o valor do ajuste, a data de efetivação e, opcionalmente, a data de envio do e-mail. Os agendamentos aparecem na aba Listagem, onde é possível acompanhar o status (Agendado / Concluído / Cancelado) e excluir os que ainda estiverem agendados.

Processamento

O trabalho pesado roda no hook AfterCronJob, ou seja, junto do cron diário do WHMCS. Na data de efetivação, o módulo confere se o valor atual do serviço/addon ainda bate com o registrado no agendamento (proteção contra alterações manuais no meio do caminho) e então aplica o novo valor, marca o ajuste como concluído e escreve uma nota no serviço e no log do cliente. O e-mail, quando configurado, é enviado na data de envio definida.

Estrutura

Arquivo	Função
nx_smartprice.php	Configuração, ativação/desativação, upgrade e ponto de entrada do admin
hooks.php	Processamento no cron diário (aplica reajustes e envia e-mails)
lib/Admin/AdminDispatcher.php	Roteia as abas do admin
lib/Admin/Controller.php	Telas de listagem, agendamento e configuração