Importazione file CSV

Se si desidera inviare pacchi a un numero elevato di destinatari, è possibile utilizzare la funzione Importazioni file.

---

Crea profilo

Prima di importare il file, è necessario creare un profilo di importazione.

1. Andare a Profili → Indirizzi o Spedizioni → premere +
2. Selezionare Tipo di importazione → Indirizzi o Spedizioni
3. Aggiungere un Nome profilo (ad es. rubrica)
4. Selezionare Tipo file di importazione → CSV

Il resto rimane come di default.

5. Premere Continua
6. Premere Carica file

7. Premere Elabora file
8. Mappare i nomi dei campi in base ai nomi delle intestazioni del file CSV

note

Se si dispone di un file CSV senza intestazione, l'elenco a discesa consiste in Posizione 0, 1, 2 ecc. La prima colonna (A) del foglio nel file CSV corrisponde alla Posizione 0.

La colonna con Funzione può rimanere invariata.

Se necessario, aggiungere una Trasformazione — creata e utilizzata quando i dati del file CSV devono essere adattati per l'importazione. Ad esempio, se il nome del paese nel file è la Svizzera, ma il nostro sistema deve riceverlo nel formato ISO 3166-1 alpha-2 (CH).

Una volta inseriti tutti i nomi dei campi obbligatori (e facoltativi), premere Salva.

---

Caricare il file CSV

1. Andare a Importazioni file
2. Premere Importa file nell'angolo destro

3. Selezionare Profilo (il nome inserito nella 1a fase)
4. Caricare il file CSV e premere Importa

5. Premere Aggiorna

Le informazioni importate appariranno nella rubrica o nelle spedizioni.

---

Requisiti tecnici del file CSV

Il sistema supporta formati CSV flessibili con rilevamento automatico dell'intestazione e opzioni multiple di codifica/delimitatore.

Codifica caratteri

Scegliere una delle codifiche supportate:

Codifica	Caso d'uso	Note
UTF-8	Consigliato per tutti i file	Supporto universale, gestisce tutti i caratteri speciali
ISO-8859-1	Lingue dell'Europa occidentale	Umlaut tedeschi (ä, ö, ü), accenti francesi
Windows-1251	Caratteri cirillici	Ucraino, bulgaro

suggerimento

Salvare il CSV come UTF-8 in Excel: File → Salva con nome → CSV UTF-8 (delimitato da virgole)

Delimitatori di campo

Delimitatore	Simbolo	Esportazione Excel (regione)	Usare se
Punto e virgola	;	Excel europeo (DE/FR/IT)	Consigliato per i locali europei
Virgola	,	Excel USA/Regno Unito	I dati non contengono virgole
Tab	\t	Esportazione manuale	I dati contengono molti caratteri speciali
Pipe	|	Esportazioni database	Integrazioni tecniche

warning

I vostri dati non devono contenere il carattere di delimitazione o devono essere citati correttamente.

---

Formato intestazione CSV

Le intestazioni devono iniziare con una lettera (A–Z, a–z) o un trattino basso (_).

Caratteri ammessi nelle intestazioni (dopo il primo carattere):

Carattere	Esempi
Lettere	A–Z, a–z
Numeri	0–9
Trattino basso	_
Trattino	-
Punto	.
Spazio
Parentesi	( )
Slash in avanti	/
Due punti	:
E commerciale	&
Virgola	,

