Ratgeber

DocuSeal: unterschriebene Dokumente automatisch drucken (Webhook)

In DocuSeal unterschriebene PDFs automatisch drucken: Webhook submission.completed, DocuSeal API und Sealed Print, mit n8n, Zapier, Make oder eigenem Server.

Aktualisiert am 21. Oktober 2026

DocuSeal sammelt Unterschriften, aber viele unterschriebene Dokumente werden trotzdem auf Papier gebraucht: der Vertrag für die Akte, der Lieferschein für das Lager, das Übergabeprotokoll für den Hausmeister oder die Einwilligung, die abgeheftet werden muss. DocuSeal selbst druckt nicht. Dieser Artikel zeigt, wie jedes in DocuSeal unterschriebene Dokument automatisch auf einem Bürodrucker landet, mit dem DocuSeal-Webhook submission.completed und Sealed Print. Das funktioniert mit DocuSeal Cloud und mit selbst gehostetem DocuSeal, und am Router im Büro muss nichts geöffnet werden.

So funktioniert es

  1. Sobald der letzte Unterzeichner unterschrieben hat, schickt DocuSeal einen Webhook mit dem Ereignis submission.completed an eine Adresse Ihrer Wahl. Der Webhook enthält JSON, nicht das PDF: Die unterschriebenen Dokumente kommen als Download-Links.
  2. Eine Automation lädt das unterschriebene PDF über diesen Link herunter: ein n8n-Workflow, ein Zap, ein Make-Szenario oder ein paar Zeilen Code auf dem eigenen Server.
  3. Die Automation schickt das PDF an eine geheime Sealed-Print-Adresse, einen API-Endpunkt. Sealed Print macht daraus einen Druckauftrag und stellt ihn dem Drucker zu: über den Relay-Client auf einem Computer oder NAS im Büro, direkt an Drucker mit IPP INFRA oder per IPP an einen Drucker, der aus dem Internet erreichbar ist.

Relay-Client und INFRA-Drucker bauen nur ausgehende Verbindungen auf. DocuSeal, Automation und Drucker müssen nicht im selben Netzwerk sein.

Voraussetzungen

  • DocuSeal mit Webhooks: DocuSeal Cloud im Tarif Pro oder selbst gehostetes DocuSeal. Laut Preisseite von DocuSeal hat der kostenlose Tarif Cloud Basic keine Webhooks, die Open-Source-Version schon.
  • Ein Sealed-Print-Konto mit mindestens einem Ziel, also einem Drucker. Wie Sie einen Bürodrucker anbinden, steht in der Anleitung Relay-Client installieren.
  • Der Eingangskanal REST API ist unter Einstellungen → Eingangskanäle eingeschaltet. Bei Organisationen, die seit dem 21. Oktober 2026 angelegt wurden, ist er an; in älteren schaltet ihn ein Admin ein.
  • Eine Automation, die den Webhook empfängt: n8n, Zapier (für Webhooks ein bezahlter Tarif), Make oder ein kleiner eigener Server.

Welches Webhook-Ereignis von DocuSeal

DocuSeal kennt diese Ereignisse, Sie wählen sie pro Webhook-Adresse aus:

EreignisWann es kommtZum Drucken geeignet?
submission.completedalle haben unterschriebenja, kommt einmal pro Vorgang
form.completedein Unterzeichner ist fertignur wenn jede Unterschrift einzeln gedruckt werden soll
form.viewed, form.started, form.declinedjemand hat das Formular geöffnet, begonnen oder abgelehntnein
submission.created, submission.expired, submission.archivedVorgang angelegt, abgelaufen oder archiviertnein

Die Nutzlast sieht so aus (gekürzt). DocuSeal schickt sie als JSON mit dem Header Content-Type: application/json:

