# Dein Billbee verbinden

> Schritt-für-Schritt-Anleitung, wie du dein Billbee-Konto mit FFN Connect verbindest und Artikeldaten synchronisierst.

## Schritt 1: API-Zugriff in Billbee aktivieren

FFN Connect kommuniziert mit Billbee über die **Billbee-API**. Dafür musst du den API-Zugriff in deinem Billbee-Konto einmalig aktivieren und ein **API-Passwort** festlegen.

1. Öffne in Billbee **Einstellungen → Billbee API → Allgemeine Einstellungen** ([app.billbee.io/app_v2/settings/api/general](https://app.billbee.io/app_v2/settings/api/general)).
2. Aktiviere den Schalter **Aktivieren**.
3. Lege ein **API-Passwort** fest. Das Passwort muss mindestens 12 Zeichen lang sein und Großbuchstaben, Kleinbuchstaben, eine Zahl sowie ein Sonderzeichen (`!@$%^&*+#`) enthalten.
4. Klicke auf **Speichern**.

![Billbee: API-Zugriff unter Einstellungen → Billbee API aktivieren und API-Passwort festlegen](https://ffn-connect.de/docs-assets/merchants/billbee/connect-billbee/_images/01-billbee-api-einstellungen.jpg)

*Bildquelle: [Billbee-Hilfe — API-Zugriff einrichten](https://hilfe.billbee.io/article/444-api-zugriff-einrichten)*

> [!WICHTIG]
> Das API-Passwort darf **keinen Doppelpunkt (`:`)** enthalten, sonst schlägt die Anmeldung fehl.

> [!HINWEIS]
> Einen eigenen **API-Key** musst du **nicht** bei Billbee beantragen — FFN Connect bringt bereits einen mit. Du benötigst nur deinen Benutzernamen und das API-Passwort.

## Schritt 2: Verkaufskanal hinzufügen

1. Wechsle in FFN Connect zu **Verkaufskanäle → Verkaufskanal hinzufügen**.
2. Wähle **Billbee** aus.
3. Gib einen Namen für den Verkaufskanal ein (optional).
4. Trage deinen **Billbee-Benutzernamen** ein — beim Hauptaccount ist das die E-Mail-Adresse, mit der du dich bei Billbee anmeldest; bei einem Mitarbeiter-Konto der zugewiesene Benutzername.
5. Trage das in Schritt 1 festgelegte **API-Passwort** ein.
6. Klicke auf **Weiter**. FFN Connect prüft die Zugangsdaten automatisch.

<!-- TODO Bild: Screenshot des FFN-Connect-Formulars zum Anlegen des Billbee-Verkaufskanals (Name, Benutzername, API-Passwort). Vorlage: https://hilfe.billbee.io/article/444-api-zugriff-einrichten -->

> [!HINWEIS]
> Schlägt die Prüfung fehl, prüfe zuerst, ob der API-Zugriff in Billbee wirklich **aktiviert** ist (Schritt 1). Die Meldung „Das Passwort scheint falsch zu sein" deutet auf ein falsches API-Passwort hin — beachte, dass hier das **API-Passwort** gemeint ist, nicht dein Billbee-Login-Passwort.

## Schritt 3: Artikeldaten synchronisieren

1. Öffne deinen Billbee-Verkaufskanal in FFN Connect, indem du zu **Verkaufskanäle** navigierst und auf den Namen des Verkaufskanals klickst.
2. Klicke auf **Produkte synchronisieren** (du kannst dort alle Einstellungen so lassen, wie sie sind).
3. Klicke auf **Fortfahren und synchronisieren**.

Der Vorgang kann ein paar Minuten dauern, je nachdem, wie viele Produkte und Varianten du in deinem Billbee hast.

<!-- TODO Bild: Screenshot der Produkt-Synchronisierung in FFN Connect (Dialog „Produkte synchronisieren"). Vorlage: https://hilfe.billbee.io/article/444-api-zugriff-einrichten -->

Anschließend siehst du deine Billbee-Artikel in der Tabelle des Verkaufskanals. Damit dein Fulfillment-Dienstleister sie bearbeiten kann, musst du sie noch freigeben — das passiert im Hauptmenü unter **Artikel**, nicht im Verkaufskanal. Wie das geht, erklärt der Artikel [Artikel an den Fulfiller freigeben](/docs/merchants/basics/products/release-to-fulfiller).

## Schritt 4: Bestellungen und Versand

Nach der Verbindung richtet FFN Connect automatisch die Übertragung neuer Bestellungen ein — du musst dafür nichts weiter konfigurieren. Sobald in Billbee eine Bestellung angelegt oder aktualisiert wird, erscheint sie in FFN Connect.

Wird eine Bestellung versendet, meldet FFN Connect die **Trackingnummer** und den Versandstatus an Billbee zurück. Damit Billbee diese Daten korrekt an deine angebundenen Shops und Marktplätze weitergeben kann, müssen die Versandarten zugeordnet sein — wie das geht, erklärt der Artikel [Versandarten korrekt zuordnen](/docs/merchants/billbee/shipping-methods). Gerade in Verbindung mit **OTTO Market** ist das Pflicht.

## Nächste Schritte

- [Versandarten korrekt zuordnen](/docs/merchants/billbee/shipping-methods) — damit Billbee Trackingnummern an deine Shops und Marktplätze (z. B. OTTO Market) weitergeben kann.
- [Mehrere Lager in Billbee (Multi-Lager)](/docs/merchants/billbee/multi-warehouse) — wenn du in Billbee mit mehr als einem Lager arbeitest.