Importar productos masivamente

En este artículo

Cuando tienes que cargar 50, 100 o 1000 productos, hacerlo uno por uno desde el formulario es inviable. La importación desde un archivo de Excel o CSV te permite subir todo tu catálogo en minutos — productos simples, con variantes, con múltiples imágenes y con categorías.

Antes de empezar conviene saber crear un producto y productos con variantes desde el formulario. Te ayuda a entender qué representa cada columna del archivo.

El modelo mental del archivo

Esto es lo más importante de entender antes de tocar el archivo:

El archivo es plano, pero representa un árbol. Productos → variantes → imágenes.
Lo que conecta las filas es la columna identificador. Todas las filas con el mismo identificador pertenecen al mismo producto.
Una fila puede ser 3 cosas:
- Producto principal — la primera fila, con título, descripción, marca, etc.
- Variante — fila que solo tiene valores de opción (talla, color) y SKU. Hereda el resto del producto principal.
- Imagen adicional — fila que solo tiene URL de imagen y posición.

Una vez entiendes esto, el resto es llenar columnas.

Pasos

1. Descarga la plantilla

En el menú lateral abre "Productos" y haz clic en "Importar" arriba. Luego haz clic en "Descargar plantilla de ejemplo" para obtener un archivo con todas las columnas que el sistema acepta.

Abre el archivo en Google Sheets (recomendado) o en Excel. La primera fila son las cabeceras — no las toques. A partir de la fila 2 empiezas a llenar.

Puedes subir el archivo como Excel (.xlsx o el antiguo .xls) o como CSV. Lo más sencillo es guardarlo como Excel: el paso 6 lo explica.

2. Crea un producto simple (una sola fila)

Un producto sin variantes ocupa una sola fila. Llena las columnas relevantes:

Columna	Qué va	Ejemplo
identificador	Clave del producto. Se normaliza a minúsculas y guiones (sin tildes ni espacios). Si lo dejas vacío, se genera del título.	`camiseta-basica`
título	Nombre del producto. Obligatorio en la primera fila de cada producto nuevo.	"Camiseta Básica"
descripción	Texto del producto. Acepta HTML simple.	"Camiseta de algodón..."
marca	Nombre de la marca. Si no existe, se crea.	"Florenza"
etiquetas	Múltiples valores separados por `///`	"casual///algodón///básico"
colecciones	Múltiples colecciones separadas por `///`. Si no existen, se crean como colecciones manuales.	"Novedades de Primavera"
categorías	Jerarquía con `>` entre niveles. Múltiples con `///`. Deben existir ya en la tienda (no se crean solas).	"Departamentos > Mujer > Camisetas"
visibilidad	Solo `"visible"` publica el producto. Cualquier otro valor (incluido `"activo"` o vacío) lo deja oculto.	visible
título SEO	Título para Google.	"Camiseta Básica de Algodón"
descripción SEO	Meta descripción.	"Camiseta básica de algodón 100%..."
SKU	Código interno. Formatea la columna como texto en Excel para no perder ceros.	CAM-BAS-001
código de barras	EAN, UPC u otro. También como texto (Excel puede convertirlo a notación científica).	7460123456789
precio de venta	Número. Preferible con punto decimal y sin símbolo de moneda.	1200 o 19.80
precio a comparar	Para mostrar el tachado.	1500
precio de costo	Tu costo interno.	500
controlar inventario	`"sí"` o `"no"`	sí
cantidad disponible	Stock inicial. Solo se aplica si tu tienda tiene una sola sucursal / ubicación de inventario. Con dos o más, esta columna se ignora: carga el stock desde Gestión de inventario.	30
tipo de impuesto	Nombre EXACTO del impuesto en Ajustes. Si no coincide, el producto queda sin impuesto.	"ITBIS 18%"
Peso	Número en la unidad configurada de tu tienda (kg/lb/oz).	0.3
Ancho / Alto / Profundidad	En centímetros.	30 / 25 / 3
producto relacionado	Título de otro producto que ya existe en tu catálogo.	"Pantalón Slim Fit"
tipo de relación	Nombre exacto del tipo configurado. Por defecto: "Productos relacionados".	Productos relacionados
producto_nuevo	`"sí"` o `"no"` para marcarlo como novedad.	sí
habilitar fecha de entrega	Solo si tienes el addon de pedido programado. `"sí"` o `"no"`.	no

Separador /// (triple barra): se usa en lugar de la coma porque las comas pueden aparecer dentro de los nombres. Las triple barras nunca aparecen en texto normal.

