Firma Digital v2

Tipo de widget

En el esquema se representa como

"widget_type": "SIGNATURES_FIELD_V2"

Este widget es la versión mejorada de Firma Digital, que ha sido deprecado

Lectura

A la hora de leer este tipo de widget, obtenemos un array de objetos JSON. Este array puede tener como máximo 2 items. Cada uno de los mismos representa una firma junto con su aclaración.

En caso que no se haya firmado, el item será null.

Ejemplo 1

El formulario requiere dos firmas (array de dos items), y una de las mismas (la segunda) no fue firmada.

{
    ...
    "FW9ilaip": [
        {
             "name": "Ernesto Perez",
             "signature_url": "https://persat-form-fil...
        },
        null
    ]
    ...
}

Ejemplo 2

El formulario requiere dos firmas (array de dos items), y no se ha firmado ninguna de las dos.

{
    ...
    "FW9ilaip": [null, null]
    ...
}

Ejemplo 3

El formulario requiere una firma (array de un item), y se ha firmado correctamente.

son{
    ...
    "FW9ilaip": [
        {
             "name": "Ernesto Perez",
             "signature_url": "https://persat-form-fil...
        }
    ]
    ...
}

IMPORTANTE:

Las urls recibidas son links temporales, por lo que si lo que se quiere es persistir la información, se debrá subir a su propio sistema de gestion de archivos (drive, onedrive, dropbox, etc)

La duración del link es de 1 día.

Entonces, por ejemplo. No es recomendable enviar el link en un email, ya que al proximo día la imágen no va a estar disponible. Lo correcto sería generar un PDF en el momento y enviar luego el pdf por email.

Consideración Importante al utilizar webhooks

Una de las funcionalidades más fuerte de la app movil de Persat, es que puede trabajar sin conexión. Es por esto que es importante destacar, que más alla de que se reciban los links de las firmas, las mismas pueden aun no estar disponibles, debido a que el celular no tiene conexión y no pudo enviarlas (tal vez pudo enviar una y no la otra)

Es recomendable agregar un delay de algunos minutos al menos, entre el momento en que se recibe el webhook, y la búsqueda de las imágenes.

Escritura

Cuando insertamos o modificamos un formulario, en el field correspondiente a este widget, únicamente podemos enviar null. Pero tener en cuenta que si el formulairo requiere 2 firmas, entonces habrá que enviar un array con dos items

{
    ...
    "FW9ilaip": [null],
    ...
}

{
    ...
    "FW9ilaip": [null, null],
    ...
}