Historial de importaciones

Las importaciones masivas (miembros, donaciones, asistencia desde CSV) se ejecutan como trabajos en segundo plano para que el navegador no tenga que mantener abierta una conexión por 30.000 filas. La pestaña Historial de importaciones en Datos y Registros muestra los últimos 50 trabajos que tu organización ha ejecutado, con los conteos de filas para que veas de un vistazo si la importación terminó limpiamente.

Ábrelo desde Datos y Registros → Historial de importaciones en la barra lateral.

Leer la tabla

Cada fila es un trabajo de importación. Las columnas son:

Columna	Significado
Estado	queued, processing, complete o failed. Una insignia verde significa completo; gris significa aún en curso o en cola.
Total	Número de filas de datos en el CSV subido (excluye la fila de encabezado).
Procesadas	Filas que el worker ha terminado. Mientras el trabajo se ejecuta, sube en tiempo real al refrescar.
Fallidas	Filas que dieron error — correos incorrectos, campos requeridos vacíos, violaciones de clave foránea, duplicados que dispararon la regla de omitir duplicados.
Creado	Cuándo se inició la subida, en la zona horaria de tu organización.

Un trabajo saludable termina con estado = complete, procesadas = total, fallidas = 0. Cualquier otra cosa necesita atención.

Ciclo de vida del trabajo

Cuando subes un CSV desde el módulo Acciones Masivas:

1. El archivo se analiza y se inserta una fila en import_jobs con status = queued.
2. Un worker lo toma, establece status = processing y empieza a insertar filas en lotes de 100.
3. Cada fila exitosa incrementa processed_rows; cada fallo incrementa failed_rows y añade un error a una lista de fallos por fila.
4. Cuando se han intentado todas las filas, el worker establece status = complete (incluso si algunas filas fallaron — el éxito parcial sigue siendo éxito).
5. Si el worker mismo falla (corte de red, timeout de la edge function para un trabajo de 50.000 filas), el trabajo se queda en status = processing hasta que el próximo worker lo retome; los trabajos con más de 30 minutos en ese estado se marcan como failed.

TIP

Puedes salir de Acciones Masivas mientras una importación se ejecuta. El trabajo continúa del lado del servidor y puedes volver a esta página para revisar el progreso.

Qué significa realmente "filas fallidas"

El conteo failed_rows son filas que el worker rechazó, no filas que no pudo procesar en absoluto. Razones comunes:

• Fallo de validación — email no es un correo válido; phone no coincide con el formato del país; un campo requerido está en blanco.
• Clave foránea no encontrada — el CSV referencia un grupo, ministerio o fondo que aún no existe. Crea las filas padre primero, luego vuelve a importar.
• Duplicado omitido — si activaste "omitir duplicados" en la interfaz de subida, las filas que coinciden con un miembro existente por correo o teléfono cuentan como fallidas (técnicamente omitidas, pero la columna no distingue).
• Permiso denegado — tu rol no tiene permiso de escritura en la tabla destino para algunas filas. Raro; normalmente solo ocurre con configuraciones de RBAC personalizadas.

Los primeros 100 errores a nivel de fila se almacenan en el registro de errores del trabajo. La interfaz de acciones masivas muestra los primeros 10 en línea con un botón "descargar todos los errores" en CSV.

Triaje de una importación con fallos parciales

1. Abre el trabajo fallido desde Historial de importaciones.
2. Haz clic en Descargar CSV de errores — es el archivo original con dos columnas extra: __row y __error.
3. Corrige los errores en el CSV (o separa las filas problemáticas).
4. Vuelve a subir solo las filas corregidas. La regla de omitir duplicados evitará reimportar las filas que ya tuvieron éxito.

WARNING

No vuelvas a subir el CSV original sin omitir-duplicados activado después de un fallo parcial. Crearás duplicados de cada fila que tuvo éxito la primera vez.

Diferencias frente al registro de auditoría

El registro de auditoría captura qué hizo la importación (una fila por cada miembro insertado, con actor_email = system). El Historial de importaciones captura si el trabajo en sí terminó. Usa:

• Historial de importaciones cuando quieras saber "¿funcionó mi importación y cuántas filas no?"
• Registro de auditoría cuando quieras saber "¿qué tocó específicamente esta importación?" — filtra el registro de auditoría a la ventana temporal del trabajo.

Una importación típica de 1.000 miembros escribe 1.000 filas en el registro de auditoría y 1 fila en el historial de importaciones.

Retención

Los trabajos de importación y sus registros de errores se conservan por 1 año en todos los planes pagos (90 días en Starter). El CSV original subido se elimina del almacenamiento después de 30 días sin importar el plan — suficiente para reimportaciones y análisis forense, lo bastante corto para mantener los costos de almacenamiento razonables.

Si necesitas el CSV original por cumplimiento, descárgalo desde Acciones Masivas → Historial (una vista distinta que expone el archivo original) antes de que se cierre la ventana de 30 días.

Véase también

• Acciones Masivas para ejecutar las importaciones mismas
• Registro de auditoría de la organización para ver las inserciones a nivel de fila
• Exportar registros para el archivo fuera de la plataforma