# Modello CSV del catalogo 1012labs

Versione A02-2026-10-16.1. Verifica del lettore CSV: 16 ottobre 2026.

I file contengono esclusivamente esempi illustrativi. Nomi, prezzi e disponibilità non appartengono a un negozio reale. Sono stati controllati con il lettore CSV del progetto; questa verifica non attesta un'importazione completata sul server.

## I due file

- `catalogo-1012labs-modello.csv`: tre righe a peso, al pezzo e a confezione, tutte con `pubblicato=no`. I nomi iniziano con `DEMO1012-`.
- `catalogo-1012labs-errori-dimostrativi.csv`: materiale di prova con un prezzo non numerico, un'unità non prevista e un nome mancante. Le tre righe devono risultare da correggere. **Non importare in un catalogo operativo.**

Risultato del controllo locale sul file degli errori: riga 2, colonna `prezzo`; riga 3, colonna `unita`; riga 4, colonna `nome`. Nessuna delle tre righe produce un prodotto valido nel lettore.

Prova entrambi soltanto in un ambiente o catalogo di collaudo autorizzato. Il prefisso `DEMO1012-` riduce le collisioni accidentali: non garantisce nomi univoci. `pubblicato=no` non rende innocuo il reimport: una scheda esistente riconosciuta dal nome può essere aggiornata e passare in bozza.

## Formato e colonne

Il modello usa CSV UTF-8 con BOM, separatore punto e virgola e fine riga Windows (CRLF). Non è un file XLSX: conserva il foglio originale ed esporta il foglio del catalogo in CSV UTF-8. Il lettore riconosce anche virgola e tabulazione dalla prima riga, ma per questo modello mantieni il punto e virgola.

`nome;descrizione;categoria;unita;misura;riferimento;prezzo;disponibili;pubblicato;illustrazione;codice`

| Colonna | Come compilarla |
| --- | --- |
| nome | Obbligatorio, massimo 80 caratteri. Usa un nome stabile e distinto per ogni prodotto. |
| descrizione | Facoltativa. Oltre 300 caratteri viene troncata dal lettore. |
| categoria | Obbligatoria, massimo 40 caratteri. |
| unita | `peso`, `pezzo` o `confezione`. Non scrivere `litro` come unità. |
| misura | `peso` nella riga del modello a peso; vuota per pezzo e confezione. |
| riferimento | `1000` per prezzo al chilo; `100` per l'etto o `500` per mezzo chilo. Vuoto per pezzo e confezione. Non scrivere `1 kg`. |
| prezzo | Importo in euro, per esempio `3,50`, senza formule. Positivo e fino a 10.000,00 euro per prodotto al controllo server. |
| disponibili | `si`/`no` per il peso; intero da `0` a `10000` per pezzi o confezioni. Evita segni, decimali e parole nelle quantità numeriche. |
| pubblicato | `no` durante la preparazione; `si` solo dopo i controlli. |
| illustrazione | Lascia vuoto per usare quella predefinita del settore. Non è l'indirizzo di una fotografia. |
| codice | Codice a barre facoltativo EAN-8, EAN-13 o UPC-A con cifra di controllo valida. Non è un codice articolo libero. Conserva eventuali zeri iniziali usando una cella di testo; lascia vuoto se non lo conosci. |

Se una cella contiene punto e virgola o un a capo, racchiudila tra virgolette doppie. Le virgolette interne vanno raddoppiate: `"Nota; proposta ""del giorno"""`. Controlla sempre il CSV dopo l'esportazione.

Il tracciato si può adattare anche a un menù: cambia esempi, categorie, prezzi e unità in base al servizio reale. Il CSV non importa fotografie, varianti, ingredienti, allergeni o l'intera scheda alimentare. Una confezione importata nasce come confezione singola generica: il contenuto va verificato nella scheda. Per il peso, il lettore imposta minimo 500 g, incremento 250 g e massimo 5.000 g: controllali nel caso del negozio.

## Prima della prova e del reimport

1. Conserva una copia del listino e verifica che nessun nome dimostrativo sia già usato nel catalogo di collaudo. Non caricare dati personali di clienti.
2. Leggi l'anteprima: tre righe valide nel modello; tre righe da correggere nel file degli errori. L'anteprima non equivale al salvataggio sul server.
3. Prova inizialmente soltanto tre prodotti. La richiesta server accetta da 1 a 300 prodotti, ma ha anche un limite di **32.768 byte per il JSON inviato**, diverso dalla dimensione del CSV e dal numero di righe. Un file con 300 righe può superarlo. Il lettore locale non applica questi limiti server.
4. Prima di reimportare, confronta i nomi: il servizio abbina il nome eliminando gli spazi esterni e ignorando maiuscole/minuscole. Il codice a barre non è la chiave di abbinamento. Cambiare nome può creare una nuova scheda; cambiare unità per un nome esistente fa saltare quella riga.
5. Il reimport riscrive anche descrizione, categoria, prezzo, disponibilità e pubblicazione delle schede abbinate. Una descrizione vuota o `pubblicato=no` possono quindi modificare un prodotto esistente. Non è una sincronizzazione del magazzino. Le schede assenti dal file non vengono eliminate.
6. In un collaudo completo controlla separatamente il risultato server, i contatori di creazione/aggiornamento/scarto e le schede salvate. Questa versione del modello è stata provata soltanto con funzioni pure del lettore, senza database o importazioni reali.

## Fonte e crediti

Tracciato ricavato dalle funzioni del catalogo 1012labs. Esempi e istruzioni preparati per il progetto 1012labs; nessun dato cliente o materiale fotografico di terzi. Non è un formato universale né un'integrazione automatica con altri gestionali.