Importar productos con CSV

#Para que sirve

Si tienes 50, 100, o 500 productos, agregarlos uno por uno desde el admin es lento. La importacion por CSV te permite subir todos tus productos de golpe con un solo archivo.

Es ideal cuando:

• Estas migrando de otra plataforma (Shopify, Tiendanube, Excel)
• Tienes un inventario grande que ya esta en una hoja de calculo
• Necesitas actualizar precios masivamente

#Formato del archivo CSV

Tu archivo debe ser un CSV (valores separados por coma) con estas columnas en la primera fila:

nombre,precio,precio_comparativo,descripcion,categoria,imagen_url,activo

#Ejemplo completo

nombre,precio,precio_comparativo,descripcion,categoria,imagen_url,activo
"Camisa azul clasica",25.00,35.00,"Camisa de algodon 100%, corte regular","Camisas","https://ejemplo.com/camisa-azul.jpg",true
"Pantalon negro slim",40.00,,"Pantalon de vestir, corte slim fit","Pantalones","https://ejemplo.com/pantalon-negro.jpg",true
"Gorra deportiva",15.00,20.00,"Gorra ajustable, talla unica","Accesorios","https://ejemplo.com/gorra.jpg",true
"Bufanda de lana",18.50,,"Bufanda tejida a mano, 180cm","Accesorios","https://ejemplo.com/bufanda.jpg",false

#Detalle de columnas

Columna	Requerido	Tipo	Descripcion
nombre	Si	texto	Nombre del producto (max 200 caracteres)
precio	Si	numero	Precio actual. Usar punto como decimal: 25.00
precio_comparativo	No	numero	Precio anterior (para mostrar descuento). Dejar vacio si no aplica
descripcion	No	texto	Descripcion del producto (max 2000 caracteres)
categoria	No	texto	Nombre exacto de la categoria. Si no existe, se crea automaticamente
imagen_url	No	URL	URL publica de la imagen del producto (HTTPS)
activo	No	boolean	true (visible) o false (oculto). Default: true

#Descargar template

Para asegurarte de que el formato es correcto, descarga el template desde tu panel de admin:

1. Ve a Productos en tu admin
2. Haz click en Importar
3. Haz click en Descargar template CSV

El template viene con las columnas correctas y dos filas de ejemplo.

#Como importar

1. Prepara tu archivo CSV siguiendo el formato de arriba
2. Ve a Productos → Importar en tu panel de admin
3. Arrastra tu archivo o haz click para seleccionarlo
4. Revisa la vista previa — Karrito te muestra los primeros 5 productos y resalta errores
5. Si todo se ve bien, haz click en Importar productos
6. Espera a que termine. Veras una barra de progreso

#Que pasa durante la importacion

• Los productos nuevos se crean con estado activo (a menos que especifiques false)
• Las categorias que no existen se crean automaticamente
• Los slugs se generan automaticamente a partir del nombre
• Si un slug ya existe, se agrega un sufijo numerico (camisa-azul-2)

#Reglas del archivo

#Encoding

El archivo debe estar en UTF-8. Si usas Excel en Windows, al guardar selecciona "CSV UTF-8 (delimitado por comas)". Si usas Google Sheets, el CSV exportado ya viene en UTF-8.

#Separador

Solo se acepta la coma (,) como separador. No se soporta punto y coma (;) ni tabulador.

#Campos con comas

Si un campo contiene comas, encerralo entre comillas dobles:

"Camisa azul, manga larga",25.00,,"Camisa de algodon, corte regular","Camisas",,true

#Precios

• Usar punto como separador decimal: 25.00 (correcto), 25,00 (incorrecto)
• No incluir simbolo de moneda: 25.00 (correcto), $25.00 (incorrecto)
• No incluir separador de miles: 1500.00 (correcto), 1,500.00 (incorrecto)

#Imagenes

• La URL debe ser publica (accesible sin login)
• Debe empezar con https://
• Formatos soportados: JPG, PNG, WebP, GIF
• Si la URL no es valida, el producto se crea sin imagen

#Limite

Puedes importar hasta 500 productos por archivo. Si tienes mas, divide tu archivo en lotes de 500 y haz multiples importaciones.

#Errores comunes

Error	Causa	Solucion
"Encoding no soportado"	El archivo no es UTF-8	Re-exporta desde Google Sheets o guarda como "CSV UTF-8" en Excel
"Precio invalido"	Formato de numero incorrecto	Usar punto decimal, sin simbolo de moneda ni miles
"URL de imagen invalida"	La URL no es HTTPS o no existe	Verificar que la URL sea publica y empiece con https://
"Nombre es requerido"	Fila sin nombre de producto	Verificar que todas las filas tienen la primera columna llena
"Excede limite de productos"	El archivo tiene mas de 500 filas	Dividir en archivos mas pequenos
"Excede limite del plan"	Tu plan no permite tantos productos	Importar solo lo que tu plan permite o mejorar al plan Pro/Lifetime

#Tips

• Empieza con pocos — Importa 5-10 productos primero para verificar que todo se ve bien en tu catalogo
• Imagenes despues — Si no tienes las URLs de las imagenes listas, importa sin imagenes y agregalas despues desde el admin
• Google Sheets es tu amigo — Mantiene el formato limpio y exporta en UTF-8 por defecto

#Disponibilidad

La importacion por CSV esta disponible en los planes Pro y Lifetime.