DocuSign API: Umschläge aus Vorlagen mit vorausgefüllten Feldern senden

Vereinfachung von Dokumenten-Workflows mit der DocuSign API

In der schnelllebigen Welt des digitalen Geschäftsbetriebs haben sich E-Signatur-Plattformen wie DocuSign zu unverzichtbaren Werkzeugen für die Automatisierung des Vertragsmanagements und die Reduzierung des Papierkrams entwickelt. Die DocuSign API zeichnet sich durch ihre Leistungsfähigkeit bei der Handhabung komplexer Workflows aus, insbesondere bei der Verwendung von Vorlagen zum Versenden von Umschlägen – DocuSigns Bezeichnung für ein Dokumentenpaket, das zur Unterzeichnung vorbereitet ist – mit vorausgefüllten Feldern. Diese Funktion spart nicht nur Zeit, sondern minimiert auch Fehler in Umgebungen mit hohem Volumen, wie z. B. Vertriebsteams oder Rechtsabteilungen. Aus geschäftlicher Sicht kann die Integration einer solchen API zu erheblichen Effizienzsteigerungen führen, wobei Studien zeigen, dass die Dokumentenbearbeitungszeit um bis zu 80 % reduziert werden kann.

Vergleich von E-Signatur-Plattformen: DocuSign oder Adobe Sign?

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

👉 Starten Sie eine kostenlose Testversion

Die DocuSign API meistern: Umschläge aus Vorlagen versenden

Die DocuSign eSignature API ist ein leistungsstarkes Entwicklerwerkzeug, das es Unternehmen ermöglicht, Signaturfunktionen direkt in ihre Anwendungen einzubetten. Im Kern ist ein "Umschlag" ein Container für ein oder mehrere Dokumente, die zur Unterzeichnung, Genehmigung oder anderen Aktionen weitergeleitet werden können. Vorlagen in DocuSign definieren das Dokumentenlayout, die Felder (sogenannte "Tabs") und den Workflow vor, was sie ideal für sich wiederholende Aufgaben wie Onboarding oder Rechnungsfreigaben macht.

Vorausgefüllte Tabs beziehen sich auf das Ausfüllen dieser Felder mit Daten, bevor der Umschlag versendet wird – z. B. Textfelder, Datumsangaben oder Kontrollkästchen. Dies ist besonders nützlich, wenn die Informationen des Empfängers bekannt sind, und sorgt für ein reibungsloseres Signaturerlebnis. Für Unternehmen lässt sich diese Funktion nahtlos in CRM-Systeme (wie Salesforce) oder ERP-Tools integrieren, um die Datenextraktion zu automatisieren.

Um dies über die API zu erreichen, verwenden Entwickler in der Regel RESTful-Endpunkte, wobei die Authentifizierung über OAuth 2.0 oder JWT-Autorisierung erfolgt. Die DocuSign-Entwickler-Sandbox bietet eine kostenlose Testumgebung, die für Unternehmen, die Integrationen iterativ durchführen möchten, ohne Produktionskosten zu verursachen, von entscheidender Bedeutung ist.

Voraussetzungen für die API-Integration

Bevor Sie sich mit dem Code befassen, stellen Sie sicher, dass Sie Folgendes haben:

• Ein DocuSign-Entwicklerkonto (kostenlose Anmeldung).
• Einen Integrationsschlüssel (App-ID) und ein API-Token für die Authentifizierung.
• Vertrautheit mit JSON-Nutzlasten, da die API in diesem Format kommuniziert.
• Das DocuSign SDK für Ihre bevorzugte Sprache (z. B. Java, .NET, Python), das HTTP-Anfragen vereinfacht.

Unternehmen sollten auch die API-Preisstufen berücksichtigen: Der Starter-Plan kostet 600 US-Dollar pro Jahr und unterstützt bis zu 40 Umschläge pro Monat, was für kleine Integrationen geeignet ist, während der Advanced-Plan für 5.760 US-Dollar pro Jahr Massenversand und Webhooks freischaltet und für größere Operationen geeignet ist.

Schritt-für-Schritt-Anleitung zum Versenden eines Umschlags mit vorausgefüllten Feldern

Schritt 1: Erstellen oder Abrufen einer Vorlage

Laden Sie zunächst eine Vorlage in die DocuSign-Webanwendung hoch oder erstellen Sie sie über die API. Die Vorlage enthält das Dokument und die darauf platzierten Felder. Die Felder werden kategorisiert als:

• Textfelder: Für Namen, Adressen usw.
• Datumsfelder: Füllen Sie automatisch das aktuelle Datum oder benutzerdefinierte Werte aus.
• Kontrollkästchenfelder: Für Vereinbarungen.
• Initialen-/Signaturfelder: Für Aktionen des Unterzeichners.

Verwenden Sie die Templates API, um vorhandene Vorlagen aufzulisten:

GET /restapi/v2.1/accounts/{accountId}/templates

