Produkt-Updates Mai 2026

Diesen Monat wurden sechs Updates veröffentlicht, die das Branding, die UX bei der Unterzeichnung und eine präzisere API-Steuerung des Unterzeichnungsprozesses betreffen. Hier ist das Neue auf einen Blick.

Logo-Upload für Unternehmen und Arbeitsbereiche

Sie können jetzt Ihr eigenes Logo hochladen, das auf Signaturzertifikaten und in Benachrichtigungs-E-Mails angezeigt wird. Laden Sie eine PNG- oder JPEG-Datei (bis zu 2 MB) über die Einstellungen > Darstellung hoch, oder verwalten Sie Logos programmgesteuert über die API. Logos werden auf Zertifikaten mit einer maximalen Größe von 180x50px angezeigt, wobei ihr ursprüngliches Seitenverhältnis beibehalten wird.

Die Prioritätskette funktioniert genauso wie andere kaskadierende Einstellungen in Firma.dev: Das Logo des Arbeitsbereichs überschreibt das Unternehmenslogo, welches wiederum die Standardeinstellung überschreibt. Wenn Sie ein Multi-Brand-Setup mit Kunden-Arbeitsbereichen betreiben, kann jeder Arbeitsbereich sein eigenes Branding tragen. Wenn kein benutzerdefiniertes Logo festgelegt ist, fallen die Zertifikate auf den Standard von Firma.dev zurück.

API-Endpunkte: POST /company/logo und DELETE /company/logo für das Branding auf Unternehmensebene. POST /workspaces/{id}/logo und DELETE /workspaces/{id}/logo für das Branding auf Arbeitsbereichsebene. Das Feld icon_url in GET-Antworten gibt eine öffentlich zugängliche URL zur Gewährleistung der E-Mail-Kompatibilität zurück. Alle Details finden Sie im API-Changelog v1.19.0.

Steuerung der geführten Navigation

Standardmäßig scrollt Firma.dev Unterzeichner automatisch zum nächsten erforderlichen Feld, sobald sie das vorherige ausgefüllt haben. Das funktioniert bei kurzen Formularen gut, kann aber bei längeren Dokumenten, bei denen Unterzeichner den Inhalt der Reihe nach lesen müssen, desorientierend wirken.

Sie können dieses automatische Scrollverhalten nun mit einem einzigen Schalter deaktivieren. Wenn die geführte Navigation ausgeschaltet ist, bewegen sich die Unterzeichner im eigenen Tempo durch das Dokument. Die Schaltfläche „Nächstes Pflichtfeld“ ist weiterhin für alle verfügbar, die sie nutzen möchten, sodass für Unterzeichner, die den geführten Ablauf bevorzugen, nichts beeinträchtigt wird.

Wie andere Einstellungen in Firma.dev kaskadiert auch diese über vier Ebenen: Unternehmen, Arbeitsbereich, Vorlage und Signaturanforderung. Jede Ebene überschreibt die darüber liegende, was Ihnen eine präzise Kontrolle über den Unterzeichnungsprozess pro Dokument oder pro Client ermöglicht.

Der neue Parameter disable_guided_navigation ist für POST/PATCH /signing-requests, POST/PATCH /templates sowie für die Endpunkte der Arbeitsbereichs-/Unternehmenseinstellungen verfügbar. Es gilt dasselbe Kaskadierungsmuster wie bei require_otp_verification. Alle Details finden Sie im API-Changelog v1.20.0.

Geführter Unterzeichnungsablauf

Die Unterzeichneransicht führt die Unterzeichner nun Feld für Feld durch die Dokumente. Wenn ein Unterzeichner den Bedingungen zustimmt und das Dokument geladen wird, wird das erste Pflichtfeld automatisch hervorgehoben und in den Fokus gescrollt.

Nach dem Ausfüllen eines Feldes wechselt die Ansicht nach einer kurzen Verzögerung automatisch zum nächsten Feld. Ein schwebendes Label über dem aktiven Feld teilt dem Unterzeichner genau mit, was erforderlich ist: „Hier unterschreiben“, „Text eingeben“, „Datum auswählen“ oder „Datei hochladen“. Eine Statusleiste am oberen Rand zeigt an, wie viele der erforderlichen Felder insgesamt ausgefüllt wurden.

