Firma di Persona

La firma di persona (in-person signing) permette a un operatore (host) di ospitare la sessione di firma sul proprio dispositivo. Il firmatario si reca fisicamente dall'operatore e appone la firma sul suo computer, tablet o dispositivo mobile.

Quando Usarla

• Sportelli: banche, uffici postali, sportelli PA dove il cliente firma di persona
• Vendita in negozio: contratti firmati dal cliente al punto vendita
• Visite mediche: consensi informati firmati dal paziente nello studio
• Uffici: documenti interni firmati di persona durante una riunione

Come Funziona

1. L'operatore (host) avvia la pratica specificando se stesso come host
2. Il firmatario si presenta fisicamente dall'operatore
3. L'operatore apre la pratica sul proprio dispositivo
4. Il firmatario appone la firma sul dispositivo dell'operatore
5. La pratica prosegue con gli eventuali altri firmatari

---

Configurazione via API

Per abilitare la firma di persona, specificare il campo hostUsername nel firmatario:

{
  "documents": [
    { "filename": "consenso.pdf", "base64content": "..." }
  ],
  "name": "Consenso informato - Firma di persona",
  "sendNotifications": false,
  "signers": [
    {
      "email": "[email protected]",
      "firstName": "Mario",
      "lastName": "Rossi",
      "action": "S",
      "hostUsername": "operatore.sportello1",
      "signatureCoordinates": [
        {
          "document": 0,
          "page": 1,
          "signatureType": "S",
          "positionX": 0.5,
          "positionY": 0.8,
          "width": 0.25,
          "height": 0.08
        }
      ]
    }
  ]
}

Parametri del firmatario

Campo	Tipo	Descrizione
hostUsername	string	Username dell'utente Askme Sign che ospita la sessione di firma. L'operatore deve essere un utente attivo nel sistema.

Requisiti

• L'utente host deve essere attivo e abilitato nel sistema
• L'host deve appartenere allo stesso tenant della pratica
• L'host deve avere i permessi necessari (es. DOC_SIGN)
• La funzionalità deve essere abilitata nella configurazione del tenant (signInPersonEnabled)

Notifiche

In genere per la firma di persona si imposta sendNotifications: false a livello di pratica o di singolo firmatario, poiché il firmatario è già presente fisicamente e non necessita di un'email con il link.

---

Flusso Operativo

1. Sistema esterno → POST /api/v2/files/send (con hostUsername)
2. Operatore → apre la pratica dalla propria dashboard
3. Firmatario → appone la firma sul dispositivo dell'operatore
4. Sistema → registra la firma e avanza il workflow
5. Webhook → notifica il sistema esterno del completamento

---

Esempio: Sportello con Più Firmatari

{
  "documents": [
    { "filename": "apertura-conto.pdf", "base64content": "..." }
  ],
  "name": "Apertura conto corrente",
  "sendNotifications": false,
  "signers": [
    {
      "email": "[email protected]",
      "firstName": "Mario",
      "lastName": "Rossi",
      "action": "E",
      "hostUsername": "sportello.bancario.1",
      "signatureCoordinates": [
        { "document": 0, "page": 2, "signatureType": "E", "positionX": 0.1, "positionY": 0.7, "width": 0.2, "height": 0.08 }
      ]
    },
    {
      "email": "[email protected]",
      "firstName": "Luigi",
      "lastName": "Verdi",
      "action": "P",
      "signatureCoordinates": [
        { "document": 0, "page": 2, "signatureType": "P", "positionX": 0.6, "positionY": 0.7, "width": 0.2, "height": 0.08 }
      ]
    }
  ]
}

In questo esempio:

• Il cliente firma di persona allo sportello (FES con host)
• Il direttore appone il visto (P) successivamente dalla propria postazione