Zum Hauptinhalt springen

Juni 2026

Erhöhung des File-Upload-Limits (10 MB → 40 MB)​

Die maximale Dateigrösse für Dokument-Uploads wurde von 10 MB auf 40 MB erhöht, sodass grössere PDF-Dokumente an einen Signaturprozess angehängt werden können.

Integration: Gilt für Dokument-Uploads über den Endpoint POST /api/process/{processId}/attach.

Zugehörige API: Plattform-Update (keine spezifische API-Version)

Tag-basierte Signaturpositionierung via Integration API​

Signaturpositionen können zur Laufzeit bestimmt werden, indem nach einer im PDF eingebetteten Tag-Zeichenfolge gesucht wird – über locator: TAG am Attach-Endpoint. Der Tag (\s1\ für Index 0, \s2\ für Index 1 usw.) markiert die obere linke Ecke des Signaturfelds. Optionale offsetX / offsetY (PDF-Punkte, −200 bis 200) ermöglichen eine Feinabstimmung; Koordinaten sind nicht erforderlich.

Integration: Setzen Sie locator: TAG an einer Signaturposition im Endpoint POST /api/process/{processId}/attach.

tipp

Betten Sie die Tags vor dem Hochladen direkt in das PDF ein. Verwenden Sie für die Tags weisse Schrift, damit sie im PDF-Viewer unsichtbar bleiben, von der API aber weiterhin erkannt werden.

Zugehörige API-Version: 2.15.0

Reminder-Konfiguration via Integration API​

Der Release-Endpoint unterstützt jetzt optionale automatische Erinnerungen für Teilnehmende, die ihre Signaturaktion noch nicht abgeschlossen haben. Erinnerungen werden im reminder-Objekt des notification-Knotens konfiguriert; die beiden folgenden Modi können kombiniert werden.

Beide Modi verwenden ISO-8601-Dauern (z. B. P3D = 3 Tage), und jeder Wert muss zwischen P1D (1 Tag) und P30D (30 Tage) liegen:

  • interval — eine einzelne Dauer, die eine wiederkehrende Erinnerung sendet, solange die teilnehmende Person noch aussteht. Beispielsweise sendet P3D alle 3 Tage eine Erinnerung, bis die Person handelt oder der Prozess abläuft.
  • beforeExpiry — ein Array von Dauern, die feste Erinnerungen relativ zum Prozessablauf (validUntil) senden. Pro Offset wird eine Erinnerung gesendet; z. B. erinnert ["P5D", "P1D"] 5 Tage und 1 Tag vor Ablauf. Dieser Modus erfordert, dass der Prozess ein validUntil hat.

Beispiel-notification-Payload beim Release:

{
  "notification": {
    "locale": "de-CH",
    "reminder": {
      "interval": "P3D",
      "beforeExpiry": ["P5D", "P1D"]
    }
  }
}

Integration: Konfigurieren Sie Erinnerungen im notification.reminder-Objekt des Endpoints POST /api/process/{processId}/release.

Zugehörige API-Version: 2.17.0