# Importación de productos

La importación carga productos desde una hoja de cálculo: crea productos nuevos y actualiza los existentes. Abre la tienda, elige «Productos» y haz clic en «Importar». La importación está disponible para el propietario del proyecto y para los miembros del equipo con el permiso «Productos y categorías».

La tienda no puede exportar el catálogo a un archivo.

## Prepara el archivo

Se aceptan hojas de cálculo XLSX, ODS y CSV. La primera fila contiene los encabezados de las columnas, y cada una de las siguientes es un producto. Las columnas pueden tener cualquier nombre: en el segundo paso indicarás qué significa cada una.

| Campo del producto | Qué debe contener la celda |
|---|---|
| «Nombre» | El nombre del producto. Campo obligatorio |
| «Precio» | Un número en la moneda de la tienda, p. ej., `1990.50` |
| «Precio anterior» | Un número en la moneda de la tienda |
| «SKU» | El código del producto, de hasta 64 caracteres |
| «Stock» | Un número entero no negativo. Una celda vacía en un producto nuevo significa que el stock no se controla |
| «Categoría» | Anida con "/" y separa varias categorías con ";": `Ramos / Rosas; Novedades` |
| «Descripción» | El texto de la descripción |
| «Foto» | Enlaces a fotos separados por espacios o comas |

Ejemplo de hoja de cálculo:

| Nombre | Precio | SKU | Stock | Categoría | Foto |
|---|---|---|---|---|---|
| Ramo «Margarita» | 1990 | RM-001 | 12 | Ramos / Flores silvestres | `https://example.com/romashka.jpg` |
| Jarrón de cristal | 850.50 | VZ-014 | 5 | Jarrones; Novedades | `https://example.com/vaza.jpg` |

Lo que debes saber sobre el archivo:

- **CSV.** El separador de columnas (coma, punto y coma o tabulación) se detecta automáticamente. La codificación es UTF-8 o Windows-1251, la que usa la versión rusa de Excel.
- **Categorías.** La importación crea las categorías que todavía no existen. Los niveles por debajo del tercero se descartan.
- **Fotos.** La plataforma descarga las fotos a partir de sus enlaces: los enlaces deben abrirse sin autorización y empezar por `http://` o `https://`. Formatos: JPG, PNG, GIF, WebP.
- **Características.** Las columnas pueden rellenar las características del producto. Crea la característica con antelación y la columna con el mismo nombre se asignará automáticamente. En el tipo «Varias de una lista», separa los valores con ";"; en «Sí o no», usa «sí», «no», 1 o 0.
- **Las opciones y variantes** no se cargan desde una hoja de cálculo: se añaden en la ficha del producto.

## Sube el archivo

![Subida del archivo de productos](https://support.cleverapp.pro/_media/es/05-shop/_images/import-upload.webp?v=1792562451)

1. Arrastra el archivo al área «Archivo de productos», o haz clic en ella y elige el archivo.
2. En el paso «Asignar columnas», elige una columna de la hoja para cada campo del producto. La plataforma rellena por sí misma los nombres de columna conocidos. Un campo sin columna queda como «No importar». Abajo se muestran las «Primeras filas» del archivo para comprobarlo.
3. Más abajo, en el bloque «Características», elige las columnas para las características. Aquí también puedes crear una característica: «Nueva característica».
4. Elige qué hacer «Si el producto ya existe»:

   | Opción | Qué pasa |
   |---|---|
   | «Añadir como nuevo» | Cada fila crea un producto nuevo |
   | «Actualizar por SKU» | Se actualiza el producto con ese SKU; las demás filas crean productos nuevos |
   | «Actualizar por nombre» | Se actualiza el producto con ese nombre; las demás filas crean productos nuevos |

5. Haz clic en «Iniciar importación».

![Asignación de columnas durante la importación](https://support.cleverapp.pro/_media/es/05-shop/_images/import-mapping.webp?v=1792562451)

La importación se ejecuta en segundo plano. La página muestra los contadores: «filas procesadas», «productos añadidos», «productos actualizados», «filas con errores». Puedes cerrar la página: la importación seguirá. Si abres «Importar» mientras está en curso, verás su progreso. El resultado solo se muestra en la página abierta; si sales, revísalo en la lista de productos. Cuando termina la importación, el botón «Ir a productos» lleva al catálogo, e «Importar más», a subir el siguiente archivo.

Debajo de los contadores hay una tabla con las columnas «Fila» y «Qué está mal»: los números de fila del archivo y los motivos por los que una fila no se cargó o se cargó solo en parte.

![Resultado de la importación: contadores y filas con errores](https://support.cleverapp.pro/_media/es/05-shop/_images/import-result.webp?v=1792618388)

## Cómo se actualizan los productos

- Las celdas vacías no borran los datos del producto: solo se actualiza lo que está rellenado.
- Las categorías del archivo se añaden a las que ya tiene el producto.
- Las fotos solo se cargan si el producto aún no tiene fotos.
- En un producto con variantes, se omite la columna de stock: el stock se lleva por variante.

> [!TIP]
> Para actualizar precios y stock, sube una hoja con las columnas «SKU», «Precio» y «Stock» y la opción «Actualizar por SKU». Aun así tienes que indicar la columna del nombre: sin ella, la importación no se inicia.

## Límites

- Una importación procesa como máximo 20 000 filas.
- Una importación descarga como máximo 10 000 fotos, y como máximo 50 por producto.
- Una tienda puede tener como máximo 10 000 productos y 500 categorías: las filas que superan el límite acaban en los errores.
- Un producto puede tener como máximo 100 características.
- La tabla de errores muestra las primeras 100 entradas.
- Solo se ejecuta una importación a la vez.

## Si algo no funciona

| Mensaje | Causa |
|---|---|
| «Se pueden importar hojas de cálculo XLSX, ODS y CSV.» | El archivo tiene otro formato; por ejemplo, el antiguo XLS |
| «No se pudo leer el archivo. Guarda la hoja de cálculo como XLSX o CSV.» | El archivo está dañado o se guardó con un error |
| «Ya hay una importación en curso. Espera a que termine.» | La importación anterior aún no ha terminado |
| «Para buscar productos por SKU, elige la columna de SKU.» | Se eligió «Actualizar por SKU», pero no se indicó ninguna columna para el campo «SKU» |
| «Falta el nombre del producto.» | El nombre de la fila está vacío y no se encontró ningún producto que actualizar |
| «No se pudo leer el precio «…».» | La celda del precio no contiene un número |
| «El stock debe ser un número entero no negativo, no «…».» | La celda del stock contiene un número decimal, un número negativo o texto |
| «No se pudo subir la foto …» | El enlace no se abre o no lleva a una imagen. El producto se carga igualmente, sin esa foto |
| «Característica «…»: el valor «…» no es válido.» | El valor no corresponde al tipo de la característica. El producto se carga sin él |
| «La importación se detuvo: su autor ya no puede editar el catálogo.» | El miembro del equipo que inició la importación perdió el permiso «Productos y categorías» durante la importación |
| «La importación se interrumpió por un error. Inténtalo de nuevo.» | Un fallo por parte de la plataforma. Vuelve a iniciar la importación; las filas que ya se cargaron se actualizan más fácilmente por SKU |