Cadastro de ocorrência
A ocorrência é a data de visita de uma atração. Ela decide se aquele dia pode ser vendido e quantas pessoas cabem.
Onde fica
Menu lateral → Ocorrências → Nova ocorrência. Também são criadas em lote pelas regras de recorrência.
Quem pode manter
occurrences.manage para criar e editar; occurrences.view para consultar.
Campos
| Campo | Obrigatório | Descrição | Formato ou exemplo | Observações |
|---|---|---|---|---|
| Atração * | sim | A qual atração a data pertence. | Seleção | A atração precisa ter “gera ocorrências” ligada. Erro: “Atração é obrigatória”. |
| Data * | sim | O dia da visita. | Seletor de data | Não pode ser no passado em criação manual. Erro: “Data é obrigatória”. |
| Status * | sim | Situação operacional do dia. | Aberta · Fechada · Bloqueada · Esgotada · Cancelada | Esgotada é definida automaticamente pelo sistema. Erro: “Status é obrigatório”. |
| Capacidade máxima | não | Limite de pessoas do dia. | Número inteiro, ou vazio | Vazio = sem limite. Não pode ser reduzida abaixo do já vendido (capacity_below_sold). Erro: “Capacidade inválida”. |
| Disponível para venda | não | Interruptor independente do status. | Ligado · Desligado | Desligado, a data não aparece na loja mesmo estando aberta. |
| Motivo do fechamento | não | Justificativa interna do fechamento. | “Manutenção programada” | Ajuda o time a entender a decisão. |
| Notas | não | Observações livres sobre o dia. | Texto livre | — |
Campos preenchidos pelo sistema
| Campo | O que significa |
|---|---|
| Origem | Manual, gerada por regra ou importada. |
| Alterada manualmente | Marcada automaticamente quando alguém edita uma data gerada por regra. A partir daí, regerações nunca sobrescrevem essa data. |
Para uma data vender, três coisas precisam ser verdadeiras
StatusPrecisa ser “Aberta”
Disponível para vendaPrecisa estar ligado
CapacidadePrecisa ter vaga
Data vendávelAparece na loja e no PDV
O que acontece ao salvar
- A data passa a existir para a atração e, se vendável, aparece no calendário da loja.
- O sistema passa a controlar automaticamente a alternância entre Aberta e Esgotada.
- Se a ocorrência veio de uma regra e você a editou, ela é marcada como alterada manualmente.
O que impede a conclusão
- Já existir outra ocorrência ativa da mesma atração naquela data — “Já existe uma ocorrência ativa para esta atração nesta data.”
- Data no passado em criação manual.
- Atração com “gera ocorrências” desligada (
attraction_no_occurrence). - Reduzir a capacidade abaixo do já vendido (
capacity_below_sold).
Como cancelar ou arquivar
Venda futura bloqueia
Cancelar ou arquivar uma ocorrência é recusado quando existem ingressos ativos ou pendentes para ela. Remarque ou reembolse antes.
Ingressos já utilizados não impedem o cancelamento da data — quem já visitou não precisa mais ser protegido.
Relacionamentos
- Atração — dona da data.
- Regra de recorrência — pode ter gerado a ocorrência.
- Passaporte pacote — pode incluir esta ocorrência.
- Regra de preço do tipo ocorrência — aponta para ela.
- Vouchers — cada ingresso de acesso está preso a uma ocorrência.
Exemplo de preenchimento (fictício)
| Atração | Piscinas |
|---|---|
| Data | 15/12/2026 |
| Status | Aberta |
| Capacidade máxima | 800 |
| Disponível para venda | Ligado |
| Notas | Alta temporada — reforçar equipe. |