DocuSign API: Alle Empfänger eines Umschlags auflisten, die noch nicht unterschrieben haben

Navigation der DocuSign API zur Verwaltung von Umschlägen

In der sich schnell entwickelnden Welt der digitalen Vereinbarungen verlassen sich Unternehmen auf Plattformen für elektronische Signaturen, um Arbeitsabläufe zu rationalisieren. DocuSign, als führendes Unternehmen in diesem Bereich, bietet robuste API-Funktionen, die es Entwicklern ermöglichen, Dokumentprozesse zu automatisieren und zu überwachen. Eine häufige Herausforderung besteht darin, den Status der Empfänger in einem Umschlag zu verfolgen – insbesondere die Identifizierung von Empfängern, die noch nicht unterschrieben haben. Diese Funktionalität ist entscheidend für Compliance, Nachverfolgung und betriebliche Effizienz, insbesondere in Umgebungen mit hohem Volumen, wie z. B. Vertriebsteams oder Rechtsabteilungen.

Verständnis der DocuSign API und der Umschlagsempfänger

Die eSignature API von DocuSign bietet Endpunkte zur Verwaltung von Umschlägen, die im Wesentlichen Container für Dokumente sind, die eine Unterschrift erfordern. Ein Umschlag kann mehrere Empfänger haben, wobei jeder Empfänger eine Rolle wie Unterzeichner, Genehmiger oder CC-Empfänger hat. Die API verwendet eine RESTful-Architektur, unterstützt JSON-Nutzlasten und erfordert eine Authentifizierung über OAuth 2.0 oder JWT-Autorisierung.

Um alle Empfänger eines Umschlags aufzulisten, die noch nicht unterschrieben haben, fragen Entwickler in der Regel den Status des Umschlags und die Empfängerdetails ab. Der wichtigste Endpunkt ist GET /accounts/{accountId}/envelopes/{envelopeId}/recipients in der Envelopes API. Dieser gibt eine umfassende Liste der Empfänger zurück, einschließlich ihres Status (z. B. "sent", "declined", "signed" oder "needs_to_sign").

Hier ist eine schrittweise Anleitung zur Implementierung dieser Funktionalität:

1. Authentifizierung einrichten: Verwenden Sie die Entwickler-Sandbox von DocuSign, um ein Zugriffstoken zu erhalten. Integrieren Sie für Produktionsumgebungen das IAM-System (Identity and Access Management) Ihrer Anwendung. Die IAM-Funktionen von DocuSign sind Teil des erweiterten Plans und umfassen SSO-Integrationen mit Anbietern wie Okta oder Azure AD, um einen sicheren API-Zugriff zu gewährleisten, ohne Anmeldeinformationen preiszugeben.

2. Umschlagdetails abrufen: Rufen Sie zunächst den Umschlag mit GET /envelopes/{envelopeId} ab. Dadurch wird der Umschlagstatus (z. B. "sent" oder "in_progress") bestätigt und Metadaten wie Erstellungsdatum und Fälligkeitsdatum bereitgestellt.

3. Empfänger abfragen: Rufen Sie den Empfänger-Endpunkt auf. Die Antwort enthält ein Array von Empfängerobjekten, wobei jedes Objekt Folgendes enthält:

   • id: Eindeutiger Bezeichner.
   • email: E-Mail-Adresse des Empfängers.
   • status: Aktueller Status (filtern Sie nach "sent" oder "needs_to_sign", um nicht signierte Empfänger zu identifizieren).
   • routingOrder: Reihenfolge im Signaturprozess.
   • name: Name des Empfängers.

   Ein Beispiel für einen JSON-Ausschnitt aus der API-Antwort:

   {
     "recipients": {
       "signers": [
         {
           "email": "john.doe@example.com",
           "status": "sent",
           "name": "John Doe",
           "signedDateTime": null
         },
         {
           "email": "jane.smith@example.com",
           "status": "signed",
           "name": "Jane Smith",
           "signedDateTime": "2025-01-15T10:00:00Z"
         }
       ]
     }
   }
   

