DocuSign API: Wie aktualisiert man das Ablaufdatum eines laufenden Umschlags?

Das Verwalten von Umschlägen in der DocuSign API verstehen

In der schnelllebigen Welt der digitalen Vereinbarungen ist die Verwaltung von Umschlägen, die sich in Bearbeitung befinden (oder "in der Schwebe"), ein entscheidender Aspekt von elektronischen Signatur-Workflows. Unternehmen stehen oft vor dem Szenario, dass sie die Ablaufdaten von Umschlägen anpassen müssen, sei es aufgrund von Verzögerungen bei der Reaktion der Unterzeichner, verlängerten Verhandlungen oder Änderungen in den Projektzeitplänen. Die API von DocuSign bietet leistungsstarke Werkzeuge, um dies zu erreichen, sodass Entwickler die Compliance und Effizienz aufrechterhalten können, ohne den Prozess zu unterbrechen. Dieser Artikel untersucht, wie man das Ablaufdatum eines Umschlags, der sich in Bearbeitung befindet, mit der DocuSign API aktualisiert, und bietet gleichzeitig eine ausgewogene Perspektive aus geschäftlicher Sicht auf den Markt für elektronische Signaturen, wobei die Auswirkungen und Alternativen diskutiert werden.

Warum das Ablaufdatum in Umschlägen, die sich in Bearbeitung befinden, aktualisieren?

Das Ablaufdatum auf einem DocuSign-Umschlag dient als Sicherheitsvorkehrung, die nicht signierte Dokumente nach einem festgelegten Zeitraum automatisch ungültig macht, um sensible Informationen zu schützen und einen rechtzeitigen Abschluss zu gewährleisten. In der realen Geschäftswelt können starre Fristen jedoch zu unnötigen Ungültigkeiten führen, die ein erneutes Senden erforderlich machen, was den Verwaltungsaufwand und die potenziellen Kosten erhöht. Aus geschäftlicher Sicht hilft die Möglichkeit, diese Daten über die API zu verlängern, die Ressourcenzuweisung zu optimieren, die Gebühren für Umschläge zu reduzieren (ungenutzte Umschläge werden weiterhin auf das Kontingent angerechnet) und die Zufriedenheit der Unterzeichner zu erhöhen – alles entscheidende Faktoren in Branchen mit hohem Volumen wie Immobilien, Personalwesen und Finanzen.

Das Aktualisieren des Ablaufdatums eines Umschlags, der sich in Bearbeitung befindet, ist nicht immer einfach, da DocuSign bei der Entwicklung Sicherheit und Auditierbarkeit priorisiert. Direkte Änderungen an den Kerneigenschaften des Umschlags nach der Erstellung sind eingeschränkt, um Manipulationen zu verhindern. Stattdessen unterstützt die API indirekte Methoden wie Korrektur oder Ungültigmachung und Neukreierung. Dieser Ansatz steht im Einklang mit DocuSigns Fokus auf Compliance, z. B. die Einhaltung des US ESIGN Act und der EU eIDAS-Standards, und stellt sicher, dass Änderungen für die rechtliche Verteidigung protokolliert werden.

Schritt-für-Schritt-Anleitung: Aktualisieren des Ablaufdatums über die DocuSign API

Um dieses Problem zu beheben, verwenden Entwickler typischerweise die DocuSign eSignature REST API (Version 2.1 oder höher), die eine Authentifizierung über OAuth 2.0 (JWT oder Autorisierungscode-Gewährung) erfordert. Angenommen, Sie haben ein Entwicklerkonto mit API-Zugriff; die Preise beginnen bei 600 US-Dollar pro Jahr für den Starter-Plan, der etwa 40 Umschläge pro Monat beinhaltet. Hier ist eine praktische Anleitung:

1. Abrufen des Umschlagstatus

