Saltar al contenido principal

Importar Productos Masivamente (CSV)

Cuando tu catálogo de proveedores es extenso, Bukeer te ofrece un asistente de importación masiva en 3 pasos para cargar decenas de hoteles, actividades o transfers de una vez, con validación automática de duplicados y resolución de proveedores.

Nivel de Acceso Requerido

Solo usuarios con permiso de gestión de productos (canManageProducts) pueden iniciar una importación. Normalmente corresponde a los roles de Administración u Operaciones.

⏱️ Tiempo estimado: 5 a 15 minutos dependiendo del tamaño del archivo.

Prerrequisitos
  • Tener un archivo CSV o Excel (.xlsx) con los datos de los productos, correctamente formateados según la plantilla de Bukeer.
  • Tener acceso al módulo de Catálogo con permisos de edición.
  • Para hoteles, tener definidos previamente los proveedores (agentes contratados) en tu cuenta.

1. Descargar la Plantilla CSV​

Para evitar errores de formato, Bukeer provee una plantilla oficial con las columnas exactas que el importador espera.

  1. Dirígete a Catálogo de Productos en el menú principal.
  2. Haz clic en el botón de menú superior (tres puntos o ícono de descarga) y selecciona Importar Productos.
  3. En el primer paso del asistente, haz clic en el enlace "Descargar Plantilla CSV".
  4. Abre la plantilla descargada en Excel o Google Sheets y comienza a rellenar las filas con tus productos.
Campos clave por tipo de producto
  • Hoteles: Nombre, País, Ciudad, Estrellas, Descripción, Proveedor.
  • Actividades: Nombre, Destino, Duración, Precio neto, Proveedor operador.
  • Transfers: Origen, Destino, Tipo de vehículo, Tarifa máx. PAX, Precio neto.

[PLACEHOLDER: Captura mostrando el modal de importación en el Paso 1 con el enlace "Descargar Plantilla" visible (Entry State)]

2. Cargar el Archivo y Seleccionar Tipo​

  1. En el Paso 1 del asistente ("Archivo"), selecciona el Tipo de Producto que estás importando: Hoteles, Actividades o Transfers.
  2. Arrastra y suelta tu archivo CSV completo en la zona de carga, o haz clic en Seleccionar archivo para buscarlo en tu computador.
  3. Una vez cargado, el sistema validará el formato y mostrará un resumen del conteo de filas detectadas.
  4. Haz clic en Siguiente → para continuar.

[PLACEHOLDER: Animación mostrando el drag-and-drop del CSV y el conteo de filas detectadas antes de avanzar (Action State)]

3. Revisar Vista Previa y Resolver Duplicados​

El Paso 2 ("Vista Previa") es el más importante. Bukeer analizará cada fila del CSV para:

  • Resolver Proveedores: Si mencionas un nombre de proveedor, el sistema intentará asociarlo al registro existente en tu cuenta.
  • Detectar Duplicados: Si un hotel con el mismo nombre y ciudad ya existe en tu catálogo, te lo marcará en rojo como posible duplicado.

Si el producto es nuevo y diferente a cualquier registro existente:

  1. Déjalo sin marcar (o confirma la opción "Crear nuevo").
  2. Avanza al Paso 3 para importar.

[PLACEHOLDER: Captura de la tabla de Vista Previa mostrando filas con estado Nueva (verde), Duplicada (rojo) y en proceso de asignación de Proveedor (amarillo) (Action State)]

4. Ejecutar la Importación​

  1. Finalizada tu revisión en el Paso 2, haz clic en el botón Importar.
  2. El Paso 3 ("Importar") muestra una barra de progreso en tiempo real conforme Bukeer procesa cada fila.
  3. Al finalizar, verás un resumen con:
    • ✅ Importados correctamente: Número de productos creados o actualizados.
    • ⚠️ Con advertencias: Productos que se crearon pero con datos incompletos.
    • ❌ Fallidos: Registros que no pudieron insertarse (ej. proveedor no encontrado).
  4. Haz clic en Cerrar para regresar al catálogo.

Resultado Esperado​

Los productos importados estarán inmediatamente disponibles en el listado del Catálogo. Puedes verificar los registros paginando por los últimos creados (ordenados por fecha de creación del más reciente al más antiguo) y buscar por nombre en la barra de filtros.

Problemas Comunes​

El archivo sube pero aparecen 0 filas detectadas

Verifica que las columnas de tu CSV coincidan exactamente con los encabezados de la plantilla oficial de Bukeer (distingue mayúsculas/minúsculas). Un error común es usar separador de "punto y coma" (;) en lugar de "coma" (,). También prueba exportando el archivo como "CSV UTF-8" desde Excel.

El sistema indica que todos los productos son duplicados

Bukeer compara nombre del producto + país/ciudad. Si previamente hiciste una importación parcial, es posible que esos registros ya existan. Usa la opción Actualizar existente en lugar de Crear Nuevo para aplicar los cambios sin duplicar.

El botón "Importar Productos" no aparece o está inactivo

Confirma que tu rol tiene el permiso canManageProducts. Si tu cuenta es tipo Agente o Contabilidad, deberás solicitarle al Administrador que realice la importación o que eleve temporalmente tus permisos.

Artículos Relacionados​