# Firma Digital v2

### Tipo de widget

En el esquema se representa como

> "widget\_type": "SIGNATURES\_FIELD\_V2"

{% hint style="success" %}
Este widget es la versión mejorada de [Firma Digital](/modulos/formularios-digitales/tipos-de-widgets/firma-digital-deprecado.md), que ha sido deprecado
{% endhint %}

### 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.

```json
{
    ...
    "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.

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

#### Ejemplo 3

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

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

{% hint style="info" %} <mark style="color:blue;">**IMPORTANTE:**</mark>

Las urls recibidas son <mark style="color:blue;">links temporales</mark>, 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.&#x20;

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.
{% endhint %}

{% hint style="danger" %} <mark style="color:red;">**Consideración Importante al utilizar webhooks**</mark>

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)&#x20;

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.
{% endhint %}

### 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

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.api.persat.com.ar/modulos/formularios-digitales/tipos-de-widgets/firma-digital-v2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.