Importación de catálogo
Descripción general
La importación te permite cargar productos, variantes, categorías y propiedades en bloque, sin crearlos uno por uno. El flujo es con plantilla de Excel (XLSX): eliges una plantilla, descargas un archivo .xlsx ya armado con tus columnas, lo llenas, lo subes y pasas 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.
Hoy el formato disponible es la plantilla XLSX. Otros dos métodos —Excel/CSV con mapeo manual y PDF, Word o imagen con IA— aparecen en la pantalla marcados como Próximamente.
Cómo acceder
- Navega a Catálogo de Ventas > Productos y haz clic en Nueva importación (
/sales/imports/new). - Rol requerido: Administrador.
Vista general de la interfaz
La importación tiene tres etapas visibles:
- Elegir el método — Tres tarjetas: Plantilla (disponible), Excel / CSV y PDF, Word o imagen (ambas Próximamente).
- Configurar, descargar y subir — Un asistente de tres pasos: eliges la plantilla, descargas el XLSX, lo llenas y lo subes.
- 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.
Cuando confirmas, aparece un modal de progreso con dos fases (productos y medios). Puedes cerrarlo y volver al listado; el chip de progreso superior mantiene visible el estado. Al terminar verás un resumen con cuántos productos se crearon, cuántos se actualizaron y cuántas filas fallaron.
El flujo con plantilla XLSX
Paso 1 — Elige una plantilla
Una plantilla define qué columnas trae tu archivo (campos de producto y variante, propiedades personalizadas, imágenes). La predeterminada funciona para la mayoría de los catálogos; crea una personalizada si necesitas más columnas. Consulta Plantillas de importación para diseñarlas.
Paso 2 — Descarga la plantilla XLSX
El botón Descargar plantilla XLSX genera un archivo con encabezados en tu idioma, las columnas requeridas marcadas, menús desplegables y comentarios por columna con el formato esperado. Llénalo en Excel o Google Sheets.
Paso 3 — Sube tu archivo
Sube el .xlsx lleno. Aurora valida cada celda y te lleva al editor de staging. Solo se aceptan archivos .xlsx; otros formatos se rechazan.
El editor de staging
Después de subir el archivo, Aurora te lleva al editor de staging. Aquí:
- Cada fila del archivo se convierte en una fila editable de la tabla.
- 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.
- 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.
Columnas y formato
Cada fila necesita al menos Nombre, SKU, Precio y Moneda; las demás columnas son opcionales. Algunos formatos útiles:
- Precio acepta
$100.00,100,00o1,234.56. - Moneda es un código ISO 4217 (MXN, USD, EUR).
- Para variantes (talla, color), usa el mismo Identificador del producto (ProductHandle) en todas las filas de un mismo producto; déjalo en blanco si el producto tiene una sola variante.
Importación de imágenes
Cuando tu plantilla incluye columnas de URL de imagen, Aurora descarga las imágenes desde esas URLs durante la importación y las guarda en tu cuenta. Las imágenes 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), valida las URLs antes y divide el archivo en lotes (ver "Importaciones grandes").
Funciones y acciones
Iniciar una importación
Qué hace: Abre el asistente para elegir plantilla y subir el archivo.
Pasos:
- En el listado de productos, haz clic en Nueva importación.
- Elige la tarjeta Plantilla.
- Selecciona la plantilla, descarga el XLSX, llénalo y súbelo.
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 las filas que quieres excluir.
- 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) y Medios (descarga imágenes).
- Puedes cerrar el modal y seguir trabajando; el chip de progreso superior te avisa cuando termina.
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 y 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:
- Al terminar, 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 accedes al historial desde Catálogo de Ventas > Configuración > Historial de importaciones.
Importaciones grandes (miles de productos e imágenes)
- Divide el archivo en lotes de unos 5,000 productos. Cada lote es una importación independiente.
- Valida las URLs de imagen antes de importar. Las URLs 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 busque de forma semántica en productos recién importados, Aurora procesa cada producto en segundo plano. 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 | Sí | Acepta $100.00, 100,00 o 1,234.56 |
| Moneda | Código ISO 4217 | Sí | MXN, USD, EUR, etc. |
| Identificador del producto | Agrupa variantes del mismo producto | No | Mismo valor en todas las filas de un producto multi-variante |
| Categoría | Categoría del producto | No | Se resuelve por nombre; se crea si no existe |
| Marca | Marca del producto | No | Texto libre |
| Estado | Borrador / Activo / Descontinuado / Archivado | No | Predeterminado: Borrador |
| URLs de imágenes | Una o varias columnas con URLs públicas | No | Públicas y accesibles |
| Propiedades personalizadas | Una columna por propiedad definida | No | El valor respeta el tipo de la propiedad |
Notas importantes
- Solo archivos
.xlsx. El formato CSV ya no se sube directamente; descarga la plantilla XLSX y llénala. - Máximo 10,000 filas por archivo. 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 se conserva en Configuración > Historial de importaciones —incluyendo los archivos de error por fila.
Preguntas frecuentes
P: ¿Qué formatos puedo subir?
R: Por ahora, .xlsx generado desde una plantilla. El mapeo manual de Excel/CSV y la extracción con IA desde PDF/Word/imagen aparecen como Próximamente.
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: ¿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" automático. Para minimizar el riesgo, los productos nuevos quedan en Borrador por defecto; si necesitas revertir, archívalos o haz una segunda importación de corrección.
P: ¿La importación corre incluso si cierro el navegador? R: Sí. Una vez confirmada, corre en segundo plano. Vuelve a entrar a Aurora y verás el chip de progreso o el resumen final.