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.
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.

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




