Mehrsprachige E-Signaturen: So lokalisieren Sie das eingebettete Signieren in 15 Sprachen

Wenn Sie das Signiererlebnis von Firma.dev in Ihre App einbetten, möchten Sie wahrscheinlich, dass es der Sprache Ihres Nutzers entspricht. Diese Anleitung zeigt Ihnen, wie Firma.dev Lokalisierung handhabt und wie Sie diese in Ihrer Integration steuern können.

Wie Firma.dev die Sprache erkennt

Firma.dev verwendet ein 3-stufiges Erkennungssystem, das in dieser Reihenfolge geprüft wird:

1. URL-Parameter (?lang=xx): Höchste Priorität. Wenn Sie einen Sprachcode in der URL übergeben, ist es das, was der Nutzer sieht.

2. Local Storage: Bei wiederkehrenden Besuchen sucht Firma.dev nach einer zwischengespeicherten Spracheinstellung. Dies ermöglicht eine sofortige Sprachauswahl ohne Netzwerkanfrage.

3. Browser-Erkennung: Fällt auf die Browser- oder Systemspracheinstellung des Nutzers zurück.

Wenn die erkannte Sprache nicht zu den 15 unterstützten Sprachen gehört, verwendet Firma.dev standardmäßig Englisch.

Unterstützte Sprachen

Firma.dev unterstützt diese Sprachen standardmäßig:

Alle UI-Elemente, Schaltflächen, Beschriftungen, Benachrichtigungen, E-Mails und Fehlermeldungen sind in jeder Sprache vollständig übersetzt.

Steuerung der Sprache beim eingebetteten Signieren

Wenn Sie den Signier-Ablauf in einem Iframe einbetten, funktioniert die Browser-Erkennung nicht zuverlässig. Der Iframe erbt den Kontext der übergeordneten Seite, nicht die Browsereinstellungen des Nutzers. Sie müssen die Sprache explizit übergeben.

Hängen Sie den Parameter ?lang= an die Signier-URL an:

<iframe
  src="https://app.firma.dev/signing/{signing_request_user_id}?lang=es"
  style="width:100%;height:900px;border:0;"
  allow="camera;microphone;clipboard-write"
  title="Firmar Documento"
></iframe>

<iframe
  src="https://app.firma.dev/signing/{signing_request_user_id}?lang=es"
  style="width:100%;height:900px;border:0;"
  allow="camera;microphone;clipboard-write"
  title="Firmar Documento"
></iframe>

<iframe
  src="https://app.firma.dev/signing/{signing_request_user_id}?lang=es"
  style="width:100%;height:900px;border:0;"
  allow="camera;microphone;clipboard-write"
  title="Firmar Documento"
></iframe>

Quelle: Leitfaden zur Lokalisierung

Dadurch wird die Signieroberfläche unabhängig von den Browsereinstellungen des Nutzers auf Spanisch gerendert.

Abrufen von Signier-URLs und Rendern des Iframes

So rufen Sie die Signier-URL von der API ab und rendern sie dynamisch:

// fetch signing request
const r = await fetch('/internal/signing-request/' + signingRequestId)
const json = await r.json()

// get recipient signing URL
const recipient = json.recipients[0]
const signingUrl = recipient.signing_url || `https://app.firma.dev/signing/${recipient.id}`

// render iframe
const iframe = document.createElement('iframe')
iframe.src = signingUrl
iframe.style.width = '100%'
iframe.style.height = '900px'
iframe.frameBorder = '0'
iframe.allow = 'camera;microphone;clipboard-write'
document.getElementById('signing-root').appendChild(iframe)

// fetch signing request
const r = await fetch('/internal/signing-request/' + signingRequestId)
const json = await r.json()

// get recipient signing URL
const recipient = json.recipients[0]
const signingUrl = recipient.signing_url || `https://app.firma.dev/signing/${recipient.id}`

// render iframe
const iframe = document.createElement('iframe')
iframe.src = signingUrl
iframe.style.width = '100%'
iframe.style.height = '900px'
iframe.frameBorder = '0'
iframe.allow = 'camera;microphone;clipboard-write'
document.getElementById('signing-root').appendChild(iframe)

// fetch signing request
const r = await fetch('/internal/signing-request/' + signingRequestId)
const json = await r.json()

// get recipient signing URL
const recipient = json.recipients[0]
const signingUrl = recipient.signing_url || `https://app.firma.dev/signing/${recipient.id}`

