> ## Documentation Index > Fetch the complete documentation index at: https://docs.getqr.com/llms.txt > Use this file to discover all available pages before exploring further. # Formato CSV > Come preparare il file CSV per la creazione in blocco: intestazione obbligatoria, righe, regole per gli URL ed errori di convalida. La creazione in blocco legge un semplice file CSV: una riga di intestazione, poi una riga per ogni codice QR con un nome e un URL di destinazione. Questa pagina elenca le regole che GetQR verifica quando carichi il file. ## File di esempio ```csv bulk-qr-template.csv theme={null} name,url Spring Menu,https://getqr.com/spring Store #14,https://getqr.com/store-14 Table 7,example.com/menu?table=7 "Downtown, Main St",https://example.com/stores/downtown ``` Puoi anche scaricare questo file di partenza nell'app: nel passaggio **Add links**, fai clic su **Download CSV template**. ## Regole | Elemento | Regola | | - | - | | File | Deve essere un file `.csv`. Excel e altri formati non sono accettati. | | Intestazione | La prima riga deve essere esattamente `name,url`: in minuscolo, in quest'ordine, senza altre colonne. | | Righe | Fino a 100 righe non vuote. Le righe vuote vengono ignorate. | | `name` | Obbligatorio. Diventa il nome del codice QR. Massimo 40 caratteri; i nomi più lunghi vengono troncati a 40. | | `url` | Obbligatorio. Un indirizzo web che inizia con `http://` o `https://`. | ### Regole per gli URL * Se ometti lo schema, GetQR aggiunge `https://`. `example.com/menu` diventa `https://example.com/menu`. * L'indirizzo deve includere un dominio reale con un punto, come `example.com`. * Niente spazi, tabulazioni o interruzioni di riga. * Funzionano solo i link web. `mailto:`, `ftp://`, `javascript:` e i semplici indirizzi email vengono rifiutati. ### Nomi duplicati I nomi non devono essere per forza univoci. Se due righe hanno lo stesso nome (senza distinzione tra maiuscole e minuscole), GetQR numera le ripetizioni: `Menu`, `Menu 2`, `Menu 3`. ### Virgole e virgolette Se un nome contiene una virgola, racchiudilo tra virgolette doppie, come in `"Downtown, Main St"`. Le app per fogli di calcolo lo fanno automaticamente quando salvi in CSV. ## Crea il file in un foglio di calcolo **1. Imposta due colonne** Nella prima riga, digita `name` nella colonna A e `url` nella colonna B. **2. Aggiungi una riga per ogni codice** Inserisci un nome e un link in ogni riga, fino a 100 righe. **3. Salva in CSV** Esporta o salva il foglio in formato CSV. In Excel, scegli **CSV UTF-8**. In Google Sheets, scegli **File > Download > Comma-separated values**. > [!TIP] > > Il salvataggio in UTF-8 mantiene intatte le lettere accentate e gli altri caratteri non inglesi nei nomi. ## Errori di convalida ### Errori del file Questi errori bloccano l'intero file. Correggi il file e caricalo di nuovo. | Messaggio | Cosa fare | | - | - | | Choose a CSV file. Other file types are not supported. | Salva il file come `.csv`, non `.xlsx` o `.numbers`. | | The CSV header must be exactly name,url in that order. | Fai in modo che la prima riga sia esattamente `name,url`. Controlla maiuscole, colonne in più o un'intestazione mancante. | | Add at least one non-empty data row to the CSV. | Il file ha un'intestazione ma nessuna riga. Aggiungi almeno un nome e un link. | | A CSV can contain at most 100 non-empty rows. | Dividi l'elenco in file da massimo 100 righe. | | This CSV is malformed and could not be read. | Esporta di nuovo il file dall'app per fogli di calcolo. Cerca virgolette non chiuse. | ### Errori di riga Questi errori segnalano singole righe. Puoi correggerle e ricaricare il file, oppure continuare solo con le righe valide. | Badge o messaggio | Causa | | - | - | | **MISSING** / Name is required | La cella `name` è vuota. | | **MISSING** / URL is required | La cella `url` è vuota. | | **INVALID** / Enter a valid HTTP(S) URL | Il link viola una delle [regole per gli URL](#regole-per-gli-url). | La numerazione delle righe considera l'intestazione come riga 1, quindi la prima riga di dati è la riga 2, come nel foglio di calcolo. ## Problemi comuni > **L'intestazione sembra corretta ma ricevo comunque l'errore di intestazione** > > L'intestazione deve essere in minuscolo e contenere solo due colonne. `Name,URL` o `name,url,notes` non funzionano. Verifica anche che non ci siano colonne vuote a destra di `url` nel foglio di calcolo. > **Un link che funziona nel browser è contrassegnato come INVALID** > > Il link potrebbe contenere uno spazio o usare uno schema diverso da http o https. Codifica gli spazi come `%20` o rimuovili e usa un indirizzo web completo. > **Alcuni nomi sono stati accorciati** > > I nomi più lunghi di 40 caratteri vengono troncati a 40. Accorciali nel file se vuoi scegliere tu la formulazione. ## Passaggi successivi > **[Crea codici QR da un CSV](/it/bulk/create-from-csv)** > > Carica il file e avvia il lotto. > **[Panoramica della creazione in blocco](/it/bulk/overview)** > > Limiti e funzionamento della creazione in blocco. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.