Voltar para Resources
Passo a Passo

Documentação: formato de inscrições CSV/Excel

28 de julho de 20264 min de leituraPor Suporte Sports Timing Brasil
Documentação: formato de inscrições CSV/Excel

Formato de Arquivo CSV/Excel de Inscrições

Além dos formatos padronizados de importação como LENEX (.lef/.lxf) e SDIF (.sd3), você pode importar inscrições para competições de natação e águas abertas utilizando arquivos de texto (.,csv, .txt) ou planilhas Excel (.xlsx).

O formato do arquivo segue uma especificação simples e direta, conforme a especificação original da Swimrankings.net, desenvolvida por Christian Kaufmann. A Sports Timing Brasil adota esse formato por entender que ele oferece uma alternativa ágil, acessível e de fácil manipulação para equipes, treinadores e organizadores que gerenciam inscrições fora dos softwares tradicionais de gestão.


Estrutura Geral do Arquivo

  1. Linha 1 (Identificação do Evento): Contém as informações da competição: nome do evento, cidade, país, tipo de piscina (comprimento) e data. Todos os campos devem ser separados por ponto e vírgula (;).
  2. Linha 2 (Cabeçalho das Colunas): Contém os nomes das colunas em letras maiúsculas (UPPERCASE), separados por ponto e vírgula (;). As colunas podem estar em qualquer ordem.
  3. Linha 3 em diante (Inscrições): Contém as inscrições, sendo uma inscrição por linha.

Colunas Necessárias (Mínimas)

Para uma importação válida, o arquivo precisa conter pelo menos as seguintes colunas:

  • DISTANCE: A distância da prova em metros (ex: 50, 100, 200, 400, 800, 1500). Para provas de revezamento, é a distância percorrida por um único atleta (ex: 100 em um revezamento 4x100).
  • STROKE: O estilo da prova. Valores permitidos: FREE (Livre), BACK (Costas), BREAST (Peito), FLY (Borboleta) ou MEDLEY (Medley).
  • ENTRYTIME: O tempo de balizamento/inscrição no formato MM:SS.ZZ ou SS.ZZ (ex: 1:02.50, 54.30 ou NT caso não possua tempo). Atenção: alguns sistemas usam 99:99.99 para sinalizar um atleta sem tempo... nunca faça isso em arquivos importados!!!.
  • GENDER: Gênero do atleta ou, no caso de revezamentos, o gênero da prova. Valores permitidos: M (Masculino), F (Feminino) ou X (Misto).
  • CLUBCODE: O código ou sigla oficial do clube/equipe (ex: ECP, CRF, MTC). Utilize valores oficiais da sua federação.
  • CLUBNAME: Nome completo do clube ou equipe.
  • RELAYCOUNT: Número de atletas da prova. Para inscrições individuais, utilize 1. Para revezamentos (ex: 4x100), utilize 4.
  • FIRSTNAME: Primeiro nome do atleta (para provas individuais).
  • LASTNAME: Sobrenome do atleta (para provas individuais).
  • FULLNAME: Nome completo do atleta (para provas individuais, feito para países que utilizam apenas o nome completo comumente).
  • BIRTHDATE: Data de nascimento do atleta no formato DD.MM.YYYY ou DD/MM/YYYY. Deixe em branco para revezamentos (veja também a coluna YOB, apenas em casos extremos).
  • LICENSE: Número de licença/registro oficial do atleta na federação. No caso do Brasil, este campo deve ser preenchido exclusivamente com o ID CBDA do atleta. Se não souber, pode deixar em branco.
  • NATION: Nacionalidade do atleta (código ISO de 3 letras, ex: BRA, ARG, SUI), o mesmo utilizado pela World Aquatics (AQUA).

Colunas Opcionais

Você também pode incluir as seguintes colunas opcionais no arquivo para enriquecer os dados ou atender a especificidades da competição:

  • YOB: Ano de nascimento do atleta com 4 dígitos (ex: 2005). Pode ser usado no lugar de BIRTHDATE caso você não possua a data completa. Nota: Recomendamos fortemente a utilização da data completa (BIRTHDATE), pois o uso do ano isolado converterá a data de nascimento para 01/01 do ano informado.
  • CLUBNATION: País do clube (código ISO de 3 letras). Se omitido, será considerado por padrão a mesma nacionalidade informada em NATION (registro do atleta).
  • HANDICAP: Classe funcional para atletas paralímpicos (ex: S9, SB8, SM9), utilizada para balizamento e organização por classes adaptadas.
  • EXCEPTION: Código de exceção/restrição funcional para atletas paralímpicos.
  • RELAYNUMBER: Número de identificação da equipe no revezamento. Essencial caso o mesmo clube inscreva mais de uma formação na mesma prova (ex: Equipe A = 1, Equipe B = 2).

Atletas do Revezamento

Para incluir a escalação dos atletas no revezamento, você pode adicionar colunas com o sufixo <n>, onde <n> é o número do nadador (1 a 4). Exemplo:

  • FIRSTNAME1, LASTNAME1, GENDER1, BIRTHDATE1 (ou YOB1), LICENSE1 (1º nadador)
  • FIRSTNAME2, LASTNAME2, GENDER2, BIRTHDATE2 (ou YOB2), LICENSE2 (2º nadador)
  • ...e assim por diante até o nadador 4.

Exemplo de Arquivo CSV

Abaixo está um exemplo completo com o cabeçalho da competição, duas inscrições individuais e uma de revezamento:

Troféu Brasil de Natação;Rio de Janeiro;BRA;LCM;15.08.2026
RELAYCOUNT;DISTANCE;STROKE;LASTNAME;FIRSTNAME;GENDER;BIRTHDATE;CLUBCODE;CLUBNAME;NATION;ENTRYTIME;LASTNAME1;FIRSTNAME1;GENDER1;BIRTHDATE1;LASTNAME2;FIRSTNAME2;GENDER2;BIRTHDATE2;LASTNAME3;FIRSTNAME3;GENDER3;BIRTHDATE3;LASTNAME4;FIRSTNAME4;GENDER4;BIRTHDATE4
1;400;FREE;Cordeiro;João Pedro;M;01.01.2000;STB;Sports Timing Brasil;BRA;4:59.99
1;200;MEDLEY;Domingues;Carlos Eduardo;M;01.01.1999;STB;Sports Timing Brasil;BRA;2:01.01
4;100;MEDLEY;;;F;;STB;Sports Timing Brasil;BRA;4:01.02;Cordeiro;João Pedro;M;01.01.2000;Domingues;Carlos Eduardo;M;01.01.1999;Silva;Matheus;M;01.01.2002;Oliveira;Lucas;M;01.01.2001