Non consentiti come primo carattere: numeri, simboli speciali ($, #, @, !, ecc.)

Esempi di intestazione validi:

Nome;Indirizzo1;Codice postale;Paese
DokStatus;DokDat.;Bestell_Nr;Gewicht.KG
Nome cliente;Via e numero;Data/ora;Stato (attivo)
nome_destinatario;indirizzo_destinatario;numero di tracking

Esempi di intestazione non valida:

123;456;789              (inizia con un numero)
$Importo;#ID;@Email      (caratteri speciali: $, #, @)
;Nome;Indirizzo          (prima colonna vuota)

---

Rilevamento automatico intestazione

Il sistema rileva automaticamente se la prima riga è un'intestazione:

• Caratteristiche dell'intestazione: contiene almeno una lettera, non puramente numerico, corrisponde allo schema di caratteri consentito
• Caratteristiche dei dati: la seconda riga contiene numeri, e-mail o testo significativamente diverso; differenza di lunghezza > 3 caratteri dall'intestazione

Prima riga	Seconda riga	Risultato del rilevamento
Nome;Indirizzo;Peso	John Doe;Main St 1;2,5	Intestazione rilevata
Cliente;Ordine;Totale	ACME Corp;12345;99.99	Intestazione rilevata
123;456;789	111;222;333	Nessuna intestazione (tutti numeri)
Attivo;In sospeso;Fatto	Attivo;Fatto;In sospeso	Ambiguo (lunghezze di testo simili)

---

Parametri di configurazione CSV

Parametro	Tipo	Descrizione	Esempio di valori
columnDelimiter	Stringa	Carattere che separa i campi	; , \t |
decimalSeparator	Stringa	Punto decimale per i numeri	. (USA) o , (UE)
multiValueDelimiter	Stringa	Separatore per campi multivalore	| ; ,
containsHeader	Booleano	Indica se la prima riga è un'intestazione	vero/falso

Esempi separatori decimali:

Formato europeo (virgola come decimale):

Nome;Peso;Prezzo
Prodotto A;2,5;19,99
Prodotto B;1,8;15,50

Formato USA (punto come decimale):

Nome,Peso,Prezzo
Prodotto A,2.5,19.99
Prodotto B,1.8,15.50

---

Creazione di file CSV da Excel

1. Preparare i dati:

   • Prima riga = intestazioni
   • Nessuna riga vuota in alto
   • Conteggio delle colonne coerente

2. Salvare come CSV:

   • Europeo (punto e virgola): File → Salva con nome → CSV (delimitato da punto e virgola) *.csv
   • UTF-8: File → Salva con nome → CSV UTF-8 (delimitato da virgole) *.csv
   • US (virgola): File → Salva con nome → CSV (delimitato da virgole) *.csv

3. Verifica codifica:

   • Aprire il file in Blocco note o TextEdit
   • Controllare che i caratteri speciali (ä, ö, ü, é) siano visualizzati correttamente

---

Problemi e soluzioni comuni

Visualizzazione errata caratteri speciali

Problema: Müller appare come Müller

Soluzione: Salvare il file come codifica UTF-8. In Excel usare il formato «CSV UTF-8», non CSV normale. Verificare nell'editor di testo che i caratteri speciali appaiano corretti.

---

I numeri non vengono riconosciuti

Problema: 2,5 è trattato come testo anziché come numero

Soluzione: Impostare decimalSeparator in modo che corrisponda al formato file.

• Europeo: "decimalSeparator": ","
• USA/Internazionale: "decimalSeparator": "."

---

Delimitatore errato

Problema: Tutti i dati appaiono nella prima colonna

Soluzione: Controllare il delimitatore effettivo nel file. Excel europeo utilizza ;, Excel US utilizza ,. Impostare il columnDelimiter corretto.

---

Intestazione non rilevata

Problema: Il sistema tratta le righe di intestazione come dati

Soluzione: Assicurarsi che le intestazioni inizino con lettere, non numeri. Impostare esplicitamente "containsHeader": true. Controllare che le righe di dati siano diverse dalle intestazioni.

---

Righe vuote o colonne aggiuntive

Problema: L'importazione non è riuscita o ha colonne inaspettate

Soluzione: Rimuovere le righe vuote nella parte superiore del file. Assicurarsi che tutte le righe abbiano lo stesso numero di colonne. Rimuovere i delimitatori alla fine delle righe.

---

Lista di controllo prima dell'importazione

Prima di importare, verificare:

• La codifica del file è UTF-8 (o appropriata per la propria lingua)
• Il delimitatore corrisponde alla configurazione (punto e virgola per l'europeo, virgola per gli USA)
• Le intestazioni iniziano con lettere (se si utilizzano le intestazioni)
• Nessuna riga vuota in alto
• Conteggio delle colonne coerente su tutte le righe
• Il separatore decimale corrisponde al formato del numero
• I caratteri speciali (ä, ö, ü, é) vengono visualizzati correttamente nell'editor di testo
• Nessun spazio finale o delimitatori
• La dimensione del file è ragionevole (< 25 MB consigliati)