Come formattare correttamente un file CSV per l’importazione
L’importazione di dati tramite file CSV è una delle operazioni più comuni nei sistemi gestionali e nei CRM.
Che si tratti di migrare dati da un vecchio software, importare contatti da un foglio di calcolo o caricare anagrafiche prodotti, il formato CSV rappresenta uno standard semplice e universalmente supportato. Tuttavia, per evitare errori durante l’importazione o problemi di lettura dei dati, è fondamentale preparare il file in modo corretto.
Cos’è un file CSV
Il formato CSV (Comma Separated Values) è un file di testo che organizza i dati in righe e colonne. Ogni riga rappresenta un record (ad esempio un cliente o un prodotto), mentre le colonne rappresentano i campi associati a quel record.
Le colonne sono separate da un delimitatore, che nella maggior parte dei casi è una virgola o un punto e virgola. Nei contesti europei, dove la virgola è spesso utilizzata come separatore decimale, è molto comune utilizzare il punto e virgola come separatore tra le colonne.
Esempio di struttura CSV:
Nome;Cognome;Email;Telefono
Mario;Rossi;mario.rossi@email.it;3331234567
Laura;Bianchi;laura.bianchi@email.it;3479876543
La prima riga contiene le intestazioni dei campi, mentre le righe successive contengono i dati.
Utilizzare correttamente l’intestazione delle colonne
La riga di intestazione è fondamentale perché permette al gestionale o al CRM di riconoscere i campi da importare. Ogni colonna deve avere un nome chiaro e coerente con i campi previsti dal sistema di destinazione.
Ad esempio, se il CRM prevede i campi:
- Nome
- Cognome
- Telefono
le intestazioni del CSV dovrebbero rispecchiare esattamente questi nomi oppure quelli indicati nella documentazione di importazione del software.
Una discrepanza nei nomi delle colonne può impedire la corretta mappatura dei dati.
Mantenere una struttura uniforme
Ogni riga del file deve contenere lo stesso numero di colonne. Se un campo non ha valore, è comunque necessario lasciare il delimitatore per mantenere la struttura corretta.
Esempio corretto:
Nome;Cognome;Email;Telefono
Mario;Rossi;mario@email.it;333111111
Anna;Verdi;;349222222
Nel secondo record il campo email è vuoto, ma la struttura rimane valida.
Attenzione ai caratteri speciali
I file CSV possono generare errori se contengono caratteri speciali non gestiti correttamente. In particolare è importante prestare attenzione a:
- virgolette
- delimitatori presenti nei testi
- ritorni a capo all’interno delle celle
Se un campo contiene il delimitatore (ad esempio il punto e virgola), il valore deve essere racchiuso tra virgolette.
Esempio:
Nome;Indirizzo;Città
Marco;"Via Roma 10; Interno 3";Milano
In questo modo il sistema interpreterà correttamente il campo come un unico valore.
Formattazione dei dati
I gestionali e i CRM spesso richiedono formati specifici per determinati campi. Alcuni esempi comuni includono:
Date
È preferibile utilizzare formati standard come:
YYYY-MM-DD
Esempio:
2026-03-11
Numeri
I valori numerici dovrebbero essere inseriti senza simboli aggiuntivi, come il simbolo dell’euro o separatori di migliaia.
Esempio corretto:
1500.50
Esempio da evitare:
€ 1.500,50
Gli indirizzi email devono essere scritti in formato completo e senza spazi.
Codifica del file
Un altro aspetto spesso trascurato riguarda la codifica del file. Per evitare problemi con caratteri accentati o simboli speciali, è consigliabile salvare il file CSV con codifica UTF-8.
Questa codifica garantisce la corretta lettura di caratteri come:
- à
- è
- ì
- ò
- ù
senza generare errori durante l’importazione.
Evitare formattazioni tipiche dei fogli di calcolo
Quando un file CSV viene creato tramite software di fogli di calcolo, può contenere formattazioni che non vengono interpretate correttamente dal gestionale.
È quindi importante:
- evitare formule
- evitare celle unite
- non inserire colori o formattazioni
- verificare che i valori siano esportati come semplice testo
Il CSV deve contenere esclusivamente dati grezzi.
Verificare il file prima dell’importazione
Prima di procedere con l’importazione è buona pratica aprire il file con un editor di testo per controllare che la struttura sia effettivamente corretta. Questo permette di individuare rapidamente eventuali errori come:
- colonne mancanti
- delimitatori incoerenti
- caratteri non previsti
- righe vuote
Una verifica preventiva riduce significativamente il rischio di errori durante il caricamento dei dati nel gestionale o nel CRM.
Conclusione
Il formato CSV è uno strumento semplice ma estremamente potente per lo scambio e l’importazione di dati tra sistemi diversi. Una corretta preparazione del file — dalla struttura delle colonne alla codifica dei caratteri — è essenziale per garantire che i dati vengano interpretati correttamente dal software di destinazione.
Prestare attenzione a questi aspetti consente di evitare errori di importazione, ridurre i tempi di gestione dei dati e assicurare una migrazione più affidabile verso sistemi gestionali o piattaforme CRM.
