Saltar al contenido principal

Auditoría

La pista de auditoría (/dashboard/audit) registra toda modificación de datos hecha en el dashboard o vía API. Cada entrada captura quién lo hizo, qué se modificó, los valores antes y después, la IP, el User-Agent y el horario, formando un historial inmutable para compliance, depuración y análisis de incidentes.

Qué se registra​

Toda operación sensible pasa por el auditService. Entre las acciones registradas:

  • Creación, actualización, suspensión y activación de cuentas de cobro y clientes
  • Cambios de plan, ítems, status de suscripción, pausa y cancelación
  • Operaciones en facturas, pagos, reembolsos y créditos
  • Emisión, cancelación y errores de NF-e
  • Modificaciones en empresas, gateways, webhooks y API keys
  • Cambios en miembros, roles, configuraciones y templates
  • Inicios y cierres de sesión administrativos

La lista completa de acciones está definida en lib/services/audit.service.ts (AuditActions).

Filtros​

La interfaz permite filtrar por:

  • Acción (por ejemplo, subscription.canceled, invoice.paid)
  • Tipo de recurso (subscription, invoice, customer, nfe, etc.)
  • Usuario que la ejecutó
  • Rango de fechas
  • Búsqueda de texto por ID o nombre del recurso

Detalle de una entrada​

Cada fila puede expandirse en un modal que muestra:

  • previous_values — JSON con el estado anterior
  • new_values — JSON con el estado después de la modificación
  • metadata — contexto adicional (origen, motivo, idempotency key)
  • IP y User-Agent capturados en la solicitud

Retención y exportación​

Las entradas de auditoría son inmutables. Para análisis externos o retención a largo plazo, usa Exportaciones para descargarlas en CSV.

Captura de pantalla​

Pista de auditoría con acciones, recursos y detalles de la modificación