21points

Centro de ajuda

Importar dados a partir do Excel

Última atualização: 30 julho 2026

Nem todas as inscrições passam pelo formulário do 21POINTS. Às vezes o clube já tem o seu próprio formulário, a federação manda-te a lista, ou chegou tudo por email e acabou numa folha de cálculo. É para isso que existe a importação a partir do Excel: um único modelo que cria pistas, categorias, equipas, jogadores e equipa técnica. Preenches só as folhas de que precisas, envias o ficheiro e vês exatamente o que vai acontecer antes de se guardar seja o que for.

  • 5 FOLHAS, 1 MODELO
  • PRÉ-VISUALIZAÇÃO
  • CRIA, NUNCA SUBSTITUI
  • ATÉ 5 MB
  1. 1 Descarrega o modelo
  2. 2 Preenche as folhas necessárias
  3. 3 Envia e pré-visualiza
  4. 4 Corrige os erros
  5. 5 Confirma a importação
Podes enviar e pré-visualizar as vezes que quiseres; até ao último passo não se cria nada.

01Abre o importador

No menu do evento, entra em Participantes → Importar dados. Chegas a Importar evento a partir do Excel, que cria as cinco coisas de uma vez: pistas, categorias, equipas, jogadores e equipa técnica.

Não é preciso ter nada criado antes. Podes usá-lo num evento acabado de criar e vazio: o próprio modelo cria as pistas e as categorias, e depois pendura nelas as equipas.

Ecrã «Importar evento a partir do Excel» com dois passos: descarregar o modelo e selecionar o ficheiro Excel.
Importar evento a partir do Excel — dois passos: descarregar o modelo e enviar o ficheiro preenchido.

02Descarrega o modelo

Carrega em Descarregar modelo. Obténs um `.xlsx` gerado para esse evento concreto e no idioma do teu painel, com seis folhas:

  • Instruções — o resumo disto tudo, dentro do próprio ficheiro.
  • Pistas, Categorias, Equipas, Jogadores e Equipa técnica — uma folha por tipo de dado, com as suas colunas e com listas pendentes nas células que precisam delas.

Preenche só as folhas de que precisas: as que deixares vazias são ignoradas. Se só te faltam equipas, preenche Equipas (e Jogadores se tiveres os plantéis) e esquece o resto.

Dois detalhes do modelo a conhecer antes de escrever:

  • O que já existe no evento aparece a cinzento com a nota «(já existe)». É só referência: não volta a ser criado. Podes apagar essas linhas.
  • Cada folha traz uma linha de exemplo a azul itálico que começa por «EXEMPLO ▸». Também não é importada: apaga-a ou escreve por cima.

03Preenche as folhas

A ordem por que as preenches é indiferente: o 21POINTS importa sempre pela ordem certa (pistas → categorias → equipas → jogadores → equipa técnica), por isso na folha Equipas podes referenciar à vontade uma categoria que estejas a criar nesse mesmo ficheiro. Os campos marcados com `*` são obrigatórios.

Pistas

  • Nome \* — o nome do campo.
  • Ordem — a ordem de apresentação. Se ficar vazia é atribuída sozinha.

Categorias

  • Nome \* e Géneros permitidos \* — um ou vários de `m`, `f`, `mixed`, separados por vírgulas (por exemplo `m, f`).
  • Capacidade — número máximo de equipas (2-1024). Só é obrigatória se o evento usar lotação fixa.
  • Ano nasc. mín e Ano nasc. máx — o escalão etário da categoria.
  • Pistas permitidas — nomes de pista separados por vírgulas; vazio significa que pode jogar em todas.
  • Atenção: só se importam categorias simples. A divisão por género (subcategorias) faz-se depois dentro da aplicação.

Equipas

  • Nome \* e Categoria \* — a categoria tem de existir no evento ou ser criada na folha Categorias deste mesmo ficheiro.
  • Género — `m`, `f` ou `mixed`.
  • Email, Tutor (nome), Tutor email e Tutor telefone — contacto da equipa e do responsável legal. Opcionais.

Jogadores

  • Equipa \* — tem de coincidir exatamente com um nome da folha Equipas. Se não coincidir com nenhum, o jogador fica órfão e bloqueia a importação.
  • Nome \* e Apelidos \*.
  • Número — opcional, mas não pode repetir-se dentro da mesma equipa.
  • Data de nascimento — sempre com o dia primeiro: `15/03/2005`. O separador é indiferente (`/`, `-` ou `.`), e uma célula com formato de data do Excel também serve.

Equipa técnica

  • Nome completo \* e Telefone — o telefone é obrigatório exceto se marcares É menor = Sim.
  • N.º — número de pessoal (1-999, único no evento). Vazio = atribuído sozinho.
  • Funções — separadas por vírgulas. A Scorer APP usa `referee` (árbitro) e `table` (mesa) para atribuir pessoal a cada jogo.
  • Email — opcional.

A regra dos duplicados

