Desarrollador de signos OneSpan: anular la firma del remitente de la cuenta

Duo Liang, 22 de Agosto de 2018

En el blog anterior " Subir firma para su firmante ", Exploramos cómo funciona la firma capturada en OneSpan Sign y cómo cargar una firma para sus firmantes si su aplicación está integrada y utiliza una firma personalizada desde un panel de firma. Hoy, profundizaremos y discutiremos dos escenarios de excepción que puede encontrar al cargar una firma a los remitentes a los que no tiene acceso, y no puede modificar su firma de perfil de remitente.

Anular la firma del remitente de la cuenta

Al crear un paquete con la firma del firmante cargada, agregaría un valor dibujado a mano en el bloque "firma" en su carga útil de solicitud directamente. Sin embargo, esta práctica solo funciona para los firmantes cuyo correo electrónico no se ha registrado como una cuenta en OneSpan Sign. Si hace lo mismo con un remitente de la cuenta, OneSpan Sign reconocerá al remitente e ignorará su firma cargada. Para anular la firma registrada de un remitente, deberá realizar un par de pasos adicionales. Este blog le mostrará los detalles de ese proceso.

1) Cree su paquete y deje el estado como "BORRADOR".

2) Actualice la firma de su firmante

Primero, llame a la API " GET / api / packages / {packageID} / roles / {roleID} "Para tomar todo el rol JSON.

Luego, reemplace el valor dibujado a mano con la nueva firma.

Luego, llame a " PUT / api / packages / {packageID} / roles / {roleID} "Para permitir que el cambio surta efecto.

3) Envía tu paquete.
La primera vez que cree un firmante, OneSpan Sign reconocerá al remitente e inyectará automáticamente la información relacionada con el rol. Esta información del rol incluye la firma dibujada a mano. Con esa firma ya adjunta al firmante, OneSpan Sign ignora su firma cargada y por defecto es la firma que ya tiene en el archivo. A través de estos tres pasos mencionados anteriormente, actualiza el firmante manualmente y OneSpan Sign no volverá a coincidir con el firmante. Por lo tanto, la modificación es válida.

Nota:

Este proceso en realidad no modificará la firma original y solo funcionará esta vez.
Puede anular la firma de cualquier cuenta, incluida su propia cuenta.

Subir firma para un notario

Si bien el proceso anterior funcionará en la mayoría de las situaciones, hay pasos especiales que debe seguir para cargar una firma cuando exista un notario.

Paso 1

Cree un paquete notariado sin asignar el notaryRoleID y déjelo en estado "DRAFT". Con la API, reemplace la información del rol de notario con la suya propia:

POST / api / paquetes
Autorización: apikey básico
Aceptar: aplicación / json
Tipo de contenido: multipart / form-data
Solicitar carga útil:
{
   "roles": [
      {
         "id": "role1",
         "type": "SIGNER",
         "índice": 0,
         "firmantes": [
            {
               "email": "su correo electrónico notarial",
               "firstName": "notary.firstname",
               "lastName": "notary.lastname"
            }
         ],
         "nombre": "Firmante1"
      },
      {
         "id": "role2",
         "type": "SIGNER",
         "índice": 0,
         "firmantes": [
            {
               "id": "role2",
               "correo electrónico": "firmante1 @mailinator .com ",
               "firstName": "1.firstname",
               "lastName": "1.lastname"
            }
         ],
         "nombre": "Signer2"
      }
   ],
   "status": "BORRADOR",
   "documentos":[
      ......
   ],
   "notariado": verdadero,
   "notaryRoleId": nulo,
   "type": "PAQUETE",
   "nombre": "prueba de firma de carga para notario"
}

Paso 2

Actualización de firma para notario:
(1) Utilizar GET / api / packages / {packageID} / roles / {notaryRoleID} y copie todo el cuerpo de respuesta
(2) Notario de actualización:

PUT / api / packages / {packageID} / roles / {notaryRoleID}
Autorización: apikey básico
Aceptar: aplicación / json
Tipo de contenido: aplicación / json
Solicitar carga útil:
{
   ...
    "firmantes": [
        {
          ...
            "firma": {
                "textual": nulo,
                "handdrawn": "su valor handdrawn"
              },
          ...
        }
],
"Nombre": "Firmante1"
}

Pegará el cuerpo de respuesta en su carga útil y reemplazará el valor dibujado a mano con el suyo.

Paso 3

Asigne notaryRoleID en el nivel del paquete:

PUT / api / packages / {packageID}
Autorización: apikey básico
Aceptar: aplicación / json
Tipo de contenido: aplicación / json
Solicitar carga útil:
{
"notaryRoleId": "su identificación de notario"
}

Paso 4

Envía el paquete:

PUT / api / packages / {packageID}
Autorización: apikey básico
Aceptar: aplicación / json
Tipo de contenido: aplicación / json
Solicitar carga útil:
{
"estado": "ENVIADO"
}

Nota:

Los pasos 3 y 4 deben realizarse a través de dos llamadas API separadas.

El punto principal detrás de estos cuatro pasos es que si sigue el proceso que hicimos en la primera sección, recibirá un error que dice "no puede editar un notario". Pero, si no asigna un notario hasta que actualice su valor dibujado a mano, puede evitar este error y todo funciona como se espera.

Si tiene acceso a sus remitentes y notarios, es mejor actualizar la firma de su perfil de remitente, y siempre se recomienda probar todo el proceso en Postman antes de implementarlo en el código.

Si tiene alguna pregunta sobre este blog o cualquier otra cosa relacionada con la integración de OneSpan Sign en su aplicación, visite el Foros de la comunidad de desarrolladores . ¡Sus comentarios nos importan!

función avanzada de firma electrónica

Duo Liang

OneSpan Blog