{
  "event_type": "submission.completed",
  "timestamp": "2026-10-21T09:41:12Z",
  "data": {
    "id": 4711,
    "status": "completed",
    "template": { "id": 12, "name": "Dienstleistungsvertrag" },
    "documents": [
      { "name": "dienstleistungsvertrag", "url": "https://…/file/…" }
    ],
    "combined_document_url": "https://…/file/…",
    "audit_log_url": "https://…/file/…"
  }
}
  • documents enthält die unterschriebenen PDFs mit name und Download-url. Meist drucken Sie documents[0].url; bei mehreren Dokumenten gehen Sie die Liste durch.
  • combined_document_url ist ein PDF mit allen Dokumenten des Vorgangs.
  • audit_log_url ist das Prüfprotokoll von DocuSeal, falls Sie es auch auf Papier brauchen.

Die Download-Links laufen ab. Standardmäßig gelten sie 40 Minuten. Laden Sie das PDF deshalb sofort in derselben Automation herunter, nicht in einem Lauf Stunden später. Bei selbst gehostetem DocuSeal legt die Umgebungsvariable FILE_URLS_EXPIRE_MINUTES die Gültigkeit fest.

Schritt 1: API-Endpunkt in Sealed Print anlegen

  1. Gehen Sie zu Quellen → API-Endpunkte und wählen Sie Neuer API-Endpunkt.
  2. Geben Sie einen Namen ein, zum Beispiel „DocuSeal Verträge“.
  3. Wählen Sie unter Ziel den Drucker, die Zielgruppe oder den Ablauf für die unterschriebenen Dokumente.
  4. Wählen Sie Erstellen und kopieren Sie die Endpunkt-URL: https://www.sealedprint.com/api/print/sp_ep_…

Die URL ist der Zugangsschlüssel: Wer sie kennt, kann Dokumente an Ihren Drucker schicken. Hinterlegen Sie sie in den Zugangsdaten der Automation, nicht in einem geteilten Dokument. Mehr dazu in der Anleitung API-Endpunkte.

Schritt 2: Die Automation bauen

Variante A: n8n

  1. Fügen Sie einen Webhook-Node mit HTTP Method POST hinzu und kopieren Sie seine Production URL.

  2. Fügen Sie einen If-Node mit der Bedingung {{ $json.body.event_type }} ist gleich submission.completed hinzu. So werden andere Ereignisse ignoriert, falls Sie mehr abonnieren.

  3. Fügen Sie einen HTTP Request-Node hinzu, der das PDF herunterlädt:

    EinstellungWert
    MethodGET
    URL{{ $json.body.data.documents[0].url }}
    Options → Response → Response FormatFile
  4. Fügen Sie einen zweiten HTTP Request-Node hinzu, der das PDF an Sealed Print schickt:

    EinstellungWert
    MethodPOST
    URLIhre Endpunkt-URL https://www.sealedprint.com/api/print/sp_ep_…
    Send Query Parametersan, name = {{ $('Webhook').item.json.body.data.template.name }}
    Send Bodyan
    Body Content Typen8n Binary File
    Input Data Field Namedata
  5. Aktivieren Sie den Workflow. In DocuSeal tragen Sie die Production URL als Webhook ein (Schritt 3).

Weitere Druckoptionen und den Parameter targets für andere Drucker beschreibt Aus n8n automatisch drucken.

Variante B: Zapier

  1. Auslöser: Webhooks by Zapier mit dem Ereignis Catch Hook. Kopieren Sie die Webhook-Adresse.
  2. Filter: nur weiter, wenn event_type gleich submission.completed ist.
  3. Aktion: Code by Zapier mit Run Javascript. Eingabedaten: file = das Feld data documents url aus dem Auslöser, name = data template name, endpoint = Ihre Endpunkt-URL. Dazu dieser Code:
const source = await fetch(inputData.file)
if (!source.ok) {
    throw new Error(`Download von DocuSeal fehlgeschlagen: HTTP ${source.status}`)
}
const url = new URL(inputData.endpoint)
url.searchParams.set("name", inputData.name || "DocuSeal")
const response = await fetch(url, {
    method: "POST",
    headers: { "Content-Type": "application/pdf" },
    body: Buffer.from(await source.arrayBuffer()),
})
const text = await response.text()
if (!response.ok) {
    throw new Error(`Sealed Print: HTTP ${response.status} ${text}`)
}
const job = JSON.parse(text)
output = { id: job.id, number: job.number, state: job.state }

