Horários e Feriados: como configurar o expediente e bloquear datas - Ajuda

A agenda usa o horário de funcionamento da clínica pra saber quando está aberta e quais slots oferecer pra agendamento. Os feriados são dias em que a agenda deve estar bloqueada (clínica fechada). Sem configurar esses dois, a agenda fica sempre aberta — incluindo madrugada e Natal.

Este guia cobre como configurar o horário (com o conceito de turnos e vigência) e como cadastrar feriados.

Horário de funcionamento

Configurações → Horário de Funcionamento (rota /app/horarios-clinica).

Como funciona: turnos por dia

Cada dia da semana tem N turnos (períodos de atendimento). Exemplo padrão (Seg-Sex):

Manhã: 08:00 - 12:00
Tarde: 13:00 - 18:00
Almoço: 12:00 - 13:00 (não é turno, é “fechado”)

Por padrão o sistema cria Seg-Sex com 2 turnos (manhã e tarde) e Sábado-Dom desativados. Você ajusta conforme sua clínica.

Editando um dia

Selecione o dia da semana (na linha do dia).
Marque “Atende nesse dia” (toggle).
Adicione ou remova turnos — cada turno tem início e fim (ex.: 14:00 às 19:00).
Salve.

Você pode ter quantos turnos quiser por dia. Algumas clínicas têm 3 turnos (manhã, tarde, noite). Outras têm 1 só (sábado de manhã).

Casos comuns

“Sábado só de manhã” — Desmarque “Atende” no Sábado ou crie 1 turno (08:00-12:00) sem turno de tarde.
“Quarta à noite” — Adicione um terceiro turno (ex.: 19:00-22:00).
“Folga fixa na segunda” — Desmarque “Atende” na segunda. Agenda fica fechada.

Vigência: mudanças programadas

Aqui está o ponto mais importante: o sistema suporta mudanças programadas de horário. Em vez de simplesmente salvar o novo horário (que afeta o passado também), você agenda a mudança pra uma data futura.

Exemplo: a clínica decide que a partir de 01/08 o horário muda — passa a abrir também aos sábados. Em vez de mudar o horário “agora” (afetando relatórios passados), você:

Vai no horário atual.
Clica em Agendar mudança de horário (ícone de calendário).
Define a data de início da vigência (01/08).
Define o novo horário (sábado agora ativo, com turno de manhã).
Salva.

A partir de 01/08, o sistema usa o novo horário. Antes, usa o antigo. Relatórios não são regredidos — a mudança é clara no histórico.

Quando usar: mudança de horário permanente, início de horário de verão, expansão da clínica, troca de turno de um profissional. Quase tudo é vigência. Mudança imediata sem vigência: só pra correção de erro de digitação (e é logado).

Permissão

Ver / editar horário: config.horarios (geralmente restrita a gerentes).
Agendar mudança (vigência): mesma permissão.

Feriados

Configurações → Feriados (rota /app/feriados).

A lista mostra os feriados cadastrados, com filtros (nacional/estadual/municipal, ativo, busca).

Como cadastrar um feriado

+ Novo feriado. Campos:

Nome (obrigatório) — ex.: “Natal”, “Carnaval - quarta-feira”, “Feriado Municipal de São Paulo”.
Data (obrigatório) — dia do feriado. Para feriados de múltiplos dias (Carnaval), cadastre um por dia.
Abrangência (obrigatório) — uma das 3 opções:
- Nacional — vale pra todas as clínicas do Brasil, independente de estado/município.
- Estadual — vale só pro estado selecionado (ex.: “Dia da Consciência Negra” em São Paulo e Alagoas).
- Municipal — vale só pro município selecionado (ex.: “Aniversário de São Paulo”).
Estado (se Estadual ou Municipal) — UF.
Município (se Municipal) — cidade.
Recorrente (padrão: sim) — se marcado, o feriado se repete todo ano na mesma data. Use pra Natal, Ano Novo, etc. Desmarque pra feriados específicos (ex.: “Carnaval 2027” — só aquele ano).
Ativo — se tá valendo. Desative pra “apagar temporariamente” (mantém no histórico).

Importante: a agenda só bloqueia o dia se o feriado estiver ativo e a abrangência bater com a localização da clínica. Feriados municipais só bloqueiam se você cadastrar o município.

Feriados nacionais comuns (cadastrar)

Data	Feriado	Recorrente
01/01	Confraternização Universal	Sim
21/04	Tiradentes	Sim
01/05	Dia do Trabalho	Sim
07/09	Independência	Sim
12/10	Nossa Senhora Aparecida	Sim
02/11	Finados	Sim
15/11	Proclamação da República	Sim
25/12	Natal	Sim

Feriados estaduais e municipais variam. Cadastre conforme a localização da sua clínica.

Feriados móveis (Carnaval, Páscoa, Corpus Christi)

O sistema não calcula automaticamente feriados móveis. Você precisa cadastrar um por ano. Ou: ative a recorrência se a data for fixa (não é o caso de Carnaval).

Para clínicas que querem se preocupar menos, peça ao suporte um cadastro anual automático de feriados móveis.

Como horário e feriado afetam a agenda

Evento	Efeito
Dentro do horário	Slots aparecem pra agendamento
Fora do horário	Slots somem, agendamento bloqueado
Dia com “Atende = não”	Agenda fica vazia o dia todo
Feriado ativo	Agenda fica vazia o dia todo (igual a dia não-útil)
Mudança de horário futura	Sistema usa o novo horário a partir da data

Confirmação automática: o horário e o feriado afetam a confirmação automática de agendamento. Se o paciente agendou pra próxima semana, o lembrete respeita o horário novo.

Permissões

Ver / editar horário: config.horarios.
Ver / editar feriados: config.feriados.
Agendar mudança de horário (vigência): mesma permissão de horário.

Boas práticas

Configure o horário uma vez, mantenha com vigência. Não troque o horário direto — sempre agende mudança futura. O histórico fica mais limpo.
Cadastre os feriados nacionais (lista acima) + estaduais e municipais da sua cidade. Sem isso, a agenda abre no feriado.
Revise mensalmente se houveram mudanças em feriados municipais (prefeitura às vezes cria).
Não desative um feriado pra “abrir” a agenda naquele dia — em vez disso, use a vigência do horário pra abrir excepcionalmente (mude o horário só praquele dia).

Perguntas rápidas

A agenda mostra o dia todo, mesmo com horário configurado. Você provavelmente não salvou o horário depois de editar, ou editou a data errada. Vá em Horário de Funcionamento e confira se todos os dias estão com Atende = sim e pelo menos 1 turno com horário.

Paciente agendou pra um feriado por engano. A agenda bloqueia automaticamente se o feriado está ativo. Se passou, foi porque o feriado não estava cadastrado — adicione.

Mudou o horário mas o gráfico de relatórios mostra o antigo. Os relatórios respeitam a vigência: até a data de mudança, é o horário antigo; depois, o novo. É o comportamento correto.

Como faço o horário de Natal funcionar diferente (meio expediente)? Crie um feriado de Natal (25/12 ativo) e abra a agenda no horário normal — o sistema não abre a agenda em feriado ativo. Se quer abrir meio expediente, cadastre o feriado desativado e use o horário normal.

Posso bloquear só algumas salas num feriado? Hoje o feriado bloqueia toda a clínica. Pra abrir uma sala específica, é customização — fale com o suporte.

Dúvidas sobre como configurar o horário, vigência de mudança, ou cadastrar feriados estaduais e municipais? Chame o suporte pelo WhatsApp — a gente ajuda.