Quando devi costruire la tua rete di vettori da zero — o aggiungere molti subappaltatori in un colpo solo — inserirli uno per uno con il dialog «+ AGGIUNGI VETTORE» è lento. L'import CSV ti permette di caricare fino a 200 vettori partendo da un foglio di calcolo: scarichi un template già pronto, lo compili con i tuoi dati e lo carichi. Rispetto all'import dei clienti, qui la piattaforma fa un passo in più: riconosce i vettori già registrati su Truckscanner e manda automaticamente l'invito a quelli che non lo sono ancora.
Il flusso completo dell'import in massa: dove vive il bottone «IMPORTA CSV», come scaricare e
compilare il template template_vettori.csv, quali colonne sono obbligatorie, la differenza tra
un vettore già registrato (entra «Attivo») e un vettore da invitare (entra «Invitato» e riceve
l'email di invito), a cosa serve la colonna referenziato, e come la piattaforma gestisce
duplicati ed errori riga per riga. Per la mappa generale della sezione (tabella, filtri, drawer)
vedi la Panoramica Vettori; per l'inserimento di un singolo
vettore con verifica P.IVA vedi Aggiungere e invitare un
vettore.
Prima di iniziare
- Account spedizioniere con ruolo ADMIN oppure OPERATOR: l'import dei vettori — 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 200 righe di dati e pesare al massimo 5 MB.
L'import CSV è la scorciatoia per popolare la rete in blocco (migrazione da un gestionale, primo caricamento dei tuoi vettori storici). Per aggiungere un singolo vettore — con la verifica della Partita IVA su VIES e sui registri istituzionali e i tre percorsi automatici (vettore già in rete, già su Truckscanner, da invitare) — è più comodo il dialog «+ AGGIUNGI VETTORE», descritto nella guida Aggiungere e invitare un vettore.
1. Apri il dialog di import
Dal menu di sinistra, sezione «Operativo & Trasporti», apri la voce «Vettori» (URL /company/{idAzienda}/network): la pagina si intitola «Rete Vettori». In alto a destra dell'header clicca il bottone «⤴ IMPORTA CSV», accanto al bottone lime «+ AGGIUNGI VETTORE».
Si apre il dialog modale «Importa vettori da CSV», con il sottotitolo «Carica un file CSV per importare vettori 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_vettori.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 otto colonne del template template_vettori.csv sono:
| Colonna | Cosa contiene | Obbligatoria |
|---|---|---|
ragione_sociale | Nome dell'azienda vettore | Sì |
paese | Codice paese della Partita IVA, es. IT | Sì |
partita_iva | Numero di Partita IVA, senza il prefisso paese | Sì |
nome_referente | Nome della persona di contatto | No |
email_referente | Email del referente — se valorizzata, un vettore non ancora registrato riceve l'email di invito (vedi «Cosa succede dopo») | No |
telefono_referente | Telefono del referente | No |
referenziato | Segna il vettore come «garantito»: si / sì / true / 1, oppure no / false / 0 / vuoto | No |
note | Testo libero sulla scheda vettore | No |
Una riga viene importata solo se sono valorizzate le tre colonne ragione_sociale, paese e
partita_iva. È la stessa regola del dialog «+ AGGIUNGI VETTORE»: anche lì la Partita IVA è
obbligatoria, perché è l'identificatore univoco del vettore — serve a riconoscere i vettori già
registrati su Truckscanner ed evitare i doppioni. Tutte le altre colonne (referente, note) sono
facoltative: puoi lasciarle vuote e completarle 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 riconoscere può volerci qualche secondo. Hai sbagliato file? Clicca la X accanto al nome per rimuoverlo e ricaricarne un altro.
4. Controlla il risultato
A import concluso compare un toast di conferma in alto a destra — ad esempio «3 vettori 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 vettori compaiono subito in tabella e i contatori delle tab di stato in alto si aggiornano. Ogni vettore importato entra con lo stato giusto in automatico: chi è già registrato su Truckscanner entra come «Attivo», chi non lo è ancora come «Invitato».
Nella colonna «Referenziato» vedi una spunta verde sulle righe dei vettori a cui avevi messo si nella colonna referenziato del CSV.
Cosa succede dopo l'import
A differenza dell'import dei clienti — che popola solo la tua rubrica — l'import dei vettori avvia anche la collaborazione. Cosa succede dipende da una cosa sola: se quel vettore è già registrato su Truckscanner o no.
- Vettore già registrato su Truckscanner. La piattaforma lo riconosce dalla Partita IVA e lo aggiunge alla tua rete come «Attivo»: nessuna email, nessun invito da accettare. È subito operativo — puoi assegnargli i mandati di carico fin da ora.
- Vettore non ancora registrato. Entra nella tua rete come «Invitato». Se la riga del CSV aveva l'
email_referente, parte automaticamente l'email di invito a quell'indirizzo: . Il referente trova nell'email un link per registrare la sua azienda e unirsi alla tua rete. Se invece la riga non aveva l'email, il vettore resta «Invitato» ma nessuna email parte: per fargli avere l'invito, apri la sua riga e usa il bottone «Copia link invito», poi mandaglielo tu (WhatsApp, SMS, email).
I vettori in stato «Invitato» compaiono in tabella con il nome del referente (es. «Marco Ferrari»), non con la ragione sociale dell'azienda. È normale: finché il vettore non accetta l'invito e completa la registrazione, la sua scheda azienda non esiste ancora — c'è solo l'invito che gli hai mandato. La ragione sociale che hai scritto nel CSV resta comunque salvata e ricompare appena il vettore si registra.
La colonna referenziato attiva la referenza garantita. Mettere si significa che garantisci tu per quel vettore: quando accetterà l'invito e si registrerà, salterà l'onboarding documentale di verifica e nascerà già «Attivo» invece di restare in attesa di verifica. Per un vettore che è già registrato (e quindi entra subito «Attivo»), il flag resta come semplice annotazione sulla relazione.
Mettere si nella colonna referenziato fa saltare al vettore la verifica dei documenti
professionali, dei mezzi e degli autisti. Usala solo per vettori che conosci e di cui ti fidi
davvero: stai garantendo tu per loro davanti a Truckscanner. Nel dubbio lascia la colonna vuota
— il vettore farà il normale onboarding e potrai sempre attivare la referenza più tardi dal suo
drawer di dettaglio.
Cosa vede l'altro lato
Il vettore non ancora registrato che ha l'email nel CSV riceve l'email di invito NC-A03: un messaggio a nome della tua azienda con un link per registrarsi e unirsi alla tua rete. Quando completa la registrazione, la sua riga nella tua tabella passa da «Invitato» ad «Attivo». Il percorso visto dal lato del vettore è descritto in Accettare l'invito di uno spedizioniere.
Problemi comuni
Vedi anche
- Panoramica Vettori — la mappa completa della sezione: tabella, filtri, drawer di dettaglio, segnalazioni e rimozioni.
- Aggiungere e invitare un vettore — l'inserimento di un singolo vettore con verifica P.IVA, i tre percorsi automatici e la referenza garantita.
- Accettare l'invito di uno spedizioniere — l'altra faccia di questo flusso, vista dal vettore destinatario.
- Per spedizionieri — panoramica