Integraciones con la API firmar.online

 
La API de firmar.online consta de tres partes:
  • Prestador de Servicios de Confianza – PSC
  • Firma avanzada desde dispositivo – SignFromApp
  • Servicios avanzados de firma, firma con certificado y timeStamp: eSign

 

PSC

Es el servicio que permite embeber el proceso de firma dentro de una aplicación y de esa forma independizarse del dispositivo de firma.
Consta de varias operaciones para gestionar la firma del documento, las enumeramos para ofrecer una visión general del producto:

  • DocumentSet. desde una aplicación se puede subir un documento a la plataforma y ésta envía un correo electrónico al firmante para acceder a la firma del documento.
  • Url: sube el documento: después de haber subido el documento a la plataforma, se devuelve el enlace para acceder al documento. De esa forma se puede embeber el proceso de firma dentro de una aplicación o bien insertar el enlace en un correo u otro medio al que se necesite dar acceso a la firma.

A partir de que el documento queda en custodia por la plataforma, ésta se encarga de gestionar la firma del documento: registra todos los eventos que se producen sobre el documento, permitiendo consultar en tiempo real el estado de la petición, descargar el documento una vez firmado, descargar su certificado de evidencias de firma…etc. La lista completa de operaciones, estructura…etc, se puede consultar en el swagger que tenemos publicado en esta dirección. https://restapi.firmar.online/index.html

Por ejemplo, el ciclo de vida de un envío podría ser el siguiente:

  1. Subida de la petición a la plataforma y devolución del enlace para embeberlo en una aplicación => método URL
  2. Cuando el documento queda firmado,
    • recuperar el documento firmado para su archivo:DocumentSet/Document/{documentSetId}/{documentId}
    • descarga del certificado de evidencias en formato PDF /DocumentSet/Evidences/{documentSetId}
 

En la petición de firma se pueden configurar distintos tipos de firma:

  • 10:Notification 
  • 20:Acceptance 
  • 21:AcceptanceSignature 
  • 30:BioSignature 
  • 40:OTPSignature
  • 60:CryptoAPISignature.