Come inviare un documento da un modello esistente?

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

Seguendo questi passaggi, creerai una busta da un modello, imposterai i dettagli del destinatario e invierai la busta per la firma.

Prerequisiti

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

Passaggio 1: Crea una busta da un modello

1. Usa l'endpoint POST /v2/envelope/from_template/{template_id} per creare una nuova busta a partire da un modello.
2. Sostituisci {template_id} con l'ID del tuo modello esistente.
   Dove posso trovare l'ID del mio modello?
   • Vai su https://app.sign.plus/templates .
     
   • Fai clic sul nome del modello desiderato.
     
   • Copia l'ID dalla barra laterale destra.
3. Invia una richiesta POST a POST /v2/envelope/from_template/{template_id} con il seguente corpo JSON:
   {
"name": "My wonderful envelope from template"
}
4. Includi la tua chiave API nell'intestazione Authorization.
5. In caso di successo, riceverai un oggetto Envelope. {
"id": "66eb7d0467d2d549b89fcb6d",
// ...
"signing_steps": [
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb70",
"uid": null,
"name": "",
"email": "",
"role": "SIGNER",
"verification": null
}
]
},
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb71",
"uid": null,
"name": "",
"email": "",
"role": "RECEIVES_COPY",
"verification": null
},
{
"id": "66eb7d0467d2d549b89fcb72",
"uid": null,
"name": "",
"email": "",
"role": "SIGNER",
"verification": null
}
]
}
],
"documents": [
// ...
],
"notification": {
// ...
}
}
6. Salva l'id restituito come envelope_id per le future chiamate API.
7. Registra l'iddi ciascun destinatario per usarlo successivamente nel processo di firma.
   Esempi:
   • 66eb7d0467d2d549b89fcb71: Primo SIGNER (Passaggio 1)
   • 66eb7d0467d2d549b89fcb71: RECEIVES_A_COPY (Passaggio 1)
   • 66eb7d0467d2d549b89fcb72: Secondo SIGNER (Passaggio 2)

Passaggio 2: Imposta i dettagli del destinatario

Se il tuo modello non ha destinatari fissi e devi impostare o aggiornare i dettagli del destinatario:

1. Usa l'endpoint POST /v2/envelope/{envelope_id}/signing_steps per aggiornare le informazioni del destinatario.
2. Sostituisci {envelope_id} con l'ID ricevuto nel Passaggio 1.
3. Invia una richiesta POST con il seguente corpo JSON:
   {
"signing_steps": [
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb70",
"name": "John Doe",
"email": "john.doe@example.com",
"role": "SIGNER"
}
]
},
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb71",
"name": "Mark Twain",
"email": "m.twain@example.com",
"role": "RECEIVES_COPY"
},
{
"id": "66eb7d0467d2d549b89fcb72",
"name": "Jane Smith",
"email": "j.smith@example.com",
"role": "SIGNER"
}
]
}
]
}
4. In caso di successo, riceverai un array di oggetti SigningStep.

Passaggio 3: 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 dal Passaggio 1.
3. Invia una richiesta POST a questo endpoint.
4. In caso di successo, la busta verrà inviata al/ai destinatario/i per la firma.

Conclusione

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

L'utilizzo dei modelli può semplificare notevolmente il flusso di lavoro di firma dei documenti, specialmente per i documenti utilizzati di frequente con layout e requisiti di firma coerenti.