DocuSign API: Wie verwendet man "Composite Templates" zum Zusammenführen mehrerer PDFs?

Navigation der DocuSign API für effiziente Dokumenten-Workflows

In der schnelllebigen Welt des digitalen Geschäftsbetriebs haben sich E-Signatur-Plattformen wie DocuSign zu unverzichtbaren Werkzeugen zur Rationalisierung des Vertragsmanagements und zur Reduzierung des Papieraufwands entwickelt. Von kleinen Teams bis hin zu großen Unternehmen ermöglichen diese Tools sichere und konforme Signaturprozesse. Eine Schlüsselfunktion innerhalb des DocuSign API-Ökosystems sind Composite Templates, die es Entwicklern ermöglichen, mehrere PDFs zu einem Umschlag zum Signieren zusammenzuführen. Diese Funktion ist besonders wertvoll für Unternehmen, die komplexe Workflows abwickeln, wie z. B. Mehrparteienvereinbarungen oder die automatisierte Dokumentenerstellung. Dieser Artikel untersucht, wie Composite Templates in der DocuSign API implementiert werden, unter Bezugnahme auf die offizielle Dokumentation und reale Geschäftsanwendungen, wobei eine neutrale Perspektive auf ihre Nützlichkeit im kommerziellen Umfeld beibehalten wird.

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 einem schnelleren Onboarding-Erlebnis.

👉 Starten Sie eine kostenlose Testversion

Nutzung von DocuSign API Composite Templates für die PDF-Zusammenführung

Was sind Composite Templates?

Composite Templates in der DocuSign eSignature API sind ein leistungsstarker Ansatz zum Kombinieren mehrerer Dokumente und Signaturkonfigurationen in einem einzigen Umschlag. In der DocuSign-Terminologie ist ein "Umschlag" ein Container für ein oder mehrere Dokumente, die signiert werden müssen. Herkömmliche Umschläge verarbeiten Dokumente sequenziell, aber Composite Templates unterstützen die parallele Zusammenstellung, sodass Sie verschiedene PDFs an bestimmte Empfänger anhängen und gleichzeitig Registerkarten (Signaturfelder) über Dokumente hinweg definieren können. Dies ist ideal für Szenarien wie Kreditanträge, bei denen ein Deckblatt, ein PDF mit den Bedingungen und ein Offenlegungsformular von derselben Partei signiert werden müssen, ohne dass eine manuelle Zusammenführung erforderlich ist.

Aus geschäftlicher Sicht reduziert diese Funktion API-Aufrufe, minimiert Dokumentenrouting-Fehler und beschleunigt die Bearbeitungszeit - was für Vertriebsteams zum Abschließen von Geschäften oder für Personalabteilungen zur Bearbeitung von Onboarding-Paketen von entscheidender Bedeutung ist. Laut den Entwicklerressourcen von DocuSign sind Composite Templates in den API-Stufen Intermediate und Advanced verfügbar, deren Jahresgebühren für eine moderate Nutzung bei etwa 3.600 US-Dollar beginnen.

Schritt-für-Schritt-Anleitung zur Verwendung von Composite Templates

Um mehrere PDFs mit Composite Templates zusammenzuführen, interagieren Sie mit der DocuSign REST API (Version 2.1 oder höher). Zu den Voraussetzungen gehören ein DocuSign-Entwicklerkonto (das eine kostenlose Sandbox bietet) und API-Anmeldeinformationen, die über OAuth abgerufen wurden. Hier ist eine praktische Anleitung:

1. Bereiten Sie Ihre Dokumente und Vorlagen vor:

   • Laden Sie Ihre PDFs in den temporären Speicher von DocuSign hoch oder referenzieren Sie sie über die Base64-Kodierung. Bereiten Sie beispielsweise pdf1.pdf (Vertrag) und pdf2.pdf (Anhang) vor.
   • Erstellen Sie bei Wiederverwendbarkeit Vorlagen in der DocuSign-Webanwendung. Jede Vorlage kann vordefinierte Registerkarten wie Signatur-, Datums- oder Textfelder enthalten. Notieren Sie die Vorlagen-IDs aus dem DocuSign-Dashboard.

