# fb>xpert

> Was fb>xpert kann und wie du die Integration aktivierst, freigibst, deinen fb>xpert-Account anlegst und Accounts stilllegst oder löschst.

fb>xpert ist die spartenübergreifende Vergleichs- und Angebotssoftware von Franke und Bornberg. Mit eigenem fb>xpert-Zugang legst du aus i-Planner mit den Daten eines Kunden einen neuen fb>xpert-Vorgang an und springst direkt hinein. Angebote, die fb>xpert zu diesem Vorgang zurückmeldet, legt i-Planner samt Dokumenten beim Kunden als Verträge mit Status **Angebot** an.

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

Die Integration verbindet die Kundenverwaltung mit deinem fb>xpert-Zugang:

- Kunden übergeben: Du wählst in der Kundenverwaltung einen Kunden und eine Sparte. fb>xpert legt mit den Kundendaten einen Vorgang im gewählten Spartenbereich an und öffnet sich in einem eigenen Browserfenster.
- Angebote übernehmen: Meldet fb>xpert den Vorgang zurück, holt i-Planner die Angebote dazu bei fb>xpert ab und legt beim Kunden je Angebot einen Vertrag mit Status **Angebot** an.
- Dokumente übernehmen: Dokumente, die fb>xpert zum Vorgang bereitstellt, legt i-Planner beim Kunden unter den Dokumenten ab. Lassen sie sich einem Angebot zuordnen, verknüpft i-Planner sie mit dem passenden Vertrag.
- Verbindung prüfen: i-Planner prüft nach dem Anlegen, auf Knopfdruck und einmal täglich, ob fb>xpert die Zugangsdaten eines Accounts annimmt.

Einen zeitgesteuerten Abruf, einen Posteingang oder eine Synchronisation gibt es nicht. Angebote und Dokumente holt i-Planner nur ab, wenn fb>xpert einen Vorgang zurückmeldet, der über **Öffnen** aus i-Planner heraus angelegt wurde. Die Rückmeldeadresse gibt i-Planner bei genau diesem Absprung mit.

Typische Aufgaben:

