Abrir agenda (agenda por período)

📌 O que é

Por padrão, toda agenda do Cliniset é sempre aberta: os dias e horários cadastrados valem para qualquer data. É o jeito da maioria das clínicas.

Algumas trabalham de outro jeito, o de hospitais, policlínicas e do SUS: a agenda é um molde (dias, horários, tempo de cada vaga), e só existe vaga nos períodos que alguém abriu. “Vou abrir a agenda de fono de setembro” quer dizer: a partir de agora, setembro tem vaga de fono; outubro ainda não.

O módulo Abertura de agenda traz esse modelo, sem mudar nada para quem não o usa:

Como a agenda abre: Sempre aberta (como hoje) ou Por período.
Abrir agenda: escolher o período num calendário, marcar os dias da semana e os horários em que vai ter vaga.
Aceita marcar até: quantos dias à frente a recepção consegue marcar.
Vagas por tipo: limite por dia de cada tipo de agendamento (ex.: 3 retornos por dia) e limite de horários extras por dia.
Feriados: veja Feriados.

👥 Quem pode usar

Ação	Quem faz
Ligar o módulo para a clínica	Suporte Cliniset
Trocar o modo da agenda, abrir períodos, definir vagas por tipo	Administrador e proprietário (quem configura agendas)
Ver a agenda aberta, marcar e remarcar	Todo mundo que já usa a agenda

Se você não pediu o módulo, nada muda: nenhuma tela nova aparece e a agenda segue com os horários de sempre.

🪜 Passo a passo

1. Colocar a agenda no modo “por período”

Agenda → Configurar agendas → ⋯ → Editar na agenda desejada.
No fim da coluna Funcionamento, em Períodos e limites, troque Como a agenda abre para Por período.
Salve. A partir desse dia, a agenda só tem vaga nos períodos abertos. O passado continua como estava.

Na mesma caixa você define, se quiser:

Aceita marcar até … dias à frente (vazio = sem limite).
Funciona em feriado? — Sim para agenda de plantão.
Vagas por tipo, por dia — um número por tipo de agendamento; vazio = sem limite. É um limite, não uma reserva: não segura horário, só impede a próxima marcação daquele tipo quando o limite do dia foi atingido.
Horários extras por dia — quantos “Abrir horário” cabem num mesmo dia.

2. Abrir um período

Três caminhos levam ao mesmo formulário:

Agenda → Configurar agendas → Aberturas → Abrir agenda;
no card da agenda, ⋯ → Abrir agenda;
na agenda do dia, Opções → Abrir agenda (período).

No formulário:

Agenda — só aparecem as que estão no modo Por período.
Período — clique o primeiro dia e depois o último no calendário, como numa passagem de avião. Os atalhos Este mês, Próximo mês e Próximos 30 dias preenchem de uma vez. Dias que já pertencem a outro período aparecem riscados, e feriados aparecem em roxo. Já vem sugerido o período seguinte ao último aberto.
Dias e horários — os sete dias da semana vêm marcados como na agenda; desmarque os que não abrem. Abaixo, as faixas de horário (“08:00 até 12:00”), com + Adicionar horário para mais de uma. À direita, a cada 30 min é o tempo de cada vaga, e Diferente por dia abre uma caixa por dia da semana quando os horários mudam de um dia para o outro. Mexeu demais? Voltar aos horários da agenda desfaz.
Adicionar observação (opcional) — ex.: “fono cobrindo férias da Ana”.
O resumo mostra o que vai ser aberto: dias com vaga, vagas por dia e vagas no período, mais as pílulas dos feriados que serão pulados.
Abrir agenda.

As vagas por tipo e os horários extras não aparecem aqui: o período copia os da agenda. Para mudar num período específico, use Editar período depois de ajustar a agenda.

Dois períodos da mesma agenda não podem se sobrepor — o formulário avisa antes de salvar.

3. Acompanhar os períodos

Em Configurar agendas → Aberturas:

a linha do tempo mostra, por agenda, do mês passado a cinco meses à frente: cada período como uma barra (verde = em aberto, azul = programado, cinza = encerrado), a linha vermelha de hoje e o trecho tracejado âmbar onde não há período aberto;
a lista traz cada período com o estado, os horários, as vagas por dia e quem abriu;
Editar período muda datas, dias e horários; Fechar antes encurta o fim; Excluir período remove; Repetir último período copia o último para logo depois dele (nunca para o passado).

Fechar ou excluir não cancela nenhum agendamento: quem já estava marcado continua marcado. O sistema avisa quantos ficaram fora do período.

O card da agenda mostra o estado: “Por período · Aberta até 30/09” ou “Sem período aberto” em âmbar.

🗓️ O que muda na agenda do dia

Num dia sem período aberto:

no calendário lateral, o dia fica tracejado, com a explicação no tooltip;
na tabela do dia, uma faixa âmbar no topo explica, com o botão Abrir este período para quem configura;
no Novo agendamento, o painel de horário explica e oferece Registrar retorno previsto (o paciente entra na fila com o mês-alvo e a recepção marca quando abrir — veja Retornos) e Abrir este período.

O servidor recusa a marcação num dia fechado. A saída é sempre a mesma: “Abrir horário” (o encaixe) libera aquele horário mesmo num dia fechado — seja feriado, dia sem período aberto ou data além do limite de marcação. O que o encaixe não fura são as vagas por tipo.

Data além do limite de marcação aparece do mesmo jeito, com o texto “Só aceita marcar até 60 dias à frente”.

Vagas por tipo no Novo agendamento

Ao lado do Tipo de agendamento aparecem as vagas do dia: “Retorno 2/3”. Tipo esgotado fica riscado, aparece como “· esgotado” na lista de tipos, e a marcação é recusada com “Vagas de Retorno esgotadas neste dia (3/3)”. Agendamento sem tipo não consome vaga nenhuma.

❗ Erros comuns

“Este dia não está aberto” — abra o período em Configurar agendas → Aberturas, use “Abrir horário” para o caso urgente, ou registre um retorno previsto.
“Já existe um período de 01/09 a 30/09 nesta agenda” — os períodos não podem se sobrepor: feche o anterior ou escolha outras datas.
“Esta agenda está sempre aberta” — só agenda no modo Por período precisa (e pode) ser aberta. Troque o modo em Editar agenda.
“Só aceita marcar até N dias à frente” — aumente ou apague o campo Aceita marcar até na agenda.
Mudei a agenda e o período aberto não mudou — é assim mesmo: o período guarda uma cópia dos horários. Use Editar período para aplicar a mudança naquele intervalo.