¿Cómo enviar un documento a partir de una plantilla existente?

Este artículo le guiará a través del proceso de envío de un documento para firma utilizando una plantilla con la API de eSignature de Sign.Plus.

Siguiendo estos pasos, creará un sobre a partir de una plantilla, establecerá los detalles del destinatario y enviará el sobre para su firma.

Requisitos previos

• Una cuenta de Sign.Plus con un plan de API
• Su Personal Access Token
• Una plantilla existente en su cuenta de Sign.Plus 

Paso 1: Crear un sobre a partir de una plantilla

1. Utilice el endpoint POST /v2/envelope/from_template/{template_id} para crear un nuevo sobre a partir de una plantilla.
2. Sustituya {template_id} por el ID de su plantilla existente.
   ¿Dónde puedo encontrar el ID de mi plantilla?
   • Vaya a https://app.sign.plus/templates .
     
   • Haga clic en el nombre de la plantilla deseada.
     
   • Copie el ID de la barra lateral derecha.
3. Envíe una solicitud POST a POST /v2/envelope/from_template/{template_id} con el siguiente cuerpo JSON:
   {
"name": "My wonderful envelope from template"
}
4. Incluya su clave de API en el encabezado Authorization.
5. Si la operación se realiza correctamente, recibirá un objeto an 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. Guarde el id devuelto como envelope_id para futuras llamadas a la API.
7. Anote el idde cada destinatario para utilizarlo más adelante en el proceso de firma.
   Ejemplos:
   • 66eb7d0467d2d549b89fcb71: primer SIGNER (Paso 1)
   • 66eb7d0467d2d549b89fcb71: RECEIVES_A_COPY (Paso 1)
   • 66eb7d0467d2d549b89fcb72: segundo SIGNER (Paso 2)

Paso 2: Configurar los datos del destinatario

Si su plantilla no tiene destinatarios fijos y necesita configurar o actualizar los datos del destinatario:

1. Utilice el endpoint POST /v2/envelope/{envelope_id}/signing_steps para actualizar la información del destinatario.
2. Sustituya {envelope_id} con el ID que recibió en el Paso 1.
3. Envíe una solicitud POST con el siguiente cuerpo 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. Si la operación se realiza correctamente, recibirá un array de objetos SigningStep.

Paso 3: Enviar su sobre para la firma

1. Utilice el endpoint POST /v2/envelope/{envelope_id}/send para enviar el sobre.
2. Sustituya {envelope_id} con el ID de su sobre del Paso 1.
3. Envíe una solicitud POST a este endpoint.
4. Si la operación se realiza correctamente, el sobre se enviará al destinatario o destinatarios para su firma.

Conclusión

Ahora ha enviado correctamente un documento para su firma utilizando una plantilla con la API de eSignature de Sign.Plus. El destinatario o destinatarios recibirán una notificación por correo electrónico con un enlace para firmar el documento.

El uso de plantillas puede agilizar significativamente su flujo de trabajo de firma de documentos, especialmente para documentos de uso frecuente con diseños y requisitos de firma coherentes.