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 Sign.Plus eSignature API.

Seguendo questi passaggi, potrai creare una busta da un modello, impostare i dettagli del destinatario e inviare la busta per la firma.

Prerequisiti

• Un account Sign.Plus con un piano API
• Il Tuo Token Di Accesso Personale
• Un modello esistente nel tuo account Sign.Plus 

Passo 1: Crea una busta da un modello

1. Usa l'endpoint POST /v2/envelope/from_template/{template_id} per creare una nuova busta 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.
     
   • Fare 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": "La mia meravigliosa busta dal modello"
}
4. Includi la tua chiave API nell'intestazione Authorization.
5. Al successo, riceverai un oggetto Envelope. {
"id": "66eb7d0467d2d549b89fcb6d",
// ...
"signing_steps": [
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb70",
"uid": null,
"nome": "",
"email": "",
"ruolo": "SIGNER",
"verifica": null
}
]
},
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb71",
"uid": null,
"nome": "",
"email": "",
"ruolo": "RECEIVES_COPY",
"verifica": null
},
{
"id": "66eb7d0467d2d549b89fcb72",
"uid": null,
"nome": "",
"email": "",
"ruolo": "SIGNER",
"verifica": null
}
]
}
],
"documenti": [
// . .
],
"notification": {
// ...
}
}
6. Salva l' id restituito come envelope_id per le future chiamate API.
7. Registra l'ID di ogni destinatario per un uso successivo nel processo di firma.
   Esempi:
   • 66eb7d0467d2d549b89fcb71: First SIGNER(Step 1)
   • 66eb7d0467d2d549b89fcb71: RECEIVES_A_COPY(Fase 1)
   • 66eb7d0467d2d549b89fcb72: Second SIGNER(fase 2)

Passo 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 che hai ricevuto nel passaggio 1.
3. Invia una richiesta POST con il seguente corpo JSON:
   {
"signing_steps": [
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb70",
"nome": "John Doe",
"email": "john. oe@esempio. om",
"ruolo": "SIGNER"
}
]
},
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb71",
"nome": "Mark Twain",
"email": "m. wain@esempio. om",
"ruolo": "RECEIVES_COPY"
},
{
"id": "66eb7d0467d2d549b89fcb72",
"nome": "Jane Smith",
"email": "j. mith@esempio. om",
"ruolo": "SIGNER"
}
]
}
]
}
4. Al successo, riceverai una serie di oggetti SigningStep.

Passo 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 Passo 1.
3. Invia una richiesta POST a questo endpoint.
4. Al successo, la busta sarà inviata al destinatario o ai destinatari per la firma.

Conclusione

Ora hai inviato con successo un documento per la firma utilizzando un modello con l'API Sign.Plus eSignature. I destinatari riceveranno una notifica via email con un link per firmare il documento.

Utilizzando i modelli puoi semplificare in modo significativo il flusso di lavoro per la firma dei documenti, specialmente per i documenti di uso frequente con layout coerenti e requisiti di firma.