- Cumplimiento normativo y evidencia legal — demuestra quién firmó qué, cuándo y desde dónde
- Depuración de problemas de firmantes — observa exactamente qué hizo un destinatario durante su sesión de firma
- Reportes internos — rastrea acciones administrativas como creación, ediciones y cancelaciones
- Eventos de firmante — visualizaciones de documento, interacciones con campos, firma, rechazo, descargas de certificado
- Eventos de administrador — creación, ediciones, envío, cancelación, reenvío (desde el panel o vía API)
Ver el registro de auditoría en el panel
Abre cualquier solicitud de firma en el panel de Firma y haz clic en la pestaña Registro de Auditoría. Verás una línea de tiempo cronológica de todos los eventos, con las acciones de firmantes y de administradores distinguidas visualmente. Los eventos repetitivos consecutivos (como desplazamientos o interacciones repetidas con campos) se condensan automáticamente con un indicador de conteo.Autenticación en el certificado de finalización
Cada fila de firmante del certificado de finalización incluye una líneaAutenticación: que indica Enlace de correo electrónico o Enlace de correo electrónico + código de un solo uso. Para un firmante con código, la línea termina con (código verificado el <hora>), la hora en que el firmante introdujo el código. La fila Identidad: de la parte superior del certificado muestra el método compartido, o Mixto (ver firmantes) cuando los firmantes difieren. La hora del código puede ser anterior a la hora Visto impresa encima, porque el firmante introduce el código antes de que se cargue el documento.
Obtener el registro de auditoría vía API
Usa el endpoint de auditoría para obtener el historial completo de eventos de una solicitud de firma:curl
Node.js
Python
Ejemplo de respuesta
Campos de la respuesta
Comprender las fuentes de eventos
El camposource indica si un evento proviene de un firmante o de un administrador, y el campo actor tiene una forma diferente para cada caso.
Eventos de firmante
Los eventos consource: "signer" son acciones realizadas por los destinatarios durante el flujo de firma. El objeto actor contiene el name y email del firmante. El campo ip_address está poblado.
organization_seal_*) usan source: "signer" con actor e ip_address en null. Firma.dev los registra cuando aplica, pausa, intercambia o vuelve a fijar un sello, y details contiene los datos del sello.
Eventos de administrador
Los eventos consource: "admin" son acciones realizadas desde el panel o vía API. El objeto actor contiene un campo type ("api_key" o "user") y opcionalmente un user_id. El campo ip_address es null.
- Cancelación desde el panel:
Signing Request Cancellation requested - Eliminación desde el panel:
Signing Request Deletion requested - Reintento de certificado:
Certificate regeneration requested
Signing Request Cancelled / Signing Request Deleted).
Seguimiento en tiempo real vía webhooks
Si necesitas notificación en tiempo real de eventos de firmante en lugar de consultar periódicamente el endpoint de auditoría, Firma admite webhooks. Consulta la guía de Webhooks para instrucciones de configuración.Referencia de eventos
Ciclo de vida del documento
Firma y verificación
Dos eventos identifican el código de un solo uso verificado por el ID de su registro (
otp_code_id) en details; el código en sí no se incluye:
otp_verified:{"channel": "email", "otp_code_id": "<uuid>"}document_finished:{"otp_code_id": "<uuid>"}, presente cuando la sesión que finalizó el documento estaba vinculada a un código verificado
Interacciones con campos
Las interacciones con campos se registran como eventosfield_interaction. El objeto details contiene la acción específica y los metadatos del campo.
El objeto
details para las interacciones con campos incluye:
Navegación
Sellos de organización
Firma.dev registra estos eventos para un sello de organización de la solicitud cuando se aplica, se pausa, se intercambia o se vuelve a fijar.Actividad administrativa
Los eventos de administrador usanevent: "activity" con un campo description legible que describe la acción realizada (por ejemplo, “Created signing request via API”, “Sent signing request”, “Cancelled signing request”).