Hat der Vorgang mehrere Dokumente, übergibt Zapier die Links als kommagetrennte Liste; drucken Sie das erste oder teilen Sie die Liste im Code auf. Mehr zu Zapier in Aus Zapier drucken.

Variante C: Make

  1. Webhooks > Custom webhook als Auslöser; Adresse kopieren.
  2. Ein Filter auf event_type = submission.completed.
  3. HTTP > Download a file mit der URL data.documents[1].url (Make zählt Listen ab 1).
  4. HTTP > Make a request, Methode POST, Ihre Endpunkt-URL, Multipart-Body mit einem Feld vom Typ File namens file, das die heruntergeladene Datei übernimmt.

Die Einzelheiten zur Anfrage in Make stehen in Aus Make drucken.

Variante D: der eigene Server

Läuft DocuSeal ohnehin auf dem eigenen Server, kann ein kleiner Dienst den Webhook empfangen. Dieses Beispiel für Node.js ab Version 20 prüft die Signatur von DocuSeal, lädt das unterschriebene PDF herunter und schickt es an Sealed Print:

import { createHmac, timingSafeEqual } from "node:crypto"
import { createServer } from "node:http"

const SECRET = process.env.DOCUSEAL_WEBHOOK_SECRET // Signaturschlüssel aus den Webhook-Einstellungen von DocuSeal
const ENDPOINT = process.env.SEALEDPRINT_ENDPOINT // https://www.sealedprint.com/api/print/sp_ep_…

function signatureValid(header, body) {
    const [timestamp, signature] = String(header ?? "").split(".")
    if (!timestamp || !signature || Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) {
        return false
    }
    const expected = createHmac("sha256", SECRET).update(`${timestamp}.${body}`).digest("hex")
    return expected.length === signature.length && timingSafeEqual(Buffer.from(expected), Buffer.from(signature))
}

createServer(async (request, response) => {
    let body = ""
    for await (const chunk of request) {
        body += chunk
    }
    if (!signatureValid(request.headers["x-docuseal-signature"], body)) {
        response.writeHead(401).end()
        return
    }
    const event = JSON.parse(body)
    if (event.event_type === "submission.completed") {
        for (const document of event.data.documents) {
            const pdf = await fetch(document.url)
            const url = new URL(ENDPOINT)
            url.searchParams.set("name", `${event.data.template.name} – ${document.name}`)
            await fetch(url, {
                method: "POST",
                headers: { "Content-Type": "application/pdf" },
                body: Buffer.from(await pdf.arrayBuffer()),
            })
        }
    }
    response.writeHead(200).end()
}).listen(3000)

DocuSeal signiert jeden Webhook mit dem Header X-Docuseal-Signature in der Form Zeitstempel.Signatur: ein HMAC-SHA256 über Zeitstempel.Nutzlast mit dem Signaturschlüssel des Webhooks. Die Prüfung oben lehnt außerdem Anfragen ab, die älter als fünf Minuten sind. Stellen Sie den Dienst hinter HTTPS; DocuSeal Cloud schickt Webhooks nur an HTTPS-Adressen.

Schritt 3: Den Webhook in DocuSeal eintragen

  1. Öffnen Sie in DocuSeal Settings → Webhooks.
  2. Tragen Sie die Adresse aus Schritt 2 ein (Production URL von n8n, Webhook-Adresse von Zapier oder Make oder Ihr Server).
  3. Wählen Sie das Ereignis submission.completed.
  4. Notieren Sie bei Bedarf den Signaturschlüssel, oder hinterlegen Sie einen eigenen geheimen Header, den Ihre Automation prüft.
  5. Schicken Sie eine Testanfrage und unterschreiben Sie dann ein Testdokument. Das unterschriebene PDF erscheint in der Warteschlange von Sealed Print und wird gedruckt.

Schlägt ein Webhook fehl oder antwortet Ihre Automation mit einem Fehler, wiederholt DocuSeal ihn mit wachsenden Pausen. Antworten Sie deshalb schnell mit HTTP 200 und erledigen Sie langsame Arbeit danach, sonst kann eine Wiederholung das Dokument ein zweites Mal drucken.

Druckoptionen und Zieldrucker

