Guia de pacotes para tratamentos
Como controlar pacotes de sessões na clínica de estética?
Controle pacotes ao registar a oferta, guardar a venda na ficha da cliente e utilizar uma sessão apenas na marcação certa; a Bia mantém saldo, validade, estados e idempotência, mas não substitui cobrança ou conciliação financeira.
Um pacote parece simples quando a clínica olha apenas para o total de sessões. A rotina precisa de responder que oferta foi vendida, que preço a cliente comprou, que marcação consumiu uma sessão, quanto resta e o que acontece se alguém repetir o clique ou tentar utilizar depois do prazo. A Bia separa o catálogo da venda e conserva estas respostas na ficha da cliente. Este guia descreve o fluxo real e os seus limites, sem inventar pagamento recebido, recorrência, estorno ou renovação garantida.
- Catálogo com pacote ou plano mensal e até 365 sessões
- Venda guardada como retrato do nome, total e preço
- Saldo utilizado sobre o total contratado na ficha da cliente
- Utilização ligada à marcação e protegida por idempotência
- Validade comparada com o dia no fuso da clínica
- Estados ativo, concluído, expirado e cancelado com auditoria
1. Separe a oferta do pacote já vendido
Comece pelo catálogo de serviços. A equipa regista nome, tipo, quantidade de sessões, preço total, preço por sessão e, quando existir, um serviço-base ativo. O tipo pode ser pacote ou plano mensal, mas organiza apenas a oferta e não cria cobrança recorrente. A clínica continua responsável pelo acordo comercial.
Um item ativo aparece numa nova venda; um item desativado deixa de ser oferecido sem desaparecer do histórico. O nome é único na clínica e o serviço-base pertence ao mesmo tenant e está ativo. Assim, um pacote não aponta para outra operação ou para um serviço retirado.
A quantidade aceita vai de uma a 365 sessões. Escolha um número que a receção consiga explicar e reveja preços antes de publicar. A Bia guarda os dados para a venda seguinte; não escolhe desconto, não aprova promoções e não decide se há recorrência.
- Pacote e plano mensal são tipos do catálogo, não cobranças automáticas.
- Nome e serviço-base são validados no servidor.
- Itens desativados continuam registados para preservar a operação.
2. Registe a venda na ficha da cliente
Na ficha da cliente, a receção escolhe um pacote ativo e regista o direito às sessões. A venda copia nome, total e preço para um registo próprio. Se o catálogo mudar amanhã, o pacote comprado não muda silenciosamente com a oferta futura.
A operação confirma que a cliente pertence à clínica e exige permissão de balcão. A lista mostra itens ativos e permite registar a venda; não é um ecrã público de pagamento. Registar o pacote não prova que cartão, transferência ou dinheiro foram recebidos.
Depois da venda, confirme nome, total e data de validade, se houver. Nota fiscal, meio de pagamento, assinatura e política de reembolso devem ficar no processo que realmente tem esses campos. Não prometa na página um contrato que o código não entrega.
- A venda guarda o retrato do nome, total e preço daquele momento.
- Cliente e pacote têm de pertencer à mesma clínica.
- Venda registada não é confirmação de pagamento ou estorno.
3. Leia o saldo como sessões contratadas e usadas
A ficha mostra total contratado, sessões usadas, barra de progresso e estado. O servidor devolve o contador depois de cada operação; a clínica não depende de uma conta só do navegador. Uma venda de dez sessões começa com o total e diminui quando uma marcação válida é associada ao pacote.
Quando restam uma ou duas sessões, a operação tenta criar um aviso deduplicado de pacote quase terminado. O aviso ajuda a receção a falar com a cliente, mas não cria renovação nem garante aceitação. A chave evita vários avisos iguais para o mesmo pacote.
A última utilização passa o estado para finished, apresentado como concluído, e utilizações posteriores são recusadas. Não corrija um saldo com um número inventado para esconder uma baixa perdida. Reveja registo e auditoria antes de criar outra venda.
- Saldo é o total comprado menos as sessões utilizadas.
- Aviso de uma ou duas sessões é apoio, não renovação.
- Estado concluído impede utilização além do total.
4. Utilize uma sessão na marcação certa
A utilização exige uma marcação existente da mesma cliente. A receção escolhe o pacote na ficha ligada à marcação e envia o identificador da operação. O servidor confirma o vínculo antes de alterar o saldo; pacote de outra cliente ou marcação de outro tenant é recusado.
A mesma conclusão não pode utilizar duas vezes a sessão do pacote porque a operação usa uma chave idempotente.
A transação bloqueia o pacote, confirma validade e saldo, incrementa sessionsUsed e guarda pacote, cliente, marcação, estado, total e responsável. Uma tentativa igual devolve o resultado guardado; uma combinação diferente é conflito, não uma segunda baixa.
- Uma sessão só é usada numa marcação da mesma cliente.
- Locks e chave idempotente protegem tentativas concorrentes.
- Cada utilização deixa auditoria e registo do pacote.
5. Verifique validade antes de prometer saldo
Um pacote pode não ter validade ou receber uma data civil definida pela clínica. Ao listar e antes de usar, o servidor compara a data com o dia no fuso do tenant. A madrugada UTC do servidor não deve terminar o pacote antes do dia que a receção ainda considera válido.
Quando a data passa, o pacote ativo fica expired, apresentado como expirado, e a transição é auditada. A verificação também ocorre dentro da operação. Se o dia mudar entre leitura e atualização, não há utilização fora do prazo.
Antes de confirmar a marcação, leia validade, estado e saldo juntos. A aplicação não estende prazo, não transforma saldo em dinheiro e não reabre um pacote automaticamente. Uma tolerância é uma política aprovada, não um comportamento presumido.
- Data civil é comparada no fuso da clínica.
- Expiração é auditada e impede utilização posterior.
- Sem data não existe expiração automática.
6. Distinga ativo, concluído, expirado e cancelado
Ativo permite utilização quando marcação, validade e saldo deixam. Concluído significa que todas as sessões foram usadas. Expirado significa que a data passou. Cancelado é uma decisão de gestão sem apagar o registo. A ficha mostra estados separados para não misturar saldo com decisão administrativa.
O cancelamento conserva nome, total, utilizações, validade e auditoria. Exige permissão de gestão e bloqueia a linha antes de atualizar, para que cancelamento concorrente com utilização não substitua o resultado acabado de gravar. Cancelar duas vezes é recusado.
Não use o estado do pacote para representar pagamento, autorização clínica ou presença. Utilização de sessão e conclusão da marcação relacionam-se, mas são contratos diferentes. O pacote regista o uso pedido pela equipa; os restantes estados ficam nos seus próprios fluxos.
- Cada estado responde a uma pergunta operacional.
- Cancelar conserva o registo e o saldo histórico.
- Pagamento, conclusão e pacote são contratos separados.
7. Faça a conferência quando o saldo ficar baixo
Quando o aviso indicar uma ou duas sessões, abra a ficha e compare marcações utilizadas. Confirme nome, cliente, datas e responsável com o que a receção registou. O aviso é deduplicado e nasce fora da transação principal como melhor esforço; a indisponibilidade do serviço de notificações não é renovação automática.
A conversa de renovação é humana. A clínica pode oferecer outro pacote, alterar a oferta ou aceitar que a cliente não continue. A aplicação não cobra, não agenda recorrência e não regista venda sem que a equipa escolha o item. Não venda recuperação de receita que o código não mede.
Se a contagem parecer errada, não compense na venda seguinte. Verifique auditoria, marcação e idempotencyKey. Um conflito pode significar repetição, pacote errado ou cliente errada; cada caso precisa de correção explícita.
- Saldo baixo orienta a conversa, mas não cria venda.
- Compare ficha, marcação e auditoria.
- Não compense uma utilização suspeita noutra venda.
8. Termine a rotina sem prometer cobrança ou estorno
No fecho semanal, reveja pacotes ativos, expirados, concluídos e cancelados. Veja saldo e marcações utilizadas. A API aplica tenant, vínculo da cliente e permissões no servidor; esconder o botão não seria isolamento. O histórico permite explicar a operação sem reescrever o passado.
A venda usa snapshot, a utilização usa transação e idempotência, a validade usa o fuso e o cancelamento é auditado. Isto resolve rastreabilidade, não todo o processo financeiro. Cobrança recorrente, conciliação, estorno, fatura e comissão ficam onde existe esse contrato.
O resultado é uma frase que a receção consegue repetir: que pacote foi vendido, quantas sessões restam, que marcação fez a última utilização e que estado pede decisão. A Bia organiza o retrato e impede repetição silenciosa; não inventa pagamento, renovação ou resultado clínico.
- Leia pacotes junto dos registos financeiros reais.
- Tenant e permissões são verificados no servidor.
- Recorrência, estorno e fatura ficam fora desta rotina.
O que o controlo de pacotes faz — e o que fica separado
A Bia regista ofertas, vendas, saldo, validade, utilização idempotente e estados. A página não promete cobrança, recorrência, estorno, conciliação ou renovação automática.
- O catálogo aceita pacote ou plano mensal, mas o tipo mensal não gera cobrança recorrente.
- A venda guarda nome, total e preço, mas não confirma recebimento ou meio de pagamento.
- A utilização exige marcação da mesma cliente e não conclui a marcação por si só.
- Validade, saldo e estados impedem usos inválidos; sem data não há expiração automática.
- Cancelamento conserva histórico, mas não estorna dinheiro nem reabre sessões.
Perguntas frequentes
Dúvidas sobre pacotes e sessões na clínica
Editar o catálogo muda um pacote já vendido?
Não. A venda guarda o retrato do nome, total e preço daquele momento. A edição vale para novas vendas.
Uma repetição pode baixar duas sessões?
Não na mesma operação. A marcação e a chave de idempotência encontram a utilização gravada; conflitos são recusados.
O que acontece ao usar a última sessão?
O contador chega ao total e o pacote passa para concluído. Uma nova utilização é bloqueada.
O plano mensal cobra automaticamente?
Não. Plano mensal é um tipo do catálogo. Cobrança recorrente, pagamento e conciliação ficam fora deste fluxo.
Cancelar apaga o pacote?
Não. O registo fica cancelado com saldo, datas e auditoria. Cancelamento não é estorno.
Teste o percurso completo antes da primeira venda
Crie um serviço e um pacote de teste, registe uma cliente fictícia e confirme venda, marcação e saldo antes da rotina real.
Criar a minha conta