DocuSign API: Wie füge ich nach dem Senden einen "Carbon Copy"-Empfänger hinzu?

Verstehen von CC-Empfängern in DocuSign

Im Bereich der elektronischen Signaturen bietet die API von DocuSign leistungsstarke Werkzeuge zur Automatisierung von Dokumentenworkflows, aber das Hinzufügen von Empfängern nach dem Erstellen eines Umschlags kann knifflig sein. Ein "Carbon Copy" (CC)-Empfänger ist eine Nicht-Signatur-Rolle, die eine Kopie des signierten Dokuments zur Ansicht oder zur Aufbewahrung von Aufzeichnungen erhält, ohne dass eine Unterschrift oder Genehmigung erforderlich ist. Aus geschäftlicher Sicht ist diese Funktion für Compliance-Teams, Rechtsabteilungen oder Vertriebsleiter von unschätzbarem Wert, die benachrichtigt werden müssen, ohne die Signaturkette zu ändern. Die API von DocuSign hat jedoch Einschränkungen bei Änderungen nach dem Senden eines Umschlags, die wir im Detail untersuchen werden.

Dieser Artikel befasst sich mit den praktischen Schritten zum Hinzufügen von CC-Empfängern nach dem Senden eines Umschlags über die DocuSign eSignature API. Wir behandeln Voraussetzungen, API-Aufrufe, potenzielle Fallstricke und Best Practices unter Bezugnahme auf die offizielle Dokumentation und praktische Implementierungserkenntnisse. Für Unternehmen, die DocuSign integrieren, kann das Verständnis dieser Nuancen Workflow-Unterbrechungen verhindern und revisionsbereite Prozesse gewährleisten.

Grundlagen der DocuSign API-Empfängerverwaltung

Bevor Sie CC-Empfänger nach dem Senden hinzufügen, ist es wichtig, den Lebenszyklus von DocuSign-Umschlägen zu verstehen. Ein Umschlag stellt ein Dokumentenpaket dar, und sobald er "gesendet" wurde, ist er aktiv, wobei Änderungen eingeschränkt sind, um die Erfahrung des Unterzeichners und die rechtliche Integrität zu schützen. Die eSignature REST API (v2.1) verwaltet diese Interaktionen und erfordert eine Authentifizierung über JWT oder OAuth für einen sicheren Zugriff.

Schlüsselkonzepte:

• Empfänger: Umfasst Unterzeichner, Genehmiger und CCs. CCs werden über das carbonCopies-Array im Empfängerobjekt hinzugefügt.
• Umschlagstatus: Nach dem Senden befindet sich der Umschlag im Status "sent" oder "delivered". Änderungen sind eingeschränkt; Sie können keine Unterzeichner hinzufügen, die eine Aktion erfordern, aber CCs sind zulässig, da sie die Signaturreihenfolge nicht ändern.
• API-Endpunkte: Verwenden Sie /envelopes/{envelopeId}/recipients für Aktualisierungen.

Aus geschäftlicher Sicht beginnt die API-Preisgestaltung von DocuSign bei 600 US-Dollar pro Jahr für den Starter-Plan, der bis zu 40 Umschläge pro Monat unterstützt und für kleine Integrationen geeignet ist, aber hohe Volumenanforderungen erhöhen die Kosten.

Schritt-für-Schritt-Anleitung: Hinzufügen von CC-Empfängern nach dem Senden

Das Hinzufügen von CCs nach dem Senden erfordert die Verwendung des correct-Modus oder eine Void-and-Resend-Problemumgehung, da das direkte Hinzufügen nach dem Senden nicht immer einfach ist. DocuSign empfiehlt, Empfänger im Voraus zu planen, aber für dynamische Szenarien (z. B. das bedingte Hinzufügen von Managern basierend auf Geschäftslogik) befolgen Sie diese Schritte. Dieses Verfahren setzt voraus, dass Sie ein Entwicklerkonto und ein API-Zugriffstoken haben.

Voraussetzungen

1. API-Setup: Integrieren Sie das DocuSign SDK (für Java, .NET, PHP usw.) oder verwenden Sie rohe REST-Aufrufe. Authentifizieren Sie sich mit Ihrem Integrationsschlüssel und Ihrer Benutzer-ID.
2. Umschlag-ID: Rufen Sie die ID aus der ersten Sendeantwort ab (z. B. über einen /envelopes POST).
3. Berechtigungen: Stellen Sie sicher, dass Ihr Konto Umschlagskorrekturen zulässt (aktiviert unter "Funktionen" in den Admin-Einstellungen).
4. Umschlagstatusprüfung: Fragen Sie /envelopes/{envelopeId} ab, um zu bestätigen, dass er sich im Status "sent" befindet und keine Unterzeichner Aktionen abgeschlossen haben, die Änderungen sperren.