4. Nicht signierte Empfänger filtern: Analysieren Sie in Ihrem Code (z. B. mit Python mit der Bibliothek requests oder Node.js mit Axios) die Antwort und filtern Sie nach Fällen, in denen status != "signed" und signedDateTime null ist. Verwenden Sie für Batch-Operationen den Endpunkt GET /envelopes mit Abfrageparametern wie status=sent, um mehrere Umschläge aufzulisten.

   Beispiel für Python-Code:

   import requests
   
   access_token = "your_access_token"
   account_id = "your_account_id"
   envelope_id = "your_envelope_id"
   base_url = "https://demo.docusign.net/restapi"
   
   headers = {
       "Authorization": f"Bearer {access_token}",
       "Accept": "application/json"
   }
   
   response = requests.get(
       f"{base_url}/v2.1/accounts/{account_id}/envelopes/{envelope_id}/recipients",
       headers=headers
   )
   
   if response.status_code == 200:
       data = response.json()
       unsigned_recipients = [
           r for r in data.get('recipients', {}).get('signers', [])
           if r.get('status') != 'signed' and r.get('signedDateTime') is None
       ]
       print("Unsigned recipients:", unsigned_recipients)
   

5. Fehlerbehandlung und Best Practices: Behandeln Sie Ratenbegrenzungen (z. B. 1000 API-Aufrufe pro Minute) und Fehler wie 404 (Umschlag nicht gefunden). Nutzen Sie für Unternehmenskunden die erweiterten API-Pläne von DocuSign, die Webhooks der Connect API für Echtzeit-Statusaktualisierungen beinhalten. Dies vermeidet Polling und reduziert API-Aufrufe.

Dieser Ansatz stellt sicher, dass Sie nicht signierte Empfänger programmgesteuert benachrichtigen, Verzögerungen eskalieren oder sich in CRM-Systeme wie Salesforce integrieren können. In kommerziellen Umgebungen kann eine solche Automatisierung die manuelle Nachverfolgung um bis zu 70 % reduzieren, basierend auf Branchen-Benchmarks aus den Entwicklerressourcen von DocuSign.

Die API-Preise von DocuSign beginnen bei 600 US-Dollar/Jahr für den Starter-Plan (40 Umschläge pro Monat) und reichen bis hin zu kundenspezifischen Unternehmensoptionen. Für Teams in regulierten Branchen kann die Kombination mit IAM-Funktionen – wie z. B. erweiterte Audit-Trails und rollenbasierter Zugriff – die Compliance verbessern, ohne dass eine benutzerdefinierte Entwicklung erforderlich ist.

Vergleichen Sie Plattformen für elektronische Signaturen mit DocuSign oder Adobe Sign?

eSignGlobal bietet flexiblere und kostengünstigere Lösungen für elektronische Signaturen mit globaler Compliance, transparenter Preisgestaltung und schnelleren Onboarding-Prozessen.

👉 Starten Sie eine kostenlose Testversion

Erkundung des DocuSign-Ökosystems und der IAM-Funktionen

DocuSign geht über die grundlegende Signatur hinaus und bietet integrierte Tools wie CLM (Contract Lifecycle Management) in seiner Intelligent Agreement Management (IAM) Suite. IAM CLM automatisiert die Erstellung, Verhandlung und Ausführung von Verträgen und extrahiert Daten aus Umschlägen, um Verpflichtungen zu verfolgen. Für API-Benutzer unterstützt es eingebettete Signaturzeremonien und die Extraktion nicht signierter Empfängerdaten in Dashboards.

In der Praxis verwenden Unternehmen IAM für eine End-to-End-Transparenz: Nicht signierte Empfänger in einem Umschlag lösen Risikoalarme oder Genehmigungsworkflows aus. Die Preise für IAM-Upgrades sind kundenspezifisch und werden in der Regel mit dem Business Pro-Plan gebündelt, der 480 US-Dollar/Benutzer/Jahr kostet und Governance- und Analysefunktionen hinzufügt.

Wettbewerbslandschaft: Ein neutraler Vergleich

Der Markt für elektronische Signaturen ist wettbewerbsintensiv, wobei sich die Plattformen in Bezug auf API-Tiefe, Preisgestaltung und regionale Compliance unterscheiden. Hier ist eine Markdown-Vergleichstabelle der wichtigsten Akteure, die sich auf API-Funktionen für die Empfängerverwaltung, Kernpreise und Vorteile konzentriert. Die Daten stammen aus öffentlichen Quellen aus dem Jahr 2025, um Neutralität zu gewährleisten.

