Saltar al contenido principal

Plantillas de importación

Descripción general​

Una plantilla de importación es un mapeo guardado entre las columnas de un archivo CSV y los campos del catálogo de Aurora. Una vez definida, tú o tu equipo pueden subir nuevos archivos con el mismo formato y la importación reconoce las columnas automáticamente —sin volver a mapearlas. Ideal para cargas recurrentes desde la misma fuente: el sistema de tu proveedor, una hoja maestra interna, un export programado.

Cómo acceder​

  • Navega a Catálogo de Ventas > Configuración > Plantillas de importación (/sales/settings).
  • También disponible en la ruta directa /sales/imports/templates/new (crear nueva) o /sales/imports/templates/:id (editar existente).
  • Rol requerido: Administrador.

Vista general de la interfaz​

La pestaña de Plantillas de importación dentro de la configuración muestra:

  • Listado de plantillas existentes — Tabla con nombre, descripción, fecha de actualización y acciones (Editar / Eliminar).
  • Botón Nueva plantilla — Abre el editor de plantillas.

El editor (/sales/imports/templates/:id) es la herramienta principal: te permite ver una vista previa del archivo CSV, definir el mapeo de cada columna y guardar la plantilla.

Funciones y acciones​

Crear una plantilla​

Qué hace: Define un nuevo mapeo CSV → campos de Aurora que podrás reutilizar.

Pasos:

  1. En la pestaña Plantillas de importación, haz clic en Nueva plantilla.
  2. Sube un CSV de muestra que represente el formato que vas a recibir habitualmente. Aurora detecta los encabezados de columna y los muestra en el editor.
  3. Ingresa un Nombre y una Descripción para la plantilla (visible para tu equipo).
  4. Para cada columna del archivo, elige el campo de Aurora al que corresponde:
    • Campos estándar: Nombre, SKU, Precio, Moneda, Marca, Categoría, Tipo, Estado, Unidad de medida, etc.
    • Propiedad personalizada: si tienes propiedades personalizadas definidas, aparecerán como opciones del desplegable.
    • URL de imagen: para columnas con la URL de una imagen del producto.
    • Ignorar: para columnas que no quieres importar.
  5. Configura el comportamiento del encabezado (primera fila = encabezados de columna, sí/no).
  6. Define el comportamiento ante valores ausentes y conflictos (cuando aplique).
  7. Haz clic en Guardar plantilla.

Notas importantes:

  • La plantilla guarda el mapeo, no el archivo de muestra. Cada vez que importes, subes un archivo nuevo con la misma estructura.
  • Si tus archivos varían levemente (por ejemplo, una columna extra o en otro orden), Aurora intenta reconciliar por nombre de encabezado. Si el orden cambia pero los nombres son iguales, la plantilla funciona.

Editar una plantilla​

Qué hace: Modifica el nombre, descripción o el mapeo de una plantilla existente.

Pasos:

  1. Desde el listado, haz clic en el ícono de Editar de la plantilla.
  2. Ajusta el mapeo (puedes recargar un nuevo CSV de muestra para ver cómo quedan los encabezados).
  3. Haz clic en Guardar.

Eliminar una plantilla​

Qué hace: Quita la plantilla del listado.

Pasos:

  1. Desde el listado, haz clic en el ícono de Eliminar.
  2. Confirma.

Notas importantes:

  • Eliminar una plantilla no afecta las importaciones que ya se ejecutaron usando esa plantilla.
  • Las importaciones futuras no podrán usar la plantilla eliminada.

Usar una plantilla en una importación​

Qué hace: Aplica el mapeo guardado a un archivo nuevo.

Pasos:

  1. Desde Productos, haz clic en Nueva importación.
  2. Elige el formato Plantilla CSV.
  3. Sube el archivo.
  4. Selecciona la plantilla del desplegable.
  5. Aurora aplica el mapeo y te lleva directamente al editor de staging.

Buenas prácticas​

Una plantilla por fuente, no por archivo​

Si recibes catálogos de tres proveedores distintos con formatos distintos, crea tres plantillas —una por proveedor. Si todos vienen del mismo proveedor con el mismo formato, una sola plantilla alcanza para todas las cargas.

Nombra bien tus plantillas​

"Catálogo proveedor X — formato estándar 2026" es mejor que "Importación 1". Tu equipo en seis meses te lo agradecerá.

Documenta convenciones en la descripción​

La descripción de la plantilla es un buen lugar para anotar convenciones internas: "Las URLs de imagen deben ser HTTPS y públicas", "El precio viene en MXN", "Filas con SKU vacío se ignoran".

Combina con productos en Borrador​

Por defecto, los productos importados quedan en estado Borrador. Esto te permite usar plantillas con confianza: si la importación trae filas con errores no detectados, los productos no se exponen al agente IA hasta que tu equipo los revise y los active.

Notas importantes​

  • Las plantillas son por inquilino: las plantillas que crees están disponibles para todos los usuarios con rol Administrador en tu cuenta.
  • Si tu fuente cambia el formato (agrega/quita columnas, renombra), actualiza la plantilla antes de la próxima importación.
  • No hay un límite duro práctico en la cantidad de plantillas; en la práctica, un puñado bien mantenidas funciona mejor que muchas duplicadas.

Preguntas frecuentes​

P: ¿Las plantillas soportan propiedades personalizadas? R: Sí. Cualquier propiedad personalizada definida en tu catálogo aparece como opción en el desplegable de campos al mapear una columna.

P: ¿Qué pasa si el archivo tiene columnas que la plantilla no contempla? R: Las columnas no mapeadas se ignoran. Si necesitas usarlas, edita la plantilla y agrégalas al mapeo.

P: ¿Las plantillas mapean también las URLs de imagen? R: Sí. En el desplegable de campos hay una opción específica para URLs de imagen. Puedes incluso definir varias columnas de URL si tu archivo trae múltiples imágenes por producto separadas por columnas.

P: ¿Puedo importar sin plantilla? R: Sí. La opción Excel/CSV te lleva al mapeo de columnas manual al momento. La plantilla solo automatiza ese paso.

Funciones relacionadas​