handle identifica al producto y el sku identifica a la variante. Las variantes de un mismo producto se agrupan con el mismo handle.
Puedes iniciar una importación desde Productos.
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
- Descarga la plantilla o exporta tus productos. Las columnas se reconocen por su nombre. Puedes borrar las que no vas a cambiar, pero conserva siempre
handleysku. - Guarda el archivo como Excel
.xlsx, sin contraseña. No se admiten archivos.xlsni.csv. - El archivo puede pesar hasta 10 MB y contener hasta 10 000 filas de datos.
- Un producto no puede tener más de 500 variantes.
- Crea primero los tipos de producto, marcas, categorías, impuestos, 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.
Importa el archivo
1
Abre la importación
En Productos, haz clic en Importar.
2
Descarga la plantilla
Haz clic en Descargar plantilla. Completa ese archivo o copia en él los datos que ya preparaste.
3
Selecciona el archivo
Haz clic en el área de carga y elige el archivo
.xlsx.4
Inicia la importación
Haz clic en Importar. El archivo se carga, todas las filas se validan y los cambios se aplican en segundo plano.
5
Revisa el resultado
La pantalla de detalle muestra cuántos productos se crearon o actualizaron. También puedes consultar el trabajo desde Configuración → Transferencia de datos.
Organiza productos y variantes
Elhandle es la URL del producto. Corresponde al campo URL del producto de la sección SEO del panel y a la última parte de la dirección /products/{handle} de tu tienda. Repítelo en todas las filas de las variantes del producto.
Las columnas del producto, como nombre, tipo, marca y categorias, pueden ir solo en la primera fila de cada handle. De cada columna se usa el primer valor no vacío. Las columnas de la variante, como precio, las opciones, las medidas y el inventario, se aplican al sku de su fila.
Un producto sin opciones tiene una sola variante, por lo que ocupa una fila. Si un producto tiene opciones, agrega una fila por cada combinación.
Por ejemplo, un producto de tipo Ropa con los atributos diferenciadores Color y Talla puede verse así:
El tipo de producto debe contener los atributos diferenciadores y las opciones que escribas. Cada variante nueva debe incluir un valor para todos los atributos diferenciadores de ese tipo, y dos variantes de un producto no pueden repetir la misma combinación.
Cómo se resuelve cada fila
La importación nunca cambia la URL de un producto. Un
handle existente actualiza ese producto y uno nuevo crea otro. Para cambiar la URL, edita el campo URL del producto en el panel.
Cuando el handle está vacío, se genera a partir del nombre. Si ya lo usa otro producto u otra fila del mismo archivo, se le agrega un número: polo-azul, polo-azul-2, polo-azul-3. Un handle que escribes tú se usa tal cual, y si no es válido la fila falla. Así, dos filas con handle vacío y el mismo nombre crean dos productos distintos.
Un producto sin tipo tiene una sola variante, y el tipo de un producto existente no cambia por importación. Para crear un producto con variantes, escribe su handle y su tipo desde el principio.
Para crear
- Un producto necesita
nombrey al menos una fila consku. - Una variante necesita su
sku. Si el tipo tiene atributos diferenciadores, también un valor para cada uno. estadovacío crea el producto como borrador, ycontrolar_stockvacío crea la variante controlando stock, igual que en el panel.
Para actualizar
- Un producto solo necesita su
handle. - Una variante necesita el
handlede su producto y susku. Si dejas vacías las columnas de opciones, la variante conserva su combinación. - Las celdas vacías, y las columnas que no están en el archivo, no cambian el valor guardado.
- Una lista llena (
categorias,etiquetas,sinonimos) reemplaza la lista completa guardada; vacía la conserva. - Las variantes que el archivo no menciona se conservan sin cambios.
Columnas del producto
Columnas de cada variante
Una variante sin
sku no se puede editar por importación. La exportación deja vacías sus columnas de variante, y una fila sin sku con alguna columna de variante llena se rechaza con el error “Indica el sku para cambiar los datos de la variante”.
Packs
Los packs se crean y se arman solo en el panel: unhandle nuevo siempre crea un producto normal. La fila de un pack existente actualiza sus columnas de producto y de variante, salvo controlar_stock e inventario: un pack no tiene stock propio, así que cualquiera de las dos llena rechaza la fila con el error “Los packs no tienen stock propio”. La exportación las deja vacías en los packs. Los componentes no están en el archivo y la importación no los cambia.
Precio fijo y tramos por cantidad
Los tramos por cantidad se editan solo con la importación de precios. En esta importación:- La exportación deja
preciovacío en una variante con tramos en la lista de la política comercial predeterminada. - Un
preciovacío conserva los tramos. - Un
preciolleno fija un precio único y borra los tramos, igual que un precio fijo en la importación de precios o en el panel.
Corrige errores de validación
Si una fila tiene errores, no se aplica ninguna fila del archivo. Descarga el reporte, que es tu mismo archivo con la columnaerrores. Corrige las filas indicadas y vuelve a importarlo. El flujo completo está en Reporte de errores.
Los errores más comunes son un encabezado mal escrito, un handle con espacios, un sku repetido, un sku que pertenece a otro producto, una marca o categoría inexistente, una opción que no pertenece al tipo de producto, un precio con más decimales que tu moneda, dimensiones incompletas, un inventario en una variante que no controla stock o por debajo de lo comprometido, controlar_stock o inventario en un pack, o una columna de variante llena en una fila sin sku.