Guida import catalogo CSV

Il file deve essere in formato CSV (UTF-8, separatore virgola o punto e virgola). In fase di import il sistema normalizza automaticamente delimiter e decimali (virgola → punto). Ogni riga dati deve avere almeno uno tra codice, titolo o descrizione compilato.

Scarica template CSV vuoto

Uso con Microsoft Excel

Scarica il template e aprilo con Excel. Se Excel avvia una procedura guidata di importazione testo, scegli separatore virgola o punto e virgola e codifica UTF-8.
Non modificare i nomi delle colonne nella prima riga: devono restare identici a quelli del template.
Formatta la colonna codice come Testo prima di inserire i valori, così Excel non rimuove zeri iniziali né converte codici come 001 in numero.
Inserisci importi, costi e durate come numeri o testo con virgola o punto decimale; evita formule nelle celle da importare.
Per elenchi multipli (categoria, tag) usa il separatore | direttamente nella cella, senza andare a capo.
Salva sempre come CSV (delimitato da virgola o da punto e virgola), non come cartella di lavoro Excel (.xlsx). In Excel: File → Salva con nome → CSV UTF-8 (delimitato da virgola) o CSV (delimitato da punto e virgola), a seconda della versione.
Chiudi il file in Excel prima di caricarlo nell'import: un file ancora aperto può risultare bloccato o salvato in modo incompleto.
Dopo il salvataggio, verifica che la prima riga contenga ancora tutte le colonne e che le righe dati non abbiano spostato i valori in colonne sbagliate (succede se nel testo ci sono virgole non racchiuse tra virgolette).

Colonne del file

Intestazione obbligatoria con i nomi colonna esatti (ordine consigliato): codice, titolo, descrizione, categoria, area, UM, importo, costo, durata, voce_catalogo_manodopera, voce_catalogo_materiali, voce_catalogo_attrezzature, voce_catalogo_altro, tag.

Colonna	Tipo / formato	Se vuota
`codice`	Testo. Codice completo (es. GFG-00001, CNT-001, G1-1-001) oppure solo prefisso con trattino finale (es. GFG-) per assegnare il prossimo progressivo di quel prefisso.	Viene generato un codice progressivo. Senza prefisso dedicato nell'import si usa il prefisso predefinito del catalogo (GFG). Le righe duplicate (stesso contenuto) senza codice vengono saltate tramite fingerprint.
`titolo`	Testo libero. Nome breve della voce.	La voce viene creata senza titolo (post_title vuoto).
`descrizione`	Testo libero. Descrizione estesa della lavorazione.	Descrizione vuota. Partecipa al fingerprint per deduplicare righe senza codice.
`categoria`	Nome di una categoria già presente in catalogo (match per slug). Più valori separati da \|.	Nessuna categoria assegnata (eventuali categorie esistenti vengono rimosse in aggiornamento).
`area`	Titolo di un'area di lavoro esistente (confronto case-insensitive).	Nessuna area associata.
`UM`	Unità di misura: mq, m3, ml, pezzo, corpo (o "a corpo"), cad/cad., kg (o chilogrammi/kilogrammi).	Unità di misura non impostata.
`importo`	Numero decimale (punto o virgola). Prezzo/importo base della voce.	Valore 0. La marginalità non viene calcolata.
`costo`	Numero decimale. Costo massimo.	Valore 0.
`durata`	Numero decimale. Durata stimata (es. ore/giorni secondo l'uso interno).	Valore 0.
`voce_catalogo_manodopera`	Numeri decimali. Dettaglio costi per componente (manodopera, materiali, attrezzature, altro).	In creazione: salvati solo se almeno uno dei quattro valori è maggiore di zero. In aggiornamento (Update): sempre sovrascritti, anche con zero.
`voce_catalogo_materiali`
`voce_catalogo_attrezzature`
`voce_catalogo_altro`
`tag`	Elenco di tag separati da \|. I tag mancanti vengono creati automaticamente.	I tag già presenti sulla voce non vengono modificati (la colonna vuota non azzera i tag esistenti).

Opzioni di import

Genera codici — L'opzione Genera codici è utile quando il CSV contiene codici da ignorare (es. codici fornitore) e vuoi rigenerare tutti i codici con numerazione progressiva. Se non specifichi un prefisso dedicato sotto, viene usato il prefisso predefinito del catalogo impostato sopra. Non utilizzabile insieme a Update.
Update — Aggiorna le voci con codice già presente nel database. Le righe senza codice completo vengono saltate. Non compatibile con Genera codici.
Specifica prefisso per l'import — Se le righe del CSV hanno già un codice completo, questa opzione non si applica. Per le righe senza codice, la numerazione progressiva continuerà dal progressivo successivo all'ultimo codice presente nel database con il prefisso scelto (esistente o nuovo). Se il prefisso è nuovo e non presente ancora nel catalogo, la numerazione partirà da 001.

Comportamenti da tenere presente

Codice già esistente senza Update: la riga viene saltata.
Categoria non trovata: la riga viene importata ma viene segnalato un avviso con lo slug mancante.
Area non trovata per titolo: la voce viene creata/aggiornata senza area.
Codice non valido: la riga viene saltata con messaggio di errore.