Identificador: escribe camiseta-basica o Camiseta Básica — el sistema lo convierte igual (camiseta-basica). Usa siempre el mismo valor en todas las filas del producto (variantes e imágenes).

3. Crea un producto con variantes (varias filas con el mismo identificador)

Aquí es donde el modelo mental cobra sentido. Vamos a crear un pantalón con variantes Talla × Color.

Límites importantes:

Máximo 3 ejes de opción (por ejemplo Talla, Color y Material).
Todas las variantes del mismo producto deben repetir los mismos nombres de opción (Talla, Color, …). Si una fila trae opciones distintas o incompletas, esa fila falla.
La primera fila del producto debe llevar título. Las filas siguientes de variante pueden dejar título y descripción vacíos (heredan).

Fila 1 — Producto principal + primera variante:

Llena todas las columnas como en el producto simple, PERO además agrega:

Columna	Valor
identificador	pantalon-slim
(resto del producto)	...
nombre de opción 1	Talla
valor de opción 1	S
nombre de opción 2	Color
valor de opción 2	Negro
SKU	PAN-SLIM-S-NEG

Fila 2 — Segunda variante:

Columna	Valor
identificador	pantalon-slim (mismo que fila 1, EXACTAMENTE igual)
título / descripción / marca / categorías / etc.	(VACÍAS — heredan de fila 1)
nombre de opción 1	Talla
valor de opción 1	S
nombre de opción 2	Color
valor de opción 2	Gris
SKU	PAN-SLIM-S-GRI

Y así sucesivamente para Talla M / Negro, Talla M / Gris, etc. Repite los nombres de opción ("Talla", "Color") en cada fila pero deja vacíos los datos del producto que ya están en la fila 1.

Variante con precio o peso diferente:

Si una talla XL tiene precio o peso distinto, llena esos campos específicamente en su fila. El sistema usa los valores específicos donde estén, y hereda del producto principal donde estén vacíos. Solo escribes lo que es diferente.

4. Agrega imágenes (filas dedicadas)

Las imágenes se manejan con tres columnas: imagen, posición de imagen y asociar imagen a atributo.

Imagen del producto principal (siempre visible):

Va en la fila del producto principal o en una fila adicional con el mismo identificador.

identificador	imagen	posición de imagen	asociar imagen a atributo
camiseta-basica	https://.../camiseta-frente.jpg	1	(vacío)

Segunda foto del mismo producto:

Una fila nueva con el mismo identificador y solo las columnas de imagen.

identificador	imagen	posición de imagen
camiseta-basica	https://.../camiseta-espalda.jpg	2

Imagen vinculada a un color específico (variantes):

La columna "asociar imagen a atributo" asocia la imagen a un valor de opción (típicamente colores). Cuando el cliente selecciona ese color en la tienda, se muestra esta imagen.

identificador	imagen	posición de imagen	asociar imagen a atributo
pantalon-slim	https://.../pantalon-general.jpg	1	(vacío — imagen general)
pantalon-slim	https://.../pantalon-negro.jpg	2	Negro
pantalon-slim	https://.../pantalon-gris.jpg	3	Gris

Una URL por celda. Si pegas varias URLs separadas por coma en la misma celda, solo se usa la primera. Para más fotos, usa filas adicionales.

Las URLs deben ser públicas y responder rápido. Enlaces privados de Google Drive / Dropbox, o imágenes muy lentas, suelen fallar sin que el resto del producto se cree.

5. Sube las imágenes primero (Archivos)

Para que las URLs del archivo funcionen, las imágenes tienen que ser públicas. La forma más fácil es subirlas a la sección "Archivos" de tu tienda:

En el menú lateral, abre "Archivos".
Haz clic en "Subir archivos" y selecciona todas las fotos. Puedes subir muchas a la vez.
Cada archivo subido tiene un ícono de enlace a la derecha — haz clic para copiar la URL.
Si son muchas imágenes, haz clic en "Exportar" arriba para descargar todas las URLs en un archivo. Las pegas en bloque en tu archivo.

6. Guarda el archivo

Lo más sencillo: guárdalo como Excel (.xlsx). Excel conserva los acentos, las eñes y los SKU tal cual, sin pasos extra.

Si prefieres CSV, también sirve:

Da igual cómo lo guarde Excel ("CSV UTF-8" o "CSV delimitado por comas"): reconocemos los acentos y las eñes en ambos casos.
Da igual si las columnas van separadas por coma o por punto y coma (lo habitual en Excel en español): lo detectamos solo.
Desde Google Sheets: Archivo → Descargar → Valores separados por comas (.csv), o Microsoft Excel (.xlsx).

