> ## 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

> Cómo preparar el archivo CSV para la creación masiva: encabezado obligatorio, filas, reglas de las URL y errores de validación.

La creación masiva lee un archivo CSV sencillo: una fila de encabezado y, después, una fila por cada código QR con un nombre y una URL de destino. En esta página se enumeran las reglas que GetQR comprueba al subirlo.

## Archivo de ejemplo

```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
```

También puedes descargar esta base en la aplicación: en el paso **Add links**, haz clic en **Download CSV template**.

## Reglas

| Parte | Regla |
| - | - |
| Archivo | Debe ser un archivo `.csv`. No se aceptan archivos de Excel ni otros formatos. |
| Encabezado | La primera fila debe ser exactamente `name,url`: en minúsculas, en ese orden y sin más columnas. |
| Filas | Hasta 100 filas no vacías. Las filas vacías se ignoran. |
| `name` | Obligatorio. Se convierte en el nombre del código QR. Hasta 40 caracteres; los nombres más largos se recortan a 40. |
| `url` | Obligatorio. Una dirección web que empiece por `http://` o `https://`. |

### Reglas de las URL

* Si omites el esquema, GetQR añade `https://`. `example.com/menu` pasa a ser `https://example.com/menu`.
* La dirección debe incluir un dominio real con un punto, como `example.com`.
* Sin espacios, tabulaciones ni saltos de línea.
* Solo funcionan los enlaces web. Se rechazan `mailto:`, `ftp://`, `javascript:` y las direcciones de correo electrónico sin más.

### Nombres duplicados

No es necesario que los nombres sean únicos. Si dos filas tienen el mismo nombre (sin distinguir mayúsculas y minúsculas), GetQR numera las repeticiones: `Menu`, `Menu 2`, `Menu 3`.

### Comas y comillas

Si un nombre contiene una coma, ponlo entre comillas dobles, como en `"Downtown, Main St"`. Las aplicaciones de hojas de cálculo lo hacen por ti al guardar como CSV.

## Crear el archivo en una hoja de cálculo

**1. Prepara dos columnas**

En la primera fila, escribe `name` en la columna A y `url` en la columna B.

**2. Añade una fila por código**

Rellena un nombre y un enlace en cada fila, hasta 100 filas.

**3. Guarda como CSV**

Exporta o guarda la hoja como CSV. En Excel, elige **CSV UTF-8**. En Google Sheets, elige **File > Download > Comma-separated values**.

> [!TIP]
>
> Guardar en UTF-8 conserva intactas las letras con tilde, la ñ y otros caracteres no ingleses de tus nombres.

## Errores de validación

### Errores del archivo

Estos errores bloquean todo el archivo. Corrige el archivo y vuelve a subirlo.

| Mensaje | Qué hacer |
| - | - |
| Choose a CSV file. Other file types are not supported. | Guarda el archivo como `.csv`, no como `.xlsx` ni `.numbers`. |
| The CSV header must be exactly name,url in that order. | Haz que la primera fila sea exactamente `name,url`. Comprueba si hay mayúsculas, columnas de más o falta el encabezado. |
| Add at least one non-empty data row to the CSV. | El archivo tiene encabezado, pero no filas. Añade al menos un nombre y un enlace. |
| A CSV can contain at most 100 non-empty rows. | Divide la lista en archivos de hasta 100 filas. |
| This CSV is malformed and could not be read. | Vuelve a exportar el archivo desde tu aplicación de hojas de cálculo. Busca comillas sin cerrar. |

### Errores de fila

Estos errores marcan filas concretas. Puedes corregirlas y volver a subir el archivo, o continuar solo con las filas válidas.

| Etiqueta o mensaje | Causa |
| - | - |
| **MISSING** / Name is required | La celda `name` está vacía. |
| **MISSING** / URL is required | La celda `url` está vacía. |
| **INVALID** / Enter a valid HTTP(S) URL | El enlace incumple alguna de las [reglas de las URL](#reglas-de-las-url). |

Los números de fila cuentan el encabezado como fila 1, así que la primera fila de datos es la fila 2, igual que en tu hoja de cálculo.

## Problemas habituales

> **Mi encabezado parece correcto, pero sigo recibiendo el error de encabezado**
>
> El encabezado debe estar en minúsculas y contener solo dos columnas. `Name,URL` o `name,url,notes` fallan. Comprueba también si hay columnas vacías a la derecha de `url` en tu hoja de cálculo.

> **Un enlace que funciona en mi navegador aparece como INVALID**
>
> Puede que el enlace contenga un espacio o use un esquema distinto de http o https. Codifica los espacios como `%20` o elimínalos, y usa una dirección web completa.

> **Se han acortado algunos nombres**
>
> Los nombres de más de 40 caracteres se recortan a 40. Acórtalos en el archivo si quieres elegir tú el texto.

## Siguientes pasos

> **[Crear códigos QR a partir de un CSV](/es/bulk/create-from-csv)**
>
> Sube tu archivo y empieza el lote.

> **[Descripción general de la creación masiva](/es/bulk/overview)**
>
> Límites y cómo funciona la creación masiva.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.