
4,8-Sterne-Bewertung auf g2.com

Dokumentensammlung sollte kein separater Arbeitsablauf sein
Dateiuploadfelder: Alles an einem Ort, einem API-Aufruf
Die Datei-Upload-Felder von Firma.dev ermöglichen es Ihnen, unterstützende Dokumente direkt im Signaturablauf zu sammeln. Unterzeichner können Bilder oder PDFs direkt neben ihrer Unterschrift, ihren Initialen und anderen Formularfeldern hochladen. Ein Erlebnis, ein API-Aufruf, alles an einem Ort.
Datei-Upload-Felder wurden in v1.11.0 ausgeliefert und sind in allen Konten verfügbar.
Was sind Datei-Upload-Felder?

Platzieren und Konfigurieren von Datei-Upload-Feldern
Der file-Feldtyp funktioniert wie jedes andere Feld in Firma.dev. Sie platzieren es in einem Dokument, weisen es einem Empfänger zu und markieren es als erforderlich oder optional.
Wenn der Unterzeichner das Dokument öffnet, sehen sie einen Upload-Bereich, in dem sie eine Datei anhängen können.
Akzeptierte Dateitypen
Der Unterschied besteht darin, was es sammelt. Anstatt eine Unterschrift oder einen Texteingabebereich zu erfassen, akzeptiert ein Dateifeld Bild-Uploads (JPG, PNG) und PDF-Dateien. Der Unterzeichner wählt eine Datei von seinem Gerät aus, Firma.dev validiert sie serverseitig, und der Anhang wird Teil des abgeschlossenen Signaturanforderung.


Alles in einer Einreichung
Dies bedeutet, dass Sie Workflows erstellen können, bei denen die unterzeichnete Vereinbarung und die dazugehörigen Unterlagen gemeinsam eintreffen und nicht als separate Einreichungen an verschiedenen Tagen.
Wie es funktioniert
Jedes Dateiuploadfeld hat ein format_rules-Objekt, das steuert, welche Dateitypen akzeptiert werden. Es gibt drei Modi:
Bild_und_PDF
Akzeptiert sowohl Bilder (JPG, PNG) als auch PDF-Dateien. Dies ist die Standardoption.
Bild
Akzeptiert nur JPG und PNG.
pdf
Akzeptiert nur PDF-Dateien.
Die maximale Dateigröße beträgt 10 MB pro Upload. Dateien werden serverseitig über Edge-Funktionen verarbeitet, nicht clientseitig gespeichert.
So fügen Sie ein Dateiupload-Feld zu einer Signaturanfrage hinzu:
Dies erstellt eine Signaturanfrage mit einem Signaturfeld und einem Datei-Upload-Feld auf derselben Seite. Das Dateifeld ist so konfiguriert, dass es nur Bilder akzeptiert, was für etwas wie ein Ausweisfoto sinnvoll ist.

Magische Byte-Validierung
Firma.dev validiert hochgeladene Dateien, indem es ihren tatsächlichen Inhalt (Magie-Bytes) überprüft, nicht nur die Dateiendung. Wenn jemand eine .exe in .jpg umbenennt und versucht, sie hochzuladen, wird dies von der Validierung erkannt.
Dies ist eine bedeutungsvolle Sicherheitsebene, die die meisten E-Signatur-Plattformen überspringen, wobei sie stattdessen auf erweiterungsbasierte Prüfungen vertrauen, die leicht zu umgehen sind.
Die Validierung erfolgt serverseitig, bevor die Datei angenommen wird, so dass ungültige Dateien niemals in Ihre Signaturanfragen-Daten gelangen.
Anwendungsfälle
Datei-Upload-Felder sind nützlich, wo immer Sie unterstützende Dokumente zusammen mit einer unterzeichneten Vereinbarung benötigen.
Mitarbeiter Einarbeitung
Sammeln Sie ein unterschriebenes Angebotsbrief und ein Foto des neuen Mitarbeiters' von der Regierung ausgestellten Ausweises im gleichen Ablauf. Setzen Sie acceptedFileTypes auf image für das ID-Upload-Feld, und der Unterzeichner macht ein Foto oder wählt eines von seinem Gerät aus.
Versicherungsabläufe
Eine PDF-Upload als Nachweis der Versicherung verlangen, zusammen mit der unterschriebenen Police-Vereinbarung. Ein Unterzeichnungserlebnis erfasst sowohl das Engagement als auch den Nachweis.
Ausgabengenehmigungen
Fügen Sie Quittungsbilder einem unterschriebenen Spesenbericht bei. Markieren Sie das Dateifeld als optional, wenn Belege nicht immer erforderlich sind, oder als erforderlich, wenn Ihre Richtlinien dies verlangen.
Compliance und Inspektionen
Sammeln Sie Foto-Beweise (Sicherheitsinspektionen, Zustandsberichte von Immobilien) zusammen mit dem unterschriebenen Konformitätsformular. Die Datei und die Unterschrift sind mit derselben Signaturanfrage verknüpft, sodass es keine Unklarheiten darüber gibt, zu welchem Dokument die Fotos gehören.
In jedem Fall ist die Alternative ohne Datei-Upload-Felder ein mehrstufiger Prozess: Dokument unterschreiben, dann separat Anhänge per E-Mail, Form Builder oder Filesharing-Link sammeln. Das bedeutet mehr Integrationsarbeit für Sie und mehr Reibung für den Unterzeichner.
API-Referenz
Das file Feldtyp ist überall dort verfügbar, wo Felder definiert sind: Erstellung von Signieranfragen (POST /signing-requests), Erstellung von Vorlagen (POST /templates) und Feldaktualisierungen über PATCH Operationen.
Das Feldschema folgt der gleichen Struktur wie andere Feldtypen, mit der Ergänzung von format_rules zur Konfiguration des Dateityps:
Die acceptedFileTypes-Werte sind image_and_pdf (Standard), image oder pdf. Wenn Sie format_rules vollständig weglassen, akzeptiert das Feld standardmäßig sowohl Bilder als auch PDFs.
Datei-Upload-Felder funktionieren zusammen mit allen anderen Feldtypen in derselben Signaturanfrage. Sie können sie mit Signaturen, Initialen, Texteingaben, Kontrollkästchen, Ankertags und jedem anderen Feldtyp ohne Einschränkungen kombinieren.
Siehe das API-Änderungsprotokoll für das vollständige FileFormatRules-Schema.
Warum das wichtig ist

Die versteckte Reibung nach der Unterschrift
Die meisten E-Signatur-Plattformen betrachten die Dokumentensammlung als das Problem eines anderen. Sie unterschreiben den Vertrag in einem Tool und jagen dann Anhänge per E-Mail, Slack oder ein separates Upload-Portal hinterher. Jeder Übergang ist eine Chance für Abbrüche, Verzögerungen und verlorene Dateien.
Alles in einer API-Antwort
Firma.dev fasst alles zu einem einzigen Ablauf zusammen. Der Unterzeichner öffnet das Dokument, füllt seine Felder aus, lädt seine unterstützenden Dateien hoch und unterschreibt. Alles kommt in einer API-Antwort zusammen. Für Entwickler bedeutet das weniger Integrationsaufwand und weniger Randfälle. Für Unterzeichner bedeutet es, nur eine Sache statt zwei zu tun.


Keine zusätzlichen Kosten
Bei €0,029 pro Umschlag kostet das Hinzufügen der Dateisammlung zu Ihrem Signaturablauf nicht extra. Das Datei-Upload-Feld ist nur ein weiterer Feldtyp, der im gleichen Umschlag enthalten ist.


