Quando devi inserire la tua rubrica clienti da zero — o aggiungere molti committenti in un colpo solo — crearli uno per uno con il dialog «+ NUOVO» è lento. L'import CSV ti permette di caricare decine (fino a 500) di clienti partendo da un foglio di calcolo: scarichi un template già pronto, lo compili con i tuoi dati e lo carichi.
Il flusso completo dell'import in massa: dove vive il bottone «IMPORTA CSV», come scaricare e
compilare il template template_clienti.csv, quali colonne sono obbligatorie, come la piattaforma
gestisce i duplicati e gli errori riga per riga, e cosa succede ai clienti appena importati. Per
la mappa generale della sezione (tabella, filtri, drawer) vedi la Panoramica
Clienti; per l'inserimento di un singolo cliente con verifica
P.IVA vedi Aggiungere e invitare un cliente.
Prima di iniziare
- Account spedizioniere con ruolo ADMIN oppure OPERATOR: l'import dei clienti — come l'inserimento manuale — richiede uno di questi due ruoli.
- Un foglio di calcolo (Excel, Google Sheets, LibreOffice) con cui compilare e salvare il template in formato CSV.
- Il file CSV può contenere al massimo 500 righe di dati e pesare al massimo 5 MB.
L'import CSV è la scorciatoia per popolare la rubrica in blocco (migrazione da un gestionale, primo caricamento dei tuoi committenti storici). Per aggiungere un singolo cliente — con la verifica della Partita IVA su VIES e la pre-compilazione automatica della ragione sociale — è più comodo il dialog «+ NUOVO», descritto nella guida Aggiungere e invitare un cliente.
1. Apri il dialog di import
Dalla pagina Clienti (URL /company/{idAzienda}/trading-partners), clicca il bottone «⤴ IMPORTA CSV» in alto a destra dell'header, accanto al bottone lime «+ NUOVO».
Si apre il dialog modale «Importa clienti da CSV», con il sottotitolo «Carica un file CSV per importare clienti in blocco».
2. Scarica il template e compilalo
Dentro il dialog, in alto, clicca il link verde «Scarica template CSV»: il browser scarica subito il file template_clienti.csv, già pronto con la riga di intestazione e due righe di esempio.
Sotto il link, una tabella di anteprima ti mostra le colonne del template con due righe di esempio, così sai subito cosa scrivere in ogni colonna. Le dodici colonne del template template_clienti.csv sono:
| Colonna | Cosa contiene | Obbligatoria |
|---|---|---|
ragione_sociale | Nome dell'azienda cliente | Sì |
paese_iva | Codice paese della P.IVA, es. IT | Sì |
partita_iva | Numero di Partita IVA, senza il prefisso paese | Sì |
indirizzo | Via e numero civico della sede legale | No |
citta | Città della sede legale | No |
provincia | Sigla provincia, es. MI | No |
cap | Codice di avviamento postale | No |
paese | Codice paese della sede, es. IT | No |
nome_referente | Nome della persona di contatto | No |
telefono_referente | Telefono del referente | No |
email_referente | Email del referente | No |
note | Testo libero sulla scheda cliente | No |
Una riga viene importata solo se sono valorizzate le tre colonne ragione_sociale, paese_iva e
partita_iva. È la stessa regola del dialog «+ NUOVO»: anche lì la Partita IVA è obbligatoria,
perché è l'identificatore univoco del cliente e serve a riconoscere ed evitare i doppioni. Tutte
le altre colonne (indirizzo, referente, note) sono facoltative: puoi lasciarle vuote e completare
i dati più tardi dal drawer di dettaglio.
- Il separatore di colonna è il punto e virgola
;(è quello con cui il template viene generato). - Mantieni la riga di intestazione con i nomi delle colonne in italiano: è la riga che Truckscanner usa per capire l'ordine delle colonne. - Le righe che iniziano con il carattere#vengono ignorate: puoi usarle per appunti o commenti dentro al file. - Salva sempre il file in formato.csv(codifica UTF-8 consigliata). Altri formati —.xlsx,.txt— non vengono accettati.
3. Carica il file e avvia l'import
Una volta compilato il template, torna nel dialog. Puoi trascinare il file nell'area tratteggiata «Trascina qui il file CSV o sfoglia», oppure cliccarci sopra per aprire la finestra di selezione file del sistema operativo. L'area accetta solo file .csv fino a 5 MB.
Appena il file è selezionato, l'area si trasforma in una riga che mostra il nome del file e la sua dimensione, e il bottone «IMPORTA» in basso a destra si attiva.
Clicca «IMPORTA». Il bottone passa allo stato «IMPORTAZIONE…» mentre la piattaforma elabora il file: per file grandi o con molte Partite IVA da verificare può volerci qualche secondo. Hai sbagliato file? Clicca la X accanto al nome per rimuoverlo e ricaricane un altro.
4. Controlla il risultato
A import concluso compare un toast di conferma in alto a destra — ad esempio «3 clienti importati» — e dentro il dialog un riquadro verde con lo stesso conteggio. Se non ci sono errori il dialog si chiude da solo dopo un paio di secondi.
I nuovi clienti compaiono subito in tabella e i contatori delle tab in alto si aggiornano: ogni cliente importato entra come «Non invitato» (nella colonna Truckscanner vedi il bottone «COLLABORA SU TRUCKSCANNER»), perché l'import popola solo la tua rubrica e non manda nessun invito.
Cosa succede dopo l'import
I clienti caricati via CSV sono identici a quelli creati con «+ NUOVO»: li trovi in rubrica, puoi aprirne il drawer di dettaglio, modificarli, associarli alle commesse per le notifiche operative di ritiro e consegna.
Due cose da sapere:
- Nessuna email parte. A differenza del flusso di invito, l'import CSV non manda nulla ai clienti: li aggiunge solo alla tua rubrica interna. Quando vorrai che un cliente collabori attivamente su Truckscanner, lo inviti in un secondo momento con il bottone «COLLABORA SU TRUCKSCANNER» sulla sua riga — il flusso è descritto in Aggiungere e invitare un cliente.
- I duplicati vengono saltati, non sovrascritti. Se una riga del CSV ha una Partita IVA già presente in rubrica, quel cliente non viene né creato né modificato: viene contato fra i «duplicati saltati». L'import non aggiorna i clienti esistenti.
Problemi comuni
Vedi anche
- Panoramica Clienti — la mappa completa della sezione: tabella, filtri, drawer di dettaglio, azioni di riga.
- Aggiungere e invitare un cliente — l'inserimento di un singolo cliente con verifica P.IVA, e come invitarlo a collaborare su Truckscanner.
- Per spedizionieri — panoramica