Wie senden Sie ein Dokument aus einer vorhandenen Vorlage?

Dieser Artikel führt Sie durch den Prozess des Sendens eines Dokuments zur Signatur mithilfe einer Vorlage mit der Sign.Plus-eSignature-API.

Mit den folgenden Schritten erstellen Sie einen Umschlag aus einer Vorlage, legen die Empfängerdetails fest und senden den Umschlag zur Signatur.

Voraussetzungen

• Ein Sign.Plus-Konto mit einem API-Tarif
• Ihr Personal Access Token
• Eine vorhandene Vorlage in Ihrem Sign.Plus-Konto 

Schritt 1: Einen Umschlag aus einer Vorlage erstellen

1. Verwenden Sie den POST /v2/envelope/from_template/{template_id}-Endpunkt, um einen neuen Umschlag aus einer Vorlage zu erstellen.
2. Ersetzen Sie {template_id} durch die ID Ihrer vorhandenen Vorlage.
   Wo finden Sie Ihre Vorlagen-ID?
   • Gehen Sie zu https://app.sign.plus/templates .
     
   • Klicken Sie auf den gewünschten Vorlagennamen.
     
   • Kopieren Sie die ID aus der rechten Seitenleiste.
3. Senden Sie eine POST-Anfrage an POST /v2/envelope/from_template/{template_id} mit dem folgenden JSON-Body:
   {
"name": "My wonderful envelope from template"
}
4. Fügen Sie Ihren API-Schlüssel im Authorization-Header ein.
5. Bei Erfolg erhalten Sie ein Envelope-Objekt. {
"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. Speichern Sie die zurückgegebene id als envelope_id für zukünftige API-Aufrufe.
7. Notieren Sie sich die id jedes Empfängers zur späteren Verwendung im Signaturvorgang.
   Beispiele:
   • 66eb7d0467d2d549b89fcb71: Erster SIGNER (Schritt 1)
   • 66eb7d0467d2d549b89fcb71: RECEIVES_A_COPY (Schritt 1)
   • 66eb7d0467d2d549b89fcb72: Zweiter SIGNER (Schritt 2)

Schritt 2: Empfängerdetails festlegen

Wenn Ihre Vorlage keine festen Empfänger hat und Sie Empfängerdetails festlegen oder aktualisieren müssen:

1. Verwenden Sie den Endpunkt POST /v2/envelope/{envelope_id}/signing_steps, um die Empfängerinformationen zu aktualisieren.
2. Ersetzen Sie {envelope_id} durch die ID, die Sie in Schritt 1 erhalten haben.
3. Senden Sie eine POST-Anfrage mit folgendem JSON-Body:
   {
"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. Bei Erfolg erhalten Sie ein Array von SigningStep-Objekten.

Schritt 3: Ihren Umschlag zur Signatur senden

1. Verwenden Sie den Endpunkt POST /v2/envelope/{envelope_id}/send, um den Umschlag zu senden.
2. Ersetzen Sie {envelope_id} durch Ihre Umschlag-ID aus Schritt 1.
3. Senden Sie eine POST-Anfrage an diesen Endpunkt.
4. Bei Erfolg wird der Umschlag an den/die Empfänger zur Signatur gesendet.

Fazit

Sie haben nun erfolgreich ein Dokument mithilfe einer Vorlage über die Sign.Plus-eSignature-API zur Signatur gesendet. Der/die Empfänger erhalten eine E-Mail-Benachrichtigung mit einem Link zum Signieren des Dokuments.

Die Verwendung von Vorlagen kann Ihren Dokumentensignaturprozess erheblich vereinfachen, besonders bei häufig verwendeten Dokumenten mit einheitlichem Layout und gleichbleibenden Signaturanforderungen.