Geschäftstipp: Für Unternehmen schaltet der Advanced API-Plan (5.760 US-Dollar pro Jahr) Funktionen wie Bulk Send und Webhooks frei, die CCs automatisch benachrichtigen können, wenn sie abgeschlossen sind.

Methode 1: Verwenden der Umschlagskorrektur (empfohlen für kleine Änderungen)

Die "Correct"-Funktion von DocuSign ermöglicht Änderungen im laufenden Betrieb, ohne den Umschlag zu annullieren, was ideal für das Hinzufügen von CCs ist.

1. Korrektur initiieren:

   • PUT an /envelopes/{envelopeId}/correct mit folgendem Body:

     {
       "clientUserId": "optional_client_id",
       "correctInProgress": true
     }
     

     Dadurch wird der Umschlag vorübergehend angehalten.

2. CC-Empfänger hinzufügen:

   • POST an /envelopes/{envelopeId}/recipients mit CC-Details:

     {
       "carbonCopies": [
         {
           "email": "cc@example.com",
           "name": "John Doe",
           "recipientId": "unique_id_for_cc",  // z. B. "CC1"
           "routingOrder": 0  // CCs beeinflussen die Reihenfolge nicht
         }
       ],
       "resendEnvelope": false  // Benachrichtigungen noch nicht erneut senden
     }
     

     • recipientId muss eindeutig sein; vermeiden Sie Konflikte mit vorhandenen Empfängern.
     • Optional: Fügen Sie accessControl für passwortgeschützten CC-Zugriff hinzu.

3. Erneut senden oder benachrichtigen:

   • PUT erneut an /envelopes/{envelopeId}/correct, um fortzufahren:

     {
       "resendEnvelope": true  // E-Mails für neue CCs auslösen
     }
     

     CCs erhalten eine Kopie, sobald der Umschlag abgeschlossen ist oder wie angefordert.

Potenzielle Fallstricke: Wenn ein Umschlag "completed" ist, kann er nicht korrigiert werden - verwenden Sie Webhooks über die Connect-Funktion (Advanced Plan), um den Status zu überwachen.

Methode 2: Annullieren und erneut senden (für komplexe Szenarien)

Wenn eine Korrektur nicht möglich ist (z. B. aufgrund von Aktionen des Unterzeichners), annullieren Sie den Umschlag und erstellen Sie ihn mit dem neuen CC neu.

1. Umschlag annullieren:

   • PUT an /envelopes/{envelopeId}:

     {
       "status": "voided",
       "voidedReason": "Adding CC recipient"
     }
     

2. Mit CC neu erstellen:

   • POST an /envelopes mit der ursprünglichen Payload, plus CCs im recipients-Objekt:

     {
       "emailSubject": "Updated Document",
       "documents": [/* original docs */],
       "recipients": {
         "signers": [/* original signers */],
         "carbonCopies": [
           {
             "email": "cc@example.com",
             "name": "John Doe",
             "recipientId": "CC1"
           }
         ]
       },
       "status": "sent"
     }
     

3. Ursprüngliche Unterzeichner benachrichtigen: Verwenden Sie /envelopes/{newEnvelopeId}/recipients/{recipientId}/resend für jeden Unterzeichner, um fortzufahren.

Geschäftliche Beobachtung: Diese Methode verursacht zusätzliche Umschlagverbrauchskosten (z. B. ~100 Umschläge pro Benutzer und Jahr für Business Pro, 480 US-Dollar/Benutzer/Jahr), daher ist sie für Korrekturen mit geringem Volumen geeignet. Verwenden Sie Dashboards über die API, um Kontingente zu verfolgen und zu verwalten.

Best Practices und Einschränkungen