2. Richten Sie die Umschlagdefinition ein:

   • Erstellen Sie einen neuen Umschlag mit dem Endpunkt /envelopes. Strukturieren Sie das Array compositeTemplates im JSON-Anforderungstext.
   • Schlüsselelemente:
     • document: Inline- oder Remote-PDF.
     • serverTemplates oder inlineTemplates: Verknüpfung mit vorhandenen Vorlagen.
     • recipients: Definieren Sie Unterzeichner (z. B. Unterzeichnerrolle) und hängen Sie sie an Composite Templates an.

   Beispiel für einen JSON-Ausschnitt (Verwenden von Node.js oder ähnlichen Tools für API-Aufrufe):

   {
     "status": "sent",
     "emailSubject": "Please sign the merged agreement",
     "compositeTemplates": [
       {
         "compositeTemplateId": "template1",
         "document": {
           "documentBase64": "base64_of_pdf1",
           "name": "Main Contract",
           "fileExtension": "pdf",
           "documentId": "1"
         },
         "serverTemplates": [
           {
             "sequence": "1",
             "templateId": "your-template-id-1"
           }
         ],
         "inlineTemplates": [
           {
             "sequence": "1",
             "recipients": {
               "signers": [
                 {
                   "email": "signer@example.com",
                   "name": "John Doe",
                   "recipientId": "1",
                   "tabs": {
                     "signHereTabs": [
                       {
                         "documentId": "1",
                         "pageNumber": "1",
                         "xPosition": "100",
                         "yPosition": "200"
                       }
                     ]
                   }
                 }
               ]
             }
           }
         ]
       },
       {
         "compositeTemplateId": "template2",
         "document": {
           "documentBase64": "base64_of_pdf2",
           "name": "Addendum",
           "fileExtension": "pdf",
           "documentId": "2"
         },
         "serverTemplates": [
           {
             "sequence": "2",
             "templateId": "your-template-id-2"
           }
         ]
       }
     ],
     "recipients": {
       "signers": [
         {
           "email": "signer@example.com",
           "name": "John Doe",
           "recipientId": "1",
           "routingOrder": "1"
         }
       ]
     }
   }
   

   Dadurch werden pdf1 und pdf2 zu einem Umschlag zusammengeführt. Die erste Composite Template hängt Vorlage 1 an das erste PDF an und fügt Signatur-Registerkarten hinzu; die zweite fügt den Anhang über Vorlage 2 hinzu. Der Empfänger signiert das zusammengeführte Dokument, ohne separate Umschläge anzuzeigen.

3. Behandeln Sie die Zusammenführungslogik:

   • Verwenden Sie documentId, um eindeutig auf PDFs zu verweisen. Registerkarten aus Vorlagen gelten für bestimmte Dokumente, werden aber in einer einheitlichen Ansicht angezeigt.
   • Für die Massenzusammenführung integrieren Sie die Bulk Send API (Business Pro- oder Advanced-Plan) mit einem Limit von etwa 100 Sendungen pro Benutzer und Jahr.
   • Fehlerbehandlung: Validieren Sie die Base64-Größe (maximal 5 MB pro Dokument) und stellen Sie sicher, dass die OAuth-Bereiche signature enthalten.

4. Senden und überwachen Sie den Umschlag:

   • POST an https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes.
   • Rufen Sie den Status über /envelopes/{envelopeId} ab. Abgeschlossene Umschläge geben das zusammengeführte PDF über die API zurück.
   • Geschäftstipp: Verwenden Sie in Produktionsumgebungen Webhooks (Connect-Funktion im Advanced-Plan) für Echtzeitbenachrichtigungen über den Abschluss der Signatur.

5. Testen und optimieren Sie:

   • Sandbox-Tests verbrauchen keine Umschlagkontingente. Überwachen Sie die Nutzung im API-Dashboard, um Überschreitungen zu vermeiden - der Starter-Plan ist auf 40 Umschläge pro Monat beschränkt.
   • Für komplexe Zusammenführungen kombinieren Sie PowerForms für öffentlich zugängliche Vorlagen, um die Skalierbarkeit für E-Commerce oder Partner-Onboarding zu verbessern.

Branchen-Benchmarks zufolge kann dieser Ansatz die Dokumentenvorbereitungszeit in Umgebungen mit hohem Volumen um 50-70 % reduzieren. Für Unternehmen kann eine benutzerdefinierte Integration jedoch einen Enterprise API-Plan erfordern, dessen Preisgestaltung auf die Kapazität zugeschnitten ist.

