Ir para o conteúdo principal

Importação de pedidos em lote via CSV no Pretix

Visão geral

Este tutorial descreve o procedimento para importação de pedidos em lote no Pretix, utilizando um arquivo CSV.

A funcionalidade é especialmente útil quando:

  • Uma instituição deseja adquirir um grande volume de ingressos (ex.: 50 ou 100 ingressos);
  • O cadastro manual seria inviável ou demorado;
  • A compra é realizada por escolas, empresas ou grupos organizados.

Durante a importação:

  • Cada linha do arquivo será interpretada como um ingresso;
  • O sistema poderá gerar:
    • Um único pedido com múltiplos ingressos; ou
    • Múltiplos pedidos, conforme a configuração escolhida.

Cenário de uso

Exemplo típico:

  • Uma escola solicita 100 ingressos para visitação.
  • A instituição envia uma planilha preenchida.
  • A equipe administrativa prepara o arquivo final no formato exigido pelo Pretix.
  • O pedido é importado automaticamente.

1. Fluxo geral do processo

O processo ocorre em três etapas principais:

  1. Recebimento da planilha da instituição;
  2. Preparação da planilha de importação;
  3. Importação do arquivo CSV no Pretix.

2. Planilha enviada pela instituição

A instituição (ex.: escola) preenche um modelo contendo:

  • Nome da instituição;
  • Tipo (pública ou privada);
  • Nome do participante;
  • Vínculo (professor ou aluno);
  • E-mail da instituição;
  • Telefone da instituição;
  • Fortaleza a ser visitada;
  • Data da visita.

Observações importantes:

  • Para escolas públicas, normalmente utiliza-se:
    • Um único e-mail institucional;
    • Um único telefone institucional.
  • Não é necessário informar e-mails individuais dos alunos (exceto quando desejado).

3. Planilha de importação para o Pretix

Após receber a planilha da escola:

  1. Copiar os dados relevantes;
  2. Colar na planilha padrão de importação;
  3. Ajustar os campos necessários.

3.1 Formato de data

O Pretix exige o formato de data no padrão:

YYYY-MM-DD HH:MM

Exemplo: 2026-02-08 08:30

  • Ano
  • Mês
  • Dia
  • Hora do evento

No caso das Fortalezas:

  • O horário é fixo (08:30).
  • A planilha pode ser configurada para permitir digitação no formato local e salvar automaticamente no padrão exigido.

3.2 Coluna “Grupo” (opcional)

A coluna Grupo permite gerar múltiplos pedidos dentro do mesmo arquivo.

Exemplo:

Grupo Resultado
G1 Um pedido para todas as linhas G1
G2 Outro pedido para todas as linhas G2

Funciona com qualquer identificador:

  • G1 / G2
  • EscolaA / EscolaB
  • Abacaxi / Pepino

O sistema agrupa por valor idêntico na coluna.

Atualmente, o uso de grupos pode ser opcional, mas é útil ao importar várias instituições simultaneamente.

3.3 Separação de nome e sobrenome

O Pretix exige:

  • Primeiro nome
  • Sobrenome

A planilha pode conter fórmulas para:

  • Extrair a primeira palavra (primeiro nome);
  • Extrair o restante (sobrenome).

Isso automatiza a preparação do arquivo.

3.4 Produto e variação

Cada linha precisa conter:

  • Código do produto;
  • Código da variação (quando aplicável).

Exemplos:

  • Produto 139 + Variação 99 → Professor isento
  • Produto 139 + Variação 117 → Aluno escola pública (isento)
  • Produto 140 (sem variação) → Meia escola privada

Recomendação prática:

  • Preencher as duas primeiras linhas;
  • Selecionar;
  • Arrastar para replicar automaticamente nas demais.

4. Salvando no formato correto

Após finalizar o preenchimento:

  1. Clique em Salvar como;
  2. Selecione o formato:

CSV UTF-8 (delimitado por vírgulas)

Importante:

  • CSV não mantém:
    • Cores
    • Negrito
    • Fórmulas
  • Apenas texto simples será salvo.

Utilize a planilha Excel apenas para edição.
O arquivo enviado ao Pretix deve ser o CSV.

5. Importação no Pretix

5.1 Acessando a área de importação

  1. Acesse o evento (ex.: Visitação às Fortalezas);
  2. Clique em Pedidos;
  3. Selecione Importar;
  4. Escolha o arquivo CSV.

Deixe a opção de Character Set como detecção automática.

O sistema exibirá uma pré-visualização dos dados.

6. Modo de importação

O Pretix oferece três opções:

6.1 Criar um pedido separado para cada linha

Não recomendado para grupos escolares.

  • Cada participante vira um pedido diferente.
  • Gera desorganização.

6.2 Criar um pedido com uma posição por linha

Opção recomendada.

  • Um único pedido;
  • Cada linha = um ingresso dentro do mesmo pedido.

Ideal para:

  • Escolas;
  • Empresas;
  • Grupos organizados.

6.3 Criar múltiplos pedidos baseados em grupos

  • Utiliza a coluna “Grupo”;
  • Cada grupo gera um pedido diferente.

Útil quando:

  • Importando várias escolas simultaneamente.

7. Status de pagamento

É possível definir:

Criar pedidos como totalmente pagos

Indicado quando:

  • Escola pública;
  • Todos os ingressos são isentos.

O pedido já será criado como pago, sem pendências.

Criar pedidos pendentes

Indicado quando:

  • Escola privada;
  • Ingressos meia-entrada ou pagos.

O sistema:

  • Gera o pedido;
  • Envia e-mail com link para pagamento.

8. Mapeamento de colunas

O sistema solicitará o vínculo entre:

  • Campos do Pretix;
  • Colunas do CSV.

Exemplos:

Campo Pretix Coluna CSV
Data Data da visita
E-mail Email da instituição
Telefone Telefone da instituição
Produto Produto
Variação Variação
Primeiro nome Primeiro nome
Sobrenome Sobrenome

Observação importante:

  • O Pretix memoriza os cabeçalhos utilizados anteriormente;
  • Manter os mesmos nomes facilita futuras importações.

9. Finalizando a importação

Após mapear os campos:

  1. Clique em Realizar importação;
  2. O sistema criará o pedido automaticamente;
  3. Você será redirecionado para a tela do pedido.

10. Validação do pedido gerado

Ao abrir o pedido:

  • Verifique:
    • E-mail da instituição;
    • Lista de participantes;
    • Produtos vinculados;
    • Status (Pago ou Pendente).

Caso o pedido tenha sido criado como pago:

  • Nenhuma pendência será exibida.

11. Boas práticas

  • Sempre revisar:
    • Produto;
    • Variação;
    • Data;
    • Formato CSV.
  • Manter padrão fixo de cabeçalhos.
  • Utilizar modo teste quando estiver validando o processo.
  • Conferir o pedido após a importação.

12. Materiais disponibilizados

Serão disponibilizados:

  • Modelo de planilha para envio às instituições;
  • Modelo de planilha de importação para o Pretix.

13. Suporte

Em caso de dúvidas, inconsistências ou necessidade de ajustes:

  • Entre em contato com a SeTIC/UFSC;
  • A documentação poderá ser atualizada conforme necessidade;
  • Novos tutoriais poderão ser publicados.

Fim do tutorial

Nenhum comentário para exibir

Voltar ao topo