Die Tastaturnavigation funktioniert ebenfalls. Unterzeichner können mit der Tabulatortaste in Leserichtung durch die Felder navigieren und die Eingabetaste drücken, um fortzufahren, sodass der gesamte Unterzeichnungsprozess abgeschlossen werden kann, ohne eine Maus zu berühren. Dies ist eine spürbare Verbesserung für Dokumente mit vielen Feldern, bei denen Unterzeichner zuvor hin- und herscrollen mussten, um herauszufinden, was sie übersehen hatten.

Editierbare vorausgefüllte Datenfelder

Vorausgefüllte Datenfelder können nun optional von den Unterzeichnern bearbeitet werden, anstatt immer gesperrt zu sein. Ein neuer Schalter prefilledEditable in den Formatierungsregeln des Feldes steuert, ob Unterzeichner den vorausgefüllten Wert während der Unterzeichnung ändern können.

Dies ist im Vorlagen-Editor, im Signaturanforderungs-Editor, in beiden eingebetteten Editoren und in der vollständigen REST-API verfügbar. Auf der Benutzeroberfläche des Editors wird es als Kontrollkästchen „Unterzeichner das Bearbeiten dieses Werts erlauben“ angezeigt, wenn vorausgefüllte Daten ausgewählt sind.

Der typische Anwendungsfall: Verträge, bei denen Formulardaten Felder (Name, Adresse, Mitarbeiter-ID) vorausfüllen, aber Unterzeichner vor der Unterschrift eventuell Korrekturen vornehmen müssen. Bestehende vorausgefüllte Felder bleiben standardmäßig gesperrt, sodass sich nichts ändert, es sei denn, Sie aktivieren diese Option explizit.

Explizite Feldwerte über die API

API-Nutzer können jetzt beim Erstellen von Signaturanforderungen einen expliziten value für jedes Feld festlegen, unabhängig vom Mechanismus für vorausgefüllte Daten oder von den Read-Only-Einstellungen. Übergeben Sie value für ein beliebiges Feldobjekt in POST /signing-requests oder POST /signing-requests/create-and-send, und dieser Wert erhält Vorrang vor automatisch ausgefüllten Empfängerdaten.

Dies bietet Ihnen eine saubere Möglichkeit, vertragsspezifische Werte wie Beträge, Daten oder Referenznummern zum Zeitpunkt der Erstellung programmatisch einzufügen, ohne Konfigurationen für vorausgefüllte Datenzuordnungen vornehmen zu müssen. Die API validiert die gegenseitige Exklusivität, sodass Sie eine eindeutige Fehlermeldung 400 VALIDATION_ERROR erhalten, wenn widersprüchliche Wertquellen für ein einzelnes Feld festgelegt werden.

Editierbare Identitätsfelder

Unterzeichner können nun ihre Identitätsdaten (Name, Firma, Position, Telefon, Adresse) vor der Unterzeichnung über einen Bestätigungsdialog überprüfen und bearbeiten. Eine neue Einstellung identity_editable_fields akzeptiert ein Array von Feld-Keys, um diese editierbar zu machen, oder null, um die Funktion vollständig zu deaktivieren.

Sie können verschiedene editierbare Felder pro Empfänger festlegen, sodass beispielsweise ein Unterzeichner seine Position und Firma aktualisieren kann, während die Daten eines anderen gesperrt sind. Wenn ein Unterzeichner seine Identität ändert, kann Firma.dev Sie über ein neues Webhook-Ereignis signing_request.signer_identity_changed und optionale E-Mail-Benachrichtigungen informieren. Beide werden über die Einstellungen notify_identity_change_webhook und notify_identity_change_email gesteuert.

Standardmäßig deaktiviert, vollständig abwärtskompatibel.

API-Referenz

Der Logo-Upload und die Steuerung der geführten Navigation sind Teil von API v1.19.0 beziehungsweise v1.20.0. Die anderen vier Funktionen wurden in v1.18.0 veröffentlicht. Wenn Sie bereits integriert sind, aktualisieren Sie Ihre API-Version, um auf die neuen Endpunkte und Feldeigenschaften zuzugreifen.

Nutzen Sie Firma.dev noch nicht? Starten Sie kostenlos, keine Kreditkarte erforderlich.