Der API-Endpunkt nimmt dieselben Query-Parameter an wie jeder andere Sealed-Print-Endpunkt, zum Beispiel:

ParameterBeispielWirkung
nameDienstleistungsvertrag – MüllerName des Auftrags in der Warteschlange
copies2ein Exemplar für die Akte, eines für den Kunden
sidestwo-sided-long-edgebeidseitig
targetsbuerodruckt auf dem Ziel mit der Kennung buero statt auf dem Ziel des Endpunkts
noTargettruebehält den Auftrag in Sealed Print, bis ihn jemand prüft und abschickt

Die vollständige Liste steht in Aus n8n automatisch drucken. Ist das Ziel des Endpunkts ein Ablauf, kann das Dokument zuerst in Sealed Print warten, etwa um vor dem Druck geprüft zu werden.

Fehler und was sie bedeuten

  • HTTP 401 oder 403 beim Download-Link von DocuSeal: Der Link ist abgelaufen. Laden Sie das PDF im selben Lauf wie den Webhook herunter.
  • HTTP 403 von Sealed Print: Der Eingangskanal REST API ist ausgeschaltet, oder die Person, der der Endpunkt gehört, hat die Organisation verlassen.
  • HTTP 404 von Sealed Print: Die Endpunkt-URL ist falsch oder wurde mit Neue URL erzeugen ersetzt, oder eine Kennung in targets existiert nicht.
  • HTTP 413: Das PDF ist größer als 50 MB oder größer, als Ihr Tarif erlaubt.
  • HTTP 415: Die Anfrage hat keinen Content-Type application/pdf. Setzen Sie ihn wie in den Beispielen.

Unterschreiben und Drucken an einem Ort

Werden die Dokumente nur unterschrieben, um danach gedruckt zu werden, kann Sealed Print die Unterschriften auch selbst einholen: Das unterschriebene PDF bekommt auf jeder Seite einen Prüfcode und einen QR-Code und geht ohne Automation dazwischen an den Drucker. Mehr unter Elektronische Signaturen. Wer schon mit DocuSeal-Vorlagen und der DocuSeal API arbeitet, ist mit dem hier beschriebenen Webhook schneller am Ziel.

Häufige Fragen

Kann DocuSeal Dokumente drucken?

Nein. DocuSeal hat keine Druckfunktion und keine Druckeranbindung. Sie können das unterschriebene PDF herunterladen und von Hand drucken oder es, wie hier beschrieben, per Webhook an einen Cloud-Druckdienst schicken, der es dem Drucker zustellt.

Welches Webhook-Ereignis kommt, wenn alle unterschrieben haben?

submission.completed. Das Ereignis form.completed kommt für jeden einzelnen Unterzeichner; ein Vorgang mit drei Unterzeichnern würde damit dreimal gedruckt.

Funktioniert das mit selbst gehostetem DocuSeal?

Ja. Die Open-Source-Version schickt dieselben Webhooks. Die Automation braucht nur Internetzugang, der Drucker bleibt im Büro hinter dem Relay-Client.

Kann ich auch das Prüfprotokoll drucken?

Ja. Der Webhook enthält audit_log_url. Laden Sie es wie das Dokument herunter und schicken Sie es an denselben API-Endpunkt, oder nehmen Sie combined_document_url, wenn alles in einem PDF kommen soll.

Die Datei-Links von DocuSeal gelten standardmäßig 40 Minuten. Wartet Ihre Automation länger, fragen Sie den Vorgang über die DocuSeal API (GET /submissions/{id}) erneut ab und erhalten frische Links.

Was kostet das?

Sealed Print rechnet pro Zustellung ab, also pro Auftrag an einen Drucker; die Tarife stehen auf der Seite Preise. DocuSeal-Webhooks brauchen DocuSeal Cloud Pro oder die selbst gehostete Version, Zapier für Webhooks einen bezahlten Tarif.

Print and sign from anywhere

Unterzeichner unterschreiben per E-Mail-Link ohne Konto; alle erhalten das gesiegelte PDF. Im Tarif Free zahlen Sie nur pro Unterschrift.

Weitere Ratgeber und Vorlagen