// render iframe
const iframe = document.createElement('iframe')
iframe.src = signingUrl
iframe.style.width = '100%'
iframe.style.height = '900px'
iframe.frameBorder = '0'
iframe.allow = 'camera;microphone;clipboard-write'
document.getElementById('signing-root').appendChild(iframe)

Quelle: Leitfaden zum Senden einer Signieranfrage

Um das Gebietsschema Ihrer App anzupassen, hängen Sie den Sprachparameter an, wenn Sie die Iframe-Quelle festlegen:

const userLocale = getCurrentUserLocale() // returns 'es', 'de', 'fr', etc.
iframe.src = `${signingUrl}?lang=${userLocale}`

const userLocale = getCurrentUserLocale() // returns 'es', 'de', 'fr', etc.
iframe.src = `${signingUrl}?lang=${userLocale}`

const userLocale = getCurrentUserLocale() // returns 'es', 'de', 'fr', etc.
iframe.src = `${signingUrl}?lang=${userLocale}`

Dadurch bleibt das Signiererlebnis im Einklang mit dem Rest Ihrer Anwendung.

Best Practices

Diese Richtlinien stammen direkt aus der Dokumentation von Firma.dev:

• Verwenden Sie den lang-Parameter beim eingebetteten Signieren: Verlassen Sie sich in Iframe-Kontexten nicht auf die Browser-Erkennung. Übergeben Sie die Sprache explizit, um ein einheitliches Erlebnis zu gewährleisten.

• Passen Sie das Gebietsschema Ihrer Anwendung an: Übergeben Sie beim Einbetten von Firma.dev dasselbe Gebietsschema, das Ihre Anwendung verwendet, damit das Signiererlebnis nahtlos wirkt.

• Lassen Sie die Nutzer wählen: Lassen Sie bei direkten Firma.dev-Links (z. B. in E-Mails) den lang-Parameter weg und überlassen Sie es der automatischen Erkennung von Firma.dev. Nutzer, die eine Präferenz festgelegt haben, sehen ihre ausgewählte Sprache.

Quelle: Leitfaden zur Lokalisierung

Firma.dev übersetzt die Signieroberfläche und deren E-Mails, und Ihr Dokument erscheint genau so, wie Sie es hochgeladen haben. Ein Unterzeichner in Madrid sieht spanische Schaltflächen und Anweisungen rund um die Sprache, in der der Vertrag verfasst ist. Wenn Ihre Unterzeichner eine andere Sprache sprechen, übersetzen Sie die Datei vor dem Hochladen. Ein professioneller KI-Übersetzer wie Lara Translate liefert Ihnen schnell einen Entwurf und ermöglicht es Ihnen, Kontext hinzuzufügen, um die Übersetzung zu steuern. Lassen Sie Verträge und andere vertrauliche Dokumente von einem qualifizierten Prüfer – idealerweise jemandem, der das Vertragsrecht im Land des Unterzeichners kennt – überprüfen, bevor sie zur Unterschrift versendet werden.

Lokalisierung in anderen einbettbaren Komponenten

Der Parameter ?lang= funktioniert genauso für die anderen einbettbaren Komponenten von Firma.dev:

• Einbettbarer Vorlageneditor: Zum Erstellen und Bearbeiten von Dokumentvorlagen

• Einbettbarer Editor für Signieranfragen: Zum Konfigurieren von Empfängern und Versandoptionen

Beide verwenden JWT-Authentifizierung und unterstützen alle 15 Sprachen. Einzelheiten zur Implementierung finden Sie im Leitfaden zum einbettbaren Editor für Signieranfragen.

Ein Hinweis zur Infrastruktur

Firma.dev wird in der EU gehostet (AWS-Region Paris), was ideal zur mehrsprachigen Unterstützung passt, wenn Sie europäische Märkte bedienen. Die Plattform unterstützt DSGVO und eIDAS (SES- und AdES-Stufen) für regionale Compliance-Anforderungen.

Nächste Schritte

Die vollständige technische Referenz finden Sie im Leitfaden zur Lokalisierung in der Dokumentation. Er deckt Sonderfälle wie gemischtsprachige Teams und das Verhalten bei der Beibehaltung von Sprachen ab.

Bereit zum Start? API-Schlüssel holen und mit der Integration lokalisierter E-Signaturen beginnen. Keine Kreditkarte erforderlich.