Ir para o conteúdo principal

Cadastro de datas para tipo de evento [Série de Eventos]

Um evento série no Pretix (também chamado de event series ou evento com sub-eventos) é um evento que contém múltiplas datas ou sessões dentro do mesmo evento principal. Em vez de criar vários eventos separados para cada data, o modo de série permite gerenciar tudo em um só lugar. Todos os ajustes gerais (como formulário de compra, métodos de pagamento, etc.) valem para todas as datas da série, facilitando a administração em casos de muitos eventos em sequência.
Exemplos de uso incluem: sessões recorrentes de teatro, visitas guiadas por horário, oficinas repetidas, horários de museu, turnês, etc.
Uma grande vantagem é que o cliente pode comprar ingressos para várias datas diferentes em um único pedido, reduzindo trabalho tanto para o sistema quanto para o usuário.


📂 Acessando o menu lateral "Datas"

Dentro de um evento do tipo série, acesse o painel do Pretix e clique em Datas.
Ali você verá:

  1. Lista de todas as datas já criadas
  2. Botão Criar uma nova data
  3. Botão Criar várias datas novas
  4. Ações em lote (apagar/editar/ativar/desativar)
  5. Acesso ao ID único de cada data



Se o menu **Datas** não aparece, o evento não é do tipo série.

🛠️ Métodos de criação de novas datas

✏️ Criação manual (uma data por vez)

Clique em Criar uma nova data e preencha:

Informação geral
  1. Nome da sessão – Nome de exibição da data/sessão dentro da série de eventos.
  2. Ativo - define se o evento está ativo ou desativo:
    • Ativo - Permite que seja visualizado pelos clientes e que estes adiquiram ingressos.
    • Desativo - Não permite que seja visualizado pelos clientes e que estes adiquiram ingressos.
  3. Data/hora de início e (opcional) término – Momento em que a sessão começa e, se definido, termina.
  4. Localização – Local onde a sessão será realizada (endereço ou descrição do espaço).
  5. Coordenadas geograficas – Latitude e longitude do local da sessão.
  6. Tempo de Admissão – Horário a partir do qual o público pode entrar no evento.
  7. Texto Frontpage – Texto exibido na página inicial da sessão para o cliente.
  8. Mostrar em listas - Se selecionado, este evento vai aparecer publicamente na lista de datas para seu evento.
  9. Comentário interno – Anotações visíveis apenas para a equipe de organização.
Linha do tempo
  1. Início de pré-venda e Fim da pré-venda – Intervalo em que a venda de ingressos online fica aberta para esta sessão.
Quotas
  1. Nome da Quota – Nome para identificar esta quota de capacidade.
  2. Capacidade total – Número máximo de ingressos disponíveis nesta quota.
  3. Produtos – Produtos/ingressos que consomem esta quota ao serem vendidos.
  4. Permitir para vender mais bilhetesquando as pessoas fazerem check-out - Com esta opção, a quota será libertada assim que as pessoas digitalizarem uma saída do seu evento. Isso só vai acontecer se eles tiverem sido digitalizados, tanto à entrada como à saída e a saída é o scan mais recente. Não importa em qual lista de check-in o scan foi feito, mas as listas de check-in são ignoradas se eles são definidos como "Permitir re-entrar depois de uma verificação de saída" para evitar overbooking acidental.
  5. Ignore esta cota ao determinar a disponibilidade de eventos- Se ativar isto, esta cota será ignorada ao determinar a disponibilidade de eventos no seu calendário de eventos. Isto é útil, por exemplo Para mercadorias que são adicionadas a cada evento, mas não devem impedir que o evento seja mostrado como esgotado.
  6. Adicionar numa nova quota - adiciona nova quota de ingressos (útil para ter quotas diferentes para grupos de ingressos ou produtos individuais)
Listas de check-in
  1. Nome da lista de check-in
  2. Incluir pedidos pendentes - Com esta opção, as pessoas poderão fazer o check-in mesmo que o pedido não tenha sido pago.
  3. Selecionar produtos para check-in – Define quais produtos/ingressos poderão ser validados nesta lista de check-in.
  4. Permitir re-entrada depois de um scan de saída - Permite que o participante entre novamente após ter sido registrado como saída.
