Come inviare un documento per la firma?

Questo articolo ti guiderà attraverso il processo di invio di un documento per la firma utilizzando l'API eSignature di Sign.Plus.

Seguendo questi passaggi, creerai una busta, aggiungerai un documento, imposterai un destinatario, inserirai un'annotazione di firma e infine invierai la busta per la firma.

Prerequisiti

• Un account Sign.Plus con un piano API
• Il tuo Personal Access Token

Passaggio 1: crea una busta

Una busta è un contenitore per i documenti da firmare da parte dei destinatari.

1. Invia una richiesta all'endpoint POST /v2/envelope per creare una nuova busta. {
"name": "La mia fantastica busta",
"flow_type": "REQUEST_SIGNATURE",
"legality_level": "SES",
"expires_at": 1831280113,
"sandbox": true
}
2. Includi la tua chiave API nell'header Authorization .

3. In caso di successo, riceverai un oggetto Envelope.

   { "id": "<string>" ... }

4. Salva l'id come envelope_id

Passaggio 2: aggiungi un documento alla tua busta

1. Usa l'endpoint POST /v2/envelope/{envelope_id}/document per aggiungere un documento.

2. Sostituisci {envelope_id} con l'ID ricevuto nel Passaggio 1.

3. Invia una richiesta POST con il file del documento nel corpo della richiesta come multipart/form-data.

4. Se l'operazione riesce, riceverai un oggetto Document come risposta.
   { "id": "<string>" ... }

5. Salva id come document_id per usarlo in seguito.

Passaggio 3: imposta un destinatario per la tua busta

1. Utilizza l'endpoint POST /v2/envelope/{envelope_id}/signing_steps per aggiungere un destinatario.

2. Sostituisci {envelope_id} con l'ID della tua busta.

3. Invia una richiesta POST con il seguente corpo JSON:

   {
"signing_steps": [
{
"recipients": [
{
"name": "John Doe", "email": "john.doe@example.com", "role": "SIGNER"
} ] } ] }

4. In caso di successo, riceverai un array di SigninStep.

5. Scorri l'array e prendi il nome id del destinatario per il quale vuoi aggiungere il riquadro della firma (annotazione di firma). Salva questo id come recipient_id.

Passaggio 4: inserisci un'annotazione di firma nel tuo documento

Prima di aggiungere un'annotazione di firma, assicurati di aver definito la tua firma sulla piattaforma Sign.Plus.

1. Usa l'endpoint POST /v2/envelope/{envelope_id}/annotation per aggiungere un'annotazione di firma.
2. Sostituisci {envelope_id} con l'ID della tua busta. 
3. Invia una richiesta POST con il seguente corpo JSON:
   {
"recipient_id": "<recipient_id>",
"document_id": "<document_id>",
"page": 1,
"x": 50,
"y": 20,
"width": 20,
"height": 60,
"required": true,
"type": "SIGNATURE",
}

   Sostituisci <recipient_id> e <document_id>con i valori appropriati.

Passaggio 5: invia la tua busta per la firma

1. Usa l'endpoint POST /v2/envelope/{envelope_id}/send per inviare la busta.
2. Sostituisci {envelope_id} con l'ID della tua busta.
3. Invia una richiesta POSTa questo endpoint.
4. In caso di successo, la busta verrà inviata al destinatario per la firma.
   
   

Conclusione

Hai ora inviato con successo un documento per la firma utilizzando l'API eSignature di Sign.Plus. Il destinatario riceverà una notifica via email con un link per firmare il documento.

Per informazioni più dettagliate su ciascun endpoint API utilizzato in questo processo, consulta la nostra documentazione API.