Ejemplo práctico end-to-end

Este ejemplo muestra un flujo completo de firma de un documento PDF mediante la API de Firma en la Nube, desde la autenticación del usuario hasta la obtención del documento firmado.

El objetivo es ilustrar cómo se combinan los distintos pasos explicados en las secciones anteriores.

Contexto del ejemplo

En este escenario:

El usuario ya se autenticó y obtuvo un token JWT válido
Existe al menos una solicitud de firma disponible
El cliente desea firmar un documento PDF y obtener el archivo resultante

Paso 1: Obtener solicitudes disponibles

El primer paso consiste en consultar las solicitudes de firma asociadas al usuario autenticado.

Request:

GET/solicitudesAuthorization: Bearer <jwt_token>

Respuesta de ejemplo:

[
  {
    "solicitudId": 123,
    "documento": "contrato.pdf",
    "estado": "pendiente"
  }
]

El valor solicitudId será utilizado en el siguiente paso para enviar el documento a firmar.

Paso 2: Enviar el documento para firma

Una vez seleccionada la solicitud, se envía el documento junto con las opciones de firma.

Request:

POST /solicitudes/firmar
Authorization: Bearer <jwt_token>
Content-Type: application/json

Body de ejemplo:

{
  "solicitudId": 123,
  "fontColor": "BLACK",
  "fontName": "Serif",
  "fontSize": 12,
  "fontStyle": "PLAIN",
  "page": 1,
  "x": 100,
  "y": 200,
  "zoomPercent": 100,
  "restriccion": "NO_VALUE",
  "password": "MiClaveSecreta!"
}

En este paso, la firma se ejecuta de forma segura en la infraestructura de Lakaut AC, utilizando la clave privada protegida en el HSM en la nube.

Paso 3: Obtener el documento firmado

Como resultado del proceso de firma, la API devuelve una referencia al documento firmado.

Respuesta de ejemplo:

{
  "status": "success",
  "documentoFirmado": "https://lakautac.com/files/contrato_firmado.pdf"
}

Puede utilizar esta URL para descargar el documento firmado o almacenarlo según sus necesidades.

Resultado final

Al completar el flujo:

El documento queda firmado digitalmente

La firma es verificable y auditable

El archivo puede ser distribuido o archivado como comprobante válido