# Verfahren für den Anschluss an den Französischen Segelverband (FFV) Dieser Leitfaden erklärt, wie Sie Yoplanning mit dem französischen Segelverband (FFV) verbinden, um FFV-Lizenzen direkt über Ihre Software zu verkaufen, zu erstellen und zu verwalten. *** ### Welchen Zweck hat die FFV-Verbindung? Die Verbindung zwischen Yoplanning und der FFV-API ermöglicht Folgendes: * FFV-Lizenzen online über das Buchungsmodul verkaufen. * Um automatisch zu prüfen, ob ein Teilnehmer bereits über eine gültige Lizenz verfügt. * Um einen visuellen Indikator für die Sitzungen anzuzeigen. * Damit die Behörde (BE) die Lizenzen schnell überprüfen kann. * Um nach dem Kauf eine FFV-Lizenz auf den Namen des Kunden zu erstellen. *** ### Funktionsprinzip #### Optionaler Lizenzverkauf Die FFV-Lizenz wird als **Option** im Buchungsmodul angeboten. Wenn ein Kunde eine Lizenz erwirbt: 1. Die Lizenz wird seiner Bestellung hinzugefügt. 2. **Es wurde eine automatische FFV-E-Mail versendet.** 3. **Der Kunde gibt seine persönlichen Daten ein.** 4. Yoplanning sendet die Erstellungsanfrage dann über die API an das FFV. Die Lizenz wird mit der FFV erst nach Überprüfung der Informationen durch den Kunden erstellt. *** #### Überprüfung bestehender Lizenzen Auch wenn der Kunde keine Lizenz erwirbt, kann Yoplanning die FFV automatisch abfragen. Obligatorische Bedingung: * Name * Vorname * Geburtsdatum * Geschlecht Sind diese vier Informationen vorhanden, fragt Yoplanning die FFV ab, um bestehende Lizenzen abzurufen. *** ### Vorgehensweise auf der FFV-Seite **Die Organisation muss Yoplanning bevollmächtigen, in ihrem Namen zu handeln.** Offizielles FFV-Verfahren: 👉 *** ### Konfiguration in Yoplanning #### Schritt 1: Aktivierung des FFV-Moduls anfordern Um die FFV-Modulkonfiguration zu erhalten: 1. Wenden Sie sich an den Yoplanning-Support (), um die Aktivierung des FFV-Moduls anzufordern. 2. Geben Sie Ihre FFV-Struktur-ID an. Unser Yoplanning-Team trägt dann die `ffv_structure_id` in die Daten Ihres Teams ein. Ohne diese Kennung kann die FFV-Integration nicht funktionieren. *** #### Schritt 2: Überprüfen Sie die automatische Erstellung der FFV-E-Mail-Vorlage Sobald das Modul aktiviert ist: * Für das Team wird automatisch eine FFV-E-Mail-Vorlage erstellt. * Diese E-Mail enthält den Link, über den der Kunde die Erstellung seiner Lizenz abschließen kann. * Sie wird gleichzeitig mit der E-Mail nach der Buchung versendet. * Dies ist eine separate E-Mail. Sie können es hier einsehen: Einstellungen → E-Mails *** #### Schritt 3: Erstellen Sie die Ressourcen „FFV-Lizenzen“. Im Menü auf der linken Seite: 1. Gehen Sie zu **Ressourcen** 2. Klicken Sie auf **Hinzufügen** 3. Erstellen Sie eine neue Ressource 4. Füllen Sie die erforderlichen Felder nach Ihren Wünschen aus, beachten Sie dabei jedoch die unten aufgeführten Pflichtfelder, die die Zuordnung von FFV-Lizenzen ermöglichen. Erforderliche Parameter: * **Partner-Tag**: **FFV** auswählen * **Modell**: Geben Sie genau einen der folgenden Werte ein: ``` PASSFFV PASSEPORT CLUB_JEUNE CLUB_ADULTE TEMPO_TEMPO_1J TEMPO_TEMPO_4J ``` ⚠️ Rechtschreibung unbedingt beachten. Nachher : * Geben Sie den Preis ein * Fügen Sie eine klare Beschreibung hinzu * Speichern Bewährte Vorgehensweise: Erstellen Sie für jede Art von verkaufter Lizenz eine separate Ressource. *** #### Schritt 4: Produkt konfigurieren Im Menü auf der linken Seite: 1. Gehen Sie zu **Produkte** 2. Öffnen Sie das betreffende Produkt. **4.1 Informationen zu Obst und Gemüse verpflichtend machen** In den Teilnehmereinstellungen sollten folgende Optionen obligatorisch sein: * Name * Vorname * Geburtsdatum * Geschlecht Das Feld **Geschlecht** muss in der Clientdatei vorhanden sein. Konfiguration → Clientdatei Diese 4 Felder sind für die Abfrage des FFV unerlässlich. *** **4.2 FFV-Lizenzen als optionale Produktfunktion hinzufügen** Noch innerhalb des Produkts: 1. Gehen Sie zum Abschnitt **Optionen**. 2. Fügen Sie die zuvor erstellten FFV-Lizenzressourcen hinzu. 3. Speichern Sie entscheiden, welche Lizenzen Sie für jedes Produkt anbieten möchten. Beispiel : * Freizeitkurs → PASSFFV * Wettbewerb → JUGENDCLUB oder ERWACHSENENCLUB *** ### Wo kann ich den FFV-Status in Yoplanning einsehen? Neben dem Namen des Teilnehmers erscheint ein FFV-Logo: * Sitzungsdetails * Teilnehmer verwalten * Teilnehmerliste #### Bedeutung 🟢 Grün: Gültige Lizenz für die Sitzung 🟠 Orange: Lizenz fehlt, ist abgelaufen oder nicht konform Ablaufdaten werden automatisch berücksichtigt. *** ### Bewährte Verfahren * Alle 4 Felder müssen immer Pflichtfelder sein. * Bitte überprüfen Sie die genaue Schreibweise des Modells in den Ressourcen. * Testen eines kompletten Kaufs vor der öffentlichen Markteinführung. * Überprüfen Sie die FFV-E-Mail-Vorlage nach der Aktivierung. * Beschränken Sie die angebotenen Lizenzen auf diejenigen, die wirklich notwendig sind. *** ### Häufige Probleme und Lösungen #### Das FFV-Logo bleibt orange. Überprüfen : * Sind alle 4 Informationen vollständig? * Ist die Lizenz abgelaufen? * Stimmen die Angaben exakt überein (Rechtschreibung, Datum, Geschlecht)? *** #### Die Lizenz wird nicht nach dem Kauf erstellt. Überprüfen : * Hat der Kunde das per E-Mail erhaltene Formular ausgefüllt? * Ist das FFV-Modul ordnungsgemäß aktiviert? * Wurde die FFV-Strukturkennung zur Unterstützung bereitgestellt? * Enthält die Ressource das FFV-Partner-Tag? * Ist das Modell vollständig konform? *** #### Die Lizenzen werden im Produkt nicht angezeigt. Überprüfen : * Ressourcen sind unter **Ressourcen** verfügbar. * Sie sind tatsächlich als Option im Produkt enthalten. * Es handelt sich tatsächlich um das Produkt, das vom Buchungsmodul verwendet wird. *** ### Zusammenfassung Die FFV-Integration in Yoplanning ermöglicht Folgendes: * Online-Verkauf von FFV-Lizenzen * Automatische Überprüfung bestehender Lizenzen * Eine einfache Sichtprüfung für den BE * Eine direkte Verbindung zur offiziellen API des französischen Segelverbands Eine korrekte Konfiguration gewährleistet eine reibungslose, automatisierte und regelkonforme Verwaltung der FFV-Lizenzen in Yoplanning.pro.