Skip to main content

Preparare il file per l'importazione

Gli esempi e gli screenshot di questa pagina usano un'associazione inventata, Save The Unicorns: nomi, indirizzi e dati sono di fantasia.

Save The Unicorns ha l'elenco dei sostenitori in un foglio di calcolo e vuole portarlo in Riseact. Prima di importare prepara il file con queste regole.

Gli esempi e gli screenshot di questa pagina usano un'associazione inventata, Save The Unicorns: nomi, indirizzi e dati sono di fantasia.

A cosa serve

Gli importatori servono a caricare i dati iniziali di un'organizzazione, non a tenere sincronizzato un CRM esterno. Le regole valgono per sostenitori e donazioni. Come importare: Importare sostenitori e Importare donazioni.

Cosa fa l'importazione

  • Non aggiorna i record esistenti: se un record corrisponde a uno già presente, resta com'è e i dati non vengono mai sovrascritti.
  • Si può ripetere senza creare doppioni: la deduplica usa i riferimenti esterni (external ref) o, per le righe senza chiave, un marcatore interno di riga.
  • Ogni importazione lascia un evento in Impostazioni > Importazioni, con stato, conteggi e righe scartate, e manda un'email di riepilogo.
  • Per ogni organizzazione ne gira una alla volta: finché una è in corso non ne parte un'altra.

Limiti del file

VincoloValore
Righe di dati (intestazione esclusa)massimo 10.000
Dimensionemassimo 10 MB
CodificaUTF-8 (anche con BOM)
Separatorevirgola (,)
Valutasolo EUR

Un file più grande va diviso in più importazioni.

Intestazioni

Le intestazioni sono in minuscolo, con le parole separate da spazi (non snake_case, non Title Case): per esempio first name, supporter external ref, payment date. Maiuscole e spazi esterni sono ignorati; gli spazi interni multipli diventano uno. Fanno eccezione le colonne dei campi personalizzati, che mantengono il prefisso custom_ con il trattino basso.

Formato dei valori

ValoreFormato
Importi (amount)x.xx: cifre intere, punto decimale, esattamente due decimali. Non valgono la virgola (12,34), il separatore delle migliaia (1.234,56), zero o un solo decimale (12 o 12.3), valori uguali o minori di zero.
Date e orari (payment date)ISO 8601: 2026-12-31, 2026-06-25 13:29:57, 2026-06-25T13:29:57.566Z. Formati come 31/12/2026 non sono accettati. Senza fuso orario vale UTC, senza ora vale 00:00.
Data di nascita (date of birth)AAAA-MM-GG
Codice paese (country code)due lettere ISO 3166-1 alpha-2, per esempio IT
Codice fiscale e partita IVAsolo controllo formale (caratteri alfanumerici, lunghezza massima), non l'esistenza reale
Sì/no (consensi marketing, campi flag)solo t/f, true/false, 0/1, senza distinguere maiuscole. Cella vuota: valore non impostato. Altri valori (yes, si, x) fanno fallire la riga.
Etichette (tag)più valori nella stessa cella separati da virgola. Racchiudi la cella tra virgolette: "x,y,z" crea tre etichette.

Campi personalizzati

  • Si importano in colonne custom_<key>, dove <key> è la chiave del campo già creato nell'organizzazione (per esempio custom_numero_tessera).
  • Il campo deve esistere già: l'importazione non ne crea. Una chiave sconosciuta dà un errore di intestazione. Come crearli: Aggiungere dati tuoi a sostenitori e donazioni.
  • Un campo di tipo sostenitore va sul sostenitore, uno di tipo donazione sulla donazione. Nell'importatore dei sostenitori valgono solo i campi di tipo sostenitore.
  • Flag segue la regola sì/no; per il menu a tendina il valore deve essere una delle opzioni; il testo libero non ha vincoli.

Consiglio di fundraising
Prima di caricare 5.000 righe prova con tre: un sostenitore di Banchetti degli Unicorni, uno di Adotta un unicorno e uno senza email. Leggi l'esito, poi importa il resto.

Problemi comuni

  • L'importazione fallisce subito, senza creare nulla: è un errore di file: CSV illeggibile, intestazioni non valide, file troppo grande. Correggi e ricarica.
  • Alcune righe risultano scartate: apri l'importazione in Impostazioni > Importazioni, esporta in CSV le sole righe scartate, correggile e ricaricale.
  • Importi o date rifiutati: controlla il formato: punto decimale con due decimali, data in ISO 8601.
  • Lo zero iniziale del CAP sparisce: imposta le celle come testo prima di salvare il CSV.

Vedi anche