Firma desde link

Este flujo está pensado para poder firmar una petición sin necesidad de abrir sesión.

Para su uso, se debe enviar por correo electrónico un enlace a un código QR que posteriormente la aplicación móvil leerá, y desde donde se firmará la petición.

En caso de que se requiera aprobación, el usuario deberá confirmar o rechazar dicha aprobación (Ver la sección Servicios para aprobación más abajo).

Por tanto, el ciclo de vida de este flujo se resumen en los siguientes pasos:

• se recibe nuevo mensaje,
• se envía el enlace por correo electrónico,
• se firma la petición desde la aplicación móvil,
• si la petición requiere aprobación, desde el backend o el backoffice integrado se confirma o rechaza la aprobación,
• si la petición no requiere ninguna aprobación, el flujo finaliza.

Mensaje de Ejemplo

nota: puedes parametrizar el siguiente JSON de ejemplo y usarlo tal y como se explica en el capítulo 2 "Testing" a través de la UI habilitada en el backend de viafirma documents.

{
  "notification" : {
    "text" : "Firma biométricas simple con check en backend",
    "detail" : "Check en backend requerido",
    "sharedLink" : {
      "appCode" : "com.viafirma.ventamovil",
      "email" : "[email protected]"
    }
  },
  "document" : {
    "templateCode" : "329_example",
    "items" : [ {
      "key" : "KEY_01",
      "value" : "Test value"
    }, {
      "key" : "KEY_02",
      "value" : "Test value"
    }, {
      "key" : "KEY_03",
      "value" : "Test value"
    }, {
      "key" : "KEY_04",
      "value" : "Test value"
    } ]
  },
  "policies": [
      {
        "evidences": [
          {
            "type": "SIGNATURE",
            "helpText": "Firma del usuario",
            "typeFormatSign": "XADES_B"
          }
        ],
        "signatures": [
          {
            "type": "SERVER",
            "helpText": "Firma del servicio",
            "typeFormatSign": "PADES_B"
          }
        ],
        "checklist": [
          {
            "helpText": "Requiere aprobación del responsable",
            "validateCode": "12345",
            "signature": {
                "type": "SERVER",
                "helpText": "Firma del servicio",
                "typeFormatSign": "PADES_B"
            }
          }
        ]
      }
    ]
}

Mensaje de Ejemplo con OTP SMS

{
  "workflow": {
    "code": "EX006"
  },
  "notification": {
    "text": "Firma con OTP SMS",
    "detail": "Solicitud de firma mediante SMS",
    "sharedLink": {
      "appCode": "com.viafirma.documents",
      "email": "[email protected]"
    }
  },
  "document": {
    "templateCode": "350_example",
    "items": [
      {
        "key": "KEY_01",
        "value": "Test value"
      },
      {
        "key": "KEY_02",
        "value": "Test value"
      },
      {
        "key": "KEY_03",
        "value": "Test value"
      },
      {
        "key": "KEY_04",
        "value": "Test value"
      }
    ]
  },
  "policies": [
    {
      "evidences": [
        {
          "type": "OTP_SMS",
          "helpText": "SMS del usuario",
          "phone": "+34666554433",
          "typeFormatSign": "XADES_B",
          "positions": [
            {
              "rectangle": {
                "x": 535,
                "y": 10,
                "width": 50,
                "height": 50
              },
              "page": 1
            }
          ]
        }
      ],
      "signatures": [
        {
          "type": "SERVER",
          "helpText": "Documento certificado por viafirma documents (servicios de confianza)",
          "typeFormatSign": "PADES_LT",
          "stampers": [
            {
              "type": "TEXT",
              "xAxis": 565,
              "yAxis": 250,
              "rotation": "ROTATE_270",
              "page": 1
            }
          ]
        }
      ]
    }
  ],
  "callbackMails": "[email protected]"
}

Servicios para aprobación

Los servicios para confirmar o rechazar una aprobación son públicos, de forma que son accesibles desde la aplicación con usuario logado, en la parte de documentación de los servicios REST, introduciendo la clave public-key.

Confirmar

Para confirmar la aprobación, será necesario indicar el código de mensaje, así como el código de la aprobación. Además, se podrá requerir un código de validación configurable desde la política de la petición.

Rechazar

Para rechazar la aprobación, será necesario indicar el código de mensaje, así como el código de la aprobación. De forma opcional, el usuario podrá indicar un comentario con el motivo de rechazo. Además, se podrá requerir un código de validación, configurable desde la política de la petición.