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
| Vincolo | Valore |
|---|---|
| Righe di dati (intestazione esclusa) | massimo 10.000 |
| Dimensione | massimo 10 MB |
| Codifica | UTF-8 (anche con BOM) |
| Separatore | virgola (,) |
| Valuta | solo 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
| Valore | Formato |
|---|---|
| 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 IVA | solo 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 esempiocustom_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.