# 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: 👉 <https://www.notion.so/ffvoile-dsi/Autoriser-une-solution-externe-agir-au-nom-d-une-structure-2f7ebc4120c880099d31c738169e0a9a>

***

### Konfiguration in Yoplanning

#### Schritt 1: Aktivierung des FFV-Moduls anfordern

Um die FFV-Modulkonfiguration zu erhalten:

1. Wenden Sie sich an den Yoplanning-Support (<support@yoplanning.com>), 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.yoplanning.support/de/yoplanning-academy/yoplanning-parametrage/gestion-des-options-ressources-materielles-et-immaterielles/procedure-de-connexion-a-la-federation-francaise-de-voile-ffv.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