- Deine Organisation will fb>xpert nutzen: [fb>xpert einrichten](/organisation/integrationen/datenlieferanten/fbxpert/uebersicht#fb-xpert-einrichten).
- Ein Kunde soll in fb>xpert verglichen werden: [Kunden an fb>xpert übergeben](/organisation/integrationen/datenlieferanten/fbxpert/kunden-uebergeben#kunden-fb-xpert-uebergeben).
- Du willst wissen, welche Daten an fb>xpert gehen und was zurückkommt: [Welche Daten fließen](/organisation/integrationen/datenlieferanten/fbxpert/kunden-uebergeben#daten-fliessen).
- Niemand soll fb>xpert mehr nutzen: [Alle fb>xpert-Accounts auf einmal stilllegen](/organisation/integrationen/datenlieferanten/fbxpert/uebersicht#accounts-stilllegen).
- Angebote kommen nicht an oder das Fenster bleibt leer: [Fehlerbehebung](/organisation/integrationen/datenlieferanten/fbxpert/fehlerbehebung).

## Voraussetzungen {#voraussetzungen}

- Ein eigener fb>xpert-Zugang bei Franke und Bornberg: Benutzername, Passwort und gegebenenfalls die Subdomain deiner fb>xpert-Adresse.
- Zum Aktivieren braucht deine Benutzerrolle das Recht **Integrationen**. Zum Anlegen des Accounts braucht sie das Recht **Accounts**.
- fb>xpert ist unter **Organisation › Integrationen** aktiviert. Ohne Aktivierung gibt es weder die Kachel in der Kundenverwaltung, noch lässt sich ein fb>xpert-Account anlegen.
- Du bist für die Integration freigegeben. Das regelt der Bereich **Einschränkungen** auf der Detailseite von fb>xpert.
- Mindestens ein aktiver fb>xpert-Account gehört dir oder ist für dich freigeschaltet.
- Damit Angebote und Dokumente zurückkommen, braucht die Person, die den Absprung startet, einen eigenen aktiven fb>xpert-Account. Den freigeschalteten Account eines Kollegen zu nutzen, reicht dafür nicht.

## fb>xpert einrichten {#fb-xpert-einrichten}

Die Integration aktivierst du einmal für die Organisation. Die Zugangsdaten gehören in einen Account unter **Organisation › Accounts**, nicht auf die Detailseite der Integration.

### Integration aktivieren

1. Öffne **Organisation › Integrationen** und klicke unter **Entdecken › Alle** auf die Kachel **fb>xpert**.
2. Schalte im Bereich **Aktivierung** den Schalter **Integration aktivieren** ein.

*Animation: Die Detailseite von fb>xpert mit Logo, Kennzeichen Official, der Beschreibung Spartenübergreifende Vergleichs- und Angebotssoftware von Franke und Bornberg und den Angaben Built by Franke & Bornberg und Website franke-bornberg.de. Im Bereich Aktivierung wird der Schalter Integration aktivieren eingeschaltet, es erscheint Feld „Integration aktivieren“ wurde gespeichert!, und darunter erscheint der Bereich Einschränkungen mit der Freigabe Alle Mitarbeiter. Dann wird die Freigabe auf Nur ausgewählte Mitarbeiter gestellt. Im neuen Bereich Ausgewählte Mitarbeiter mit der Liste aus Gruppen, Rollen und Personen wird die Rolle Administrator angekreuzt, der Zähler springt auf 2 Mitglieder, es erscheint Freigabe gespeichert.*

3. Optional: Im jetzt sichtbaren Bereich **Einschränkungen** stellst du das Feld **Freigabe** von **Alle Mitarbeiter** auf **Nur ausgewählte Mitarbeiter**. Dann wählst du unter **Ausgewählte Mitarbeiter** Rollen, Gruppen oder Personen aus. Wie die Auswahl funktioniert, steht unter **Organisation › Integrationen** im Abschnitt [Wer die Integration nutzen darf](/organisation/integrationen/uebersicht#wer-integration-nutzen-darf).

In fb>xpert musst du keine Rückmeldeadresse hinterlegen. i-Planner übergibt sie bei jedem Absprung selbst.

### Account anlegen

1. Öffne **Organisation › Accounts** und klicke auf **Neuer Account**.
2. Wähle **fb>xpert**. Fehlt der Eintrag, ist fb>xpert nicht aktiviert oder nicht für dich freigegeben.
3. Fülle unter **Stammdaten** und **Zugangsdaten** die Felder aus dieser Tabelle aus:

| Feld | Pflicht | Was eintragen |
|---|---|---|
| **Name** | Ja | Frei wählbarer Anzeigename für den Account. |
| **Accountinhaber** | Ja | Das Teammitglied, dem der Account gehört. Vorausgewählt bist du selbst. Nur sichtbar, wenn deine Rolle Accounts für andere anlegen darf. Die Vermittlerdaten, die an fb>xpert gehen, stammen vom Accountinhaber. |
| **Benutzername** | Ja | Dein fb>xpert-Benutzername. Fehlt er, meldet die Verbindungsprüfung „Zugangsdaten unvollständig.“ |
| **Passwort** (geheim) | Ja | Dein fb>xpert-Passwort. Es wird verschlüsselt gespeichert und später nicht wieder angezeigt. |
| **Subdomain** | Nein | Der Teil vor „.fb-xpert.de“ in deiner fb>xpert-Adresse, zum Beispiel „meinbuero“. Bleibt das Feld leer, verwendet i-Planner „www“. |

4. Klicke auf **Account anlegen**. Fehlt der Name, erscheint „Name ist erforderlich“. Fehlt das Passwort, erscheint „Passwort ist erforderlich“.

i-Planner meldet „Account erstellt“ und prüft die Verbindung sofort. Nimmt fb>xpert die Anmeldung an, steht oben neben der Überschrift **fb>xpert** grün **Verbunden** mit Datum. Lehnt fb>xpert ab, öffnet sich das Fenster **Validierung fehlgeschlagen** mit dem Grund. Der Grund steht danach rot neben der Überschrift. Du kannst jederzeit im Abschnitt **Verbindung** über **Verbindung prüfen** erneut prüfen.

Wer den Account außer dem Accountinhaber nutzen darf, legst du im Abschnitt **Freischaltung** fest. Zur Wahl stehen **Alle Mitarbeiter**, **Nur das Team des Accountinhabers**, **Nur der Accountinhaber** und **Accountinhaber + ausgewählte**. Auf der Detailseite der Integration steht danach im Bereich **Accounts**, wie viele Accounts verknüpft sind.

## Alle fb>xpert-Accounts auf einmal stilllegen {#accounts-stilllegen}

Schalte unter **Organisation › Integrationen** auf der Detailseite von fb>xpert zuerst **Integration aktivieren** aus. Danach erscheint im Bereich **Accounts** der Schalter **Alle Accounts deaktivieren**. Schalte ihn ein. i-Planner deaktiviert dann alle aktiven fb>xpert-Accounts, und ihre Inhaber erhalten die Benachrichtigung **Accounts deaktiviert**. Das Ausschalten von **Integration aktivieren** allein legt die Accounts nicht still. Solange **Alle Accounts deaktivieren** an ist, lässt sich kein fb>xpert-Account einzeln einschalten oder neu anlegen. i-Planner meldet dann „Die Accounts dieser Integration sind gesammelt deaktiviert. Bitte zuerst im Integrationsbereich wieder aktivieren.“ Wie du die Accounts wieder aktivierst, steht unter **Organisation › Integrationen** im Abschnitt [Gesammelt stillgelegte Accounts wieder aktivieren](/organisation/integrationen/uebersicht#gesammelt-stillgelegte-accounts-wieder-aktivieren).

## Einen fb>xpert-Account löschen {#account-loeschen}

Öffne den fb>xpert-Account unter **Organisation › Accounts** und klicke im Bereich **Gefahrenzone** auf **Account löschen**. Bestätige im Dialog **Account löschen?** mit **Endgültig löschen**. i-Planner meldet „Account gelöscht“ und zeigt wieder die Liste **Alle**. Danach verschickt i-Planner die Sicherheits-E-Mail „Konto getrennt“. Die **Gefahrenzone** erscheint nur, wenn deine Benutzerrolle diesen Account löschen darf. Den zweiten Weg über die Accounts-Liste findest du unter **Organisation › Accounts** im Abschnitt [Account löschen](/organisation/accounts/ausschalten-und-loeschen#account-loeschen).

::callout
---
icon: i-heroicons-exclamation-triangle
color: amber
---
Das Löschen lässt sich nicht rückgängig machen. Die gespeicherten Zugangsdaten gehen verloren. Willst du den fb>xpert-Account nur vorübergehend nicht nutzen, schalte stattdessen **Account aktiv** aus.
::

## Häufige Fragen {#haeufige-fragen}

::faq
  :::faq-item{question="Kann eine Kollegin meinen fb>xpert-Account mitbenutzen?"}
  Ja. Stelle unter **Organisation › Accounts** im Abschnitt **Freischaltung** deines Accounts zum Beispiel **Accountinhaber + ausgewählte** ein und wähle sie aus. Nutzt sie deinen Account, springt sie mit deinen Zugangsdaten und deinen Vermittlerdaten zu fb>xpert. Angebote und Dokumente übernimmt i-Planner für ihre Absprünge aber nur, wenn sie selbst einen aktiven fb>xpert-Account hat.
  :::

  :::faq-item{question="Muss ich in fb>xpert eine Rückmeldeadresse für i-Planner eintragen?"}
  Nein. i-Planner übergibt die Rückmeldeadresse bei jedem Absprung automatisch. Auch auf der Detailseite der Integration unter **Organisation › Integrationen** trägst du dafür nichts ein.
  :::
::

## Weitere Themen {#weitere-themen}

- [Kunden übergeben](/organisation/integrationen/datenlieferanten/fbxpert/kunden-uebergeben): einen Kunden an fb>xpert übergeben und sehen, welche Daten dabei fließen.
- [Fehlerbehebung](/organisation/integrationen/datenlieferanten/fbxpert/fehlerbehebung): wenn die Kachel fehlt, das Fenster leer bleibt oder Angebote nicht ankommen.
- [Accounts](/organisation/accounts/uebersicht): Zugangsdaten ändern, die Verbindung prüfen, einen Account freischalten.
- [Wer die Integration nutzen darf](/organisation/integrationen/uebersicht#wer-integration-nutzen-darf): die Freigabe für Rollen, Gruppen und Personen.