Skip to main content

Preparare il file per l'importazione

1.

Gli Importazioniesempi –e infogli generaliscreenshot di questa pagina usano un'associazione inventata, Save The Unicorns: nomi, indirizzi e dati sono di fantasia.

RiseActSave permetteThe Unicorns ha l'elenco dei sostenitori in un foglio di calcolo e vuole portarlo in Riseact. Prima di importare sostenitoriprepara e donazioni dail file CSV.con queste regole.

A cosa serve

Gli importatori sono pensati come strumento di onboarding: servono a caricare i dati iniziali di un'organizzazione, non a manteneretenere una sincronizzazione continua consincronizzato un CRM esterno. Le regole valgono per sostenitori e donazioni. Come importare: Importare sostenitori e Importare donazioni.

Cosa

Principifa generali

l'importazione
  • NessunNon aggiornamentoaggiorna deii record esistenti.esistenti: Sese un record corrispondentecorrisponde esistea uno già (inpresente, base alle chiavi di deduplica), viene mantenuto cosìresta com'è:è e i dati presenti non vengono mai sovrascritti.
  • Idempotenza.Si Reimportarepuò loripetere stessosenza filecreare nondoppioni: crea duplicati. Lala deduplica avviene tramiteusa i riferimenti esterni (external ref) o, per le righe senza chiave, tramite un marcatore interno di riga.
  • Report in app. Ogni importazione generalascia un evento consultabile in Impostazioni →> Importazioni, con stato, conteggi e righe scartate.scartate, Ale termine viene inviata anchemanda un'email di riepilogo.
  • Un'importazionePer perogni organizzazione ne gira una alla volta.volta: Finchéfinché un'importazioneuna è in corso,corso non se ne può avviareparte un'altra per la stessa organizzazione.altra.

Limiti del file

Vincolo Valore Righe di dati (esclusaintestazione intestazione)esclusa) maxmassimo 10.000 Dimensione file maxmassimo 10 MB Codifica UTF-8 (o UTF-8anche con BOM) Separatore virgola (,) Valutasolo EUR

Un (unica supportata)

Filefile più grandigrande vannova suddivisidiviso in più importazioni.

Formato dell'intestazione

Intestazioni

Le intestazioni sono minuscole,in minuscolo, con le parole separate da spazi (non snake_case, non Title Case).: Esempio:per esempio first name, supporter external ref, payment date. Il confronto ignora maiuscole/minuscoleMaiuscole e spazi esterni;esterni sono ignorati; gli spazi interni multipli vengonodiventano normalizzatiuno. aFanno uno solo.

Unica eccezione:eccezione le colonne dei campi personalizzati, che mantengono il prefisso custom_ con underscore.il trattino basso.

Regole di formato

Formato dei valori

