Módulo 006: Operaciones de Carga y Exportación Masiva
Introducción
La Carga Masiva es la operación que permite crear o actualizar grandes volúmenes de productos en Loolu PIM mediante un archivo Excel estructurado. El proceso se divide en 5 fases clave: desde la obtención de la plantilla correcta hasta la verificación del éxito de la carga en el sistema.
Fase | Nombre | Descripción |
1 | Descarga de plantilla | Obtener el archivo Excel actualizado desde Loolu PIM. |
2 | Llenado y edición | Completar o modificar la información de productos en el archivo. |
3 | Subida del archivo | Cargar el Excel editado a la plataforma. |
4 | Monitoreo e identificación de errores | Verificar el resultado e interpretar los reportes de error. |
5 | Validación de éxito | Confirmar que los productos se cargaron correctamente en Loolu PIM. |
Fase 1: Descarga de la Plantilla Actualizada
Para evitar errores de estructura, siempre debes trabajar sobre la versión de plantilla más reciente del sistema.
- Ir al módulo Import/Export — en el menú lateral de Loolu PIM.
- Aplicar filtros (Opcional pero recomendado) — si la base de datos es muy grande, filtra por Categoría u otro criterio antes de exportar. Esto hará que el archivo sea más ligero y se procese más rápido.
- Hacer clic en Search y luego en Download All (o Download).
- Ir a la pestaña History — para monitorear la generación del reporte:
- In Process: verás una nueva línea de tipo descarga. El tiempo de espera dependerá del volumen de SKUs y especificaciones.
- Completado: recibirás una notificación en tu correo institucional y el ícono de descarga se habilitará en la columna Download.
⚠️ SOPORTE | Si un reporte antiguo se queda congelado en estado In Process de forma permanente, puede bloquear tus solicitudes nuevas. En ese caso, levanta un ticket en el portal de soporte de Loolu PIM para liberar la cola de procesamiento. |
Fase 2: Llenado y Edición de Datos (Archivo Excel)
Al abrir el documento descargado, notarás pestañas como Marcas, Categorías, Precios e Inventario. Enfócate principalmente en la pestaña Productos.
Regla de Oro: ¿Crear o Actualizar?
Loolu PIM determina automáticamente la acción a ejecutar según el valor de la columna Id producto:
Acción | Condición (columna Id producto) | Resultado |
Creación | Se deja en blanco o se ingresa un ID inexistente en Loolu PIM. | El sistema crea un producto nuevo y le asigna un folio automático. |
Actualización | Se coloca un ID de producto que ya existe en Loolu PIM. | El sistema modifica únicamente los campos que hayan cambiado en las demás columnas. |
Columnas Críticas y su Configuración
ℹ️ CÓMO LEER LA PLANTILLA | Los campos que muestran la leyenda (OPCIONAL) o (SOLO LECTURA) en su encabezado no son necesarios para ejecutar la carga. Los campos sin ninguna de estas leyendas son obligatorios y deben completarse para que el sistema procese la fila correctamente. |
Fase 3: Subida del Archivo a la Plataforma
Una vez que hayas guardado los cambios en tu archivo Excel local:
- Regresar a Loolu PIM — sección Import/Export → pestaña Products.
- Hacer clic en el botón Attach File.
- Seleccionar el archivo Excel editado desde tu computadora.
- Presionar el botón Upload.
Fase 4: Monitoreo e Identificación de Errores
- Ir de inmediato a la pestaña History.
- Monitorear el proceso — verás una nueva línea de tipo carga con el estado In Process. Espera hasta que el sistema termine de procesar el documento.
- Revisar si hay errores — si el sistema detecta incidencias, aparecerá un archivo adicional en la columna Download identificado como Update Response al pasar el cursor sobre él.
- Descargar y leer el archivo de respuesta — ábrelo y desplázate hasta la última columna, titulada Comentarios. Allí el sistema detalla fila por fila qué falló.
- Ejemplo: "La columna fecha lanzamiento no tiene un formato válido" o "El URL del producto ya existe".
- Corregir y reintentar — corrige los errores señalados en tu archivo original y repite el proceso de subida de la Fase 3.
Errores Frecuentes en el Archivo de Respuesta
Mensaje en columna Comentarios | Acción correctiva |
La columna fecha lanzamiento no tiene un formato válido. | Limpiar el campo (es opcional) o corregir al formato dd/mm/yyyy. |
El URL del producto ya existe. | Modificar el URL del producto por uno único y volver a subir. |
El ID del producto ya existe. | Verificar si la intención es actualizar (mantener el ID) o crear uno nuevo (dejar el campo en blanco). |
El producto ya existe en VTEX. | El Id producto e-commerce (col. Z) ya está registrado en VTEX. Usar un ID diferente o dejar el campo vacío. |
Fase 5: Validación de Éxito
Sabrás que la carga fue 100% exitosa cuando en la pestaña History el registro de tu carga finalice sin generar un segundo archivo de respuesta con errores. Para auditarlo manualmente:
- Copiar el Id producto — toma el ID de uno de los artículos que creaste o actualizaste en tu archivo Excel.
- Ir al buscador principal de productos de Loolu PIM.
- Cambiar el filtro de búsqueda a Product ID (opcional) — pega el código y presiona buscar.
- Verificar la información — ingresa al producto y confirma que los datos en Loolu PIM correspondan exactamente a los del archivo de carga masiva.
✅ CARGA EXITOSA | Si la carga fue correcta, en el historial solo aparece el archivo original (1 ícono de descarga). La ausencia de un archivo Update Response es la señal definitiva de que todos los registros se procesaron sin errores. |