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, 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, marca como Realizado sem descontar nada — e o atendimento fica com a etiqueta cinza Sem cobrança.

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.

O pacote vincula só até o saldo

Ao criar agendamentos repetidos vinculados a um pacote, o Oluma respeita o saldo. Se o pacote tem 3 sessões livres e você está marcando 5 encontros, os 3 primeiros nascem vinculados ao pacote e os 2 últimos ficam sem vínculo — eles serão descontados automaticamente do próximo pacote com saldo quando forem realizados.

O aviso aparece em laranja no topo da prévia de datas, antes de salvar, dizendo quantas sessões o pacote tem e como os agendamentos serão divididos. Depois de salvar, um resumo confirma quantos foram vinculados e quantos ficaram sem vínculo.

O saldo considerado não é só "total menos usadas": ele desconta também os agendamentos futuros já vinculados ao pacote. Um pacote de 10 sessões com 4 usadas e 3 já marcadas tem 3 sessões livres, não 6.

Editar uma série inteira de agendamentos ainda não aplica essa regra — é possível acabar com mais agendamentos vinculados do que o pacote comporta. Não há perda: os excedentes aparecem como Pacote esgotado ao serem realizados, e se corrigem pela tela do atendimento.

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.

Concluir um atendimento nunca é bloqueado por falta de saldo. Se o pacote acabou no meio do caminho, o Oluma procura outro pacote ativo do cliente; não achando, marca como Realizado assim mesmo, avisa em laranja que nenhuma sessão foi descontada e deixa o atendimento com a etiqueta Pacote esgotado. O vínculo antigo continua visível de propósito — é ele que permite a correção depois. Veja como corrigir.

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.
Um outro atendimento do mesmo pacote pode passar a exibir Sessão não abatida, porque a vaga devolvida voltou a ser disputada. Abrir esse atendimento em Editar e clicar em Salvar resolve.

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.