Lo único que no funciona es un archivo de Excel renombrado a .csv (o al revés): guárdalo con "Guardar como" en el formato que quieras.

7. Sube el archivo y revisa las columnas

Vuelve a "Productos > Importar".
Selecciona el archivo.
"Reemplazar productos existentes con el mismo identificador" — actívala solo si quieres actualizar productos que ya existen:
- Marcada: actualiza esos productos. Ojo: las imágenes existentes se reemplazan por las del archivo (se borran las anteriores de esa variante y se cargan las nuevas).
- Desmarcada: si el identificador ya existe, esa fila de producto se omite (no se crea un duplicado). Las filas de variantes nuevas del mismo producto sí pueden entrar.
Haz clic en "Subir archivo".

Verás las primeras filas de tu archivo y, encima de cada columna, un desplegable con el campo que contiene. Reconocemos las columnas por su nombre: los de la plantilla, los de la exportación de Vendabo y nombres habituales como "Nombre", "Precio" o "SKU". Si una columna no se reconoció o no quieres importarla, cámbiala en su desplegable o elige "- Ignorar".

Cuando subas otro archivo con las mismas columnas, verás el aviso "Reconocimos el formato de este archivo..." y la asignación ya estará hecha.

8. Revisa el resumen y confirma

Haz clic en "Revisar cambios". Antes de crear o cambiar nada te mostramos:

cuántos productos nuevos se van a crear, cuántos se actualizan, cuántos ya existen y no se reemplazan, y cuántas filas tienen error;
los productos afectados, con el precio actual y el nuevo cuando cambia;
las filas con error, con su número de fila en Excel y el motivo (por ejemplo, una fila sin título ni identificador).

Presta atención a los avisos en amarillo:

"Este archivo parece de precios o de inventario": el archivo solo trae columnas como SKU, nombre, precio o cantidad, y va a crear productos nuevos. Si solo querías cambiar precios o existencias, cierra y usa Importar en Precios o en Inventario: esos nunca crean productos.
"... ya existen y no se reemplazan": si querías actualizarlos, vuelve atrás y marca "Reemplazar productos existentes".

Si algo no cuadra, haz clic en "Cambiar columnas". Cuando todo esté bien, haz clic en "Confirmar e importar productos".

9. Revisa el resultado

Verás el avance en la misma ventana. Puedes cerrarla y seguir trabajando: la importación sigue en segundo plano y te enviamos un correo al terminar. Para catálogos muy grandes, conviene subir por lotes (por ejemplo de 200–500 filas) en lugar de un solo archivo enorme.

Al terminar verás cuántos productos se crearon, se actualizaron o tuvieron error. Si hubo errores, haz clic en "Descargar errores": obtienes un archivo con cada fila que no entró, su número de fila y el motivo. Corrígelas ahí y vuelve a subir solo ese archivo.

Todas tus importaciones quedan en "Ver historial" (en la ventana de importar), con la fecha, el archivo, quién la hizo y el resultado.

Después de importar, revisa en la tienda:

Si un producto “no aparece”, casi siempre está en oculto (visibilidad distinta de visible) o sin categoría asignada.
Si tienes más de una sucursal, la columna cantidad disponible de este archivo no escribe stock. Usa Gestión de inventario (import/export de stock) para cada ubicación.

Actualizar productos que ya existen

La forma más segura de actualizar un catálogo grande:

En "Productos", haz clic en "Exportar" y elige qué exportar (o aplica antes el filtro que necesites). Deja el formato "Excel (.xlsx)".
Edita solo las columnas que quieres cambiar.
Guarda el archivo tal cual.
Vuelve a Importar con "Reemplazar productos existentes con el mismo identificador" activado. Las columnas ya vienen asignadas.

Si solo cambias precios, es más simple actualizar precios con un archivo desde "Productos > Precios". Si exportas muchos productos (más de 5.000 filas), preparamos el archivo en segundo plano y te enviamos un correo con el enlace de descarga.

Reglas al actualizar:

El pivote es el identificador (debe coincidir con el de la tienda).
Una celda vacía no borra el dato actual: solo se actualiza lo que viene con valor.
Si incluyes imágenes y activaste reemplazar, las fotos previas de esa variante se sustituyen.
Con varias sucursales, no uses este archivo para stock: la columna se ignora. Usa la importación de inventario.

Problemas comunes al preparar el archivo

