Ir para o conteúdo principal

Criação de várias datas em lote 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á:

  • Lista de todas as datas já criadas
  • Botão Criar uma nova data
  • Botão Criar várias datas novas
  • Ações em lote (editar/ocultar/excluir várias de uma vez)
  • 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:

  • Nome da sessão
  • Data/hora de início e (opcional) término
  • Produtos disponíveis na sessão
  • Texto descritivo
  • Local
  • Opção de assentos
  • Cotas/capacidade específicas
  • Regras de visibilidade (ativa/pública)

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