Importar productos con CSV

#Para qué sirve

Si tienes 50, 100, o 500 productos, agregarlos uno por uno desde el admin es lento. La importación 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

#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.

#Cómo 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. Verás una barra de progreso

#Qué pasa durante la importación

• Los productos nuevos se crean con estado activo (a menos que especifiques false)
• Las categorías que no existen se crean automáticamente
• Los slugs se generan automáticamente 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)

#Imágenes

• 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 5,000 productos por archivo. Si tienes más, divide tu archivo en lotes y haz multiples importaciones.

#Errores comunes

#Tips

• Empieza con pocos — Importa 5-10 productos primero para verificar que todo se ve bien en tu catálogo
• Imágenes después — Si no tienes las URLs de las imágenes listas, importa sin imágenes y agregalas después desde el admin
• Google Sheets es tu amigo — Mantiene el formato limpio y exporta en UTF-8 por defecto

#Disponibilidad

La importación por CSV esta disponible en todos los planes, incluido el Free. Lo único que la acota es el tope de productos de tu plan.