Bestätigen Sie zunächst, dass sich der Umschlag in Bearbeitung befindet (Status: "sent" oder "in progress"). Verwenden Sie den Endpunkt GET /accounts/{accountId}/envelopes/{envelopeId}.

Beispielanfrage (cURL):

curl -X GET "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}" \
-H "Authorization: Bearer {accessToken}" \
-H "Accept: application/json"

Antwort-Snippet:

{
  "status": "sent",
  "expireDateTime": "2025-01-15T12:00:00Z",
  "envelopeId": "abc123"
}

Dies ruft das aktuelle Ablaufdatum ab. Wenn der Status "voided" oder "completed" lautet, kann er nicht aktualisiert werden – der Umschlag muss neu erstellt werden.

2. Korrigieren des Umschlags (bevorzugte Methode für kleinere Änderungen)

Verwenden Sie für Umschläge, die sich in Bearbeitung befinden und an denen noch keine Unterzeichneraktionen vorgenommen wurden, PUT /accounts/{accountId}/envelopes/{envelopeId} in Verbindung mit einer Korrekturanfrage. Obwohl die direkte Bearbeitung einzelner Felder zur Aktualisierung des Ablaufdatums nicht unterstützt wird, können Sie ihn ungültig machen und mit einem neuen Datum erneut senden oder den Timer indirekt mit der Funktion "Korrigieren" zurücksetzen.

Die Korrektur-API von DocuSign ermöglicht die Änderung bestimmter Attribute, wie z. B. des Ablaufdatums, wenn keine Unterschrift erfolgt ist. Bereiten Sie eine Korrektur-Umschlagdefinition vor:

Korrekturanfrage-Body (JSON):

{
  "status": "sent",
  "expireAfter": "30",  // Anzahl der Tage ab jetzt; nach Bedarf anpassen (maximal 999 Tage)
  "expireDateTime": "2025-02-15T12:00:00Z"  // Oder ein absolutes Datum angeben
}

cURL-Beispiel:

curl -X PUT "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/correct" \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d '{
  "clientUserId": "signer1",
  "routingOrder": "1",
  "corrector": {
    "email": "admin@company.com",
    "userId": "{userId}"
  },
  "envelopeDefinition": {
    "expireAfter": "60"
  }
}'

Dadurch wird das Ablaufdatum um 60 Tage verlängert. Hinweis: Für die Korrektur muss der Umschlag korrigierbar sein (keine abgeschlossenen Registerkarten) und kann die Unterzeichner über die Änderungen informieren, wodurch ein Audit-Trail erhalten bleibt.

3. Ungültig machen und erneut senden (für komplexe Aktualisierungen)

Wenn der Umschlag teilweise abgeschlossen ist oder die direkte Bearbeitung blockiert ist, machen Sie ihn zuerst ungültig und erstellen Sie ihn dann mit einem aktualisierten Ablaufdatum neu. Dies ist in Unternehmens-Workflows üblich, um Compliance-Risiken zu vermeiden.

Schritt 3a: Umschlag ungültig machen

curl -X PUT "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}" \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d '{
  "status": "voided",
  "voidedReason": "Extending expiration for ongoing negotiations"
}'

Schritt 3b: Mit neuer Definition erneut senden Erstellen Sie mit POST /accounts/{accountId}/envelopes neu, kopieren Sie die Originaldokumente und -empfänger, legen Sie aber ein neues expireAfter oder expireDateTime fest.

Neuer Umschlag-Anfrage-Body:

{
  "emailSubject": "Updated Agreement",
  "documents": [ /* Original docs */ ],
  "recipients": [ /* Original signers */ ],
  "expireAfter": "90",  // Neues 90-Tage-Ablaufdatum
  "status": "sent"
}

cURL:

curl -X POST "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes" \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d '{ /* Full envelope definition with updated expiration */ }'

4. Best Practices und Einschränkungen

