4,8-Sterne-Bewertung auf g2.com
PDF aktualisiert? Sie müssen Ihre Vorlage nicht neu erstellen.
Wenn Sie jemals Signaturvorlagen in der Produktion verwaltet haben, haben Sie dieses Problem gehabt. Ein Anwalt ändert eine Klausel. Die Rechtsabteilung sendet ein überarbeitetes PDF. Ihre NDA-Vorlage mit 14 Feldern muss jetzt von Grund auf neu erstellt werden: das Dokument erneut hochladen, jedes Feld ersetzen, jeden Unterzeichner neu zuweisen.
Für eine Vorlage ist das eine Stunde Arbeit. Für zehn Vorlagen über fünfzig Kundenarbeitsbereiche, wird es zu einem echten Problem.
Der Austausch des Vorlagendokuments löst es. Tauschen Sie das zugrunde liegende PDF in einer beliebigen Vorlage aus, und jedes Feld, jede Unterzeichnerzuweisung und jede Einstellung bleibt genau dort, wo sie war.
Das Problem, das es löst
Vorlagen sind der Ort, an dem die eigentliche Arbeit stattfindet.
Sie stellen häufig fest, dass der API-Zugang Sinn macht, weil sie bereits für die Plattform bezahlen. Die Erweiterung des Entwicklerzugangs zu einem bestehenden Enterprise-Vertrag ist in der Regel verhandelbar, und die rechtliche/beschaffungsmäßige Arbeit ist bereits erledigt.
Gleiche Struktur. Gleiche Felder. Keine Möglichkeit, sie zu behalten... Bis jetzt.
Die Auslöser sind häufig: ein Tippfehlerbehebung, eine Klauselrevision, eine umbenannte Überschrift, eine Aktualisierung des Rechtsteams, eine regulatorische Änderung. Die Dokumentstruktur bleibt gleich, die Seiten bleiben gleich, die Felder sollten gleich bleiben. Bisher gab es keine Möglichkeit, diese Arbeit zu bewahren. Jetzt gibt es eine.
Wie es funktioniert
Tauschen Sie die PDF aus. Alles andere bleibt gleich.
Laden Sie eine neue PDF hoch. Firma.dev überprüft, ob die Seitenzahl mit dem Original übereinstimmt und ob die Seitendimensionen innerhalb einer Toleranz von 1pt liegen. Wenn beide Prüfungen bestanden werden, wird das Dokument sofort ausgetauscht. Jede Feldposition, jede Zuweisung des Unterzeichners und jede Vorlageinstellung bleibt unverändert.
Warum die Validierungsregeln existieren
Die Validierungsregeln sind keine willkürlichen Einschränkungen, sondern Schutzmaßnahmen. Wenn sich die Seitenanzahl ändert oder sich die Maße erheblich verschieben, würden sich die Feldpositionen von der Seite entfernen oder an die falsche Stelle gelangen. Die Toleranz von 1pt deckt geringfügige Rendering-Unterschiede zwischen PDF-Exporten aus derselben Quelldatei ab, während sie Ersetzungen blockiert, die Ihre Felder falsch ausrichten würden.
Drei Oberflächen unterstützen Dokumentenersatz
Hauptvorlageneditor
Eine Schaltfläche „Dokument ersetzen“ im Vorlagenkopf. Direkt aus der Benutzeroberfläche hochladen.
Eingebetteter Editor
Server-seitige Validierung über die Edge-Funktion mit JWT-Authentifizierung. Funktioniert in jeder eingebetteten Integration.
REST-API
POST /templates/{id}/replace-document
mit einem base64-codierten PDF.
Die Verwendung der API
Der Endpunkt ist unkompliziert. Kodieren Sie Ihr Ersatz-PDF als Base64 und senden Sie es per POST an die Vorlage (API-Referenz: https://docs.Firma.dev/api-reference/v01.09.00/templates/replace-template-document)
Die Antwort ist das aktualisierte Template-Objekt. Wenn die Validierung fehlschlägt, erhalten Sie einen 400 mit einem klaren Fehlerhinweis, der angibt, ob das Problem ein Seitenzahlfehler, ein Größenfehler oder ein ungültiges PDF ist.
Validierungsregeln
DOC- und DOCX-Uploads über die Benutzeroberfläche werden vor der Validierung automatisch in PDF umgewandelt. Die API akzeptiert PDFs direkt.
Überprüfen Sie
Anforderung
Seitenanzahl
Muss genau mit dem Original übereinstimmen
Seitengröße
Muss innerhalb von 1 Punkt Toleranz pro Seite übereinstimmen
Dateiformat
Base64-codiertes PDF über API; PDF, DOC oder DOCX (bis zu 60MB) über UI
Für wen das ist
Rechts- und Compliance-Teams, die Vertragsformulierungen überarbeiten
Wenn Ihre Standardvereinbarungen aktualisiert werden, ersetzt jetzt ein API-Aufruf das Dokument in jeder Vorlage, ohne die Feldkonfiguration zu stören.
SaaS-Plattformen, die Vorlagen in den Arbeitsbereichen der Kunden verwalten
Rebranding oder Aktualisieren eines Dokuments, das über Dutzende von Arbeitsbereichen verteilt ist, bedeutet nicht mehr manuelle Neubauten in jedem einzelnen. Aktualisieren Sie die Quelldatei und Sie sind fertig.
Compliance-gesteuerte Dokumentenaktualisierungen
Regulierte Branchen benötigen manchmal Dokumentenaktualisierungen nach einem Zeitplan. Das Ersetzen der PDF-Datei, ohne die Platzierung der Felder zu verlieren, bedeutet, dass das Update automatisiert, getestet und bereitgestellt werden kann, ohne dass menschliche Nacharbeiten erforderlich sind.
Die Vorlagen-Dokumentersetzung ist in API v1.9.0 verfügbar, ohne dass es zu wesentlichen Änderungen gegenüber v1.8.0 kommt.
