Exportar registros de auditoría

La mayoría de las organizaciones nunca necesitan exportar datos de auditoría — el registro dentro de la aplicación va lo suficientemente atrás para cualquier investigación normal. Pero tres situaciones hacen que valga la pena exportar:

1. Temporada de impuestos. Quieres una copia congelada, fuera de la plataforma, de cada edición de donación del año fiscal, para poder defender un estado que sea cuestionado más adelante.
2. Retención del plan Starter. El registro de auditoría de la organización se poda a 90 días en Starter. Las exportaciones trimestrales mantienen tu historial completo.
3. Cumplimiento. Algunas denominaciones y aseguradoras requieren auditorías retenidas por 7+ años. Los respaldos de la base de datos satisfacen esto; las exportaciones CSV son más amigables para revisar los datos.

Exportar el registro de auditoría de la organización

Desde /activity-log:

1. Aplica los filtros que quieras exportar (tipo de entidad, acción, correo del actor). Omite los filtros para obtener todo.
2. Haz clic en el botón Exportar CSV en el encabezado de la página.
3. La exportación se ejecuta del lado del servidor y te envía por correo un enlace de descarga cuando esté lista. Las exportaciones grandes (100.000+ filas) tardan unos minutos; las pequeñas se completan en segundos.

Las columnas del CSV reflejan la tabla:

created_at,actor_email,actor_name,action,entity_type,entity_id,changed_columns,reason

changed_columns está separado por comas dentro de la celda (entrecomillado). reason es la justificación de texto libre cuando se suministró (por ejemplo, el motivo de ejecución de un workflow); vacío en caso contrario.

TIP

La exportación está limitada a 5 exportaciones por hora por organización para mantener manejable la cola de correo. Si estás haciendo corridas de archivo anual, prográmalas — no dispares diez a la vez.

Exportar la actividad del miembro

El registro de actividad del miembro no tiene un botón de exportación por miembro — está diseñado para lectura humana, no para extracciones masivas. Si necesitas los datos subyacentes:

• Usa la API para consultar member_activity_log filtrado por member_id o ventana created_at.
• O exporta el registro de auditoría de la organización y crúzalo con tu CSV de miembros externamente.

Exportar el historial de importaciones

Desde Datos y Registros → Historial de importaciones, el botón Exportar escribe un CSV de cada trabajo de importación (estado, conteo de filas, created_at). No incluye los registros de errores por fila — esos se descargan por trabajo mediante el botón Descargar CSV de errores en cada fila.

Si necesitas los errores a nivel de fila para muchos trabajos, el endpoint de API /api/import-jobs/{id}/errors los devuelve como JSON.

Cadencia de exportación sugerida

Plan	Qué	Cuándo	Por qué
Starter	Registro de auditoría de la organización	Mensual	Anticípate a la poda de 90 días
Growth+	Registro de auditoría de la organización	Anual	Archivo de temporada fiscal
Cualquiera	Historial de importaciones	Después de cada lote grande de importación	Para tener el CSV de errores por fila antes de la ventana de eliminación de archivos de 30 días
Cualquiera	Actividad del miembro para casos de RRHH	Ad-hoc	Documentar el ciclo de vida de una persona específica

Lo que no puedes exportar

• El registro de auditoría de la plataforma no es accesible para las organizaciones; solo para el personal de Genius Church Manager. Si tienes una solicitud regulatoria que lo requiera, contacta con soporte — podemos proporcionar un extracto limitado a tu tenant.
• Los valores de columna anteriores/posteriores no se almacenan, así que no están en la exportación. El campo changed_columns te dice qué cambió; el estado actual de la fila más los respaldos de la base de datos te dicen los valores.
• Los registros de acceso de lectura no existen en este producto. El seguimiento de vistas es un complemento empresarial; contacta con soporte si tu programa de cumplimiento lo requiere.

Almacenar exportaciones de forma segura

Los datos de auditoría en CSV contienen nombres de miembros, historial de ediciones y (en el historial de importaciones) potencialmente PII de tus archivos fuente. Trata las exportaciones igual que un respaldo de base de datos de miembros:

• Cifra en reposo si los estás almacenando fuera de un servicio gestionado.
• Mantenlos en una carpeta con acceso restringido — no una unidad compartida que todos puedan leer.
• Retén solo el tiempo que tu política de retención requiera; elimina las corridas antiguas una vez que se haya archivado una más reciente.

WARNING

No pegues filas del registro de auditoría en correos, Slack o herramientas de IA. Contienen correos de actores e IDs de entidades que pueden cruzarse de vuelta con personas. Si necesitas compartir una entrada para un caso de soporte, oculta primero el correo del actor y el ID de la entidad — el equipo de soporte puede buscar la misma fila por id o created_at.

¿Y los respaldos?

Las tablas del registro de auditoría se incluyen en el respaldo diario de Postgres que protege los datos de tu organización. Los respaldos son recuperables a punto en el tiempo por 7 días en Growth, 14 días en Network y 30 días en Unlimited. Los respaldos son la herramienta correcta para "necesito la base de datos como estaba en esta fecha"; las exportaciones CSV son la herramienta correcta para "necesito revisar el registro en una hoja de cálculo."

Véase también

• Registro de auditoría de la organización para el origen de la exportación
• Historial de importaciones para el CSV por trabajo
• API para acceso programático