• Kontingente und Kosten: Jede Ungültigmachung/erneute Sendung wird auf Ihr Umschlagslimit angerechnet (ca. 100 pro Benutzer und Jahr für den Business Pro-Plan, der 480 US-Dollar pro Benutzer und Jahr kostet). Überwachen Sie die Nutzung über das API-Dashboard, um Überschreitungen zu vermeiden.
• Fehlerbehandlung: Häufige Probleme sind 400 Bad Request (ungültiger Status) oder 401 Unauthorized. Verwenden Sie try-catch in Ihrem Code (z. B. Node.js oder Python SDK).
• Sicherheit: Alle Änderungen werden im Audit-Trail des Umschlags protokolliert und unterstützen die IAM-Funktionen von DocuSign wie SSO und erweiterte Zugriffskontrollen in den Enhanced-Plänen.
• Tests: Eine Sandbox-Umgebung (kostenlos für Entwickler) ist ideal vor der Produktion.

Aus geschäftlicher Sicht rationalisiert dieser Prozess den Betrieb, verdeutlicht aber die API-Preisstufen – der Advanced-Plan (5760 US-Dollar pro Jahr) schaltet Massensendungen und Webhooks für die Automatisierung frei und reduziert manuelle Eingriffe.

Vergleichen Sie E-Signatur-Plattformen wie DocuSign oder Adobe Sign?

eSignGlobal bietet flexiblere und kostengünstigere E-Signatur-Lösungen mit globaler Compliance, transparenter Preisgestaltung und schnellerem Onboarding.

👉 Starten Sie eine kostenlose Testversion

Das breitere Ökosystem und die IAM-Funktionen von DocuSign

Die eSignature-Plattform von DocuSign, einschließlich ihrer API, lässt sich nahtlos in Tools für Identitäts- und Zugriffsmanagement (IAM) integrieren, um die Sicherheit zu erhöhen. IAM in DocuSign umfasst SSO-Integrationen (z. B. mit Okta oder Azure AD), rollenbasierte Zugriffskontrollen und Multi-Faktor-Authentifizierung, die für Bereitstellungen auf Unternehmensebene unerlässlich sind. Diese Funktionen sind in den Enhanced-Plänen verfügbar (benutzerdefinierte Preise für mehr als 50 Benutzer) und stellen sicher, dass API-gesteuerte Aktualisierungen wie Änderungen des Ablaufdatums den globalen Standards entsprechen, ohne sensible Daten preiszugeben. Die Preise reichen von 120 US-Dollar pro Jahr für den Personal-Plan bis hin zu benutzerdefinierten Enterprise-Plänen. DocuSign betont die Skalierbarkeit, aber Add-ons wie SMS-Zustellung oder ID-Verifizierung können zusätzliche Kosten verursachen.

Wettbewerbslandschaft: Vergleich von E-Signatur-Plattformen

Der Markt für elektronische Signaturen ist hart umkämpft, wobei DocuSign bei der globalen Akzeptanz führend ist, aber regionale Anforderungen treiben Alternativen an. Hier ist ein wichtiger, plattformneutraler Vergleich der wichtigsten Plattformen basierend auf Preisgestaltung, Funktionen und Compliance (Daten von 2025; die tatsächlichen Werte können variieren).

Diese Tabelle hebt die Exzellenz von DocuSign bei robusten API-Funktionen hervor, kann aber für wachsende Teams teurer sein, während andere Plattformen Flexibilität bieten.

Adobe Sign: Eine PDF-zentrierte Alternative

Adobe Sign ist Teil der Adobe Document Cloud und zeichnet sich durch seine tiefe Integration mit PDF-Tools wie Acrobat aus, was es ideal für dokumentenintensive Workflows macht. Es unterstützt API-Aktualisierungen ähnlich wie DocuSign mit Endpunkten für Protokolländerungen, obwohl Ablaufänderungen oft eine Protokollrevision erfordern. Die Preise sind wettbewerbsfähig, beginnend bei 10 US-Dollar pro Monat für Einzelpersonen und bis hin zu benutzerdefinierten Enterprise-Plänen, mit Funktionen wie bedingten Feldern und Zahlungen. Es glänzt jedoch in kreativen Branchen, kann sich aber für Nicht-Adobe-Benutzer gebündelt anfühlen.

