Ir para o conteúdo principal

Criação de datas para tipo de evento [Série de Eventos]

🎟️ Introdução aos Eventos do tipo "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 e na loja de ingressos.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 – IntervaloMomento em que a sessão ocorre,começa usadoe, parase exibirdefinido, a programação e validar o horário dos ingressos.termina.
  4. Localização – Texto livre com o localLocal onde a sessão aconteceserá realizada (ex.:endereço “Auditórioou dadescrição Reitoria”)do espaço).
  5. Coordenadas geograficas – Latitude e longitude do local,local usadasda para exibição em mapas e integrações.sessão.
  6. Tempo de Admissão – MomentoHorário a partir do qual o público pode entrar nano sessão, antes do horário oficial de início.evento.
  7. Texto Frontpage – Texto descritivo mostradoexibido na página principalinicial da loja,sessão acimapara dao lista de ingressos.cliente.
  8. Mostrar em listas - Se selecionado, este evento vai aparecer publicamente na lista de datas para seu evento.
  9. Comentário interno – CampoAnotações visívelvisíveis apenas para a equipe interna,de para anotações administrativas sobre a sessão.organização.
Linha do tempo
  1. Início de pré-venda e Fim da pré-venda – PeríodoIntervalo em que a venda de ingressos online fica aberta para esta data específica.sessão.
Quotas
  1. Nome da Quota – Nome interno usado para identificar essaesta quota de capacidade na lista de quotas e relatórios.capacidade.
  2. Capacidade total – Número máximo de ingressos quedisponíveis podemnesta ser vendidos a partir desta quota (ou ilimitado, se configurado como tal).quota.
  3. Produtos – Seleção de produtos/variaçõesProdutos/ingressos que consomem esta quota quandoao sãoserem 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. Local – Opção ligada à configuração de locais/plantas de assento, usada quando há mapeamento mais detalhado do espaço físico.
  7. Opção de assentos – Define se a data usará lugares marcados (plano de assentos) ou lugares gerais, e como os assentos serão atribuídos.
  8. Cotas/capacidade específicas – Permite ajustar capacidades específicas por área/assento ou sobrescrever a capacidade padrão do evento para esta data.
  9. Regras de visibilidade (ativa/pública) – Ajustes avançados de quando e onde esta data aparece para o público, em complemento às opções Ativo e Mostrar em listas.
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 – RestringeDefine aquais produtos/ingressos poderão ser validados nesta lista de check-in a produtos/variações específicos, em vez de incluir todos os produtos do evento.in.
  4. Permitir re-entrada depois de um scan de saída –- AutorizaPermite nova entrada seque o últimoparticipante registroentre dessenovamente ingressoapós tiverter sido umaregistrado saída,como permitindo sair e voltar de forma controlada.saída.
Portas
  1. Selecionar portas do evento para realizar o check-in – AssociaVincula a lista/dispositivolista de check-in a portas/portõesentradas (gates)físicas específicos, permitindo relatórios por entrada/saída física.específicas.
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)

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

📋 Importação via CSV

Em Importar, você pode enviar um arquivo CSV contendo todas as datas a serem criadas. O CSV deve ter cabeçalho e colunas como:

  • name
  • date_from
  • date_to
  • location
  • product
  • quota

A interface permite mapear colunas do CSV para os campos das datas e definir valores padrão para campos ausentes.

Após o envio, o Pretix verifica erros e permite corrigí-los antes da criação final.

🔄 Clonagem de datas existentes

Você pode clonar uma data já configurada. Isso copia:

  • Produtos
  • Cotas
  • Preços
  • Descrição
  • Plano de assentos

Depois você ajusta apenas o que muda (como data/horário).

Ideal para eventos com sessões muito parecidas, evitando retrabalho.

🔌 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
  • Local próprio
  • Plano de assentos próprio
  • Produtos habilitados/desabilitados naquela sessão
  • Preços diferenciados
  • Cotas/capacidades específicas
  • Regras de check-in próprias
  • Visibilidade (pública/oculta)
  • Status (ativa/inativa)
  • Metadados personalizados

🛒 Como as datas aparecem na loja

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

  • Lista de datas
  • Calendário mensal
  • Calendário semanal
  • Filtragem por meta-dados (ex.: idioma, tipo de sessão)
  • Indicação de disponibilidade / esgotado
  • Opção de adicionar ingressos de várias datas ao mesmo carrinho

Datas passadas podem ser ocultadas automaticamente.

🔧 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
  • Usar uma data-modelo e clonar
  • Padronizar nomes (“Sessão 10h – Turma A”)
  • Usar metadados para filtros
  • 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

Voltar ao topo