É a regra que mais dores de cabeça poupa: a importação só cria coisas novas, nunca substitui.

  • Se uma pista, categoria ou equipa já existir no evento com esse mesmo nome, a linha é ignorada e reportada como aviso. O que já tens não é tocado.
  • Se um nome estiver repetido dentro do ficheiro, isso sim é um erro e tens de o corrigir.

Por isso podes importar várias vezes sobre o mesmo evento sem receio de duplicar: as linhas que já lá estiverem são simplesmente saltadas.

04Envia o ficheiro e revê a pré-visualização

Carrega em Seleciona o ficheiro Excel (aceita `.xlsx` e `.xls`, até 5 MB) e depois em Pré-visualizar. É aqui que o 21POINTS lê o teu ficheiro e te mostra o que vai acontecer. Ainda não se guarda nada.

Em cima vês a contagem por tipo — pistas, categorias, equipas, jogadores, equipa técnica — e à direita os erros e os avisos. Por baixo, cada folha com o detalhe linha a linha:

  • Erros (vermelho) — bloqueiam a importação. Por exemplo: uma categoria que não existe nem é criada no ficheiro, um nome repetido dentro do ficheiro, um género que não é `m`, `f` nem `mixed`, um jogador sem nome, um número repetido na mesma equipa, um email mal escrito ou um n.º de pessoal já em uso.
  • Avisos (âmbar) — não bloqueiam nada, apenas informam: algo que já existe e é ignorado, um ano de nascimento fora do escalão da categoria, ou uma equipa com menos jogadores do que a categoria espera.

Corrige o Excel, envia-o outra vez e pré-visualiza de novo. As vezes que forem precisas.

Pré-visualização de uma importação: contagem de pistas, categorias, equipas, jogadores e equipa técnica, com 1 erro e 1 aviso e o detalhe por folha.
Pré-visualização — a contagem por tipo e o detalhe por folha. Enquanto houver erros, não se importa nada.

05Confirma a importação

Quando não sobrarem erros, carrega em Confirmar importação. Cria-se tudo de uma vez e é-te confirmado quantas pistas, categorias, equipas, jogadores e pessoas foram dadas de alta.

A partir daí são dados normais do evento: as categorias podem dividir-se por género, as equipas entram no sorteio e no calendário, e a equipa técnica fica disponível para ser atribuída aos jogos.

O que a importação NÃO traz

O modelo cobre a estrutura do evento e os participantes. Não traz logótipos de equipa, pagamentos de inscrição nem assinaturas de consentimento: isso vive no fluxo de inscrição online. Se precisares de cobrar a quota ou recolher assinaturas, abre o formulário de inscrições e usa a importação só para o que chegou por outra via. As duas formas convivem sem problema no mesmo evento.

Existe ainda um importador só de equipas e jogadores em Participantes → Equipas → Importar equipas, com o seu modelo mais curto. Esse sim precisa que as categorias já estejam criadas: usa-o quando só te faltar acrescentar equipas a um evento já montado.

Perguntas frequentes

Tenho de criar as categorias e as pistas antes de importar?

Não. O modelo de Importar dados traz as suas folhas de Pistas e Categorias e cria-as por ti; podes partir de um evento completamente vazio. O que exige categorias prévias é o importador curto de Equipas → Importar equipas.

Posso importar várias vezes no mesmo evento?

Sim. A importação só cria elementos novos: o que já existir com o mesmo nome é ignorado com um aviso, nunca duplicado nem substituído.

E se me enganar? Posso desfazer uma importação?

Não há um botão de «desfazer», mas não se guarda nada até carregares em Confirmar importação — a pré-visualização serve exatamente para isso. Se algo passar, edita-o ou desativa-o a partir da lista correspondente.

Tenho de preencher todas as folhas?

Não. As folhas vazias são ignoradas. Preenche só o que precisas — por exemplo, apenas Equipas e Jogadores se as pistas e as categorias já estiverem montadas.

O que são as linhas cinzentas e a linha «EXEMPLO ▸»?

As cinzentas são o que já existe no teu evento, colocadas ali apenas como referência; não voltam a ser criadas. A linha azul em itálico que começa por «EXEMPLO ▸» mostra o formato esperado e também não é importada. Podes apagar ambas ou escrever por cima.

Serve um CSV?

Não. O importador aceita .xlsx e .xls, até 5 MB. Se tiveres um CSV, abre-o e copia as colunas para dentro do modelo.

Descarreguei o modelo noutro idioma, serve na mesma?

Sim. O 21POINTS reconhece as folhas do modelo em qualquer um dos seus idiomas, por isso um ficheiro descarregado por um colega com o painel noutro idioma é lido da mesma forma. A data de nascimento vai sempre com o dia primeiro, seja qual for o separador.

Posso importar categorias divididas por género?

Não diretamente: a importação cria categorias simples. A divisão por género (Feminino / Masculino dentro da mesma categoria) faz-se depois a partir da aplicação.

Posso importar equipas sem jogadores?

Sim. Deixa a folha Jogadores vazia e completa os plantéis mais tarde a partir da ficha de cada equipa.