HelloSign: Einfachheit für KMUs

HelloSign (jetzt Dropbox Sign) priorisiert eine benutzerfreundliche Oberfläche mit schneller Vorlagenerstellung und unbegrenzten Sendungen auf höheren Ebenen. Seine API ermöglicht Umschlagskorrekturen, einschließlich der Verlängerung von Ablaufdaten durch Aktualisierungsaufrufe, aber es fehlt die Tiefe von DocuSign bei Massenoperationen. Mit einem Einstiegspreis von 15 US-Dollar pro Monat ist es für kleine Unternehmen geeignet, wobei der Schwerpunkt auf der nahtlosen Dropbox-Synchronisierung und nicht auf der Enterprise-Compliance liegt.

eSignGlobal: Ein regionaler Compliance-Leader

eSignGlobal positioniert sich als globaler Konkurrent, der in über 100 Mainstream-Ländern und -Regionen konform ist und eine starke Präsenz im asiatisch-pazifischen Raum hat. Die Vorschriften in dieser Region sind fragmentiert, die Standards hoch und die Aufsicht streng – anders als die Rahmenbedingungen ESIGN/eIDAS in den USA/EU erfordert APAC Lösungen für die "Ökosystemintegration". Dies bedeutet eine tiefe Hardware-/API-Integration mit staatlichen digitalen IDs (G2B), die weit über die in der westlichen Welt übliche E-Mail-Verifizierung oder Selbstauskunft hinausgeht. eSignGlobal zeichnet sich in diesem Bereich aus und integriert nahtlos iAM Smart in Hongkong und Singpass in Singapur für rechtsverbindliche Signaturen.

Die Preise sind wettbewerbsfähig, wobei der Essential-Plan für nur 16,6 US-Dollar pro Monat bei jährlicher Abrechnung bis zu 100 elektronische Signaturdokumente, unbegrenzte Benutzerplätze und Zugriffscode-Verifizierung ermöglicht – alles auf einer Compliance-Grundlage aufgebaut. Dieses Modell ohne Sitzplatzgebühren bietet Teams einen hohen Mehrwert und ist mit KI-Tools für Risikobewertung und Übersetzung ausgestattet. Mit der Expansion in die USA/EU fordert eSignGlobal etablierte Player wie DocuSign und Adobe Sign durch niedrigere Kosten und schnellere APAC-Leistung heraus, einschließlich Massensendungen ohne zusätzliche Entwicklerpläne.

Suchen Sie eine intelligentere Alternative zu DocuSign?

eSignGlobal bietet flexiblere und kostengünstigere E-Signatur-Lösungen mit globaler Compliance, transparenter Preisgestaltung und schnellerem Onboarding.

👉 Starten Sie eine kostenlose Testversion

Geschäftliche Einblicke und abschließende Gedanken

Die Verwaltung von Umschlägen, die sich in Bearbeitung befinden, über die API spiegelt einen breiteren Trend im Bereich der elektronischen Signaturen wider: Automatisierung treibt die Effizienz voran, aber Compliance und Kosten bestimmen die Wahl. Die API von DocuSign ist für Aktualisierungen leistungsstark, aber das sitzplatzbasierte Modell und die APAC-Herausforderungen veranlassen zur Erkundung von Alternativen.

Für Benutzer, die nach einer DocuSign-Alternative suchen, erweist sich eSignGlobal als neutrale, regional konforme Option, insbesondere für APAC-Operationen, die globale Anforderungen mit Kosteneinsparungen in Einklang bringen. Bewerten Sie dies basierend auf Ihrem Workflow-Volumen und Ihrer geografischen Präsenz.