Billbee verbinden (Beta)

Zugangsdaten in Billbee

1. 1Billbee › Einstellungen › API: API-Key anfordern (Billbee schaltet ihn frei).
2. 2Im selben Bereich ein API-Passwort für deinen Billbee-Nutzer festlegen.

Verbinden

1. 1Boardarc › Einstellungen › Workspace › Integrationen › ERP › Billbee.
2. 2API-Key, Billbee-Nutzername und API-Passwort eintragen und „Verbinden“ klicken. Boardarc testet mit GET /api/v1/orders?pageSize=1.
3. 3Optional: Die angezeigte Webhook-Adresse in Billbee unter Einstellungen › Webhooks eintragen (Order created/updated, Shipment). Ohne Webhook gleicht Boardarc alle 5 Minuten ab.

Datenquelle einrichten

1. 1Öffne ein Board und klicke oben auf „Datenquelle“.
2. 2Wähle „ERP“ und die Billbee-Verbindung, dann das Objekt (z. B. Aufträge) und optional Filter (Status, Kunde, Kanal).
3. 3Wähle den Zeitraum (nur neue, letzte X Tage, ab Datum) und prüfe die Vorschau mit Anzahl und Beispielen.
4. 4Klicke „Aktivieren“. Der Erst-Sync läuft im Hintergrund; danach wird alle 5 Minuten abgeglichen.

Kanal-Filter

Jeder Auftrag trägt seinen Kanal (z. B. Amazon, eBay, Otto, Shopify) im Feld „Kanal“. Filtere in der Datenquelle danach, um z. B. nur Otto-Aufträge in ein Board zu holen.

Mapping

Boardarc schlägt für jedes ERP-Feld eine passende Spalte vor (nach Name, dann nach Typ). Du kannst jede Zuordnung ändern oder leer lassen.

Status werden auf fünf gemeinsame Gruppen abgebildet: Angelegt, Freigegeben, Versendet, Abgeschlossen, Storniert. Positionen eines Auftrags erscheinen als Unteraufgaben.

Die Spalte „ERP-Verknüpfung“ zeigt die Belegnummer mit Link ins ERP und „Nachladen“.

Rückschreiben

Beta: Billbee wird nur gelesen. Rückschreiben ist für einzelne Felder vorbereitet, aber ausgeschaltet – Boardarc ändert nichts in Billbee.

Fehlerbehebung

Fehler zeigen die Antwort von Billbee im Klartext: Statuscode, Meldung und Endpunkt.

„Billbee antwortet mit 401 auf GET /api/v1/orders …“: API-Key, Nutzername oder API-Passwort stimmen nicht.

„… mit 429 …“: Billbee erlaubt 2 Anfragen pro Sekunde. Boardarc wartet automatisch und versucht es erneut.