Dies gibt ein JSON-Array von Vorlagen zurück. Notieren Sie sich die templateId für die nächsten Schritte.

Schritt 2: Vorbereiten der Umschlagdefinition

Erstellen Sie ein Umschlagobjekt, das auf die Vorlage verweist. Füllen Sie die Felder vorab aus, indem Sie Empfängerdaten und Feldwerte in die Nutzlast aufnehmen.

Hier ist ein Beispiel-JSON zum Erstellen eines Umschlags (zur Veranschaulichung mit Node.js und dem DocuSign SDK):

const dsApi = new docusign.ApiClient();
dsApi.setBasePath('https://demo.docusign.net/restapi');
const envelopesApi = new docusign.EnvelopesApi(dsApi);

const envelopeDefinition = new docusign.EnvelopeDefinition();
envelopeDefinition.emailSubject = 'Bitte unterschreiben Sie dieses Dokument';
envelopeDefinition.status = 'sent'; // Optionen: 'created', 'sent', 'delivered'

// Referenzieren Sie die Vorlage
const template = new docusign.TemplateReference();
template.templateId = 'your-template-id';
template.roleName = 'Signer1'; // Entspricht der Vorlagenrolle
envelopeDefinition.templateReferences = [template];

// Definieren Sie den Empfänger und füllen Sie die Felder vorab aus
const signer = new docusign.TemplateRole();
signer.roleName = 'Signer1';
signer.email = 'recipient@example.com';
signer.name = 'John Doe';
signer.clientUserId = '1000'; // Für eingebettete Signierung, falls erforderlich

// Füllen Sie die Felder vorab aus (Felder aus der Vorlage)
const textTab = new docusign.Text();
textTab.tabLabel = 'FullName'; // Entspricht dem Feld in der Vorlage
textTab.value = 'John Doe';
signer.tabs = new docusign.Tabs();
signer.tabs.textTabs = [textTab];

const dateTab = new docusign.Date();
dateTab.tabLabel = 'AgreementDate';
dateTab.value = new Date().toISOString().split('T')[0];
signer.tabs.dateTabs = [dateTab];

envelopeDefinition.templateRoles = [signer];

const results = await envelopesApi.createEnvelope(accountId, { envelopeDefinition });
console.log(`Envelope ID: ${results.envelopeId}`);

Dieser Code erstellt einen Umschlag aus einer Vorlage, füllt das Textfeld "FullName" mit "John Doe" vorab aus und füllt das Datumsfeld mit dem heutigen Datum aus. tabLabel muss genau mit der Bezeichnung übereinstimmen, die dem Feld in der Vorlage zugewiesen wurde.

Schritt 3: Authentifizierung verarbeiten und senden

Authentifizieren Sie sich mit JWT oder einem Zugriffstoken. Verwenden Sie in Produktionsumgebungen NA1 (USA) oder EU1 (Europa) als Basispfad, je nach Region Ihres Kontos. Senden Sie den Umschlag mit:

const accessToken = await getJwtToken(); // Ihre Auth-Funktion
dsApi.addDefaultHeader('Authorization', `Bearer ${accessToken}`);

Für Massenszenarien unterstützt der Advanced API-Plan bis zu 100 Umschläge pro Monat und füllt Daten aus externen Quellen (z. B. Datenbanken) vorab aus.

Schritt 4: Status überwachen und abrufen

Verfolgen Sie nach dem Senden den Status mithilfe von Webhooks (Connect-Funktion im Advanced-Plan) oder durch Abfrage des Endpunkts /envelopes/{envelopeId}. Dies ist für Geschäftsprozesse von entscheidender Bedeutung und stellt sicher, dass die Anforderungen an den Audit-Trail erfüllt werden.

Häufige Herausforderungen und Lösungen

• Fehler bei der Feldzuordnung: Stellen Sie sicher, dass die Felder eindeutig sind und korrekt referenziert werden. Verwenden Sie zunächst die Template API, um Felddetails abzurufen.
• Empfängerrouting: Weisen Sie bei Umschlägen mit mehreren Unterzeichnern Rollen in der Vorlage zu und ordnen Sie diese im API-Aufruf zu.
• Beschränkungen: Standardpläne beschränken automatisierte Sendungen auf etwa 100/Benutzer/Jahr; API-Pläne haben Umschlagkontingente.
• Fehlerbehandlung: API-Antworten enthalten Fehlercodes (z. B. 400 für ungültige Felder); implementieren Sie Wiederholungsversuche für vorübergehende Probleme.

Aus geschäftlicher Sicht kann diese API-Integration die manuelle Dateneingabe um 70 % reduzieren, aber Unternehmen müssen die Kosten abwägen – API-Add-ons wie die Identitätsprüfung verursachen nutzungsabhängige Gebühren.

Erkunden Sie das breitere Ökosystem von DocuSign

