Funktionen: DOCX-Unterstützung

Mehrsprachige Signaturunterstützung

Word-Dokumente direkt in die API hochladen

Word-Dokumente direkt in die API hochladen

Word-Dokumente direkt in die API hochladen

G2 Logo

4,8-Sterne-Bewertung auf g2.com

A purple DOC file icon centered on a dark card, surrounded by small icons representing upload, code, signature, and a blank document.
A purple DOC file icon centered on a dark card, surrounded by small icons representing upload, code, signature, and a blank document.

Firma.dev akzeptiert jetzt DOCX-Dateien direkt

Firma.dev akzeptiert jetzt DOCX-Dateien direkt über jeden Dokument-Upload-Endpunkt. Die API konvertiert sie serverseitig automatisch in PDF. Ihre bestehenden PDF-basierten Integrationen funktionieren genau wie zuvor.

Überspringen Sie den PDF-Konvertierungsschritt

DOCX and PDF file types merging into a single purple field, illustrated as a flowchart on a dark background.

Ein Feld. PDF oder DOCX.

Das document-Feld an allen Hochlade-Endpunkten akzeptiert jetzt Base64-codierte DOCX-Dateien neben PDF. Laden Sie ein Word-Dokument auf die gleiche Weise hoch, wie Sie ein PDF hochladen würden, und die API erledigt den Rest. Die Antwort gibt Ihnen eine PDF-basierte Vorlage oder Signaturanfrage zurück, bereit für die Platzierung und Unterzeichnung von Feldern.

Keine zusätzlichen Schritte

Keine clientseitigen Konvertierungsbibliotheken, keine Vorverarbeitungspipeline, keine zusätzlichen API-Aufrufe. Sie senden das DOCX, Firma.dev gibt ein PDF zurück.

A hand dragging DOCX and PDF file icons into an "Upload Files" drop zone on a dark background.

Funktioniert überall, wo Sie Dokumente hochladen

DOCX-Unterstützung gilt für jeden Endpunkt, der ein Dokument akzeptiert:

Vorlagenerstellung (POST /templates), Vorlage-Dokumentersatz (POST /templates/{id}/replace-document), Erstellung einer Signaturanfrage (POST /signing-requests) und Vorlagen-/Signaturanfrage-Aktualisierungen (PUT und PATCH). Es funktioniert auch in den UI-Editoren und im eingebetteten Vorlageneditor.

Der Endpunkt replace-document ermöglicht es Ihnen beispielsweise, das zugrunde liegende Dokument einer Vorlage auszutauschen, während alle Felderplatzierungen, Signiererzuweisungen und Einstellungen beibehalten werden. Das API-Änderungsprotokoll zeigt die Struktur der Anfrage:

POST /templates/{template_id}/replace-document
{
  "document": "JVBERi0xLjQKJeLjz9..."

Dieses document-Feld akzeptiert entweder Format. Geben Sie ein Base64-kodiertes DOCX ein und die Umwandlung erfolgt transparent. Bereits bestehende Integrationen, die bereits PDFs senden, erfordern keine Änderungen.

Was passiert während der Umwandlung

DOC and PDF file icons stacked over a list of rows with colorful dot indicators, on a dark background.

Server-seitige Konversion

Wenn Sie eine DOCX-Datei hochladen, konvertiert Firma.dev sie serverseitig in PDF, bevor sie gespeichert wird. Das resultierende PDF wird für die Feldplatzierung, das Signieren und den endgültigen signierten Dokumentendownload verwendet. Es ist keine clientseitige Abhängigkeit erforderlich.

Wann man stattdessen PDF verwenden sollte

Einfache DOCX-Dateien, also Standardtext, Tabellen, Kopfzeilen, Fußzeilen und grundlegende Formatierungen, werden sauber konvertiert. Komplexe, Word-spezifische Funktionen wie umfangreiche Makros, eingebettete OLE-Objekte oder erweiterte Layout-Tricks können möglicherweise nicht perfekt übersetzt werden.

Für Dokumente, bei denen die Genauigkeit auf Pixelebene zählt, bleibt PDF die sicherere Wahl. Wenn Sie dies im Voraus ansprechen, erspart es Ihnen später Überraschungen beim Debuggen von Layouts.

A document layout with X and Y axis guides showing the placement of a "Your Signature Here" field.

Wann man DOCX im Vergleich zu PDF verwenden sollte

Es geht nicht darum, dass ein Format besser ist. Es geht darum, das Upload-Format an Ihren Workflow anzupassen.

Verwenden Sie DOCX, wenn…

  • Ihr Team erstellt Dokumente in Word und möchte den Konvertierungsschritt überspringen

  • Vorlagen werden von den Rechts-, Personal- oder Betriebsteams als Word-Dokumente gepflegt.

  • Sie möchten weniger Übergaben zwischen dem Erstellen und Hochladen

  • Sie möchten das Risiko von Versionsverwirrung verringern.

Verwenden Sie PDF, wenn

  • Sie benötigen eine präzise Layoutkontrolle

  • Ihre Dokumente werden programmgesteuert erstellt (die meisten Code-Bibliotheken geben PDF nativ aus)

  • Das Dokument hat eine komplexe Formatierung, die überall identisch dargestellt werden muss

Beide Formate durchlaufen denselben Signatur-Workflow, sobald sie hochgeladen wurden. Der einzige Unterschied besteht darin, was Sie im document-Feld senden.

Um zu beginnen

DOCX-Unterstützung wurde mit Firma.dev API v1.10.0 ausgeliefert. Es ist vollständig additiv ohne Änderungen, die bestehende Funktionen beeinträchtigen.

Wenn Sie bereits PDFs senden, ändert sich nichts. Wenn Sie anfangen möchten, DOCX-Dateien zu senden, kodieren Sie sie einfach als base64 und verwenden Sie die gleichen Endpunkte, die Sie bereits nutzen.

Firma.dev berechnet €0,029 pro Umschlag ohne monatliche Mindestgebühren und ohne Sitzplatzgebühren. Egal, ob Sie PDF oder DOCX hochladen, die Preisgestaltung bleibt gleich.

Fangen Sie kostenlos an, keine Kreditkarte erforderlich.