> ## Documentation Index
> Fetch the complete documentation index at: https://docs.riqra.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Importa productos desde Excel
> Crea o actualiza productos y variantes en bloque con la plantilla de Excel de Riqra.
La importación de productos te permite crear y actualizar el catálogo con un archivo de Excel. Cada fila representa una variante identificada por su `sku`. Las variantes de un mismo producto se agrupan con el mismo `handle`.
Puedes iniciar una importación desde **[Productos](https://app.riqra.com/products)**.
Esta guía corresponde a la nueva plataforma. Si tu panel utiliza archivos CSV, selecciona **Legacy** en el selector de versión.
## Antes de empezar
* Usa la plantilla que descargas desde Riqra. El archivo debe conservar todos los encabezados, en el mismo orden.
* Guarda el archivo como Excel `.xlsx`, sin contraseña. No se admiten archivos `.xls` ni `.csv`.
* El archivo puede pesar hasta 10 MB y contener hasta 10 000 filas de datos.
* Un mismo producto no puede tener más de 500 variantes, es decir, 500 filas con el mismo `handle`.
* Crea primero los tipos de producto, marcas, categorías, atributos y opciones que vas a escribir en el archivo. La importación los relaciona por nombre, pero no los crea.
* Si vas a actualizar productos existentes, usa **Exportar** en la página de productos y edita el archivo descargado. La exportación utiliza el mismo formato de la importación.
No renombres, elimines ni cambies de posición las columnas. Si los encabezados no coinciden exactamente con la plantilla, Riqra rechazará el archivo completo.
## Importa el archivo
En **Productos**, haz clic en **Importar**.
Haz clic en **Descargar plantilla**. Completa ese archivo o copia en él los datos que ya preparaste.
Haz clic en el área de carga y elige el archivo `.xlsx`.
Haz clic en **Importar**. Riqra carga el archivo, valida todas las filas y aplica los cambios en segundo plano.
La pantalla de detalle muestra cuántos productos se crearon o actualizaron. También puedes consultar el trabajo desde **Ajustes → Transferencia de datos**.
## Organiza productos y variantes
El `handle` identifica al producto y forma parte de la URL de su página. Repítelo en todas las filas de sus variantes. Usa solo letras minúsculas, números y guiones, sin espacios ni tildes.
Un producto sin opciones también necesita una variante y un `sku`, por lo que ocupa una fila. Si un producto tiene opciones, agrega una fila por cada combinación que quieras importar.
Por ejemplo, un producto de tipo **Ropa** con los atributos diferenciadores **Color** y **Talla** puede verse así:
| `handle` | `nombre` | `tipo` | `sku` | `opcion1_nombre` | `opcion1_valor` | `opcion2_nombre` | `opcion2_valor` | `precio` | `inventario` |
| ----------------- | --------------- | ------ | ---------- | ---------------- | --------------- | ---------------- | --------------- | -------- | ------------ |
| `camiseta-basica` | Camiseta básica | Ropa | `CAM-AZ-M` | Color | Azul | Talla | M | `49.90` | `20` |
| `camiseta-basica` | | | `CAM-AZ-L` | Color | Azul | Talla | L | `49.90` | `15` |
| `camiseta-basica` | | | `CAM-NE-M` | Color | Negro | Talla | M | `49.90` | `12` |
Las columnas del producto, como `nombre`, `tipo`, `marca` y `categorias`, pueden ir solo en la primera fila de cada `handle`. Las columnas de la variante, como `sku`, `precio`, opciones, medidas e inventario, se completan en cada fila.
El tipo de producto debe contener los atributos diferenciadores y las opciones que escribas. Cada variante debe incluir un valor para todos los atributos diferenciadores de ese tipo.
## Columnas del producto
| Columna | Cómo completarla |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `handle` | Obligatorio en todas las filas. Agrupa las variantes del producto. Usa letras minúsculas, números y guiones, por ejemplo `camiseta-basica`. Máximo 255 caracteres. |
| `nombre` | Obligatorio al crear un producto. Máximo 200 caracteres. |
| `tipo` | Nombre de un tipo de producto existente. Es necesario cuando el producto usa atributos diferenciadores. El tipo de un producto existente no cambia al importarlo. |
| `descripcion` | Descripción del producto. Máximo 10 000 caracteres. |
| `marca` | Nombre de una marca existente. |
| `categorias` | Nombres de subcategorías activas. Separa varias con una barra vertical. No uses una categoría raíz. |
| `estado` | Usa `borrador`, `publicado` o `archivado`. Un producto nuevo queda como borrador si dejas la celda vacía. |
| `etiquetas` | Separa varias con una barra vertical. |
| `sinonimos` | Nombres alternativos para la búsqueda. Separa varios con una barra vertical. Puedes agregar hasta 10. |
| `seo_titulo` | Título para buscadores. Máximo 60 caracteres. |
| `seo_descripcion` | Descripción para buscadores. Máximo 160 caracteres. |
| `imagenes` | Una o más URL públicas de imágenes. Deben usar `https`. Separa hasta 50 con una barra vertical; la primera será la portada. Se admiten imágenes JPEG, PNG y WebP de hasta 10 MB cada una. |
## Columnas de cada variante
| Columna | Cómo completarla |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sku` | Obligatorio y único dentro del archivo. Máximo 64 caracteres. Conserva esta columna con formato de texto para evitar que Excel cambie los SKU numéricos. |
| `precio` | Precio de venta en la lista de la política comercial predeterminada. Usa un número positivo o cero, con punto y hasta dos decimales, sin símbolo de moneda ni separador de miles. |
| `costo` | Costo interno. Usa el mismo formato de `precio`. |
| `precio_lista` | Precio sugerido o de referencia. Usa el mismo formato de `precio`. |
| `opcion1_nombre` a `opcion3_nombre` | Nombre exacto de un atributo diferenciador existente, por ejemplo `Color` o `Talla`. |
| `opcion1_valor` a `opcion3_valor` | Opción existente para el atributo correspondiente, por ejemplo `Azul` o `M`. Completa siempre el nombre y el valor de cada opción. |
| `peso` | Peso en kilogramos. Usa un número positivo o cero, con punto y hasta tres decimales. |
| `largo`, `ancho`, `alto` | Dimensiones en centímetros. Usa un número positivo o cero, con punto y hasta dos decimales. Si completas una dimensión, debes completar las tres. |
| `inventario` | Existencias disponibles en el almacén predeterminado. Usa un número entero positivo o cero. Déjalo vacío para no modificar el inventario. |
| `imagen_variante` | URL pública `https` de la imagen de esta variante. Se admiten los mismos formatos y el mismo tamaño máximo que en `imagenes`. |
Para varias categorías, etiquetas, sinónimos o imágenes, usa `|` sin comas. Ejemplo: `Polos|Ofertas`.
## Cómo se actualizan los productos existentes
Riqra busca primero una variante con el mismo `sku`. Si no encuentra una, busca un producto con el mismo `handle`.
* Si encuentra el producto, actualiza los datos incluidos en el archivo.
* Si no lo encuentra, crea un producto nuevo.
* Las celdas vacías no borran datos existentes ni cambian precios, medidas o inventario.
* Las variantes existentes que no aparecen en el archivo se conservan.
* Un `handle` diferente puede cambiar la URL de un producto encontrado por su `sku`.
No reutilices el `sku` de otro producto ni cambies el `handle` sin revisar el resultado. Si un `sku` y un `handle` apuntan a productos distintos, la validación marcará un conflicto.
## Corrige errores de validación
Si una fila tiene errores, Riqra no aplica ninguna fila del archivo.
En el detalle de la importación, haz clic en **Descargar reporte de errores**.
El reporte conserva tus datos y agrega la columna `errores`. Cada fila marcada explica qué debes corregir.
Edita las filas indicadas. Puedes dejar la columna `errores`; Riqra la ignora al volver a leer el archivo.
Regresa a **Productos**, haz clic en **Importar** y sube el archivo corregido como una nueva importación.
Los errores más comunes son un encabezado modificado, un `handle` con espacios, un `sku` repetido, una marca o categoría inexistente, una opción que no pertenece al tipo de producto, dimensiones incompletas o un inventario sin almacén predeterminado.