In diesem Beitrag erfährst du, wie du in PlentyOne eine fybu-Rolle anlegst, die erforderlichen Rechte vergibst, einen API-Benutzer erstellst und diese Informationen bei fybu einträgst.

Voraussetzungen:

•  Administrativer Zugriff auf PlentyOne

•  Zugriff auf die relevanten Mandantschaften, Shops, Marktplätze und Zahlungssysteme

•  Ein fybu-Zugang für die spätere Hinterlegung von Benutzername, Passwort und Hostname

Anleitung:

Gehen Sie für die Einrichtung wie folgt vor:

1. Neue Rolle anlegen

• Öffne in PlentyOne den Bereich Einrichtung > Kontoverwaltung > Rollen.

• Lege eine neue Rolle mit dem Namen "fybu" an.

• Aktiviere die Option "Erweitert" damit alle benötigten Rechte sichtbar sind.

2. Rechte für Aufträge und sichtbare Aufträge setzen

• Suche im Bereich "Rechte" nach "Aufträge" und aktivieren dort "Lesen". 

• Öffne anschließend den Bereich "Zugriffsrechte" dann "Sichtbare Aufträge" und wähle "Alle" aus.

3. Auftragsherkünfte freigeben

• Öffne unter "Zugriffsrechte" den Bereich "Auftragsherkünfte."

• Aktiviere dort direkt "manuelle Eingabe" sowie "Mandant (Shop)".

• Markiere zusätzlich alle vorhandenen und geplanten Marktplätze, Zahlungssysteme und Shops. Im Zweifel lieber etwas großzügiger auswählen.

• Speicher die Rolle.

4. API-Benutzer erstellen

• Gehe von Einrichtung > Rollen > neue Rolle > Benutzername und gebe dort fybu_1 und bei Name darunter: fybu ein.

• Erstelle darunter ein Passwort und bestätige es im rechten Feld daneben.

• Notiere Benutzername und das Passwort für Fybu aus Plenty, damit du diese später direkt eintragen kannst.

• Den Regler "API Nutzer” anschalten

• Aus den Dropdown Menü "zugewiesene Rollen" "fybu" auswählen 

• Speichern

5. Benutzer aktivieren und Hostname übernehmen

• Lege in unserer Software unter Optionen für die Systemeinrichtung das Multichannel-System: PlentyOne an

• Wechsel anschließend zurück zu PlentyOne, fahre mit der Maus über die ID des Benutzers und kopiere die vollständigen REST-API (inklusive http..) und trage die gesamte Rest API bei Fybu in den "Hostnamen" ein 

• Trage auch das notierte erstellte Passwort und den Benutzernamen in den jeweiligen entsprechenden Feldern ein

⚠️ Achte darauf, dass keine Leerzeichen beim Kopieren eingefügt werden.

6. Mandanten - IDs 

• Alle für fybu gültigen aktiven Mandantschafts-IDs müssen aus Plenty übertragen werden  

7. Welche Belegtypen importiert fybu?

Standardmäßig importiert fybu folgende Plenty-Typen:

• credit_note_external

• invoice_external

• invoice

• credit_note

• reversal_refund

• reversal_document

• pos_invoice

• pos_invoice_cancellation

Wenn du zusätzliche Typen benötigst, kontaktiere bitte den Support.

FAQ

Brauche ich zwingend einen separaten API-Benutzer?
Ja, das wird dringend empfohlen. So bleibt dein Admin-Zugang unangetastet.

Was passiert, wenn „Alle Herkünfte“ nicht aktiviert sind?
Bestimmte Aufträge werden dann nicht übertragen.

Wo finde ich den API-Endpunkt?
Unter Einrichtung → Einstellungen → API → Daten.

Begriffe erklärt

REST-API
Schnittstelle, über die fybu automatisiert Daten aus Plenty abruft.

Endpunkt (Endpoint)
Die Internetadresse, über die die API erreichbar ist.

Mandant (Shop)
Ein einzelner Plenty-Shop innerhalb deiner Systemumgebung.

Auftragsherkunft
Quelle eines Auftrags (z. B. Shop, Marktplatz, POS).

Rollen & Rechte
Steuern, welche Daten ein Benutzer sehen oder nutzen darf.

Brauchst du Hilfe?

Hast du weitere Fragen zur Einrichtung von PlentyOne mit fybu? Nutze unsere weiteren Hilfeartikel für Schritt-für-Schritt-Anleitungen und Hintergrundinformationen.

Super, dass du bis hier gelesen hast! 🎉 Falls noch Fragen offen sind, melde dich jederzeit über den Chat – wir helfen dir gerne weiter.