Integration mit DocuSign IAM CLM

Das Intelligent Agreement Management (IAM) und das Contract Lifecycle Management (CLM) von DocuSign erweitern den Wert von Composite Templates. IAM bietet KI-gesteuerte Risikobewertung und Klausel-Extraktion, während CLM eine End-to-End-Workflow-Automatisierung bietet, einschließlich Vorlagenbibliotheken und Analysen. Im API-Kontext werden diese mit Composite Templates für die dynamische PDF-Generierung integriert - z. B. das Abrufen von Daten aus CRM-Systemen, um zusammengeführte Dokumente zu befüllen. Unternehmen in regulierten Branchen wie dem Finanzwesen profitieren von den Compliance-Tools von IAM wie Audit Trails und SSO, obwohl zusätzliche Funktionen wie die Identitätsprüfung zu nutzungsabhängigen Gebühren führen.

Bewertung von E-Signatur-Plattformen im Wettbewerbsumfeld

Mit der Globalisierung von Unternehmen erfordert die Auswahl eines E-Signatur-Anbieters ein Gleichgewicht zwischen API-Flexibilität, Compliance und Kosten. DocuSign ist führend mit robusten API-Funktionen wie Composite Templates, aber Alternativen bieten unterschiedliche Vorteile. Adobe Sign zeichnet sich durch PDF-zentrierte Prozesse aus und lässt sich nahtlos in Adobe Acrobat für die erweiterte Bearbeitung vor der Zusammenführung integrieren. Seine API unterstützt ähnliche Composite-Strukturen über "Vereinbarungen", wobei die Basispläne bei 10 US-Dollar/Benutzer/Monat beginnen.

HelloSign (jetzt Dropbox Sign) bietet eine benutzerfreundliche API für einfache Zusammenführungen und betont die Benutzerfreundlichkeit für KMUs, wobei sein 15 US-Dollar/Benutzer/Monat-Plan unbegrenzte Vorlagen bietet. Es fehlt die Tiefe von DocuSign in Bezug auf bedingte Logik, zeichnet sich aber durch schnelle Integrationen mit Tools wie Google Workspace aus.

eSignGlobal positioniert sich als globaler Wettbewerber und unterstützt die Compliance in 100 wichtigen Ländern und Regionen. Es hat eine Stärke im asiatisch-pazifischen Raum (APAC), wo die E-Signatur-Gesetze fragmentiert, hochgradig und streng reguliert sind - was oft Ökosystemintegrationsansätze anstelle der rahmenbasierten ESIGN/eIDAS-Modelle erfordert, die in den USA und Europa üblich sind. APAC-Anforderungen erfordern eine tiefe Hardware-/API-Integration mit digitalen Identitäten von Behörden zu Unternehmen (G2B), was die technologische Hürde über E-Mail-Validierung oder Selbsterklärung hinaus erhöht. eSignGlobal lässt sich nahtlos in iAM Smart in Hongkong und Singpass in Singapur integrieren und bietet Funktionen wie Bulk Send und KI-Vertragstools. Sein Essential-Plan kostet 16,6 US-Dollar/Monat und Jahr und ermöglicht 100 Dokumentensendungen, unbegrenzte Benutzerlizenzen und Zugriffscode-Validierung - und bietet einen starken Wert auf Compliance-Basis mit einem leichten Kostenvorteil gegenüber Wettbewerbern. Die Plattform expandiert aggressiv in europäische und amerikanische Märkte, um die etablierten Marktführer herauszufordern.

Suchen Sie eine intelligentere Alternative zu DocuSign?

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

👉 Starten Sie eine kostenlose Testversion

Vergleichstabelle der Wettbewerber

Diese Tabelle hebt neutrale Kompromisse hervor: DocuSign ist für API-Anforderungen mit hohem Volumen geeignet, während andere Plattformen Erschwinglichkeit oder regionale Anpassungsfähigkeit priorisieren.

Abschließende Gedanken zur Auswahl von E-Signaturen

Zusammenfassend lässt sich sagen, dass die Composite Templates von DocuSign eine robuste Möglichkeit bieten, PDFs über die API zusammenzuführen und so die Effizienz von Geschäftsprozessen zu steigern. Für Teams, die Alternativen suchen, erweist sich eSignGlobal als neutrale, regional konforme Option, insbesondere für APAC-Operationen.