Wie sendet man ein Dokument von einer existierenden Vorlage?

Wer kann diese Funktion nutzen?

Verfügbar auf allen Entwickler-APIPläne.

Alle Mitglieder

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

Schritt 1: Erstellen Sie einen Umschlag aus einer Vorlage

  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}mit der ID Ihrer bestehenden Vorlage.
    Wo finde ich meine Vorlagenkennung?
  3. Sende eine POST-Anfrage an POST /v2/envelope/from_template/{template_id} mit folgendem JSON-Body:
    {
    "name": "Mein wunderbarer Umschlag aus dem Vorlage"
    }
  4. Fügen Sie Ihren API-Schlüssel in den Autorisierungs- Header ein.
  5. Bei Erfolg erhalten Sie ein UmschlagObjekt. {
    "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": {
    // ...
    }
    }
  6. Speichern Sie die zurückgegebene id als envelope_id für zukünftige API-Aufrufe.
  7. Erfassen Sie die ideines jeden Empfängers zur späteren Verwendung im Signaturprozess.
    Beispiele:
    • 66eb7d0467d2d549b89fcb71: First SIGNER(Schritt 1)
    • 66eb7d0467d2d549b89fcb71: REZEIVES_A_COPY(Schritt 1)
    • 66eb7d0467d2d549b89fcb72: Zweite SIGNER(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:

  1. Verwenden Sie die POST /v2/envelope/{envelope_id}/signing_steps Endpunkt, um 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. 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"
    }
    ]
    }
    ]
    }
  4. Bei Erfolg erhalten Sie ein Array von SigningStepObjekt.

Schritt 3: Senden Sie Ihren Umschlag für die Unterschrift

  1. Benutzen Sie den POST /v2/envelope/{envelope_id}/senden Endpunkt, 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 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.

War dieser Beitrag hilfreich?
0 von 0 fanden dies hilfreich
More Articles in this section