Importación de catálogo
Descripción general
La importación te permite cargar productos, variantes, categorías y propiedades en bloque, sin tener que crearlos uno por uno. Aurora soporta tres formatos de entrada y todos pasan por un editor de staging —una vista intermedia donde revisas el contenido, corriges errores y excluyes filas antes de comprometer los cambios al catálogo. La confirmación final corre en segundo plano con un modal de progreso que puedes cerrar y seguir trabajando.
Cómo acceder
- Navega a Catálogo de Ventas > Productos y haz clic en Nueva importación (
/sales/products). - Rol requerido: Administrador.
Vista general de la interfaz
La importación tiene tres etapas visibles:
- Modal de importación — Eliges el formato, subes el archivo y configuras adaptador y plantilla.
- Editor de staging (
/sales/imports/:id) — Una tabla con cada fila del archivo, sus errores resaltados, y acciones para editar valores, excluir filas o aceptar tal cual. - Modal de progreso — Una vez confirmas, aparece una barra de avance con dos fases (productos y medios). Puedes cerrarlo y volver al listado; el chip de progreso en la parte superior mantiene visible el estado.
Cuando termina, aparece un resumen con cuántos productos se crearon, cuántos se actualizaron y cuántas filas fallaron.
Los tres formatos de importación
Plantilla CSV
Una plantilla es un mapeo predefinido entre columnas de CSV y campos de Aurora que tú y tu equipo crearon una vez. Es la opción más rápida y predecible: subes el CSV, Aurora reconoce las columnas automáticamente porque la plantilla ya las definió. Recomendada para cargas recurrentes desde la misma fuente.
Consulta Plantillas de importación para crear una.
Excel / CSV con mapeo manual
Sube cualquier hoja de cálculo (Excel o CSV) sin plantilla previa. Aurora te lleva a un paso de mapeo de columnas: para cada columna del archivo, eliges a qué campo de Aurora corresponde (Nombre, SKU, Precio, Categoría, Marca, etc.). Útil cuando recibes un archivo de un proveedor o el formato varía.
Documento (PDF, Word o imagen)
Sube un archivo no estructurado —un PDF de catálogo, un Word con la lista de productos, una foto de la lista en papel— y Aurora usa IA para extraer los productos automáticamente. Útil para catálogos heredados que solo existen en documentos. La extracción puede tomar varios minutos; el resultado va al editor de staging como cualquier otra importación.
El editor de staging
Después de subir el archivo (y mapear columnas, si aplica), Aurora te lleva al editor de staging. Aquí:
- Cada fila del archivo se convierte en una fila editable de la tabla de staging.
- Las filas con errores se resaltan: SKU duplicado, precio inválido, categoría inexistente, columna requerida vacía. Puedes editar el valor directamente en la celda.
- Puedes excluir filas que no quieras importar (por ejemplo, productos descontinuados que aparecen en el archivo).
- El contador superior muestra cuántas filas son válidas, cuántas tienen errores y cuántas están excluidas.
- Si una fila era un producto ya existente (mismo SKU), la importación lo trata como actualización en lugar de creación.
Una vez que el archivo está limpio (o decides aceptar los errores como filas fallidas), haces clic en Confirmar importación y el proceso pasa al modal de progreso.
Importación de imágenes
Cuando tu CSV o plantilla incluye URLs de imágenes para los productos, Aurora descarga las imágenes desde esas URLs durante la importación y las guarda en tu cuenta. Las imágenes que son idénticas (mismo contenido) se deduplican automáticamente —no se duplica el almacenamiento si la misma imagen aparece en varios productos o variantes.
Notas importantes:
- Las URLs deben ser públicas y accesibles (la importación no puede autenticarse).
- Si una URL falla (404, tiempo agotado), el producto se crea de todas formas, pero sin esa imagen. El error se registra en el reporte de fallas por fila.
- Para importaciones grandes (varios miles de imágenes), te recomendamos validar las URLs antes y dividir el archivo en lotes: ver "Importaciones grandes" abajo.
Funciones y acciones
Iniciar una importación
Qué hace: Abre el modal para cargar un archivo y elegir formato.
Pasos:
- En el listado de productos, haz clic en Nueva importación.
- Elige el formato: Plantilla CSV, Excel/CSV o Documento.
- Sube el archivo arrastrándolo o usando el botón de selección.
- Si elegiste Plantilla CSV, selecciona la plantilla a usar.
- Haz clic en Continuar.
Mapear columnas (solo Excel/CSV manual)
Qué hace: Asocia cada columna del archivo con un campo de Aurora.
Pasos:
- Para cada columna del archivo, selecciona el campo destino del desplegable (Nombre, SKU, Precio, Categoría, Marca, propiedad personalizada, etc.).
- Las columnas que no quieras importar puedes dejarlas como "Ignorar".
- Haz clic en Continuar al editor.
Editar filas en staging
Qué hace: Corrige errores o ajusta valores antes de comprometer.
Pasos:
- En el editor de staging, haz clic en una celda con error (o cualquier celda editable).
- Modifica el valor.
- Los errores de validación se actualizan automáticamente.
Excluir filas
Qué hace: Marca filas para que no se importen.
Pasos:
- Marca la casilla a la izquierda de las filas que quieres excluir, o usa la acción de menú.
- Las filas excluidas quedan visibles pero atenuadas y no se cuentan en el total a importar.
Confirmar la importación
Qué hace: Comprometer los cambios al catálogo en segundo plano.
Pasos:
- Una vez revisadas las filas, haz clic en Confirmar importación.
- Aparece el modal de progreso con dos fases:
- Productos — Crea y actualiza productos y variantes.
- Medios — Descarga las imágenes desde las URLs incluidas.
- Puedes cerrar el modal y seguir trabajando. El chip de progreso superior te avisa cuando termina.
- Al terminar, verás un resumen con cuántos productos se crearon, cuántos se actualizaron y cuántos fallaron.
Cancelar una importación en curso
Qué hace: Detiene la importación. Lo ya procesado se mantiene (es seguro reanudar luego).
Pasos:
- En el modal de progreso, haz clic en Cancelar.
- Confirma. La importación se marca como cancelada en el historial.
Revisar errores por fila
Qué hace: Ve qué filas fallaron y por qué.
Pasos:
- Una vez terminada la importación, abre el panel de resultados del modal de progreso.
- La lista muestra cada fila fallida con el motivo (URL de imagen inaccesible, SKU duplicado, datos inválidos, etc.).
- También puedes acceder al historial desde Catálogo de Ventas > Configuración > Historial de importaciones.
Importaciones grandes (miles de productos e imágenes)
Si vas a cargar varios miles de productos —especialmente si traen imágenes— sigue estas recomendaciones:
- Divide el archivo en lotes de unos 5,000 productos. Cada lote es una importación independiente. Esto acota el alcance de un error y acelera la barra de progreso visible para tu equipo.
- Valida las URLs de imagen antes de importar (que devuelvan 200, tamaño razonable). Las URLs lentas o caídas hacen fallar imágenes individuales —cada falla se registra pero el producto se crea igual sin imagen.
- Espera el ciclo de búsqueda semántica. Para que el agente IA pueda buscar de forma semántica en productos recién importados, Aurora procesa cada producto en segundo plano (lotes cada pocos minutos). En una importación grande, la búsqueda semántica completa puede tardar algunas horas en estabilizarse —mientras tanto la búsqueda por palabras y los filtros estructurados ya funcionan al 100%.
Referencia de campos (resumen)
| Campo | Descripción | Requerido | Notas |
|---|---|---|---|
| Nombre | Nombre del producto | Sí | Obligatorio en cada fila |
| SKU | Identificador único de variante | Sí | Único en tu cuenta; si ya existe = actualización |
| Precio | Precio por unidad de la variante por defecto | Sí | Cero o mayor |
| Moneda | Código ISO de 3 letras | Sí | USD, MXN, BRL, etc. |
| Categoría | Categoría del producto | No | Se resuelve por nombre o slug; se crea si no existe |
| Marca | Marca del producto | No | Texto libre |
| Tipo | Producto o Servicio | No | Predeterminado: Producto |
| Estado | Borrador / Activo / Descontinuado / Archivado | No | Predeterminado: Borrador |
| URLs de imágenes | Lista de URLs (separadas por coma o en columnas) | No | Pública y accesible |
| Propiedades personalizadas | Una columna por propiedad definida | No | El valor debe respetar el tipo de la propiedad |
Notas importantes
- Máximo 10,000 filas por archivo de importación. Para volúmenes mayores, divide en varios archivos.
- La importación es resumible: si el proceso se interrumpe (cierras el navegador, se cae la conexión), el trabajo sigue en segundo plano —no necesitas volver a cargar el archivo.
- Los productos creados quedan en estado Borrador salvo que la importación especifique otro estado, para que tu equipo los revise antes de exponerlos al agente IA.
- El historial completo de importaciones se conserva en Configuración > Historial de importaciones —incluyendo los archivos de error por fila.
Preguntas frecuentes
P: ¿Qué pasa si una fila tiene un SKU que ya existe? R: Se trata como una actualización del producto/variante existente, no como una duplicación.
P: ¿Puedo importar solo categorías o solo propiedades? R: No directamente. La importación opera sobre productos; las categorías y propiedades se crean automáticamente cuando aparecen en el archivo, o las defines de antemano en la configuración.
P: ¿Por qué algunas imágenes no aparecieron después de importar? R: Probablemente las URLs respondieron con error o tardaron demasiado. Revisa el reporte de fallas por fila y corrige las URLs o súbelas manualmente al producto.
P: ¿Puedo deshacer una importación? R: No hay un botón de "deshacer importación" automático. Si necesitas revertir, archivas los productos creados (filtrando por fecha de creación) o haces una segunda importación de corrección. Para minimizar el riesgo, los productos nuevos quedan en Borrador por defecto.
P: ¿La importación corre incluso si cierro el navegador? R: Sí. Una vez confirmada, la importación corre en segundo plano. Vuelve a entrar a Aurora y verás el chip de progreso o el resumen final.