Importare dati da Excel e CSV

QuoteNode include un wizard guidato per caricare dati di catalogo da file Excel (.xlsx) o CSV (.csv). Il sistema fornisce anche template scaricabili con dati di esempio e istruzioni.

Scaricare il template di importazione

Prima di preparare i dati, scarica il template ufficiale:

1. Vai in Products > Import
2. Fai clic su Download Template
3. Scegli Template with examples oppure Empty template

Il template include:

• una riga di intestazione con tutti i nomi colonna supportati
• un foglio di istruzioni che spiega ogni campo
• righe di esempio che mostrano il formato corretto
• campi obbligatori marcati con un asterisco (*)

Colonne del template

Colonna	Obbligatoria	Descrizione
SKU		Identificatore del prodotto. Se lasciato vuoto, viene generato automaticamente.
NAME	*	Nome del prodotto mostrato in offerte e PDF.
UNIT_PRICE	*	Prezzo unitario netto. Usa il punto come separatore decimale, ad esempio 149.99.
UNIT_PRICE_GROSS		Prezzo unitario lordo. Se presente, ha priorita nei calcoli gross-first.
VAT_RATE		Percentuale IVA, ad esempio 0, 5, 8 o 23. In assenza, viene usata l’aliquota predefinita del tenant.
UNIT		Unita di misura: pcs, kg, h, m, m2, m3, l, set. Se assente, il default e pcs.
GROUP_NAME		Nome del gruppo o categoria. I gruppi vengono creati automaticamente se non esistono.
DESCRIPTION_SHORT		Descrizione breve usata nelle righe dell’offerta.
DESCRIPTION_LONG		Descrizione dettagliata per le viste di dettaglio prodotto.
WEIGHT_KG		Peso del prodotto in chilogrammi, usato per il calcolo spedizione.
MIN_QUANTITY		Vincolo di quantita minima ordinabile.
QUANTITY_STEP		Incremento minimo di quantita, ad esempio 0.5.
STATUS		active o inactive; accetta anche 1/0 e yes/no.
REFERENCE_URL		Link esterno a specifiche prodotto con http o https.
IMAGE_URL		URL immagine prodotto. Formati supportati: jpg, png, webp, gif, svg. Max 10 MB.
NOTES		Note interne non visibili al cliente.

Le colonne aggiuntive del tuo file vengono ignorate. Non e necessario rimuoverle.

Workflow di importazione

Passo 1 - Caricare il file

Trascina il file Excel o CSV, oppure selezionalo manualmente. Dimensione massima: 10 MB. Numero massimo di righe: 5.000.

Per i CSV, il sistema rileva automaticamente separatore e codifica.

Passo 2 - Mappatura colonne

Il sistema analizza le intestazioni e prova a mappare automaticamente le colonne sui campi QuoteNode. Rivedi il mapping e correggilo se necessario:

• ogni colonna sorgente puo essere mappata su un solo campo di destinazione
• le colonne non mappate vengono ignorate
• i campi obbligatori devono essere mappati prima di continuare

Puoi salvare il mapping come template nominato per importazioni future, utile se ricevi spesso file dallo stesso ERP o fornitore.

Passo 3 - Dry run

Prima del commit, il sistema valida i dati:

• controllo dei campi obbligatori, come NAME e UNIT_PRICE
• validazione di formato per prezzi numerici, URL e unita
• rilevamento duplicati per SKU contro il catalogo esistente
• anteprima delle prime 20 righe con eventuali errori evidenziati

Durante il dry run non viene scritto nulla nel database. Rivedi il report e correggi il file sorgente se necessario.

Passo 4 - Eseguire l’importazione

Fai clic su Import per confermare i dati validati:

• vengono creati nuovi prodotti per gli SKU non ancora presenti
• i prodotti esistenti vengono aggiornati se lo SKU coincide
• i gruppi di prodotto vengono creati automaticamente quando appaiono in GROUP_NAME
• le immagini vengono scaricate dalle URL e salvate localmente

Un indicatore di progresso mostra lo stato dell’importazione. Al termine viene generato un riepilogo con righe importate, aggiornate, saltate ed eventuali errori.

Importare immagini prodotto

Le immagini possono essere importate in due modi:

Tramite URL nel template

Inserisci una colonna IMAGE_URL con link HTTP o HTTPS. Il sistema scarica ogni immagine durante l’importazione.

Tramite ZIP

Per cataloghi grandi, puoi caricare un archivio ZIP con immagini:

1. Vai in Products > Import > Media Import
2. Carica un file ZIP, massimo 500 file
3. Dai a ogni file il nome dello SKU prodotto, ad esempio PRD-001.jpg
4. Il sistema abbina i file ai prodotti tramite SKU

Una preview di dry run mostra corrispondenze, file saltati ed errori.

Template di mapping

Se importi spesso dallo stesso formato:

1. Durante il passo 2 fai clic su Save Mapping Template
2. Assegna un nome, ad esempio ERP Export o Supplier X Format
3. Nelle importazioni successive, seleziona quel template per applicare automaticamente lo stesso mapping

I template di mapping vengono salvati per tenant e possono essere marcati come predefiniti.

Suggerimenti

• Parti dal template per garantire nomi colonna e formati corretti.
• Usa sempre il dry run prima del commit, soprattutto su importazioni grandi.
• Deduplica tramite SKU: reimportando un file, i prodotti esistenti vengono aggiornati invece di essere duplicati.
• Usa nomi gruppo coerenti per mantenere pulita la categorizzazione.
• Controlla la codifica UTF-8 nei CSV che contengono caratteri speciali.