# BCA

> Was die BCA-Integration kann, was du dafür brauchst und wie du BCA aktivierst, freigibst und einen BCA-Account anlegst, einstellst und prüfst.

BCA ist ein Maklerpool für Versicherungs- und Investmentprodukte. Die Integration richtet sich an Makler mit eigenem BCA-Zugang. Sie holt BCA-Dokumente in den **Posteingang** der **Kundenverwaltung** und springt mit einem ausgewählten Kunden direkt in das BCA-Maklerportal DiVA. Dort legt i-Planner den Kunden bei Bedarf neu an.

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

Die BCA-Integration verbindet deinen BCA-Zugang mit der **Kundenverwaltung**:

- Im **Posteingang** der **Kundenverwaltung** holt das Symbol mit den kreisenden Pfeilen neue Dokumente von BCA ab. Jedes Dokument kommt als Datei mit Bezeichnung, Dokumentdatum, Dateityp und Größe an. Soweit BCA sie liefert, kommen Anrede, Vorname, Nachname und Geburtsdatum des Kunden, Vertragsnummer und Gesellschaft dazu.
- Beim Öffnen des **Posteingangs** ordnet i-Planner abgeholte BCA-Dokumente im Hintergrund Vertrag und Kunde zu. Das geht über die Vertragsnummer oder ersatzweise über einen eindeutigen Vor- und Nachnamen. Legst du ein Dokument selbst ab, sind Kunde und Vertrag aus den BCA-Angaben vorbelegt.
- In der Kopfzeile der **Kundenverwaltung** öffnest du über das Symbol **Schnittstellen** die Kachel **BCA**, wählst einen Kunden und springst mit **Öffnen** in das BCA-Maklerportal DiVA. Findet BCA den Kunden nicht eindeutig und ist noch keine BCA-Kundennummer gespeichert, legt i-Planner ihn bei BCA neu an.
- Um den Zugang zu prüfen, meldet sich i-Planner mit **Benutzername** und **Passwort** bei BCA an. Das passiert direkt nach dem Anlegen des Accounts, bei jedem Klick auf **Verbindung prüfen** und einmal täglich. Setzt die tägliche Prüfung den Account neu auf Fehler, bekommt der **Accountinhaber** eine Benachrichtigung.
- Mit **Automatischer Abruf** am Account ruft i-Planner die Dokumentliste von BCA nach Zeitplan ab, ohne Dateien. Die Angaben speichert es für deine Organisation. In den **Posteingang** kommt dabei nichts.

::callout
---
color: amber
icon: i-heroicons-exclamation-triangle
---
Die Abholung in den Posteingang startet nur von Hand und reicht 7 Tage zurück. Neue BCA-Dokumente holst du im **Posteingang** der **Kundenverwaltung** über das Symbol mit den kreisenden Pfeilen. Dabei fragt i-Planner nur Dokumente ab, die bei BCA in den letzten 7 Tagen geändert wurden. Wer länger nicht abholt, bekommt ältere Dokumente nicht mehr. Der Zeitplan unter **Automatischer Abruf** ändert daran nichts, denn er legt keine Dokumente im **Posteingang** ab.
::

Typische Aufgaben mit BCA:

