Contenido de la documentación¶

Autenticación — JWT, registro, login, refresh token, gestión de usuario
Certificados — cifrado de credenciales y carga de certificados PKCS#12
Documentos — firma de PDF por etiqueta y por coordenadas (/api/doc/*, multipart)
Firma individual y masiva — niveles PAdES-B/BT/LTA, firma_visual y firma masiva asíncrona (/api/firma/*, JSON+Base64)
Sellos de tiempo (TSA) — configuración y validación de RFC 3161
Auditoría — listado paginado de firmantes y procesos, búsqueda por DNI/correo, filtros por rol/estado (/api/audit/*, solo ADMIN/SUPER)
Códigos y formatos de error — HTTP status y formatos de respuesta de error
Casos de uso — flujos completos con ejemplos curl

Glosario¶

Término	Definición
TSA	Time Stamp Authority: servicio externo que sella con fecha/hora (RFC 3161) una firma digital
PKCS#12 (`.p12`)	Formato de archivo que contiene certificado y clave privada
Alias (TSA)	Nombre único que identifica una configuración de sello de tiempo
DNI	Documento Nacional de Identidad del usuario/firmante
Certificado principal	El certificado `.p12` activo de un `dni`; solo puede haber uno a la vez
Sign by label	Modo de firma que ubica una etiqueta de texto en el PDF para posicionar la firma
Sign by coord	Modo de firma que usa coordenadas (x, y, página) explícitas
PAdES-B/BT/LTA	Niveles de firma PDF avanzada (ETSI EN 319 142): B sin sello de tiempo, BT con sello de tiempo, LTA con sello de tiempo + datos de revocación embebidos para validación a largo plazo
Solicitud de firma masiva	Lote de documentos encolado vía `/api/firma/masiva`, identificado por un código y procesado en segundo plano
Clamp (firma visual)	Ajuste automático de posición/tamaño del sello visual para que no quede fuera del borde de la página