SportOpsFormato dei dati

Il pacchetto dati aperto

Formato 1 · 30 entità · come i dati di una società escono dalla piattaforma, leggibili senza di lei.

Dove si trova. Dentro ogni backup della società (cartella export/ dell'archivio) e da Segreteria › Esporta dati › Pacchetto dati aperto. In entrambi i casi il file è uno zip cifrato AES-256 con la password scelta dalla società.

Cosa contiene. Per ogni entità due file con gli stessi campi — <entita>.json (elenco di oggetti) e <entita>.csv (separatore ;, UTF-8 con BOM, prima riga = nomi dei campi) — più schema/<entita>.schema.json (JSON Schema draft 2020-12), un LEGGIMI.md e un manifesto.json con i conteggi.

Regole del formato

Le entità

societa — La societàstagioni — Stagioni sportivecategorie — Categorieatleti — Atletifamiglie — Genitori e tutorilegami_familiari — Legami familiariallenatori — Allenatoridirigenti — Dirigenti e accompagnatorisquadre — Squadrerose — Rosestaff_squadre — Staff delle squadretesseramenti — Tesseramenti per stagionedocumenti — Documenti caricatiadempimenti — Adempimenti d'iscrizionevoci_pagamento — Voci di pagamentopagamenti — Addebiti e incassistrutture — Strutture sportivesquadre_avversarie — Squadre avversariecampionati — Campionatipartite — Partiteconvocazioni — Convocazioniallenamenti — Allenamentipresenze_allenamenti — Presenze agli allenamenticonti — Piano dei conticasse — Casse e conti correntiprima_nota — Prima notaeventi — Eventi della societàbacheca — Avvisi in bachecanote_staff — Note dello staffminutaggio — Minuti giocati

societa — La societàoggetto singolo

Chi è il titolare dei dati: ragione sociale, codici, sport e federazioni. · file: societa.json, societa.csv · schema: societa.schema.json

CampoTipoSignificato
ragione_socialetestoDenominazione legale.
codice_fiscaletestoCodice fiscale della società.
partita_ivatestoPartita IVA, se c'è.
indirizzotestoSede.
sporttestoLo sport praticato (es. calcio, pallavolo).
federazionitestoFederazioni ed enti di affiliazione, separati da virgola.
sito_webtestoSito della società.

stagioni — Stagioni sportive

Le stagioni configurate. Le altre entità citano la stagione per nome (es. «2026-2027»). · file: stagioni.json, stagioni.csv · schema: stagioni.schema.json

CampoTipoSignificato
idinteroIdentificativo.
nomechiave naturaletestoNome della stagione, es. «2026-2027». È la chiave usata dalle altre entità.
iniziodata (YYYY-MM-DD)Primo giorno.
finedata (YYYY-MM-DD)Ultimo giorno.
attivatrue / falseStagione in corso.

categorie — Categorie

Le categorie per età della società (Pulcini, Under 14, Prima squadra…). · file: categorie.json, categorie.csv · schema: categorie.schema.json

CampoTipoSignificato
idinteroIdentificativo.
nometestoNome della categoria.
descrizionetestoDescrizione.
eta_mininteroEtà minima.
eta_maxinteroEtà massima.
attivatrue / falseIn uso.

atleti — Atleti

L'anagrafica degli atleti con tesseramento, certificato medico e consensi. Il codice fiscale è la chiave naturale per riconoscere la stessa persona in un altro sistema. · file: atleti.json, atleti.csv · schema: atleti.schema.json

CampoTipoSignificato
idinteroIdentificativo nella piattaforma. Stabile dentro la stessa società; non ha significato altrove.
nometestoNome.
cognometestoCognome.
emailtestoIndirizzo email (può mancare).
telefonotestoNumero di telefono (può mancare).
codice_fiscalechiave naturaletestoCodice fiscale: la chiave naturale della persona.
data_nascitadata (YYYY-MM-DD)Data di nascita.
luogo_nascitatestoComune di nascita.
provincia_nascitatestoProvincia di nascita (sigla).
nazionalitatestoNazionalità.
sessotesto
M F
M o F.
indirizzotestoIndirizzo di residenza.
captestoCAP.
cittatestoComune di residenza.
provinciatestoProvincia di residenza (sigla).
categoria_idinteroCategoria assegnata (→ categorie.id).
categoriatestoNome della categoria, per leggere senza incrociare.
numero_tesseratestoNumero di tessera federale.
matricolatestoMatricola federale.
tessera_daldata (YYYY-MM-DD)Data del tesseramento.
tessera_scadenzadata (YYYY-MM-DD)Scadenza della tessera.
certificato_medico_scadenzadata (YYYY-MM-DD)Scadenza del certificato medico.
in_prestito_datestoSocietà di provenienza, se in prestito.
attivotrue / falseAtleta attivo (non archiviato).
archiviato_ilistante (ISO 8601)Quando è stato archiviato.
notetestoNote della segreteria.
consenso_termini_ilistante (ISO 8601)Quando ha accettato i termini d'uso (vuoto = mai).
consenso_privacy_sanitaria_ilistante (ISO 8601)Quando ha dato il consenso al trattamento dei dati sanitari.
consenso_marketingtrue / falseConsenso alle comunicazioni promozionali.

famiglie — Genitori e tutori

Le persone che rispondono per gli atleti minorenni. Il legame con gli atleti è in «legami_familiari». · file: famiglie.json, famiglie.csv · schema: famiglie.schema.json

CampoTipoSignificato
idinteroIdentificativo nella piattaforma. Stabile dentro la stessa società; non ha significato altrove.
nometestoNome.
cognometestoCognome.
emailtestoIndirizzo email (può mancare).
telefonotestoNumero di telefono (può mancare).
codice_fiscalechiave naturaletestoCodice fiscale.
indirizzotestoIndirizzo.
cittatestoComune.
provinciatestoProvincia (sigla).
captestoCAP.
attivotrue / falseAttivo.
consenso_termini_ilistante (ISO 8601)Quando ha accettato i termini d'uso (vuoto = mai).
consenso_privacy_sanitaria_ilistante (ISO 8601)Quando ha dato il consenso al trattamento dei dati sanitari.
consenso_marketingtrue / falseConsenso alle comunicazioni promozionali.

legami_familiari — Legami familiari

Chi è genitore o tutore di chi. · file: legami_familiari.json, legami_familiari.csv · schema: legami_familiari.schema.json

CampoTipoSignificato
genitore_idintero→ famiglie.id
atleta_idintero→ atleti.id
relazionetesto
PADRE MADRE TUTORE NONNO NONNA ZIO ZIA ALTRO
PADRE, MADRE, TUTORE, NONNO, NONNA, ZIO, ZIA, ALTRO.
contatto_principaletrue / falseÈ il contatto principale.
puo_ritiraretrue / falsePuò ritirare l'atleta.
contatto_emergenzatrue / falseContatto per le emergenze.
attivotrue / falseLegame in essere.

allenatori — Allenatori

Lo staff tecnico. · file: allenatori.json, allenatori.csv · schema: allenatori.schema.json

CampoTipoSignificato
idinteroIdentificativo nella piattaforma. Stabile dentro la stessa società; non ha significato altrove.
nometestoNome.
cognometestoCognome.
emailtestoIndirizzo email (può mancare).
telefonotestoNumero di telefono (può mancare).
patentinotestoQualifica o patentino.
specializzazionetestoSpecializzazione.
attivotrue / falseAttivo.

dirigenti — Dirigenti e accompagnatori

Lo staff dirigenziale. · file: dirigenti.json, dirigenti.csv · schema: dirigenti.schema.json

CampoTipoSignificato
idinteroIdentificativo nella piattaforma. Stabile dentro la stessa società; non ha significato altrove.
nometestoNome.
cognometestoCognome.
emailtestoIndirizzo email (può mancare).
telefonotestoNumero di telefono (può mancare).
ruolotestoRuolo in società.
attivotrue / falseAttivo.

squadre — Squadre

Le squadre della società, una per stagione. · file: squadre.json, squadre.csv · schema: squadre.schema.json

CampoTipoSignificato
idinteroIdentificativo.
nometestoNome della squadra.
categoriatestoCategoria (nome).
stagionetestoStagione (→ stagioni.nome).
attivatrue / falseAttiva.

rose — Rose

Chi gioca in quale squadra, con ruolo e numero di maglia. · file: rose.json, rose.csv · schema: rose.schema.json

CampoTipoSignificato
squadra_idintero→ squadre.id
atleta_idintero→ atleti.id
ruolotestoCodice del ruolo in campo secondo lo sport (es. portiere, difensore, centrocampista, attaccante).
posizionetestoPosizione, se indicata.
numero_magliainteroNumero di maglia.
attivotrue / falseIn rosa.

staff_squadre — Staff delle squadre

Chi segue quale squadra. · file: staff_squadre.json, staff_squadre.csv · schema: staff_squadre.schema.json

CampoTipoSignificato
squadra_idintero→ squadre.id
persona_idintero→ allenatori.id oppure dirigenti.id, secondo «tipo».
tipotesto
COACH DIRECTOR
COACH = allenatore, DIRECTOR = dirigente.
ruolotestoRuolo nello staff (primo allenatore, preparatore…).
attivotrue / falseIn carica.

tesseramenti — Tesseramenti per stagione

Per ogni atleta e stagione, se è un nuovo tesseramento o un rinnovo. · file: tesseramenti.json, tesseramenti.csv · schema: tesseramenti.schema.json

CampoTipoSignificato
atleta_idintero→ atleti.id
stagionetesto→ stagioni.nome
tipotestoNUOVO o RINNOVO.

documenti — Documenti caricati

I file conservati per atleta o squadra (certificati, moduli). Il file è in storage/documents/ dentro l'archivio. · file: documenti.json, documenti.csv · schema: documenti.schema.json

CampoTipoSignificato
idinteroIdentificativo.
atleta_idintero→ atleti.id (vuoto se documento di squadra).
squadra_idintero→ squadre.id (vuoto se di atleta).
nometestoNome dato al documento.
tipotestoTipo (es. certificato medico).
filetestoNome del file in storage/documents/.
scadenzadata (YYYY-MM-DD)Scadenza del documento.
caricato_ilistante (ISO 8601)Quando è stato caricato.

adempimenti — Adempimenti d'iscrizione

Per ogni requisito d'iscrizione (documento da caricare, consenso, firma): cosa ha fatto la famiglia e cosa ha verificato la segreteria. · file: adempimenti.json, adempimenti.csv · schema: adempimenti.schema.json

CampoTipoSignificato
idinteroIdentificativo.
atleta_idintero→ atleti.id
stagionetesto→ stagioni.nome
requisitotestoNome del requisito (es. «Certificato medico agonistico»).
modalitatestoCome si adempie: caricamento, presa visione, consenso, firma.
statotestoStato dell'adempimento nella piattaforma.
esitotestoPer i consensi: la risposta data.
scadenzadata (YYYY-MM-DD)Scadenza dichiarata.
filetestoNome del file caricato, se c'è (storage/preregistrations/ o storage/documents/).
verificatestoEsito della verifica della segreteria.
verificato_ilistante (ISO 8601)Quando è stato verificato.
confermato_ilistante (ISO 8601)Quando la famiglia ha confermato o firmato.

voci_pagamento — Voci di pagamento

Cosa la società chiede alle famiglie: quote, tesseramento, kit. · file: voci_pagamento.json, voci_pagamento.csv · schema: voci_pagamento.schema.json

CampoTipoSignificato
idinteroIdentificativo.
nometestoNome della voce.
descrizionetestoDescrizione.
importo_centintero (centesimi €)Importo in centesimi di euro.
ricorrenzatestoannuale, mensile, una tantum…
tesseramentotrue / falseÈ la quota di tesseramento.
stagionetesto→ stagioni.nome
attivatrue / falseIn uso.

pagamenti — Addebiti e incassi

Ogni riga è una somma dovuta da una famiglia, con il suo stato e — se incassata — quando e come. · file: pagamenti.json, pagamenti.csv · schema: pagamenti.schema.json

CampoTipoSignificato
idinteroIdentificativo.
voce_idintero→ voci_pagamento.id
atleta_idintero→ atleti.id
genitore_idintero→ famiglie.id (chi paga, se indicato).
importo_centintero (centesimi €)Importo dovuto in centesimi.
scadenzadata (YYYY-MM-DD)Data di scadenza.
periodotestoPeriodo di riferimento (es. mese).
statotesto
pending paid cancelled
pending = da pagare, paid = incassato, cancelled = annullato.
canaletestoCome è stato incassato (contanti, bonifico, online…).
pagato_ilistante (ISO 8601)Quando.
ricevuta_numerotestoNumero della ricevuta emessa.
notetestoNote.

strutture — Strutture sportive

I luoghi di gioco e allenamento, propri e in trasferta. · file: strutture.json, strutture.csv · schema: strutture.schema.json

CampoTipoSignificato
idinteroIdentificativo.
nometestoNome.
indirizzotestoIndirizzo.
cittatestoComune.
provinciatestoProvincia.
captestoCAP.
tipotestoTipo di struttura.
attivatrue / falseIn uso.

squadre_avversarie — Squadre avversarie

Le società contro cui si gioca. · file: squadre_avversarie.json, squadre_avversarie.csv · schema: squadre_avversarie.schema.json

CampoTipoSignificato
idinteroIdentificativo.
nometestoNome.
annointeroAnnata/categoria.
cittatestoCittà.

campionati — Campionati

I campionati a cui la società è iscritta. · file: campionati.json, campionati.csv · schema: campionati.schema.json

CampoTipoSignificato
idinteroIdentificativo.
nometestoNome.
stagionetesto→ stagioni.nome
categoriatestoCategoria.
livellotestoLivello (regionale, provinciale…).
gironetestoGirone.
formatotestoFormato di gioco.

partite — Partite

Amichevoli, tornei e campionato, con il risultato. La squadra della società è «squadra_casa_id» o «squadra_trasferta_id» (o entrambe, in un'amichevole interna). · file: partite.json, partite.csv · schema: partite.schema.json

CampoTipoSignificato
idinteroIdentificativo.
tipotesto
amichevole interna torneo campionato
amichevole, interna, torneo, campionato.
data_oraistante (ISO 8601)Calcio d'inizio.
ritrovo_oraistante (ISO 8601)Orario di ritrovo.
squadra_casa_idintero→ squadre.id, se la nostra squadra gioca in casa.
squadra_trasferta_idintero→ squadre.id, se la nostra squadra gioca in trasferta.
avversaria_idintero→ squadre_avversarie.id
avversaria_nometestoNome dell'avversaria, per leggere senza incrociare.
campionato_idintero→ campionati.id
struttura_idintero→ strutture.id
statotestoStato della partita (programmata, in corso, conclusa…).
risultato_casainteroGol/punti della squadra di casa.
risultato_trasfertainteroGol/punti della squadra in trasferta.
notetestoNote.

convocazioni — Convocazioni

Chi è stato chiamato per ogni partita e cosa ha risposto. · file: convocazioni.json, convocazioni.csv · schema: convocazioni.schema.json

CampoTipoSignificato
partita_idintero→ partite.id
atleta_idintero→ atleti.id
convocatotrue / falseÈ convocato.
disponibilitatesto
SI NO DA_CONFERMARE
SI, NO, DA_CONFERMARE.
numero_magliainteroNumero di maglia.
ruolotestoRuolo previsto.
notetestoNote.

allenamenti — Allenamenti

Le sedute di allenamento, squadra per squadra. · file: allenamenti.json, allenamenti.csv · schema: allenamenti.schema.json

CampoTipoSignificato
idinteroIdentificativo.
squadra_idintero→ squadre.id
titolotestoTitolo.
data_oraistante (ISO 8601)Inizio.
durata_mininteroDurata in minuti.
luogotestoLuogo.
allenatore_idintero→ allenatori.id
statotesto
scheduled completed cancelled
scheduled, completed, cancelled.
notetestoNote.

presenze_allenamenti — Presenze agli allenamenti

Chi c'era a ogni seduta. · file: presenze_allenamenti.json, presenze_allenamenti.csv · schema: presenze_allenamenti.schema.json

CampoTipoSignificato
allenamento_idintero→ allenamenti.id
atleta_idintero→ atleti.id
statotesto
present absent late excused
present, absent, late, excused.
notetestoNote.

conti — Piano dei conti

Il piano dei conti della tesoreria (schema CNDCEC/FNC per gli enti sportivi). · file: conti.json, conti.csv · schema: conti.schema.json

CampoTipoSignificato
codicechiave naturaletestoCodice del conto.
nometestoNome ufficiale.
etichettatestoEtichetta usata dalla società.
sezionetestoSezione del rendiconto.
versotestoentrata o uscita.
naturatestoNatura (istituzionale, commerciale…).
attivotrue / falseIn uso.

casse — Casse e conti correnti

Dove stanno i soldi. · file: casse.json, casse.csv · schema: casse.schema.json

CampoTipoSignificato
idinteroIdentificativo.
nometestoNome.
tipotestoTipo (cassa contanti, conto corrente…).
ibantestoIBAN, se conto corrente.
saldo_apertura_centintero (centesimi €)Saldo iniziale in centesimi.
data_aperturadata (YYYY-MM-DD)Data del saldo iniziale.
attivatrue / falseIn uso.

prima_nota — Prima nota

Tutti i movimenti di cassa registrati in tesoreria. · file: prima_nota.json, prima_nota.csv · schema: prima_nota.schema.json

CampoTipoSignificato
idinteroIdentificativo.
datadata (YYYY-MM-DD)Data del movimento.
versotestoentrata o uscita.
importo_centintero (centesimi €)Importo in centesimi.
conto_codicetesto→ conti.codice
conto_nometestoNome del conto, per leggere senza incrociare.
cassatestoNome della cassa o del conto corrente.
contropartetestoChi ha pagato o è stato pagato.
descrizionetestoDescrizione.
doc_tipotestoTipo di documento (ricevuta, fattura…).
doc_numerotestoNumero del documento.
doc_datadata (YYYY-MM-DD)Data del documento.
stagionetesto→ stagioni.nome
naturatestoNatura (istituzionale, commerciale…).
iva_percentinteroAliquota IVA, se c'è.
iva_centintero (centesimi €)IVA in centesimi.
allegatotestoNome del file allegato in storage/accounting/, se c'è.

eventi — Eventi della società

Assemblee, feste, riunioni e ogni appuntamento che non sia una partita o un allenamento. · file: eventi.json, eventi.csv · schema: eventi.schema.json

CampoTipoSignificato
idinteroIdentificativo nella piattaforma.
titolotestoTitolo dell'evento.
descrizionetestoDescrizione libera (può mancare).
datadata (YYYY-MM-DD)Giorno dell'evento.
oratestoOra di inizio, se indicata (HH:MM).
luogotestoDove si tiene.
squadra_idinteroSquadra a cui è rivolto; vuoto se è di tutta la società.
tipotestoTipo dichiarato dalla società.
visibilitatestopublic = visibile a tutti nella società; internal = solo allo staff.

bacheca — Avvisi in bacheca

Gli avvisi pubblicati alla società o a una squadra. Il testo è quello che le famiglie hanno letto. · file: bacheca.json, bacheca.csv · schema: bacheca.schema.json

CampoTipoSignificato
idinteroIdentificativo nella piattaforma.
titolotestoTitolo dell'avviso.
testotestoIl testo dell'avviso.
squadra_idinteroSquadra destinataria; vuoto se a tutta la società.
autoretestoChi lo ha scritto.
pubblicato_ilistante (ISO 8601)Quando è stato pubblicato.
ritirato_ilistante (ISO 8601)Quando è stato ritirato, se lo è stato.

note_staff — Note dello staff

Le note che allenatori e dirigenti hanno scritto su allenamenti e partite. Sono dati personali degli atleti citati: l'interessato ha diritto di conoscerne il contenuto. L'audio delle note vocali non è incluso (vedi esclusioni): qui c'è il testo. · file: note_staff.json, note_staff.csv · schema: note_staff.schema.json

CampoTipoSignificato
idinteroIdentificativo nella piattaforma.
tipo_attivitatestoALLENAMENTO o PARTITA.
attivita_idinteroIdentificativo dell'allenamento o della partita.
squadra_idinteroSquadra dell'attività.
autoretestoChi ha scritto la nota.
testotestoIl testo della nota (per le note vocali, la trascrizione fatta sul dispositivo).
ha_audiotrue / falseVero se esisteva anche una registrazione audio, che non è inclusa nel pacchetto.
scritta_ilistante (ISO 8601)Quando è stata scritta.

minutaggio — Minuti giocati

Quanti minuti ha giocato ciascun atleta in ciascun tempo di ciascuna partita. · file: minutaggio.json, minutaggio.csv · schema: minutaggio.schema.json

CampoTipoSignificato
partita_idinteroIdentificativo della partita.
atleta_idinteroIdentificativo dell'atleta.
tempointeroNumero del tempo (1, 2, …).
minuti_giocatiinteroMinuti giocati in quel tempo.

Un esempio

[
  {
    "id": 27,
    "nome": "Alessandro",
    "cognome": "Bianchi",
    "email": "a.bianchi@example.it",
    "telefono": "3200000027",
    "codice_fiscale": "BNCLSN11S02F205X",
    "data_nascita": "2011-11-02",
    "luogo_nascita": "Milano",
    "provincia_nascita": "MI",
    "nazionalita": "Italiana",
    "sesso": "M",
    "indirizzo": "Via Roma 1",
    "cap": "20100",
    "citta": "Milano",
    "provincia": "MI",
    "categoria_id": 3,
    "categoria": "Under 15",
    "numero_tessera": "1234567",
    "matricola": null,
    "tessera_dal": "2026-09-01",
    "tessera_scadenza": "2027-06-30",
    "certificato_medico_scadenza": "2027-03-15",
    "in_prestito_da": null,
    "attivo": true,
    "archiviato_il": null,
    "note": null,
    "consenso_termini_il": "2026-09-01T09:12:00.000Z",
    "consenso_privacy_sanitaria_il": "2026-09-01T09:12:00.000Z",
    "consenso_marketing": false
  }
]

Un estratto di atleti.json. Il CSV corrispondente ha una riga con gli stessi valori, nello stesso ordine dei campi.