DocuSign geht über die grundlegende elektronische Signatur hinaus und bietet Produkte wie Intelligent Agreement Management (IAM) CLM an, eine Lösung für das Vertragslebenszyklusmanagement. IAM CLM automatisiert den gesamten Vereinbarungsprozess, von der Erstellung über die Verhandlung bis hin zur Verlängerung, und integriert KI für die Klauselanalyse. Es bietet eine kundenspezifische Preisgestaltung für Unternehmen, beginnend mit dem Enhanced-Plan, der SSO- und erweiterte Analysefunktionen umfasst. Dies macht es für mittlere bis große Unternehmen geeignet, die eine End-to-End-Compliance benötigen.

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 mit Wettbewerbern konfrontiert ist, die spezialisierte Vorteile bieten. Adobe Sign legt Wert auf die nahtlose Integration mit der Adobe Creative Suite und eignet sich für dokumentenintensive Workflows. Es unterstützt das Vorabfüllen von Formularen über seine API und entspricht US ESIGN/UETA und European eIDAS. Die Preise beginnen bei 10 US-Dollar pro Monat für Einzelpersonen und reichen bis zu kundenspezifischen Plänen für Unternehmen, einschließlich Funktionen wie mobile Signatur und Zahlungserfassung.

eSignGlobal positioniert sich als regionale Größe, insbesondere im asiatisch-pazifischen Raum (APAC), wo die Vorschriften für elektronische Signaturen fragmentiert, hochstandardisiert und streng reguliert sind. Im Gegensatz zu den Rahmenstandards in den USA (ESIGN Act) oder Europa (eIDAS), die auf E-Mail-Verifizierung oder Selbsterklärung basieren, erfordert APAC die Einhaltung der "Ökosystemintegration". Dies beinhaltet eine tiefe Hardware-/API-Integration mit digitalen Identitäten von Regierung zu Unternehmen (G2B), wodurch die technischen Hürden deutlich höher sind als bei westlichen Modellen. eSignGlobal unterstützt die Compliance in 100 wichtigen globalen Ländern und Regionen und verfügt über einen Vorteil im APAC-Raum durch lokale Rechenzentren in Hongkong und Singapur. Es ist nativ in Hongkongs iAM Smart und Singapurs Singpass integriert und ermöglicht so eine robuste Authentifizierung. Die Preise sind zugänglicher: Der Essential-Plan kostet 16,6 US-Dollar pro Monat und ermöglicht das Versenden von bis zu 100 Dokumenten zur elektronischen Signatur, unbegrenzte Benutzerlizenzen und die Dokumenten-/Signaturüberprüfung über Zugriffscodes – und bietet so einen starken Mehrwert auf Compliance-Basis. eSignGlobal expandiert weltweit, einschließlich Amerika und Europa, als wettbewerbsfähige Alternative zu DocuSign und Adobe Sign mit etwas niedrigeren Kosten und schnellerer regionaler Leistung.

HelloSign (jetzt Teil von Dropbox) konzentriert sich auf die Einfachheit für KMUs und bietet ähnliche Vorlagen und vorausgefüllte API-Unterstützung wie DocuSign, jedoch zu geringeren Einstiegskosten (15 US-Dollar/Benutzer/Monat). Es zeichnet sich durch die Integration mit Google Workspace aus, verfügt aber in den Basisplänen nicht über erweiterte Unternehmensfunktionen wie den Massenversand.

Diese Tabelle hebt neutrale Kompromisse hervor: DocuSign für Skalierung, Adobe für Design-Workflows, eSignGlobal für APAC-Effizienz und HelloSign für Benutzerfreundlichkeit.

Regulatorische Nuancen globaler elektronischer Signaturen

Während sich die Überschrift auf API-Mechanismen konzentriert, kann das Verständnis von Vorschriften die Implementierung verbessern. In den USA bieten der ESIGN Act und UETA für die meisten kommerziellen Transaktionen die gleiche Rechtskraft wie Nassunterschriften. Der europäische eIDAS-Rahmen erfordert qualifizierte elektronische Signaturen für hohe Sicherheitsanforderungen. APAC ist unterschiedlich: Singapurs Electronic Transactions Act stimmt mit eIDAS überein, aber Regierungsangelegenheiten erfordern Singpass, während Hongkongs Verordnungen die sichere Authentifizierung über iAM Smart betonen. Unternehmen, die die DocuSign API verwenden, müssen Felder so konfigurieren, dass sie Compliance-Feldern entsprechen, z. B. Audit-Protokollen, um diese Standards zu erfüllen.

Abschließende Gedanken zur Auswahl elektronischer Signaturen

Für Unternehmen, die API-gesteuerte Automatisierung priorisieren, bleibt DocuSign aufgrund seines ausgereiften Ökosystems eine solide Wahl. Für regionale Compliance-Anforderungen, insbesondere im APAC-Raum, bieten Alternativen wie eSignGlobal jedoch maßgeschneiderte, kostengünstige Optionen, ohne die globale Abdeckung zu beeinträchtigen. Bewerten Sie anhand Ihrer Größenordnung, Integrationen und geografischen Standorte, um die beste Übereinstimmung zu erzielen.