Envío de Documentos y Mantenimiento¶

API REST para la firma digital de documentos PDF (PAdES). Recibe documentos, los deja disponibles para que un componente de escritorio los firme, y entrega el resultado — además de administrar los clientes, usuarios y procesos de firma que usan ese flujo.

Esta documentación es autocontenida: no asume que ya viste la documentación de ssigner-server (la app de escritorio con la que este servicio se coordina). Si vas a construir un front de administración o integrar un sistema externo contra esta API, todo lo que necesitas está acá.

Qué hace este servicio¶

• Recibe documentos PDF para firmar (POST /api/v1/documentos), junto con el identificador del proceso de firma al que deben ir.
• Consulta el estado de un documento y permite descargarlo una vez firmado.
• Administra clientes (las organizaciones a las que se les presta el servicio), usuarios (personas: un admin único y firmantes por cliente) y la asignación de qué procesos puede operar cada firmante.
• Expone dos formas de autenticación independientes: credenciales de sistema (machine-to-machine) y login de persona (con rol).

Qué NO hace este servicio¶

• No firma documentos. La firma digital la ejecuta un componente de escritorio aparte (ssigner-server), que vigila una carpeta compartida y usa una librería de firma externa. Este servicio nunca invoca esa librería ni contiene lógica de PAdES.
• No expone un endpoint para configurar procesos de firma (certificados, rutas, apariencia de la firma). Eso se configura manualmente desde la app de escritorio, por personal de soporte — ver la sección "Cómo se coordina con el resto del sistema" más abajo.

Cómo se coordina con el resto del sistema¶

Aunque esta API no firma nada directamente, depende de otro componente para completar el trabajo: una aplicación de escritorio (JavaFX) llamada ssigner-server, que corre siempre en segundo plano en el mismo servidor. Los dos componentes nunca se llaman entre sí — ninguno expone un endpoint que el otro consuma. Se coordinan únicamente a través de:

1. Una base de datos SQLite compartida (ssigner.db) — cada uno lee y escribe un subconjunto de tablas distinto (ver Modelo de datos).
2. Carpetas de archivos compartidas — cada proceso de firma tiene su propia carpeta de entrada y de salida; este servicio escribe en la de entrada y lee de la de salida.

En términos prácticos, para vos que vas a integrar contra esta API: enviás un documento, y en algún momento (normalmente segundos) deja de estar EN_PROCESO y pasa a FIRMADO — sin que tengas que saber ni que te importe qué componente físico lo firmó.

Índice de esta documentación¶

Datos rápidos¶