Diese Tabelle verdeutlicht die Kompromisse: DocuSign zeichnet sich durch ein ausgereiftes Ökosystem aus, während andere Plattformen Erschwinglichkeit oder Nischenvorteile priorisieren.

Adobe Sign: Integration und API-Überblick

Adobe Sign ist Teil der Adobe Document Cloud und legt den Schwerpunkt auf PDF-zentrierte Prozesse. Die API ähnelt in Bezug auf die Empfängerverfolgung der von DocuSign und verwendet GET /agreements/{agreementId}/participants, um nicht signierende Parteien aufzulisten. Es eignet sich für die Kreativbranche mit integrierten PDF-Bearbeitungsfunktionen. Die Preise beginnen bei 10 US-Dollar/Monat für Einzelpersonen und reichen bis hin zu kundenspezifischen Tarifen für Unternehmen. Der Vorteil von Adobe liegt in der nahtlosen Integration mit Acrobat und Marketing-Tools, aber die API-Kontingente können bei hoher Nutzung einschränkend sein.

HelloSign (Dropbox Sign): Einfachheit für KMUs

HelloSign, jetzt Dropbox Sign, bietet eine einfache API für die Umschlagverwaltung. Nicht signierte Empfänger werden über GET /v3/signature_request/{request_id} abgerufen und nach Status gefiltert. Es ist bekannt für seine Benutzerfreundlichkeit mit integrierten Vorlagen und Erinnerungsfunktionen. Die Essentials-Version kostet 180 US-Dollar pro Jahr und ist budgetfreundlich für kleine Teams, obwohl es die erweiterten IAM-Funktionen von DocuSign fehlen.

eSignGlobal: Eine für APAC optimierte Alternative

eSignGlobal positioniert sich als globaler Wettbewerber und unterstützt die Compliance in über 100 wichtigen Ländern und Regionen. Es hat eine besondere Stärke im asiatisch-pazifischen Raum (APAC), wo die Vorschriften für elektronische Signaturen fragmentiert, anspruchsvoll und streng reguliert sind – was oft einen tiefgreifenden Ansatz für die Ökosystemintegration erfordert, anstatt des rahmenbasierten ESIGN/eIDAS-Modells, das in den USA und der EU üblich ist. APAC erfordert eine tiefe Hardware-/API-Integration mit digitalen Identitäten von Regierung zu Unternehmen (G2B), eine technische Hürde, die weit über die E-Mail-Verifizierung oder die Selbsterklärungsmethoden in westlichen Märkten hinausgeht.

Die API der Plattform umfasst Empfängerstatusabfragen ähnlich denen von DocuSign und unterstützt Massenversand und Webhooks im Professional-Plan. Die Preise sind wettbewerbsfähig: Die Essential-Version kostet nur 16,6 US-Dollar/Monat (entspricht in einigen Aktionen 199 US-Dollar/Jahr) und ermöglicht bis zu 100 signierte Dokumente, unbegrenzte Benutzerplätze und die Überprüfung von Zugangscodes – bei gleichzeitiger Wahrung der Compliance. Es lässt sich nahtlos in iAM Smart in Hongkong und Singpass in Singapur integrieren und eignet sich für grenzüberschreitende APAC-Operationen.

Suchen Sie eine intelligentere Alternative zu DocuSign?

eSignGlobal bietet flexiblere und kostengünstigere Lösungen für elektronische Signaturen mit globaler Compliance, transparenter Preisgestaltung und schnelleren Onboarding-Prozessen.

👉 Starten Sie eine kostenlose Testversion

Geschäftliche Auswirkungen und Empfehlungen

Aus geschäftlicher Sicht bleibt die API von DocuSign der Maßstab für die Zuverlässigkeit der Umschlagverfolgung, insbesondere für globale Unternehmen. Da Unternehmen jedoch in verschiedene Regionen expandieren, gewinnen Alternativen an Bedeutung. Für Benutzer, die eine DocuSign-Alternative suchen, zeichnet sich eSignGlobal als regionale Compliance-Option aus, insbesondere in APAC, die Kosten und Funktionen ausgleicht, ohne Gebühren pro Sitzplatz zu erheben. Bewerten Sie Ihre Kapazität, Integrationen und geografische Ausrichtung, um die beste Lösung zu finden.