Logo

Bloqueio semanal e exceção de feriados

Markdown ChatGPT Claude

Como bloquear dias fixos da semana em um produto/serviço e, opcionalmente, liberar esses dias quando caírem em feriado.

Visão geral

Existem dois níveis de configuração:

Onde O que configura
Produto/serviço Quais dias da semana ficam bloqueados e se feriados desbloqueiam esses dias
Calendário Feriados extras (municipais, datas especiais da loja)

O horário de funcionamento do calendário continua valendo em todos os casos. Bloquear segunda no produto/serviço não substitui o horário comercial — os dois filtros se aplicam juntos.

Bloqueio por dia da semana (produto/serviço)

Disponível quando o produto/serviço tem calendário habilitado.

Na seção Calendário → Dias da semana bloqueados, marque os dias que devem ficar indisponíveis toda semana:

  • Bloquear domingo, segunda, terça, etc.

Comportamento

  • Dias marcados somem da grade de disponibilidade para o comprador.
  • A consulta de disponibilidade pula para o próximo dia liberado.
  • Vale para reservas por hora ou por dia.
  • Em kits, a regra de cada componente é respeitada na interseção de disponibilidade.

Exemplo

Buffet que não atende às segundas: marque Bloquear segunda. Toda segunda-feira comum ficará indisponível para aquele produto/serviço.

Exceto feriados (produto/serviço)

Checkbox Exceto feriados, na mesma seção dos dias bloqueados.

Exceto feriados Dia bloqueado que cai em feriado
Desmarcado (padrão) Continua indisponível
Marcado Fica disponível para aquele dia (se passar nas demais regras)

Quando marcado, o sistema ignora o bloqueio semanal apenas nas datas consideradas feriado.

O que ainda é verificado

Mesmo com Exceto feriados ativo, o dia precisa passar em:

  • Horário de funcionamento do calendário
  • Bloqueios manuais e reservas já existentes (slots)
  • Estoque, se habilitado
  • Prazo mínimo de antecedência (minBefore) e dias de produção

Exemplo

Locação que não atende domingos, mas quer abrir no Natal:

  1. Marque Bloquear domingo
  2. Marque Exceto feriados
  3. No 25/12 (domingo), o item pode aparecer disponível se o horário comercial e o estoque permitirem.

Feriados considerados

Fechamos em feriados (calendário)

Checkbox Fechamos em feriados, junto aos horários de funcionamento do calendário.

Fechamos em feriados Comportamento
Desmarcado (padrão) Feriados não bloqueiam reserva. Continuam valendo só para Exceto feriados no produto.
Marcado Feriados nacionais e extras ficam indisponíveis (como fora do expediente). Também não contam no prazo de produção.

Com a opção marcada, Exceto feriados no produto não reabre o dia — a loja está fechada.

Feriados nacionais (automático)

Feriados nacionais brasileiros (fixos e móveis — Carnaval, Sexta-feira Santa, Corpus Christi, etc.) são carregados automaticamente pelo sistema. Não é necessário cadastrá-los.

Feriados extras (calendário)

No cadastro ou edição do calendário, seção Feriados extras:

  • Data (obrigatória)
  • Nome (opcional), ex.: "Aniversário da cidade", "Ponto facultativo"

Use para feriados locais ou datas especiais que não estão na lista nacional.

Na página do calendário (visualização):

  • Consulte a lista oficial de feriados nacionais por ano
  • Veja os feriados extras já cadastrados
  • Copiar feriados extras de outro calendário seu (sem duplicar datas)

Na lista de calendários (/seller/calendar):

  • Botão Sincronizar em todos os calendários — une todos os feriados extras existentes em qualquer calendário seu e replica o conjunto em cada calendário (sem duplicar datas por calendário)

Com Fechamos em feriados, essas datas fecham a agenda. Sem a opção, só valem para produtos/serviços com Exceto feriados ativo e vinculados àquele calendário.

Vários calendários no mesmo produto/serviço

Se o item usa mais de um calendário, a exceção de feriado é avaliada por calendário na consulta. Um feriado extra cadastrado só no Calendário A libera o dia bloqueado quando a disponibilidade passa pelo Calendário A.

Resumo prático

Dia bloqueado no produto/serviço?
  └─ Não → segue fluxo normal (ainda pode fechar se closedOnHolidays)
  └─ Sim
       └─ Exceto feriados ativo E calendário NÃO fecha em feriados?
            └─ Não → dia indisponível (blocked_weekday)
            └─ Sim
                 └─ Data é feriado nacional OU feriado extra do calendário?
                      └─ Sim → não aplica bloqueio semanal (ainda passa por horário, slots, estoque, closedOnHolidays)
                      └─ Não → dia indisponível

Calendário com “Fechamos em feriados”?
  └─ Sim → feriado nacional/extra = closed_holiday (indisponível)

Perguntas frequentes

Posso desativar feriados nacionais e usar só os meus?

Não na versão atual. Os nacionais são sempre considerados quando Exceto feriados está ativo. Para datas específicas, use Feriados extras no calendário.

O bloqueio semanal funciona sem calendário habilitado?

Não. Dias bloqueados e Exceto feriados só se aplicam a produtos/serviços com calendário habilitado.

Feriado liberado mas o horário comercial não inclui aquele dia

O dia continua indisponível. O horário de funcionamento do calendário tem prioridade sobre a exceção de feriado.

Bloqueio manual no calendário vs. bloqueio semanal

  • Bloqueio semanal (produto/serviço): recorrente, por dia da semana (ex.: toda segunda).
  • Bloqueio no calendário: data específica ou período pontual (ex.: férias de 10 a 20 de janeiro).

Os dois podem coexistir.

Reserva atravessando dias bloqueados no meio

No calendário, a opção Permitir reserva com dias bloqueados no meio (allowBlockedDaysInMiddle) vale para reservas com duração em dias.

Cenário Sem a opção Com a opção
Sex→ter com sáb/dom bloqueados no produto/serviço Indisponível Disponível (extremos livres)
Sex→ter com reserva/estoque no sábado Indisponível Continua indisponível
Sex→sáb (sábado é o último dia e está bloqueado) Indisponível Indisponível

Diferença vs Exceto feriados (no produto/serviço): feriados liberam um dia pontual do bloqueio semanal. A opção do calendário permite atravessar dias estruturalmente fechados no meio do período. As duas se complementam.

Premissa: precificação e o slot cobrem o span completo (incluindo o meio atravessado).

Documentação relacionada