• Fehlerbehandlung: Häufige Fehler sind 400 (ungültiger Empfänger) oder 403 (unzureichende Berechtigungen). Validieren Sie immer zuerst mit einem /envelopes/{envelopeId}/recipients GET.
• Tests: Verwenden Sie die Developer Sandbox von DocuSign (kostenlos), um zu simulieren, ohne Produktionsumschläge zu verbrauchen.
• Compliance: Das Hinzufügen von CCs führt zu einem Audit-Trail, der den ESIGN/UETA-Standards entspricht, aber protokollieren Sie die Gründe, um Streitigkeiten zu vermeiden.
• Automatisierungsalternativen: Für häufige Anforderungen nach dem Senden integrieren Sie Webhooks (Advanced Plan), um externe Benachrichtigungen anstelle von API-Änderungen auszulösen.

In der Praxis berichten Unternehmen von einer Effizienzsteigerung von 20-30 % durch die Skriptierung dieser Vorgänge über SDKs, aber für hochvolumige Vorgänge sollten Sie Enterprise-Custom-Pläne für unbegrenzte Anpassungen in Betracht ziehen.

Vergleichen Sie E-Signatur-Plattformen mit 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

Vergleich von DocuSign mit wichtigen Wettbewerbern

Um eine ausgewogene Perspektive zu bieten, vergleichen wir die API-Funktionen von DocuSign mit Alternativen wie Adobe Sign, eSignGlobal und HelloSign (jetzt Dropbox Sign). Diese Tabelle basiert auf öffentlichen Daten aus dem Jahr 2025 und hebt Preisgestaltung, Empfängerverwaltung und regionale Stärken hervor, um Unternehmen bei der Entscheidungsfindung bei der Anbieterauswahl zu unterstützen.

Dieser Vergleich zeigt, dass DocuSign in Bezug auf die Tiefe der ausgereiften API hervorragend ist, aber zu höheren Kosten, während Wettbewerber Flexibilität für bestimmte Segmente bieten.

Adobe Sign im Fokus

Adobe Sign, Teil der Adobe Document Cloud, bietet eine nahtlose API für die Empfängerverwaltung, einschließlich einer einfacheren CC-Hinzufügung nach dem Senden über den "Amend"-API-Endpunkt. Die Preisgestaltung ist mit 10 US-Dollar/Benutzer/Monat für die Basisversion wettbewerbsfähig und erstreckt sich bis hin zu Enterprise-Custom. Es eignet sich für Unternehmen, die bereits in der Adobe-Suite sind, und bietet eine robuste PDF-Verarbeitung und globale Compliance, obwohl APAC-Latenz ein Problem sein kann.

eSignGlobal im Fokus

eSignGlobal positioniert sich als globaler Player, der in über 100 Mainstream-Ländern konform ist und insbesondere im asiatisch-pazifischen Raum (APAC) stark vertreten ist. Die E-Signatur-Landschaft in APAC ist fragmentiert, mit hohen Standards und strengen Vorschriften - anders als die Rahmenbedingungen ESIGN/eIDAS in den USA/EU erfordert APAC "Ökosystem-Integration"-Lösungen. Dies bedeutet eine tiefe Hardware-/API-basierte Anbindung an staatliche digitale Identitäten (G2B), eine technische Hürde, die weit über die in der westlichen Welt übliche E-Mail-Verifizierung oder Selbstauskunft hinausgeht. eSignGlobal geht dies mit nativen Integrationen wie iAM Smart in Hongkong und Singpass in Singapur an und gewährleistet die Rechtsgültigkeit ohne zusätzliche Kosten.

Die Preisgestaltung ist erschwinglich, wobei der Essential-Plan 16,6 US-Dollar pro Monat und Jahr kostet und bis zu 100 Dokumentsignaturen, unbegrenzte Benutzerlizenzen und die Überprüfung über Zugriffscodes ermöglicht. Dieses Compliance-orientierte Wertversprechen macht es im Wettbewerb mit DocuSign und Adobe Sign wettbewerbsfähig, insbesondere für grenzüberschreitende Teams, die niedrigere Gesamtbetriebskosten suchen.

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

Abschließende Gedanken zur Auswahl von E-Signaturen

Für Unternehmen, die API-gesteuerte Workflows navigieren, bleibt DocuSign eine solide Wahl, obwohl Änderungen nach dem Senden eine sorgfältige Planung erfordern. Angesichts des Aufstiegs von Alternativen sollten Sie regionale Anforderungen berücksichtigen - eSignGlobal zeichnet sich als neutrale, Compliance-orientierte Option für APAC-orientierte Operationen aus. Bewerten Sie anhand Ihrer Kapazität, Integrationen und geografischen Standorte, um die beste Übereinstimmung zu erzielen.