- Du richtest BCA zum ersten Mal ein: [BCA einrichten](/organisation/integrationen/pool/bca/uebersicht#bca-einrichten).
- Neue BCA-Dokumente sollen in den Posteingang: [BCA-Dokumente in den Posteingang holen](/organisation/integrationen/pool/bca/dokumente-und-diva#bca-dokumente-posteingang-holen).
- Du willst einen Kunden in DiVA ansehen: [Kunden in DiVA öffnen](/organisation/integrationen/pool/bca/dokumente-und-diva#kunden-diva-oeffnen).
- Eine Kollegin soll deinen BCA-Account mitnutzen: [BCA-Account einstellen und prüfen](/organisation/integrationen/pool/bca/uebersicht#bca-account-einstellen-pruefen).
- Anlegen, Prüfen oder Abholen klappt nicht: [Fehlerbehebung](/organisation/integrationen/pool/bca/fehlerbehebung).

## Voraussetzungen {#voraussetzungen}

- Ein eigener BCA-Zugang mit Benutzername und Passwort. i-Planner verwendet den Benutzernamen gegenüber BCA als Broker-ID.
- BCA ist unter **Organisation › Integrationen** für deine Organisation aktiviert. Ohne Aktivierung lassen sich keine BCA-Accounts anlegen, die Kachel **BCA** fehlt in der **Kundenverwaltung**, und es werden keine BCA-Dokumente abgeholt.
- Zum Aktivieren von BCA und für die **Einschränkungen** braucht deine Benutzerrolle das Recht **Integrationen**. Ohne dieses Recht lässt sich die Detailseite von BCA nicht öffnen. i-Planner leitet dich dann zum ersten Modul weiter, das du öffnen darfst.
- Zum Anlegen eines BCA-Accounts braucht deine Benutzerrolle das Recht **Accounts**. Hast du das Recht **Integrationen** nicht, musst du zusätzlich für BCA freigegeben sein. Diese Freigabe steht auf der Detailseite von BCA im Bereich **Einschränkungen** unter **Freigabe**.
- Für die Abholung im **Posteingang** und für den Sprung nach DiVA brauchst du einen eingeschalteten BCA-Account, dessen Verbindung erfolgreich geprüft wurde. Er muss dir gehören oder für dich freigeschaltet sein. Sonst zeigt das BCA-Fenster in der **Kundenverwaltung** nur einen Hinweis.
- Für den direkten Sprung zu einem Kunden in DiVA verwendet i-Planner deinen eigenen BCA-Account. Das ist ein Account, dessen **Accountinhaber** du bist. Ohne eigenen BCA-Account legt i-Planner den Kunden bei jedem **Öffnen** neu bei BCA an, über den im Fenster gewählten Account, siehe [Fehlerbehebung](/organisation/integrationen/pool/bca/fehlerbehebung#kunde-mehrfach).

## BCA einrichten {#bca-einrichten}

Die Einrichtung hat zwei Teile. Du aktivierst BCA einmal für die Organisation und legst danach einen Account mit deinen BCA-Zugangsdaten an.

### BCA aktivieren

1. Öffne **Organisation › Integrationen**, wähle links unter **Entdecken** **Alle** oder **Pool** und klicke die Kachel **BCA** an. Die Detailseite zeigt oben das Kennzeichen **Official** und die Beschreibung „Maklerpool für Versicherungs- und Investmentprodukte“. Dazu kommen **Built by** BCA, **Docs** mit dem Link **i-Planner Docs** und **Website** bca.de.
2. Schalte im Bereich **Aktivierung** den Schalter **Integration aktivieren** ein. i-Planner speichert die Änderung sofort.

*Animation: Die Detailseite von BCA mit Logo, Kennzeichen Official, der Beschreibung Maklerpool für Versicherungs- und Investmentprodukte und den Angaben Built by BCA, Docs i-Planner Docs und Website bca.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: Erst bei eingeschalteter Integration erscheint der Bereich **Einschränkungen**. Dort stellst du die **Freigabe** von **Alle Mitarbeiter** (Voreinstellung) auf **Nur ausgewählte Mitarbeiter** und wählst unter **Ausgewählte Mitarbeiter** Rollen, Gruppen oder Personen. Die Freigabe steuert, wer BCA-Accounts anlegen und die Kachel **BCA** in der **Kundenverwaltung** nutzen darf. Einzelheiten stehen unter **Organisation › Integrationen** im Abschnitt [Wer die Integration nutzen darf](/organisation/integrationen/uebersicht#wer-integration-nutzen-darf).

### BCA-Account anlegen

1. Öffne **Organisation › Accounts** und klicke auf **Neuer Account**.
2. Wähle in der Liste **BCA**. Die Liste bietet nur aktivierte Integrationen an.
3. Fülle unter **Stammdaten** und **Zugangsdaten** diese Felder aus:

| Feld | Pflicht | Was eintragen |
|---|---|---|
| **Name** | Ja | Frei wählbarer Anzeigename für den Account. Er erscheint auch im Fortschrittsfenster, wenn du im **Posteingang** der **Kundenverwaltung** Dokumente abholst. Fehlt er, erscheint **Name ist erforderlich**. |
| **Accountinhaber** | Ja | Das Teammitglied, dem der Account gehört. Voreingestellt bist du selbst. Das Feld erscheint nur, wenn deine Benutzerrolle Accounts anderen Mitgliedern zuordnen darf. |
| **Benutzername** | Ja | Dein BCA-Login, den i-Planner gegenüber BCA als Broker-ID verwendet. Das Formular lässt das Feld leer zu, ohne Benutzername scheitert aber die Anmeldung bei BCA. |
| **Passwort** | Ja, **geheim** | Dein BCA-Passwort. Die Eingabe ist verdeckt, und i-Planner speichert den Wert verschlüsselt. Die Unterzeile „Passwort bzw. App-Passwort des Postfachs.“ ist ein allgemeiner Text. Fehlt das Passwort, erscheint **Passwort ist erforderlich**. |

4. Klicke auf **Account anlegen**.

i-Planner meldet „Account erstellt“ und prüft die Verbindung sofort bei BCA. Klappt die Anmeldung, erscheint „Verbindung erfolgreich“, und der Account zeigt **Verbunden** mit Datum und Uhrzeit. Lehnt BCA die Anmeldung ab, öffnet sich der Dialog **Validierung fehlgeschlagen** mit dem Grund. Scheitert schon das Anlegen, erscheint der Dialog **Anlegen fehlgeschlagen**, auch mit dem Grund. Was du bei einer Fehlermeldung tust, steht unter [Fehlerbehebung](/organisation/integrationen/pool/bca/fehlerbehebung).

## BCA-Account einstellen und prüfen {#bca-account-einstellen-pruefen}

Auf der Seite eines BCA-Accounts unter **Organisation › Accounts** legst du fest, wer den Account nutzen darf und ob er nach Zeitplan abruft. Alle diese Einstellungen sind optional:

| Feld | Pflicht | Was eintragen |
|---|---|---|
| **Freischaltung** | Nein | **Alle Mitarbeiter**, **Nur das Team des Accountinhabers**, **Nur der Accountinhaber** (Voreinstellung) oder **Accountinhaber + ausgewählte**. Legt fest, wer den Account außer dem Inhaber nutzen darf, zum Beispiel bei der Abholung im **Posteingang** der **Kundenverwaltung**. |
| **Automatischer Abruf** | Nein | Schalter mit **Intervall** (1 bis 99), **Einheit** (**Stunde(n)**, **Tag(e)**, **Woche(n)** oder **Monat(e)**), **An diesen Tagen**, **Tag im Monat** (1. bis 28.) und **Uhrzeit**. Die Uhrzeit wählst du in Viertelstunden, Voreinstellung 06:00, Zeitzone Europe/Berlin. Ausschalten löscht den Zeitplan. Der Abruf holt nur die Dokumentliste von BCA, ohne Dateien, und legt nichts im **Posteingang** ab. |
| **Erstabruf-Zeitraum (Tage)** | Nein | Abschnitt **Datenabruf**. Wie viele Tage der erste Lauf nach Zeitplan zurückreicht. 0 heißt nur zukünftige. Voreinstellung 90, erlaubt sind 0 bis 3650. Gilt nicht für die Abholung im **Posteingang**. |

Wie **Freischaltung** und **Automatischer Abruf** im Einzelnen funktionieren, steht unter **Organisation › Accounts**.

Änderst du die Zugangsdaten, speichert i-Planner sie sofort, prüft sie aber nicht sofort. Klicke danach im Abschnitt **Verbindung** auf **Verbindung prüfen**. Sonst testet erst die tägliche Prüfung die neuen Daten. Das Feld **Passwort** zeigt das gespeicherte Passwort nicht mehr an und trägt den Hinweis „Gespeichert — aus Sicherheit nicht erneut anzeigbar. Leer lassen behält ihn, eine Eingabe ersetzt ihn.“ Lässt du das Feld leer, bleibt das gespeicherte Passwort erhalten. Eine Eingabe ersetzt es.

Den Status zeigt die Seite des Accounts: **Verbunden** mit Datum und Uhrzeit, **Nicht geprüft** oder die Fehlermeldung der letzten Prüfung. i-Planner prüft die Verbindung zusätzlich einmal täglich. Setzt diese Prüfung den Account neu auf Fehler, erhält der **Accountinhaber** die Benachrichtigung „Verbindung fehlgeschlagen: …“ mit dem Namen des Accounts und dem Grund.

::callout
---
icon: i-heroicons-light-bulb
---
Ein BCA-Account, der für eine Kollegin nur freigeschaltet ist, reicht ihr für die Abholung im **Posteingang**. Für den direkten Sprung zu einem Kunden in DiVA verwendet i-Planner dagegen nur den eigenen BCA-Account des angemeldeten Benutzers. Soll sie Kunden in DiVA öffnen, braucht sie einen BCA-Account, dessen **Accountinhaber** sie selbst ist. Sonst legt jedes **Öffnen** den Kunden über deinen Account erneut bei BCA an.
::

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

::faq
  :::faq-item{question="Was trage ich bei „Benutzername“ ein?"}
  Deinen BCA-Login. i-Planner verwendet den Benutzernamen gegenüber BCA als Broker-ID und meldet sich damit zusammen mit dem **Passwort** bei BCA an. Das Formular unter **Organisation › Accounts** lässt das Feld zwar leer zu, ohne Benutzername scheitert aber die Anmeldung bei BCA.
  :::

  :::faq-item{question="Wie oft prüft i-Planner meinen BCA-Zugang?"}
  Automatisch direkt nach **Account anlegen** und danach einmal täglich im Hintergrund. Von Hand kannst du jederzeit zusätzlich prüfen. Öffne dazu den Account unter **Organisation › Accounts** und klicke im Abschnitt **Verbindung** auf **Verbindung prüfen**. Geänderte Zugangsdaten speichert i-Planner sofort, testet sie aber erst bei einer dieser Prüfungen. Steht am Account **Nicht geprüft**, wurde die Verbindung noch nicht geprüft.
  :::

  :::faq-item{question="Kann eine Kollegin mit meinem BCA-Account Dokumente abholen?"}
  Ja, wenn du den Account für sie freischaltest. Voreingestellt ist bei einem BCA-Account die **Freischaltung** **Nur der Accountinhaber**. Öffne den Account unter **Organisation › Accounts** und wähle unter **Freischaltung** **Alle Mitarbeiter**, **Nur das Team des Accountinhabers** oder **Accountinhaber + ausgewählte**. Wie das im Einzelnen geht, steht unter **Organisation › Accounts** im Abschnitt [Einen Account für Kolleginnen und Kollegen freischalten](/organisation/accounts/bearbeiten#account-kolleginnen-kollegen-freischalten). Für den direkten Sprung zu einem Kunden in DiVA verwendet i-Planner bei ihr aber immer ihren eigenen BCA-Account. Hat sie keinen, legt jedes **Öffnen** den Kunden neu bei BCA an, siehe [Fehlerbehebung](/organisation/integrationen/pool/bca/fehlerbehebung#kunde-mehrfach).
  :::

  :::faq-item{question="Ich habe BCA deaktiviert — sind die BCA-Accounts jetzt stillgelegt?"}
  Nein. Schaltest du unter **Organisation › Integrationen** auf der Detailseite von BCA den Schalter **Integration aktivieren** aus, fehlen die Kachel **BCA** und die Abholung von BCA-Dokumenten im **Posteingang**. Auch der Zeitplan unter **Automatischer Abruf** läuft dann nicht. Die BCA-Accounts bleiben aber aktiv. Der Hinweis hinter dem Info-Symbol am Schalter sagt dazu: „Deaktivieren suspendiert die Accounts nicht — es schränkt nur die Nutzung der Schnittstelle ein. Zum Stilllegen der Accounts den Schalter ‚Alle Accounts deaktivieren‘ nutzen.“ Diesen Schalter findest du auf der Detailseite von BCA, solange BCA ausgeschaltet ist und Accounts hat. Er schaltet alle BCA-Accounts ab, und ihre Inhaber erhalten die Benachrichtigung **Accounts deaktiviert**. Mehr dazu unter **Organisation › Integrationen** im Abschnitt [Alle Accounts einer Integration stilllegen](/organisation/integrationen/uebersicht#accounts-integration-stilllegen).
  :::
::

## Weitere Themen {#weitere-themen}

- [Dokumente abholen und DiVA öffnen](/organisation/integrationen/pool/bca/dokumente-und-diva): welche Daten fließen, BCA-Dokumente holen und ablegen, Kunden in DiVA öffnen.
- [Fehlerbehebung](/organisation/integrationen/pool/bca/fehlerbehebung): wenn Anlegen, Prüfen, Abholen oder der Sprung nach DiVA nicht klappt.
- [Integrationen](/organisation/integrationen/uebersicht): Integrationen aktivieren, freigeben und ihre Accounts stilllegen.
- [Accounts](/organisation/accounts/uebersicht): Accounts anlegen, freischalten und prüfen.
