Saltar al contenido principal
Cada solicitud de firma en Firma tiene un registro de auditoría completo. Cada visualización de documento, interacción con campos, firma, rechazo y acción administrativa se registra con marca de tiempo, identidad del actor y direcciones IP. Casos de uso comunes:
  • 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
El registro de auditoría captura dos categorías de eventos:
  • 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)
Cada evento incluye una marca de tiempo, una descripción legible, la identidad del actor y (para eventos de firmante) la dirección IP del firmante.

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ínea Autenticació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 campo source 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 con source: "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.
Los eventos de sello de organización (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 con source: "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.
Tres acciones de administrador escriben estas descripciones, que la API devuelve en inglés en todos los idiomas:
  • Cancelación desde el panel: Signing Request Cancellation requested
  • Eliminación desde el panel: Signing Request Deletion requested
  • Reintento de certificado: Certificate regeneration requested
Firma.dev escribe cada línea antes del cambio, de modo que la línea permanece cuando la acción falla después o pierde una condición de carrera. “Requested” registra la solicitud; no confirma que la acción se haya completado. Las filas escritas antes de la API v1.40.3 conservan la redacción anterior (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 eventos field_interaction. El objeto details contiene la acción específica y los metadatos del campo. El objeto details para las interacciones con campos incluye:

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 usan event: "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”).