Qué ves	Causa probable	Qué hacer
"No se pudo leer el archivo" o "formato inválido" y la vista previa queda vacía	El archivo está dañado o es un Excel renombrado a `.csv` (o al revés).	Ábrelo en Excel y usa "Guardar como" → Libro de Excel (.xlsx). No es un problema de columnas.
Precios raros o rechazados	Texto en la celda del precio (por ejemplo, "consultar") o formatos mezclados.	Deja solo el número. Entendemos `1200`, `1,200.50`, `1.200,50` y con `RD$`.
SKU o código de barras aparece como `7.5E+12` o pierde ceros	Excel trató la celda como número al abrir un CSV.	Exporta desde Vendabo en Excel (.xlsx): ahí los SKU van como texto. Si escribes a mano, formatea la columna como Texto antes de pegar.
Filas rotas con comas o comillas en la descripción (solo CSV)	Texto con comas o saltos de línea sin las comillas correctas.	Guarda el archivo como Excel (.xlsx) y no tendrás este problema.
Una columna quedó asignada al campo equivocado o en "Ignorar"	El nombre de la columna no coincide con ninguno que reconozcamos.	Elige el campo correcto en su desplegable. La próxima vez que subas un archivo con esas columnas, lo recordaremos.
"la columna título es obligatoria"	Ninguna columna quedó mapeada a título.	En la vista previa, elige título en el desplegable correcto.
"no pueden haber varias columnas asignadas al mismo campo"	Dos columnas del archivo asignadas al mismo campo.	Deja una sola asignación; el resto en "Ignorar".
"las opciones de variantes no son válidas"	Ejes distintos entre filas, o faltan nombre/valor de opción.	Usa los mismos `nombre de opción 1/2/3` en todas las variantes del producto. Máximo 3 ejes.
El producto se crea pero queda oculto	Pusiste `activo`, dejaste vacío, o no usaste exactamente `visible`.	Pon `visible` en visibilidad y vuelve a importar con reemplazar.
Categorías no se asignan	El path no existe o no coincide exactamente (espacios, mayúsculas, `>`).	Crea antes las categorías en Crear categorías y copia el path tal cual.
Impuesto no aplica	El nombre no coincide con Ajustes.	Copia el nombre exacto (ej. `ITBIS 18%`).
Productos “no se actualizan”	No activaste reemplazar, o el identificador no coincide (tras normalizar).	Activa reemplazar y verifica el identificador exportado desde la tienda.
Imágenes no cargan	URL privada, rota, lenta, o varias URLs en una celda.	Usa URLs públicas de "Archivos"; una por fila.
El stock del archivo no aparece (varias sucursales)	Con 2 o más ubicaciones de inventario, `cantidad disponible` se ignora.	Importa stock desde Gestión de inventario. Con una sola sucursal, sí se aplica.

Checklist rápido antes de subir

[ ] Archivo guardado como Excel (.xlsx) (o CSV, si lo prefieres).
[ ] Primera fila = cabeceras.
[ ] Visibilidad = visible si quieres que se publiquen.
[ ] Categorías e impuestos con nombres exactos (las categorías deben existir antes).
[ ] Primera fila de cada producto nuevo con título.
[ ] Mismos identificador y mismos nombres de opción en todas las variantes.
[ ] SKU / código de barras como texto (sin notación científica).
[ ] URLs de imagen públicas, una por celda.
[ ] Si hay una sola sucursal: cantidad disponible OK. Si hay varias: stock vía Gestión de inventario.
[ ] Prueba primero con 2–3 productos.

¿Cuándo NO usar la importación masiva?

Si son menos de 10 productos — más rápido crearlos a mano que preparar el archivo.
Si los productos tienen contenido editorial complejo (descripciones largas con imágenes embebidas, formato HTML rico) — el editor visual del formulario es mejor para eso.
Si solo quieres actualizar el stock de productos ya cargados — usa Gestión de inventario, que importa y exporta solo existencias.
Si solo quieres cambiar precios — usa Actualizar precios con un archivo. Ninguna de las dos crea productos por error.

Tip

Antes de cargar tu catálogo completo, haz una prueba con 2 o 3 productos: uno simple, uno con variantes y uno con varias imágenes. Verifica que todo entra bien y se ve como esperas en la tienda. Si tu archivo de prueba pasa, el grande también.

Lee siempre el resumen antes de confirmar: si el número de productos nuevos no es el que esperabas, algo está mal asignado. Es mucho más fácil corregirlo ahí que borrar productos después.

Siguiente paso

Catálogo terminado. Ahora toca darle forma visual a la tienda — empieza con Preferencias generales para configurar nombre, contacto, idioma y moneda.