Skip to main content
La importación de productos te permite crear y actualizar el catálogo con un archivo de Excel. Cada fila representa una variante. El 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 handle y sku.
  • 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 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.
Un encabezado que no pertenece a la plantilla, o repetido, rechaza el archivo completo. Si cambias el nombre de una columna, la importación no la reconoce.

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

El handle 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 handle mal escrito en una fila con un sku nuevo crea un producto nuevo. Revisa el resultado de la importación.
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 nombre y al menos una fila con sku.
  • Una variante necesita su sku. Si el tipo tiene atributos diferenciadores, también un valor para cada uno.
  • estado vacío crea el producto como borrador, y controlar_stock vacío crea la variante controlando stock, igual que en el panel.

Para actualizar

  • Un producto solo necesita su handle.
  • Una variante necesita el handle de su producto y su sku. 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

Para varias categorías, etiquetas, sinónimos o imágenes, usa | sin comas. Ejemplo: Polos|Ofertas.
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: un handle 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 precio vacío en una variante con tramos en la lista de la política comercial predeterminada.
  • Un precio vacío conserva los tramos.
  • Un precio lleno 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 columna errores. 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.