📋 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)
Das Beförderungsvertrag-Formular wird über einen HTML-Code in eine WordPress-Seite eingebunden. Die Konfiguration erfolgt über
data-Attribute im Script-Tag sowie zentral im Ninox-Backend.⚙️ Embed-Loader System
Das System nutzt einen zentralen
embed-loader.js, der automatisch CSS, HTML-Template und JavaScript lädt und initialisiert. Alle Konfigurationsparameter werden über data-Attribute übergeben.📋 WordPress-Einbindung
Schritt 1: WordPress-Seite erstellen (z.B. /befoerderungsvertrag/)
Schritt 2: HTML-Block hinzufügen
Schritt 3: Einbettungscode einfügen
Schritt 4: Seite veröffentlichen
Schritt 2: HTML-Block hinzufügen
Schritt 3: Einbettungscode einfügen
Schritt 4: Seite veröffentlichen
💡 Hinweis: Die
data-settings-url mit allen erforderlichen Konfigurationslinks findest du im Icarus Manifest im Modul „Einstellungen" unter „Integrationen".💻 Einbettungscode
Der vollständige Code für die WordPress-Einbindung:
HTML Zum Kopieren markieren
Der Container
#bv-embed-container muss nach dem Script-Tag stehen, da der Embed-Loader den Container erst nach dem Laden des DOMs sucht.⚙️ Konfigurationsparameter Pflicht
Alle Konfigurationsparameter werden als
data-Attribute im Script-Tag übergeben. Einige sind zwingend erforderlich, andere optional.| Parameter | Beschreibung | Status |
|---|---|---|
data-settings-url | Ninox-Share-Link zu den UI-Einstellungen (Farben, Grenzwerte, APP_KEY) | Pflicht |
data-video-url | Ninox-Share-Link zu den verfügbaren Video-Optionen | Pflicht |
data-bv-data-url | Ninox-Share-Link zum Beförderungsvertrag-Text | Pflicht |
data-show-video | Video-Auswahl anzeigen: true oder false | Optional |
data-url-redirect | URL für Weiterleitung nach erfolgreicher Übermittlung | Optional |
data-contact-email | E-Mail-Adresse für Datenschutz-Widerruf (wird im Text angezeigt) | Optional |
📝 Formularfelder Frontend
Das Formular ist in mehrere Sektionen unterteilt. Alle mit * gekennzeichneten Felder sind Pflichtfelder.
👤 Person
| Vorname | Pflicht |
| Nachname | Pflicht |
| Geburtsdatum | Pflicht |
📍 Anschrift
| Straße | Pflicht |
| Hausnummer | Pflicht |
| PLZ | Pflicht |
| Wohnort | Pflicht |
| Land | Optional |
📞 Kontakt
| Pflicht | |
| E-Mail wiederholen | Pflicht |
| Handynummer | Pflicht |
📏 Gewicht & Größe
| Springergewicht (kg) | Pflicht |
| Körpergröße (cm) | Optional |
Grenzwerte werden aus den Settings geladen und dynamisch auf die Eingabefelder angewendet.
🎫 Gutschein & Video
| Gutscheincode | Optional |
| Video-Option | Pflicht* |
*Nur wenn Video-Auswahl aktiviert ist
✍️ Digitale Unterschrift Frontend
Die Unterschrift wird auf einem HTML5-Canvas gezeichnet und als Base64-PNG gespeichert. Eine intelligente Plausibilitätsprüfung stellt sicher, dass nur echte Unterschriften akzeptiert werden.
🖊️ Eingabemöglichkeiten
Die Unterschrift kann eingegeben werden per:
- Touchscreen – Finger oder Stylus auf Tablets/Smartphones
- Maus – Klassische Eingabe am Desktop
🔍 Plausibilitätsprüfung
Das System prüft automatisch, ob die Unterschrift plausibel ist:
- Mindestens 30 Punkte gezeichnet
- Mindest-Flächenverhältnis der Bounding-Box
- Mindest-Strichlänge im Verhältnis zur Canvas-Diagonale
- Mindest-Tintenanteil (Pixel mit Farbe)
🗑️ Unterschrift löschen
Mit dem Papierkorb-Symbol kann die Unterschrift jederzeit gelöscht und neu erstellt werden.
Unterschrift
✓ Unterschrift erkannt
Unterschriftsfeld mit Validierungsstatus
Status-Anzeige
✗ Ungültig
Unterschrift wurde noch nicht oder nicht ausreichend gezeichnet. Das Formular kann nicht abgesendet werden.
✓ Gültig
Unterschrift wurde erkannt und als plausibel eingestuft. Das Formular kann abgesendet werden.
🎥 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.
⚙️ 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.