Portas
  1. Selecionar portas do evento para realizar o check-in – Vincula a lista de check-in a portas/entradas físicas específicas.

  2. Adiconar uma nova lista de check-in - útil para ter check-ins de um produto ou grupo de produtos em uma porta ou conjunto de portas diferentes.

  3. Salvar - salva as configurações no sistemas para terem validade.



Este método é indicado para ajustes finos e criação de poucas sessões.

🗓️ Criação de várias datas (recorrência automática)

Em Criar várias datas novas, é possível gerar dezenas ou centenas de sessões seguindo padrões, como:

  • Repetição diária / semanal
  • Escolha de dias da semana
  • Período inicial e final
  • Múltiplos horários no mesmo dia (time slots)

Tela de [Regra de Repetição]:

A tela de [Regra de Repetição] por sofrer pequenas alterações conforme é alterada, acima é para **repetição da semana**, abaixo algumas outras variações
Diária:

* Mensal:

* Anual:


Exemplo: repetir todas segundas e quartas, das 10h às 18h, com sessões de hora em hora. O sistema mostrará uma pré-visualização de todas as datas que serão criadas. Dicas: - Criar em blocos (ex.: trimestre) e não um ano inteiro de uma vez - Ajustar manualmente datas de feriado removendo após geração

🔌 Criação via API

A API REST permite criar datas programaticamente:

Endpoint:
POST /api/v1/organizers/{org}/events/{event}/subevents/

Campos importantes:

  • name — multilíngue
  • date_from, date_to
  • location
  • active, is_public
  • item_price_overrides
  • variation_price_overrides
  • seating_plan

Exemplo de payload:

{
"name": {"en": "First Sample Conference"},
"active": false,
"is_public": true,
"date_from": "2017-12-27T10:00:00Z",
"location": "Auditório 1",
"item_price_overrides": [
{ "item": 2, "disabled": false, "price": "12.00" }
]
}


⚙️ O que pode ser configurado por data

Cada data pode ter:

  • Nome e descrição (multi-idioma)
  • Data/hora de início e fim
  • Produtos habilitados/desabilitados naquela sessão
  • Preços diferenciados
  • Cotas/capacidades específicas
  • Regras de check-in próprias
  • Status (ativa/inativa)

🛒 Como as datas aparecem na loja

Na página do evento, o cliente verá:

  • Lista de datas
  • Calendário mensal
  • Calendário semanal
  • Indicação de disponibilidade / esgotado
  • Opção de adicionar ingressos de várias datas ao mesmo carrinho

🔧 Editar / ocultar / desativar / excluir datas

  • Editar: mudar qualquer configuração
  • Ocultar (is_public=false): não aparece na loja
  • Desativar (active=false): aparece, mas não permite compra
  • Excluir: remove totalmente (somente se não houver pedidos associados)
  • Editar em lote: alterar vários campos de várias datas ao mesmo tempo

💡 Boas práticas

  • Criar datas em blocos menores
  • Padronizar nomes (“Sessão 10h – Turma A”)
  • Cotas independentes por data (mais seguro)
  • Revisar amostras após criação
  • Traduzir nomes e descrições se a loja for multilíngue
  • Escolher visão semanal ou mensal para melhorar a navegação
  • Não criar eventos separados quando a série for a ferramenta ideal

📖 Referências

  • Event Series – Pretix Docs
    https://docs.pretix.eu/en/latest/user/events/eventseries.html

  • Time Slots – Pretix Docs
    https://docs.pretix.eu/en/latest/user/events/timeslots.html

  • Widget & Display Options
    https://docs.pretix.eu/en/latest/user/events/display.html

  • Subevents API Documentation
    https://docs.pretix.eu/en/latest/api/resources/subevents.html

  • Release Notes – Hiding past dates
    https://docs.pretix.eu/en/latest/changelog/3.17.html

  • Comunidade Pretix (Reddit)
    https://www.reddit.com/r/pretix