📋 Digitaler Beförderungsvertrag
Dokumentation für Nutzer und Administratoren
🚀 Schnellnavigation
📋 Übersicht
Der digitale Beförderungsvertrag ermöglicht Tandemgästen, ihre Enthaftungserklärung online auszufüllen und digital zu unterzeichnen. Die Daten werden direkt in den Kundendatensatz im Icarus Manifest übertragen.
📧 Per E-Mail-Link
Tandemgäste erhalten in ihrer Terminbestätigung einen personalisierten Link. Vorhandene Kundendaten werden automatisch übertragen und das Formular ist bereits vorausgefüllt.
🌐 Öffentlicher Zugang
Das Formular kann auch direkt auf der Website eingebettet werden. Gäste füllen alle Daten selbst aus – ideal für Laufkundschaft oder kurzfristige Buchungen.
Hauptfunktionen
✍️ Digitale Signatur
Rechtsgültige Unterschrift direkt auf dem Gerät – per Touchscreen oder Maus. Plausibilitätsprüfung verhindert ungültige Eingaben.
📱 Responsives Design
Optimiert für alle Geräte: Desktop, Tablet und Smartphone. Touch-Unterstützung für Unterschriften auf mobilen Geräten.
🔄 Automatisches Prefill
Kundendaten werden per URL-Parameter übertragen und automatisch in die Felder eingetragen.
🎥 Video-Auswahl
Optional: Gäste können direkt beim Ausfüllen eine Video-Option auswählen und buchen.
🎨 Individuelles Branding
Farben und Einstellungen werden zentral über die Ninox-Settings gesteuert und automatisch angewendet.
📤 Direkte Datenübertragung
Alle Eingaben werden direkt ins Icarus Manifest übertragen und dem Kundendatensatz zugeordnet.
🔌 Integration (WordPress) Frontend
Das Formular wird über ein einfaches Script-Tag und einen Container in jede WordPress-Seite eingebettet. Alle Ressourcen werden automatisch vom zentralen Server geladen.
Embed-Code
HTML 📋 Kopieren und in WordPress einfügen
Den Code in einen HTML-Block in WordPress einfügen. Die URLs für
data-settings-url, data-video-url und data-bv-data-url werden im Icarus Manifest generiert.⚙️ Konfigurationsparameter Frontend
Alle Parameter werden als
data- Attribute am Script-Tag übergeben.| Parameter | Beschreibung | Pflicht |
|---|---|---|
data-settings-url | Ninox-Share-Link für Einstellungen (Farben, Grenzwerte, APP_KEY) | Ja |
data-video-url | Ninox-Share-Link für Video-Optionen | Ja |
data-bv-data-url | Ninox-Share-Link für Vertragstext | Ja |
data-show-video | Video-Auswahl anzeigen (true/false) | Optional |
data-url-redirect | URL für Weiterleitung nach Absenden | Optional |
data-contact-email | Kontakt-E-Mail für Rückfragen | Optional |
data-enable-fes | Fortgeschrittene Elektronische Signatur (true/false, Standard: true) | Optional |
📝 Formularfelder Frontend
Das Formular erfasst alle notwendigen Daten für den Beförderungsvertrag. Bei Aufruf über einen personalisierten Link sind viele Felder bereits vorausgefüllt.
👤 Persönliche Daten
- Vorname, Nachname
- E-Mail (mit Wiederholung)
- Handynummer
- Geburtsdatum
📍 Adresse
- Straße, Hausnummer
- PLZ, Wohnort
- Land
⚖️ Körperdaten
- Körpergewicht (mit Min/Max-Validierung)
- Körpergröße (mit Min/Max-Validierung)
📋 Weiteres
- Video-Option (optional)
- Digitale Unterschrift
- Datenschutz-Checkbox
- Aktuelles Datum (automatisch)
ℹ️ Hidden Fields: Die Kunden-ID und Redirect-URL werden bei personalisierten Links automatisch als versteckte Felder übertragen.
✍️ Digitale Unterschrift Frontend
Die digitale Signatur wird auf einem Canvas-Element erfasst und als Bild gespeichert. Eine Plausibilitätsprüfung stellt sicher, dass eine echte Unterschrift geleistet wurde.
🖊️ Eingabemethoden
- Maus: Klicken und ziehen
- Touch: Mit dem Finger zeichnen
- Stylus: Präzise Eingabe auf Tablets
✅ Plausibilitätsprüfung
Die Unterschrift wird auf folgende Kriterien geprüft:
- Mindestanzahl an Punkten
- Minimale Strichlänge
- Bounding-Box-Verhältnis
- Tintendichte
Unterschriftsfeld mit Lösch-Button
Einzelne Punkte oder kurze Striche werden nicht akzeptiert. Die visuelle Rückmeldung wechselt von ✗ zu ✓ sobald die Unterschrift die Mindestanforderungen erfüllt.
🎥 Video-Optionen Backend
Wenn aktiviert, können Gäste direkt im Beförderungsvertrag eine Video-Option auswählen. Die verfügbaren Optionen werden aus der Ninox-Datenbank geladen.
Video-Auswahl anzeigen
Über
data-show-video="true" oder "false" wird gesteuert, ob die Video-Auswahl angezeigt wird.📋 Video-URL JSON Format
Die
data-video-url liefert ein Array mit Objekten:[
{ "ID": "1", "description": "ohne Video" },
{ "ID": "2", "description": "Handkamera - 99 €" },
{ "ID": "3", "description": "Kameraspringer - 133 €" }
]Video-Dropdown im Formular
Bei Fehler beim Laden der Video-Optionen (z.B. ungültige URL) wird das Video-Feld automatisch ausgeblendet.
✅ Validierung Frontend
Das Formular führt verschiedene Validierungen durch, bevor es abgesendet werden kann.
📧 E-Mail-Abgleich
Die E-Mail muss zweimal identisch eingegeben werden. Bei Abweichung erscheint eine Fehlermeldung.
🎂 Mindestalter
Das Geburtsdatum wird gegen das konfigurierte Mindestalter geprüft. Standard: 12 Jahre.
⚖️ Gewicht & Größe
Die Eingaben werden gegen die in den Settings definierten Min/Max-Werte geprüft.
✍️ Unterschrift
Die digitale Signatur muss die Plausibilitätsprüfung bestehen (keine einzelnen Punkte).
☑️ Datenschutz
Die Datenschutz-Checkbox muss akzeptiert werden.
📅 Datum
Das aktuelle Datum wird automatisch eingetragen und ist nicht editierbar.
💡 Optimistisches UI: Nach Klick auf "Senden" erscheint sofort das Erfolgs-Modal. Bei einem Server-Fehler wird das Modal wieder geschlossen und eine Fehlermeldung angezeigt.
🔐 Elektronische Signatur (FES) Neu Frontend
Die Fortgeschrittene Elektronische Signatur (FES) nach eIDAS-Verordnung erhöht die rechtliche Verbindlichkeit des Beförderungsvertrags durch eine zusätzliche E-Mail-Verifizierung.
📋 Was ist FES?
Eine Fortgeschrittene Elektronische Signatur erfüllt nach EU-Recht strengere Anforderungen als eine einfache elektronische Signatur und bietet höhere Beweiskraft.
✓ Standardmäßig aktiv
FES ist automatisch für alle Beförderungsverträge aktiviert. Bei Bedarf kann es mit
data-enable-fes="false" deaktiviert werden.FES-Kriterien (eIDAS-konform)
| Kriterium | Umsetzung |
|---|---|
| Eindeutige Zuordnung | E-Mail-Adresse + Formulardaten identifizieren den Unterzeichner |
| Identifizierung | OTP-Code per E-Mail bestätigt Besitz des E-Mail-Kontos |
| Alleinige Kontrolle | Nur der E-Mail-Inhaber kennt den zugesendeten Code |
| Integritätsschutz | SHA-256 Hash + HMAC-Signatur sichern die Unveränderbarkeit |
Ablauf der FES-Verifizierung
Formular ausfüllen
Der Gast füllt alle Felder aus und leistet seine digitale Unterschrift.
Der Gast füllt alle Felder aus und leistet seine digitale Unterschrift.
Absenden klicken
Nach Klick auf "Verbindlich unterschreiben" öffnet sich das Verifizierungs-Modal.
Nach Klick auf "Verbindlich unterschreiben" öffnet sich das Verifizierungs-Modal.
Code per E-Mail erhalten
Ein 6-stelliger Code wird an die angegebene E-Mail-Adresse gesendet.
Ein 6-stelliger Code wird an die angegebene E-Mail-Adresse gesendet.
Code eingeben
Der Gast gibt den Code im Modal ein. Bei korrekter Eingabe wird das Formular abgesendet.
Der Gast gibt den Code im Modal ein. Bei korrekter Eingabe wird das Formular abgesendet.
OTP-Eingabe Modal
E-Mail mit Bestätigungscode
Sicherheitsfeatures
🔢 6-stelliger Code
1 Million mögliche Kombinationen erschweren das Erraten erheblich.
⏱ 10 Min. Gültigkeit
Der Code läuft nach 10 Minuten ab und muss dann neu angefordert werden.
🚫 Max. 3 Versuche
Nach 3 Fehlversuchen muss ein neuer Code angefordert werden.
🔒 Formular-Hash
Änderungen am Formular nach Code-Versand werden erkannt und abgelehnt.
✓ HMAC-Signatur
Das Signatur-Token ist kryptographisch gegen Manipulation geschützt.
📋 Audit-Trail
IP-Adresse, Zeitstempel und Verifizierungsdaten werden protokolliert.
Falls die E-Mail-Verifizierung fehlschlägt (z.B. E-Mail nicht zustellbar), kann der Gast das Formular trotzdem ohne FES absenden. Er wird vorher darauf hingewiesen.
⚙️ Backend-Einstellungen Backend
Die Einstellungen werden im Icarus Manifest konfiguriert und über Ninox-Share-Links bereitgestellt.
📍 Einstellungs-Orte
⚙️ Einstellungen → Tandem-Buchungssystem
Hier werden Grenzwerte und UI-Einstellungen konfiguriert:
- Basisfarbe (MAINCOLOR)
- Körpergröße von/bis
- Maximalgewicht
- Mindestalter
📜 Einstellungen → Allgemein → Verein → Tab „Beförderungsvertrag"
Hier wird der eigentliche Vertragstext hinterlegt, der im Formular angezeigt wird. Der Text kann HTML-Formatierungen enthalten (Listen, Fettdruck, etc.).
Vertragstext in Einstellungen → Allgemein → Verein
Der Vertragstext unterstützt HTML-Formatierungen wie Listen, Fettdruck und Absätze für eine übersichtliche Darstellung im Formular.
🔗 Terminbestätigung
📧 BV-Link in E-Mail
Wenn aktiviert, wird in der Terminbestätigung automatisch ein personalisierter Link zum Beförderungsvertrag eingefügt.
BV-Link in Terminbestätigung
✓ Vorteil: Kundendaten werden automatisch übertragen und das Formular ist bereits vorausgefüllt. Der Gast muss nur noch Gewicht und Unterschrift ergänzen.
📊 Anzeige im System Backend
Eingereichte Beförderungsverträge können im Icarus Manifest eingesehen und verarbeitet werden.
👤 Kundendatensatz
Beförderungsverträge werden automatisch dem entsprechenden Kundendatensatz zugeordnet. Dort können sie:
- Als PDF abgerufen werden
- Ausgedruckt werden
- Archiviert werden
📋 Tagesübersicht
Im Terminbuchungssystem werden alle tagesaktuellen Beförderungsverträge angezeigt. Ein BV erscheint wenn:
- Er am aktuellen Tag erstellt wurde
- Der Gast eine Buchung am aktuellen Tag hat
- Der Gast in einem Load des Tages manifestiert ist
📱 QR-Code & Freigabe-Link
Beim ersten Öffnen eines Beförderungsvertrags wird automatisch ein QR-Code generiert. Dieser ermöglicht:
- Schnellen Zugriff auf die PDF
- Freigabe-Link für Tandemmaster/Videospringer
- Automatische Löschung nach dem Sprung
Die Tagesübersicht eignet sich ideal für einen separaten Bildschirm im Manifest-Büro oder eine zentrale Tablet-Station am Sprungplatz.
Datenschutz: QR-Code und Freigabe-Link werden automatisch gelöscht, sobald der Tandemsprung durchgeführt wurde bzw. spätestens am Folgetag, wenn kein Sprung stattfand.
