DevPortalPagoPA

SoluzioniWebinar
Tabella dei contenuti

Creazione di una Signature request

Per creare la "Signature request", ovvero la richiesta di firma, dovrai avere con te:
Se lo desideri, puoi anche indicare la data di scadenza della richiesta di firma, ovvero il tempo massimo concesso all'utente per firmare. Se deciderai di inviare la richiesta di firma tramite messaggio su IO, la data di scadenza sarà presente nel corpo del messaggio che verrà inviato all'utente.
Vuoi inserire dei campi firma diversi rispetto a quelli del dossier?
Nella fase di creazione di una signature request, potresti avere la necessità di avere dei campi firma diversi rispetto a quelli del relativo dossier. Hai pertanto la possibilità di inserire dei metadati specifici per quella signature request, che andranno a sovrascrivere quelli del dossier. documents_metadata è un campo opzionale.
Di seguito, trovi un esempio di chiamata verso l'endpoint: POST /api/v1/sign/signature-requests
Con corpo del messaggio: 
1{
2  "dossier_id": "01GG4NFBCN4ZH8ETCCKX3766KX",
3  "signer_id": "01GG4TG9FP2D3JPWFTAM0WEFTG",
4  "expires_at": "2023-01-01T00:00:00.000Z",
5  "documents_metadata": [
6    {
7      "title": "Firma contratto 150 ore",
8      "signature_fields": [
9        {
10          "attrs": {
11            "coordinates": {
12              "x": 112,
13              "y": 510
14            },
15            "size": {
16              "w": 140,
17              "h": 40
18            },
19            "page": 0
20          },
21          "clause": {
22            "title": "Firma contratto",
23            "type": "REQUIRED"
24          }
25        }
26      ]
27    }
28  ]
29}
30
La risposta sarà la seguente:
1{
2   "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
3   "dossier_id": "01GG4NFBCN4ZH8ETCCKX3766KX",
4   "signer_id": "01GG4TG9FP2D3JPWFTAM0WEFTG",
5   "status": "DRAFT",
6   "created_at": "2022-12-05T00:00:00.000Z",
7   "updated_at": "2022-12-05T00:00:00.000Z",
8   "expires_at": "2023-01-01T00:00:00.000Z",
9   "documents": [
10      {
11         "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
12         "status": "WAIT_FOR_UPLOAD",
13         "metadata": {
14            "title": "Firma contratto 150 ore",
15            "signature_fields": [
16               {
17                  "attrs": {
18                     "coordinates": {
19                        "x": 112,
20                        "y": 510
21                     },
22                     "size": {
23                        "w": 140,
24                        "h": 40
25                     },
26                     "page": 0
27                  },
28                  "clause": {
29                     "title": "Firma contratto",
30                     "type": "REQUIRED"
31                  }
32               }
33            ]
34         },
35         "created_at": "2022-12-05T00:00:00.000Z",
36         "updated_at": "2022-12-05T00:00:00.000Z"
37      }
38   ]
39}
40
All'interno della risposta riceverai la Signature request creata con il relativo signature_request_id associato.
Serve aiuto durante l’integrazione?

Scrivi un’e-mail in cui descrivi il tuo problema o dubbio all’indirizzo firmaconio-tech@pagopa.it

Assistenza continua

Per problemi o dubbi dopo l’integrazione, scrivici all’indirizzo enti-firmaconio@assistenza.pagopa.it