Valgono per entrambi gli importatori (sostenitori e donazioni).

    ValoreFormato
    Importi (amount): formato fisso x.xx —: cifre intere, punto come separatore decimale, esattamente due decimali (regex ^\d{1,10}\.\d{2}$).decimali. Non ammessi:valgono la virgola decimale (12,34), il separatore delle migliaia (1.234,56), zero o un solo decimale (12,12 o 12.3), valori ≤uguali 0.o minori di zero.
    Date e timestamporari (payment date): ISO 8601 stretto. Formati accettati:8601: 2026-12-31, 2026-06-25 13:29:57, 2026-06-25T13:29:57.566Z. Formati ambigui come 31/12/2026 non sono accettati. Se manca ilSenza fuso orario sivale assumeUTC, UTC;senza se manca l'ora si assumevale 00:00. Data di nascita (date of birth): formato YYYY-AAAA-MM-DDGG. Codice paese (country code):due lettere ISO 3166-1 alpha-22, (2per lettere,esempio es. IT). ITCodice fiscale /e partita IVA: IVAsolo validazionecontrollo formale (caratteri alfanumerici, entro la lunghezza massima);, nessunnon controllo di l'esistenza reale. Valori booleanirealeSì/no (consensi marketing emarketing, campi personalizzati BOOLEAN): ammesse flag)solo questet/f, coppietrue/false, (case-insensitive):0/1, t/f,senza true/false,distinguere 0/1.maiuscole. Cella vuota =vuota: valore non impostato. QualsiasiAltri altro valorevalori (yes, si, x,x) ecc.) fafanno fallire la riga.Etichette Tag multivalore: (tag)più valori nella stessa cella separati da virgolavirgola. nella stessa cella. Poiché la virgola è anche il separatore CSV,Racchiudi la cella va racchiusa tra virgolette, es.virgolette: "x,y,z" → producecrea tre tag: x, y, z.

    Regole di deduplica

      Sostenitore: catena di chiavi, la prima valorizzata vince: supporter external ref → email → ssn → vat. Se nessuna chiave è valorizzata, viene sempre creato un nuovo sostenitore anonimo. Se una chiave secondaria (email/ssn/vat) individua più sostenitori esistenti, vince quello con id più basso. Donazione: chiave donation external ref. Righe con lo stesso riferimento confluiscono in un'unica donazione con più pagamenti. Senza questo riferimento, ogni riga diventa una donazione one-off separata. Pagamento: chiave (donazione, data pagamento, importo) — evita di contare due volte lo stesso pagamento in caso di reimportazione.

      etichette.

      Campi personalizzati

      • Si importano conin colonne dedicate custom_<key>, dove <key> è la chiave stabile di una definizione didel campo personalizzato già esistentecreato nell'organizzazione (es.per esempio custom_numero_tessera).
      • LaIl definizionecampo deve esistere già: l'importazione non creane nuovi campi personalizzati.crea. Una <key>chiave inesistentesconosciuta generadà un errore di intestazione. Come crearli: Aggiungere dati tuoi a sostenitori e donazioni.
      • La colonna viene assegnata all'entità della sua definizione: unUn campo di tipo sostenitore va sul sostenitore, uno di tipo donazione va sulla donazionedonazione. (anche nel file donazioni denormalizzato).
      Nell'importatore dei sostenitori sono ammessevalgono solo chiavii campi di tipo sostenitore. Coerenza valori: BOOLEANFlag segue la regola booleanasì/no; sopra;per SELECTil menu a tendina il valore deve essere trauna ledelle opzioniopzioni; dellail definizione;testo TEXTlibero senzanon ha vincoli.

      Consiglio

      Reportdi edfundraising


      Prima esitodi dell'importazionecaricare

      Al5.000 termine,righe inprova Impostazionicon →tre: Importazioniun sisostenitore trovano:di Banchetti degli Unicorni, uno di Adotta un unicorno e uno senza email. Leggi l'esito, poi importa il resto.

      Problemi comuni

      • statoL'importazione dell'importazione:fallisce Insubito, attesa,senza Increare corso,nulla: Completata,è Fallita;
      un conteggi dei record creati (sostenitori, donazioni, pagamenti) e delle righe scartate; elenco delle righe scartate con motivo, con possibilitàerrore di esportarefile: in CSV il solo sottoinsieme scartato, per correggerlo e ricaricarlo.

      Un errore a livello di file (CSV illeggibile, intestazioni non valide, file troppo grande,grande. controllo preliminare fallito) fa fallire l'intera importazione senza creare alcun record. Un errore su una singola riga non blocca l'importazione: la riga finisce tra quelle scartateCorreggi e ricarica.

      Alcune righe risultano scartate: apri l'importazione restain Completata.Impostazioni > 2.Importazioni, Importazioneesporta Sostenitoriin

      Carica i sostenitori da un file CSV. VediCSV le regolesole generalirighe soprascartate, (formatocorreggile file,e date,ricaricale.

      booleani,Importi tag,o deduplica)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 prepararesalvare il file.CSV.

      Nessuna

      Vedi colonnaanche

      èImportare obbligatoriasostenitori perImportare riga:donazioni unAggiungere sostenitoredati anonimotuoi (tuttea le celle vuote) è validosostenitori e vienedonazioni ignorato senza errore. La deduplica usa la catena supporter external ref → email → ssn → vat.

      Colonne disponibili

      Colonna Descrizione