Dieser Artikel führt Sie durch den Prozess des Versands eines Dokuments zur Unterschrift mit Hilfe einer Vorlage mit der eSignature API.
Wenn Sie diesen Schritten folgen, erstellen Sie einen Umschlag aus einer Vorlage, setzen Sie die Empfängerdaten und senden Sie den Umschlag zur Unterschrift.
Voraussetzungen
- Ein Sign.Plus-Konto mit einem API-Plan
- Ihr
Persönliches Zugangs-Token
- Eine vorhandene Vorlage in Ihrem Sign.Plus-Konto
Schritt 1: Erstellen Sie einen Umschlag aus einer Vorlage
- Verwenden Sie den POST /v2/envelope/from_template/{template_id} Endpunkt, um einen neuen Umschlag aus einer Vorlage zu erstellen.
- Ersetzen Sie
{template_id}
mit der ID Ihrer bestehenden Vorlage.
Wo finde ich meine Vorlagenkennung?- Gehe zu https://app.sign.plus/templates.
- Klicken Sie auf den Namen der gewünschten Vorlage.
- Kopieren Sie die ID aus der rechten Seitenleiste.
- Gehe zu https://app.sign.plus/templates.
- Sende eine POST-Anfrage an
POST /v2/envelope/from_template/{template_id}
mit folgendem JSON-Body:{
"name": "Mein wunderbarer Umschlag aus dem Vorlage"
} - Fügen Sie Ihren API-Schlüssel in den
Autorisierungs-
Header ein. - Bei Erfolg erhalten Sie ein
Umschlag
Objekt.{
"id": "66eb7d0467d2d549b89fcb6d",
// ...
"signing_steps": [
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb70",
"uid": null,
"name": "",
"email": "",
"Rolle": "SIGNER",
"Überprüfung: null
}
]
},
{
"Empfänger": [
{
"id": "66eb7d0467d2d549b89fcb71",
"uid": null,
"name": "",
"email": "",
"Rolle": "REZEIVES_COPY",
"Überprüfung": null
},
{
"id": "66eb7d0467d2d549b89fcb72",
"uid": null,
"name": "",
"email": "",
"Rolle": "SIGNER",
"Überprüfung: null
}
]
}
],
"documents": [
// . .
],
"notification": {
// ...
}
} - Speichern Sie die zurückgegebene
id
alsenvelope_id
für zukünftige API-Aufrufe. - Erfassen Sie die
id
eines jeden Empfängers zur späteren Verwendung im Signaturprozess.
Beispiele:-
66eb7d0467d2d549b89fcb71
: FirstSIGNER
(Schritt 1) -
66eb7d0467d2d549b89fcb71
:REZEIVES_A_COPY
(Schritt 1) -
66eb7d0467d2d549b89fcb72
: ZweiteSIGNER
(Schritt 2)
-
Schritt 2: Empfängerdetails festlegen
Wenn Ihre Vorlage keine festen Empfänger hat und Sie die Empfängerdaten festlegen oder aktualisieren müssen:
- Verwenden Sie die POST /v2/envelope/{envelope_id}/signing_steps Endpunkt, um Empfängerinformationen zu aktualisieren.
- Ersetzen Sie
{envelope_id}
durch die ID, die Sie in Schritt 1 erhalten haben. - Senden Sie eine
POST
Anfrage mit folgendem JSON-Body:{
"signing_steps": [
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb70",
"Name": "John Doe",
"email": "john. oe@Beispiel. om",
"Rolle": "SIGNER"
}
]
},
{
"Empfänger": [
{
"id": "66eb7d0467d2d549b89fcb71",
"Name": "Markiere Twain",
"email": "m. wain@example om",
"Rolle": "REZEIVES_COPY"
},
{
"id": "66eb7d0467d2d549b89fcb72",
"name": "Jane Smith",
"email": "j. mith@example om",
"role": "SIGNER"
}
]
}
]
} - Bei Erfolg erhalten Sie ein Array von
SigningStep
Objekt.
Schritt 3: Senden Sie Ihren Umschlag für die Unterschrift
- Benutzen Sie den POST /v2/envelope/{envelope_id}/senden Endpunkt, um den Umschlag zu senden.
- Ersetzen Sie
{envelope_id}
durch Ihre Umschlag-ID aus Schritt 1. - Senden Sie eine
POST
Anfrage an diesen Endpunkt. - Bei Erfolg wird der Umschlag an die Empfänger(n) zur Unterschrift geschickt.
Schlussfolgerung
Sie haben nun erfolgreich ein Dokument zur Unterschrift mit Hilfe der Sign.Plus eSignature API gesendet. Der Empfänger(n) erhält eine E-Mail-Benachrichtigung mit einem Link zum Unterschreiben des Dokuments.
Mit Hilfe von Vorlagen können Sie den Workflow zur Dokumentensignierung erheblich rationalisieren, insbesondere für häufig verwendete Dokumente mit konsistenten Layouts und Signaturanforderungen.