Importación Masiva CSV
Fenicia te permite importar grandes cantidades de productos mediante archivos CSV. El asistente de importación te guía paso a paso: desde la carga del archivo hasta la validación, mapeo de columnas y confirmación.
Acceder a la Importación
- Navega a Productos en el menú lateral
- Haz clic en el botón Importar
- Selecciona CSV como formato de importación
Asistente de Importación
El proceso de importación sigue un asistente de seis pasos:
Subir archivo
Arrastra y suelta tu archivo CSV o selecciónalo desde el explorador de archivos. Fenicia acepta archivos .csv con codificación UTF-8.
Validación
El sistema analiza el archivo y detecta automáticamente el tipo de cada columna (SKU, título, precio, cantidad, etc.). También verifica:
- SKUs duplicados dentro del archivo
- Tipos de datos correctos (números, texto, fechas)
- Campos requeridos presentes (SKU, nombre, precio)
Mapeo de columnas
Asigna cada columna de tu CSV a un campo de producto en Fenicia. Las columnas detectadas automáticamente ya aparecen mapeadas. Las columnas no mapeadas se omiten durante la importación.
Confirmar
Fenicia muestra una vista previa con el resumen de la importación:
- Productos que se crearán (SKUs nuevos)
- Productos que se actualizarán (SKUs existentes)
- Resumen de cambios por campo
Progreso
La importación se procesa y puedes ver el avance en tiempo real. Para archivos grandes (más de 500 productos), el proceso se ejecuta de forma asíncrona.
Completado
Resumen final con el número de productos creados, actualizados y errores encontrados.
Plantilla CSV
Descarga la plantilla CSV desde la sección de importación para asegurarte de usar el formato correcto. La plantilla incluye:
- Encabezados de columna en el formato esperado
- Ejemplos de datos para cada campo
- Campos requeridos marcados
Tip
Usa la plantilla como punto de partida. Puedes agregar columnas adicionales y mapearlas durante el proceso de importación.
Detección Automática de Columnas
Fenicia detecta automáticamente el tipo de columna basándose en:
- Nombre del encabezado (SKU, título, precio, descripción, etc.)
- Contenido de los datos (formato numérico, patrones de texto)
| Campo detectado | Ejemplos de encabezado |
|---|---|
| SKU | sku, SKU, codigo, reference |
| Título | title, nombre, name, producto |
| Precio | price, precio, cost |
| Cantidad | qty, quantity, stock, inventario |
| Descripción | description, descripcion, desc |
| Código de barras | barcode, upc, ean |
Validación de Datos
Durante la validación, Fenicia verifica:
| Verificación | Descripción |
|---|---|
| SKUs duplicados | Detecta SKUs repetidos dentro del archivo |
| Tipos de datos | Verifica que precios sean numéricos, cantidades enteras, etc. |
| Campos requeridos | Confirma que SKU, nombre y precio están presentes |
| Formato de datos | Valida formatos de fecha, códigos de barras, etc. |
Errores de validación
Si se detectan errores, Fenicia los muestra en detalle. Puedes corregir tu archivo y volver a intentar, o continuar con los productos válidos.
Procesamiento Asíncrono
Para importaciones grandes (más de 500 productos), el proceso se ejecuta en segundo plano:
- Puedes cerrar la página y volver después
- El progreso se actualiza en tiempo real cuando regresas
- Recibirás una notificación al completarse
Revertir una Importación
Si detectas errores después de importar, puedes revertir la importación completa:
- Ve a Productos → Historial de operaciones masivas (
/products/bulk-history) - Busca la importación que deseas revertir
- Haz clic en Revertir
- Confirma la operación
Ventana de reversión
La opción de revertir está disponible por un tiempo limitado después de la importación. Los productos creados se eliminan y los actualizados se restauran a su estado anterior.
Historial de Operaciones Masivas
Todas las importaciones se registran en /products/bulk-history con:
- Fecha y hora de la operación
- Estado: completada, en proceso, fallida, revertida
- Contadores: productos creados, actualizados, errores
- Opción de reversión (cuando está disponible)
Editor Visual de Flujo
Para transformaciones avanzadas, Fenicia ofrece un editor visual de flujo en /products/bulk/flow. Este editor basado en nodos permite crear flujos de transformación complejos:
| Tipo de nodo | Función |
|---|---|
| Filtro | Selecciona productos por condiciones (precio, categoría, stock) |
| Mutación | Modifica datos (cambiar precios, agregar etiquetas, actualizar campos) |
| Condición | Bifurca el flujo según reglas lógicas |
| Transformación IA | Aplica transformaciones inteligentes usando inteligencia artificial |
Tip
El editor visual es ideal para operaciones complejas como ajustar precios por categoría, agregar etiquetas según condiciones o transformar descripciones con IA.
Siguientes Pasos
¿Necesitas ayuda? Contacta soporte o revisa nuestras preguntas frecuentes.