Fluxo do pacote

Da compra do pacote ao desconto automático das sessões e ao encerramento, com exemplos para pacotes de sessões e planos por período.

Pacotes e planos são a forma mais comum de o cliente pré-pagar uma sequência de atendimentos. Este fluxo descreve o que acontece desde a compra até o encerramento, considerando os dois tipos suportados pelo Oluma: pacote de sessões (quantidade fixa) e plano por período (acesso por tempo).

Visão geral do fluxo

Etapa	O que você faz	O que o Oluma faz
1. Compra	Cria o pacote e configura o pagamento	Cria 1 ou N transações de receita
2. Vínculo nos agendamentos	Cria agendamentos com o pacote selecionado (ou deixa o FIFO escolher)	Mostra sessões usadas e restantes
3. Atendimentos	Marca cada agendamento como Realizado	Desconta 1 sessão (pacote) ou só atualiza status (plano)
4. Encerramento	Nada — é automático	Marca como Concluído, Expirado ou aguarda cancelamento

1. Comprar o pacote

A compra acontece dentro do cadastro do cliente, na Aba Pacotes. Você escolhe o tipo:

Pacote de sessões: quantidade fixa (ex: 10 sessões), validade opcional. Veja Pacote de sessões.
Plano por período: acesso por tempo (ex: 3 meses), sem limite de sessões, validade obrigatória. Veja Plano por período.

Em ambos, o pagamento pode ser:

Forma	O que o Oluma cria
À vista	1 transação de receita com o valor total. Status Pendente ou Pago, conforme você escolher.
Parcelado	N transações pendentes (uma por parcela), com vencimentos mensais sequenciais e numeração "(1/N)" na descrição.

Detalhes em Automações financeiras e Parcelas.

A cobrança é criada na compra do pacote, não a cada atendimento. Por isso, agendamentos vinculados a pacotes não geram nova transação financeira quando você os realiza — o pagamento já está previsto.

2. Usar o pacote nos agendamentos

Há duas formas de "usar" o pacote:

Vincular explicitamente

No formulário de agendamento, no campo Serviço ou pacote, selecione o pacote do cliente. A lista mostra:

Nome do pacote.
Quantas sessões já foram usadas e quantas restam.
Quantos agendamentos futuros já estão vinculados.

Use o vínculo explícito quando quer garantir que aquele atendimento conte para um pacote específico — útil quando o cliente tem mais de um pacote ativo.

Deixar o FIFO escolher

Crie o agendamento sem vincular pacote nenhum. Quando você marcar como Realizado, o Oluma aplica a regra FIFO:

Procura o pacote de sessões ativo mais antigo do cliente que ainda tenha sessões disponíveis.
Prioriza pacotes com vencimento mais próximo (para aproveitar antes de expirar).
Vincula o agendamento ao pacote escolhido e desconta 1 sessão.
Se nenhum pacote elegível existir, apenas marca como Realizado.

Veja Abatimento automático para os critérios completos de elegibilidade.

Planos por período não participam do FIFO. Eles aceitam vínculo explícito, mas não são escolhidos automaticamente quando o agendamento não tem vínculo.

3. Concluir os atendimentos

A cada agendamento marcado como Realizado, o pacote evolui:

Tipo	O que muda
Pacote de sessões	A contagem de sessões usadas aumenta em 1. Quando atinge o total, vai para Concluído.
Plano por período	Nada muda no plano. O status se mantém Ativo até a data de expiração.

Se o agendamento for revertido de Realizado para Agendado:

O abatimento é desfeito: a sessão volta para o pacote.
Se o pacote estava Concluído, ele volta para Ativo.
A reversão é bloqueada se houver registro clínico vinculado ao agendamento.

Veja Status do agendamento para o detalhe das transições.

4. Encerramento do pacote

O pacote pode encerrar de quatro formas. As três primeiras são automáticas; a quarta é manual.

Concluído (esgotamento)

Pacote de sessões que teve a última sessão descontada. Vai automaticamente para Concluído (azul).

Não participa mais do FIFO.
Não aparece nas listas de seleção para novos agendamentos.
Se você editar e aumentar o total de sessões, ele volta para Ativo.

Expirado (data limite)

Pacote (de sessões com validade ou plano por período) cuja data de expiração passou. Aparece como Expirado (laranja). Não é um status armazenado — é calculado em tempo real.

Pacotes de sessões podem expirar com sessões restantes não utilizadas.
Planos por período sempre encerram por expiração (não há sessões para esgotar).
Para reativar, edite e estenda a validade.

Cancelado (manual)

Você pode cancelar um pacote ativo a qualquer momento pela Aba Pacotes:

O pacote vai para Cancelado (irreversível).
Transações financeiras pendentes vinculadas ao pacote são canceladas automaticamente.
Transações pagas permanecem no histórico — o cancelamento não estorna pagamentos.
Sessões já realizadas continuam registradas.

O cancelamento do pacote não devolve dinheiro automaticamente. Se você combinou reembolso com o cliente, registre uma despesa manual no Financeiro.

Veja Ciclo de vida do pacote para o diagrama completo de transições.

Exemplo: pacote de sessões parcelado

Maria comprou um pacote de 10 sessões de Pilates por R$ 1.200, em 3 parcelas mensais.

Dia 01/03: você criou o pacote pela aba Pacotes do cadastro da Maria, parcelado em 3x. O Oluma criou:
- 3 transações pendentes: "Pacote 10 Sessões (1/3)" R$ 400 venc. 01/03, "(2/3)" R$ 400 venc. 01/04, "(3/3)" R$ 400 venc. 01/05.
Durante março: você criou 4 agendamentos para a Maria, sem vincular explicitamente o pacote. Conforme cada um foi realizado, o FIFO escolheu o pacote da Maria e descontou — chegou a 4 sessões usadas, 6 restantes.
Início de abril: a Maria pagou a 1ª parcela em dinheiro. Você abriu a transação e clicou em Registrar pagamento. Status: Pago.
No fim das 10 sessões: o pacote foi para Concluído automaticamente. As parcelas restantes seguem seu cronograma — o pagamento delas independe da conclusão.

Exemplo: plano mensal cancelado

João comprou o Plano Mensal Fisioterapia por R$ 600, à vista, com pagamento já recebido.

Dia 10/04: criação do plano com validade 1 mês. Transação de R$ 600 criada como Paga.
Durante o mês: João fez 8 atendimentos. Todos vinculados ao plano. Cada um foi para Realizado sem descontar nada — o plano é por tempo.
Dia 25/04: João avisou que ia mudar de cidade e pediu cancelamento. Você cancelou o plano pela Aba Pacotes. O plano foi para Cancelado. A transação Paga continuou no histórico (o pagamento já tinha sido recebido).
Reembolso proporcional combinado: você criou uma despesa manual no Financeiro com o valor proporcional aos dias não usados.