Wie kann ich ein Dokument zur Unterschrift schicken?

Dieser Artikel führt Sie durch den Prozess des Versands eines Dokuments zur Unterschrift mit der eSignature API.

Nach diesen Schritten erstellen Sie einen Umschlag, fügen ein Dokument hinzu, setzen einen Empfänger ein, fügen eine Signaturnotiz ein und senden schließlich den Umschlag für die Unterschrift.

Voraussetzungen

• Ein Sign.Plus-Konto mit einem API-Plan
• Ihr Persönliches Zugangs-Token

Schritt 1: Einen Umschlag erstellen

Ein Umschlag ist ein Container für Dokumente, die von den Empfängern unterzeichnet werden müssen.

1. Senden Sie eine Anfrage an den Endpunkt POST /v2/envelope um einen neuen Umschlag zu erstellen. {
"name": "Mein wunderbarer Umschlag",
"flow_type": "REQUEST_SIGNATURE",
"legality_level": "SES",
"expires_at": 1831280113,
"sandbox": true
}
2. Fügen Sie Ihren API-Schlüssel in den Autorisierungs- Header ein.

3. Bei Erfolg erhalten Sie ein Umschlag Objekt.

   { "id": "<string>" ... }

4. id als Umschlag_id speichern

Schritt 2: Füge ein Dokument zu deinem Umschlag hinzu

1. Verwenden Sie den POST /v2/envelope/{envelope_id}/document Endpunkt, um ein Dokument hinzuzufügen.

2. Ersetzen Sie {envelope_id} durch die ID, die Sie in Schritt 1 erhalten haben.

3. Senden Sie eine POST-Anfrage mit der Dokumentdatei im Anfragetext als Multipart/Formulardaten.

4. Bei Erfolg erhalten Sie ein Dokument Objekt als Antwort.
   { "id": "<string>" ... }

5. Speichern Sie die id als document_id für später.

Schritt 3: Setze einen Empfänger für deinen Umschlag

1. Verwenden Sie den POST /v2/envelope/{envelope_id}/signing_steps Endpunkt, um einen Empfänger hinzuzufügen.

2. Ersetzen Sie {envelope_id} durch Ihre Umschlag-ID.

3. Senden Sie eine POST Anfrage mit folgendem JSON Körper:

   {
"signing_steps": [
{
"Empfänger": [
{
"name": "John Doe", "email": "john. oe@Beispiel. om", "Rolle": "SIGNER"
} ] } ] }

4. Bei Erfolg erhalten Sie ein Array von SigninStep.

5. Durchsuchen Sie das Array und nehmen Sie die id Name des Empfängers, für den Sie den Signaturrahmen hinzufügen möchten (Signatur-Anmerkung). Speichern Sie diese id als recipient_id.

Schritt 4: Fügen Sie eine Signaturnotiz in Ihr Dokument ein

Bevor Sie eine Signaturnotiz hinzufügen, stellen Sie sicher, dass Sie Ihre Signatur in der Sign.Plus Plattform definiert haben.

1. Verwenden Sie den POST /v2/envelope/{envelope_id}/annotation Endpunkt, um eine Signaturnotiz hinzuzufügen.
2. Ersetzen Sie {envelope_id} durch Ihre Umschlag-ID. 
3. Senden Sie eine POST Anfrage mit folgendem JSON body:
   {
"recipient_id": "<recipient_id>",
"document_id": "<document_id>",
"page": 1,
"x": 50,
"y": 20,
"width": 20,
"height": 60,
"required": true,
"type": "SIGNATURE",
}

   Ersetzen Sie <recipient_id> und <document_id>durch die entsprechenden Werte.

Schritt 5: Sende deinen 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.
3. Senden Sie eine POSTAnfrage an diesen Endpunkt.
4. Bei Erfolg wird der Umschlag zur Unterschrift an den Empfänger gesendet.
   
   

Schlussfolgerung

Sie haben nun erfolgreich ein Dokument zur Unterschrift mit der Sign.Plus eSignature API gesendet. Der Empfänger erhält eine E-Mail-Benachrichtigung mit einem Link zum Unterschreiben des Dokuments.

Für genauere Informationen zu jedem API-Endpunkt, der in diesem Prozess verwendet wird, lesen Sie bitte unsere -API-Dokumentation.