Überblick
Für die Verbindung zwischen Xentral und fybu benötigst du einen Personal Access Token. Dieser ersetzt dein Passwort für die API-Anbindung und ermöglicht fybu einen sicheren Zugriff auf die benötigten Daten.
Damit die Verbindung dauerhaft funktioniert, sollte der Token mit der Berechtigung Admin Read erstellt und die Duration auf Unbegrenzte Laufzeit gesetzt werden.
Xentral → Personal Access Token erstellen → Admin Read aktivieren → Duration auf Unbegrenzte Laufzeit setzen → Token in fybu eintragen → Verbindung herstellen
Voraussetzungen
- ☑️ Du kannst dich bei Xentral anmelden.
- ☑️ Du hast Zugriff auf Profil → Kontoeinstellungen → Developer Einstellungen.
- ☑️ Du hast die Berechtigung, Personal Access Tokens zu erstellen.
- ☑️ Du hast Zugriff auf die Integrationseinstellungen in fybu.
Schritte
1. Personal Access Token in Xentral erstellen
So geht's:
- Melde dich bei Xentral an.
- Öffne Profil → Kontoeinstellungen.
- Wechsle zu Developer Einstellungen.
- Klicke auf Token erstellen.
- Vergib einen Namen, z. B. fybu.
- Aktiviere die Berechtigung „Admin Read“.
- Stelle bei Duration die Option Unbegrenzte Laufzeit ein.
- Klicke auf Token erstellen.
- Kopiere den angezeigten Personal Access Token.
💡 Tipp: Bewahre den Token sicher auf. Je nach Xentral-Version wird er nach dem Erstellen nicht erneut vollständig angezeigt.
⚠️ Fehlerhinweis: Ist Admin Read nicht aktiviert oder läuft der Token ab, kann fybu keine Verbindung herstellen oder keine Daten aus Xentral abrufen. Erstelle in diesem Fall einen neuen Token.
2. Xentral in fybu verbinden
So geht's:
- Öffne in fybu die Xentral-Integration.
- Trage die folgenden Daten ein:
- Passwort → Füge hier den zuvor erstellten Personal Access Token ein.
- Hostname (Seitenname) → Trage die URL deiner Xentral-Instanz ein, z. B.
https://deinunternehmen.xentral.biz - Hinweis: K
- Speichere die Einstellungen.
- Starte die Verbindung.
💡 Tipp: Verwende den vollständigen Hostnamen inklusive https:// und es darf kein / hinter der Domain gesetzt werden
⚠️ Fehlerhinweis: Falls die Verbindung fehlschlägt, prüfe:
- ob der Personal Access Token vollständig eingefügt wurde,
- ob Admin Read aktiviert ist,
- ob Duration auf Unbegrenzte Laufzeit gesetzt wurde,
- ob der Hostname korrekt eingetragen wurde,
- ob der Token noch gültig ist.
💡 Dies eignet sich als Unterkapitel innerhalb von „Xentral mit fybu verbinden“.
FAQ
Warum wird der Token im Passwort-Feld eingetragen?
Für die API-Verbindung verwendet fybu den Personal Access Token anstelle eines normalen Passworts.
Welche Berechtigungen muss der Token haben?
Aktiviere die Berechtigung Admin Read.
Welche Duration sollte ich auswählen?
Wähle Unbegrenzte Laufzeit, damit der Token nicht automatisch abläuft und die Verbindung bestehen bleibt.
Was trage ich als Hostname ein?
Die URL deiner Xentral-Instanz, z. B. https://deinunternehmen.xentral.biz.
Ich habe meinen Token verloren oder er ist abgelaufen. Was jetzt?
Erstelle in Xentral einen neuen Personal Access Token und hinterlege ihn anschließend erneut in fybu.
Begriffe erklärt
Personal Access Token
Ein sicherer Zugangsschlüssel für die API, der anstelle eines Passworts verwendet wird.
API
Eine Schnittstelle, über die Xentral und fybu Daten miteinander austauschen.
Hostname
Die Internetadresse deiner Xentral-Instanz, z. B. https://deinunternehmen.xentral.biz.
Admin Read
Eine Berechtigung in Xentral, die fybu das Auslesen der benötigten Daten erlaubt.
Duration
Legt fest, wie lange ein Personal Access Token gültig ist. Für die Verbindung mit fybu sollte Unbegrenzte Laufzeit ausgewählt werden.
Super, dass du bis hier gelesen hast! 🎉 Falls noch Fragen offen sind, melde dich jederzeit über den Chat – wir helfen dir gerne weiter.
Weiterführende Themen
- Xentral mit fybu verbinden
- Integrationen verwalten
- API-Verbindungen prüfen
- Häufige Verbindungsfehler beheben
- Personal Access Token erneuern