# Softfair öffnen und Kunden übergeben

> Wie du Softfair aus der Kundenverwaltung öffnest, dabei auf Wunsch die Stammdaten eines Kunden übergibst, welchen Softfair-Account i-Planner verwendet und welche Daten fließen.

Im Fenster **Softfair** der **Kundenverwaltung** öffnest du Softfair und übergibst auf Wunsch die Stammdaten eines Kunden. Auf dieser Seite findest du die Schritte und erfährst, welcher Softfair-Account dabei verwendet wird und welche Daten zwischen i-Planner und Softfair fließen.

## Kurz erklärt {#kurz-erklaert}

Die Kachel **Softfair** hinter dem Raster-Symbol **Schnittstellen** öffnet das Fenster **Softfair**. Mit **Übergeben & Öffnen** überträgt i-Planner zuerst die Stammdaten eines Kunden und öffnet dann Softfair im AkquiseCenter. Mit **Öffnen** startet Softfair ohne Kundenübergabe. Was du vorher einrichten musst, steht unter [Softfair › Voraussetzungen](/organisation/integrationen/datenlieferanten/softfair/uebersicht#voraussetzungen).

Typische Aufgaben:

- Ein Kunde soll in Softfair verglichen werden: [Softfair aus der Kundenverwaltung öffnen](/organisation/integrationen/datenlieferanten/softfair/oeffnen#softfair-kundenverwaltung-oeffnen).
- Dir stehen mehrere Softfair-Zugänge zur Verfügung: [Welcher Softfair-Account verwendet wird](/organisation/integrationen/datenlieferanten/softfair/oeffnen#softfair-account-verwendet-wird).
- Du willst wissen, welche Kundendaten an Softfair gehen: [Was i-Planner an Softfair übermittelt](/organisation/integrationen/datenlieferanten/softfair/oeffnen#i-planner-softfair-uebermittelt).

## Softfair aus der Kundenverwaltung öffnen {#softfair-kundenverwaltung-oeffnen}

Die Kachel **Softfair** erscheint nur, wenn Softfair unter **Organisation › Integrationen** aktiviert ist und dich die **Freigabe** zulässt.

### Kunden übergeben und Softfair öffnen

1. Öffne in der **Kundenverwaltung** den Kunden, den du an Softfair übergeben willst. Das ist nicht nötig, spart aber die Suche. Startest du aus einem geöffneten Kundendatensatz, ist der Kunde im Fenster **Softfair** schon eingetragen.
2. Klicke rechts in der Kopfzeile, zwischen Glocke und Profilbild, auf das Raster-Symbol aus Punkten. Fährst du mit der Maus darüber, erscheint **Schnittstellen**. Es öffnen sich die Kacheln der Schnittstellen, die dir zur Verfügung stehen. Steht dir keine zur Verfügung, fehlt das Symbol.
3. Klicke auf die Kachel **Softfair**. Das Fenster **Softfair** öffnet sich mit dem Hinweis „Bitte wähle einen Kunden aus und drücke "Übergeben & Öffnen", um die Daten zu übertragen.“
4. Stehen dir mehrere Softfair-Accounts zur Verfügung, wähle unter **Account** den Account, mit dem sich Softfair öffnen soll. Vorausgewählt ist dein eigener.
5. Steht unter **Kunde** noch niemand, tippe in das Suchfeld **Kunde suchen** und wähle den Kunden aus. Das Feld nimmt genau einen Kunden auf. Gesucht wird nur unter Kunden.
6. Klicke auf **Übergeben & Öffnen**. i-Planner überträgt zuerst die Stammdaten des Kunden an Softfair. Danach öffnet sich Softfair in einem eigenen Browserfenster.

Klickst du auf **Übergeben & Öffnen**, ohne dass unter **Kunde** jemand eingetragen ist, erscheint derselbe Hinweis als Dialog, und Softfair öffnet sich nicht.

### Softfair ohne Kundenübergabe öffnen

Auf der Schaltfläche **Übergeben & Öffnen** sitzt rechts neben der Beschriftung ein kleines Umschalt-Symbol mit Pfeilen nach oben und unten. Klickst du auf das Symbol, heißt die Schaltfläche **Öffnen**. Ein Klick darauf öffnet Softfair ohne Kundenübergabe, und du musst dafür keinen Kunden auswählen. Ein erneuter Klick auf das Symbol stellt **Übergeben & Öffnen** wieder her. Hast du im selben Fenster **Softfair** vorher schon auf **Übergeben & Öffnen** geklickt, schließe das Fenster. Öffne es über die Kachel **Softfair** neu, bevor du **Öffnen** ohne Kundenübergabe nutzt.

## Welcher Softfair-Account verwendet wird {#softfair-account-verwendet-wird}

Softfair öffnet sich aus der **Kundenverwaltung** mit dem Account, der im Fenster **Softfair** unter **Account** ausgewählt ist. Die Auswahl erscheint nur, wenn dir mehr als ein Softfair-Account zur Verfügung steht. Dabei zählen eigene und für dich freigeschaltete Accounts zusammen. Jeder steht dort unter dem Namen aus seinem Feld **Name**. Vorausgewählt ist dein eigener Account. Ist dein eigener Account abgeschaltet, trägt er den Zusatz **(deaktiviert)**.

::callout
---
color: amber
icon: i-heroicons-exclamation-triangle
---
Die Kundenübergabe läuft immer über deinen eigenen Softfair-Account. i-Planner verwendet dafür deinen eigenen, aktiven Account, auch wenn du unter **Account** den freigeschalteten Account eines Kollegen gewählt hast. Hast du keinen eigenen, aktiven Softfair-Account, findet keine Übergabe statt. i-Planner zeigt dann keine Fehlermeldung, und Softfair öffnet sich trotzdem mit dem gewählten Account.
::

Gibt es für dich keinen gültigen Softfair-Account oder bist du nicht freigegeben, zeigt das Fenster **Softfair** statt der Auswahl einen Hinweis und nur die Schaltfläche **Schließen**. Was die Hinweise bedeuten, steht unter [Fehlerbehebung](/organisation/integrationen/datenlieferanten/softfair/fehlerbehebung).

## Was i-Planner an Softfair übermittelt {#i-planner-softfair-uebermittelt}

i-Planner schickt zu drei Anlässen Daten an Softfair:

| Anlass | Was an Softfair geht |
|---|---|
| Prüfung der Zugangsdaten nach **Account anlegen**, bei **Verbindung prüfen** und bei der täglichen automatischen Prüfung | **Benutzername** und **Passwort** des Softfair-Accounts, an die Anmeldung von Softfair |
| Öffnen von Softfair mit **Öffnen** oder **Übergeben & Öffnen** | Der Aufruf der Softfair-Anmeldung enthält **Benutzername** und **Passwort** des im Fenster **Softfair** gewählten Accounts, das Passwort als MD5-Prüfsumme, dazu die Kennung für das AkquiseCenter. |
| Kundenübergabe, nur mit **Übergeben & Öffnen**, bevor sich Softfair öffnet | Die Stammdaten des gewählten Kunden und Angaben zur Zuordnung. Welche das sind, zeigt die Tabelle zur Kundenübergabe in diesem Abschnitt. Dafür meldet sich i-Planner mit dem eigenen Softfair-Account der angemeldeten Person bei Softfair an. |

Bei **Übergeben & Öffnen** übergibt i-Planner diese Angaben des gewählten Kunden an Softfair:

| Bereich | Angaben |
|---|---|
| Person | Anrede, Titel, Vorname, Nachname, Geburtsdatum |
| Anschrift | Straße, PLZ und Ort aus der Standardadresse |
| Kontakt | Telefon, Mobil, E-Mail und Fax, jeweils der Standardeintrag |
| Beruf | Beruf und Berufsstatus |
| Familie | Familienstand |
| Zuordnung | Die interne Kundennummer, unter der i-Planner den Kunden führt, eine Kennung des angemeldeten Vermittlers und die Angabe „Einzelperson“ |

Ein paar Einzelheiten zur Übergabe:

- Leere Felder überträgt i-Planner nicht. Ausgenommen sind Anrede, Berufsstatus und Familienstand. Sie gehen immer mit, jeweils als Wert aus einer festen Liste. Bei der Anrede gibt es nur Herr und Frau. Die Liste für den Berufsstatus enthält zum Beispiel Angestellt, Beamter, Selbständig, Rentner und Student, die für den Familienstand etwa ledig, verheiratet, geschieden und verwitwet. Ist eines dieser Felder leer oder hat sein Wert keine Entsprechung in der Liste, übergibt i-Planner „Unbekannt“.
- Übergeben wird genau ein Kunde als Einzelperson. Haushalt, Partner, Kinder, Bankverbindung, Verträge und Dokumente gehen nicht an Softfair.

## Was von Softfair zurückkommt {#softfair-zurueckkommt}

Aus Softfair kommen keine Dokumente in den Posteingang und keine Verträge, Angebote oder Kundendaten nach i-Planner. Es gibt keinen automatischen Abruf und keine Synchronisation. Auch die Antwort von Softfair auf die Kundenübergabe, etwa die Kunden-ID bei Softfair, speichert i-Planner nicht. i-Planner zeigt keine Rückmeldung zur Übergabe an, auch keine Fehlermeldung, wenn sie scheitert.

Zurück kommt nur das Ergebnis der Prüfung der Zugangsdaten:

| Ergebnis | Wo du es siehst | Wann |
|---|---|---|
| Prüfung beim Anlegen und auf Klick | Unter **Organisation › Accounts** auf der Seite des Softfair-Accounts oben rechts: grün **Verbunden** mit Datum und Uhrzeit oder rot die Fehlermeldung. Dazu erscheint „Verbindung erfolgreich“ oder der Dialog **Validierung fehlgeschlagen**. Ist Softfair nicht erreichbar, bleibt der Status unverändert, und es erscheint „Der Anbieter ist momentan nicht erreichbar — bitte später erneut versuchen.“ | Direkt nach **Account anlegen** und bei jedem Klick auf **Verbindung prüfen** |
| Tägliche Prüfung | Im Status auf der Seite des Softfair-Accounts. Wechselt der Account in den Fehlerzustand, bekommt sein **Accountinhaber** die Benachrichtigung „Verbindung fehlgeschlagen: …“ mit dem Namen des Accounts und einem Link zum Account. | Einmal täglich für alle aktiven Softfair-Accounts. Die Benachrichtigung kommt nur beim Wechsel in den Fehlerzustand, nicht jeden Tag erneut. Ist Softfair nicht erreichbar, bleibt der Status unverändert. |

Dieser Status entscheidet, ob sich Softfair öffnen lässt. Nur wenn dir ein aktiver, zuletzt als gültig geprüfter Softfair-Account zur Verfügung steht, zeigt das Fenster **Softfair** die Kundenauswahl und die Schaltfläche **Übergeben & Öffnen**. Sonst zeigt es einen Hinweis und nur **Schließen**.

## Weitere Themen {#weitere-themen}

- [Softfair](/organisation/integrationen/datenlieferanten/softfair/uebersicht): Softfair aktivieren, freigeben und den Softfair-Account anlegen.
- [Fehlerbehebung](/organisation/integrationen/datenlieferanten/softfair/fehlerbehebung): wenn das Fenster „Softfair“ nur „Schließen“ zeigt, der falsche Zugang öffnet oder unklar ist, ob der Kunde angekommen ist.
- [Smart Insurtech](/organisation/integrationen/datenlieferanten/smart-insurtech/uebersicht): eine weitere Integration, die die Stammdaten eines Kunden überträgt und danach ein Portal öffnet.
- [Datenlieferanten](/organisation/integrationen/datenlieferanten/uebersicht): alle Vergleichsrechner und Partnerportale im Überblick.