B2B Plattform

Nach dem Login in die Shopware Administration sehen Sie das Dashboard mit der Tagesstatistik. In der linken Seitenleiste befindet sich die Hauptnavigation. Das B2B-Modul wird über den Menüpunkt "Kunden" erreicht. Auf dem Dashboard sind die aktuellen Bestellungen sichtbar – hier z.B. zwei Bestellungen von B2B-Mitarbeitern (Bestellnummer 10000 und 10001).

Die Plugin-Konfiguration erreichen Sie unter Erweiterungen > Meine Erweiterungen > Bronn B2B-Plattform > Konfiguration. Hier werden die globalen Einstellungen verwaltet:

Allgemeine Einstellungen:

Genehmigungen:

Budget:

Funktionen:

Die Firmenliste zeigt alle registrierten B2B-Unternehmen unter "Kunden" > "B2B-Firmen". Die Tabelle zeigt Firmenname, Firmennummer, Inhaber, Aktiv-Status und Erstellungsdatum. Über "Firma anlegen" kann eine neue B2B-Firma erstellt werden. Klicken Sie auf einen Firmennamen, um zur Detailseite zu gelangen.

Der Tab "Allgemein" zeigt die Stammdaten der Firma: Firmenname (Pflichtfeld), Firmennummer, USt-IdNr., Aktiv-Status und Inhaber (Hauptkonto). Der Inhaber ist der Shopware-Kunde, der als Firmenadmin agiert und wird über ein Suchfeld ausgewählt.

Der Mitarbeiter-Tab zeigt alle der Firma zugeordneten Mitarbeiter mit Name, E-Mail, Rolle, Aktiv-Status und Hinzufügungsdatum. Über "Mitarbeiter hinzufügen" können bestehende Shopware-Kunden als Mitarbeiter zugeordnet werden – im Modal wählen Sie den Kunden und weisen optional eine Rolle zu.

Der Rollen-Tab zeigt alle Rollen mit Rollenname, Beschreibung, Admin-Flag, Anzahl der Berechtigungen (21 in 9 Kategorien) und zugewiesenen Mitarbeitern. Über "Rolle anlegen" erstellen Sie neue Rollen mit individuellen Berechtigungen.

Der Budget-Tab zeigt alle Budgets mit Bezeichnung, Betrag, Verbraucht, Verbleibend, Zeitraum (Monatlich/Quartalsweise/Jährlich/Einmalig), Zuordnung und Aktiv-Status. Im Beispiel: "Monatsbudget Einkäufer" (500 EUR, 0 verbraucht) und "Testbudget Perm Tester" (500 EUR, 849,99 EUR verbraucht – Überschreitung: -349,99 EUR).

Der Genehmigungen-Tab zeigt eine Read-Only-Übersicht aller Bestellfreigaben: Bestellnummer, Mitarbeiter, Status (Ausstehend/Genehmigt/Abgelehnt), Genehmiger, Anfrage- und Entscheidungsdatum. Die eigentliche Genehmigung erfolgt im Frontend durch den Firmenadmin.

Der Kostenstellen-Tab ermöglicht die Verwaltung von Kostenstellen mit Bezeichnung, Kurzcode und Aktiv-Status. Mitarbeiter können bei Bestellungen eine Kostenstelle auswählen, um Ausgaben zu kategorisieren. Die Funktion kann in der Plugin-Konfiguration global aktiviert/deaktiviert werden.

Der Adressen-Tab verwaltet gemeinsame Firmenadressen mit Bezeichnung, Name, Straße, Stadt, Land und Standard-Flag. Diese Adressen stehen allen Mitarbeitern als Liefer- oder Rechnungsadresse zur Verfügung.

Nach dem Login als Firmeninhaber sehen Sie die Kontoübersicht mit der B2B-Sidebar-Navigation. Der Firmenadmin hat Zugriff auf alle 8 B2B-Menüpunkte: Firmenübersicht, Mitarbeiter, Rollen & Rechte, Budgets, Genehmigungen, Kostenstellen, Artikelbeschränkungen und Firmenadressen.

Das B2B-Dashboard zeigt auf einen Blick: Firmendaten (Name, Nummer, USt-IdNr., Inhaber), Mitarbeiteranzahl (3), offene Genehmigungen (2 ausstehend) und Budget-Status mit Fortschrittsanzeige (0 EUR von 500 EUR, 0%). Der Toggle "Hilfe-Tooltips anzeigen" steuert erklärende Tooltips im gesamten B2B-Bereich.

Die Mitarbeiterverwaltung zeigt alle Mitarbeiter mit Name, E-Mail, Rolle, Aktiv-Status und Aktionen. Rollen können direkt per Dropdown geändert werden. Der "KST"-Button weist Kostenstellen zu. Der Firmenadmin erscheint selbst in der Liste, kann sich aber nicht entfernen.

Das Formular "Neuen Mitarbeiter anlegen" enthält: Anrede, Vorname, Nachname, E-Mail (alle Pflicht), Passwort (mind. 8 Zeichen) und Rollenzuweisung. Es wird ein vollständiges neues Shopware-Kundenkonto erstellt und automatisch der Firma zugeordnet.

Die Rollenverwaltung listet alle Rollen mit Rollenname, Berechtigungsanzahl, Mitarbeiteranzahl und Aktionen (Bearbeiten/Löschen). Über "Rolle anlegen" erstellen Sie neue Rollen.

Das Rollenformular zeigt alle 21 Berechtigungen in 9 Kategorien:

Die Checkbox "Admin-Rolle" aktiviert alle Berechtigungen auf einmal.

Die Budgetverwaltung zeigt alle Budgets mit Bezeichnung, Betrag, Verbraucht, Verbleibend, Zeitraum und Zuordnung. Negative Verbleibend-Werte zeigen eine Überziehung an. Budgets werden im Bestellprozess geprüft – liegt der Bestellwert über dem Budget, wird die Bestellung zur Genehmigung weitergeleitet.

Das Budget-Formular enthält: Bezeichnung, Betrag in EUR (min. 0,01), Zeitraum (Monatlich/Quartalsweise/Jährlich/Einmalig), Mitarbeiter-Zuordnung und Rollen-Zuordnung. Ein Budget kann einem einzelnen Mitarbeiter ODER einer Rolle zugewiesen werden. "Alle Mitarbeiter" bedeutet firmenweit. Das Budget wird automatisch im gewählten Zeitraum zurückgesetzt.

Die Genehmigungsseite zeigt ausstehende und bearbeitete Anfragen mit Bestellnummer, Mitarbeiter, Betrag, Status und Datum. Es gibt zwei Arten: Bestellungen (bei Budgetüberschreitung) und Warenkorbanfragen (bei fehlender Bestellberechtigung). Der "Warenkorbinhalt"-Button zeigt die Artikel bei Warenkorbanfragen.

Die Kostenstellenverwaltung zeigt Bezeichnung, Kurzcode und Aktiv-Status. Kostenstellen dienen der buchhalterischen Zuordnung von Bestellungen. Die Zuweisung zu Mitarbeitern erfolgt über den "KST"-Button auf der Mitarbeiterverwaltungsseite.

Artikelbeschränkungen ermöglichen es, bestimmte Produkte oder Kategorien für Mitarbeiter zu sperren oder freizugeben. So kann gesteuert werden, welche Artikel bestellt werden dürfen. Die Berechtigung "Artikelbeschränkungen verwalten" steuert den Zugriff.

Firmenadressen sind zentrale Adressen, die allen Mitarbeitern im Checkout zur Verfügung stehen. Im Unterschied zu persönlichen Adressen gehören sie der Firma. Typische Anwendungsfälle: Zentrale Firmenadresse als Rechnungsadresse, verschiedene Standorte als Lieferadressen.

Hinweis ab v1.5.0: Firmen-Inhaber sehen den Menüpunkt "Firmenadressen" in der Sidebar jetzt zuverlässig. Der Fix injiziert synthetische Owner-Permissions im `AccountMenuSubscriber` und behebt das Sichtbarkeits-Problem aus den 1.4.x-Versionen.

Schritt 1: Firmenadresse anlegen. Der Firmen-Inhaber legt im Storefront-Account unter "Firmenadressen" die zentrale Lieferadresse (z.B. Zentrallager) und Rechnungsadresse (z.B. Hauptsitz) an. Diese Adressen stehen anschließend allen Mitarbeitern mit der Berechtigung "Firmenadressen anzeigen" zur Verfügung.

Schritt 2: Im Checkout auswählen. Auf der Bestellbestätigungsseite (Confirm) erscheinen ab v1.5.0 zwei neue Dropdowns: "Firmenadresse als Lieferadresse" und "Firmenadresse als Rechnungsadresse". Der Mitarbeiter wählt die gewünschte Firmenadresse aus der Liste, bestätigt per Button und die Seite lädt mit der gewählten Adresse als aktiver Liefer- bzw. Rechnungsadresse neu. Die Adresse wird zusätzlich in das persönliche Adressbuch des Mitarbeiters kopiert, damit Standard-Shopware-Bezüge (Bestellhistorie, E-Mails) konsistent bleiben.

Sicherheit: Die zugehörige Route `adopt-and-select` ist POST-only und CSRF-geschützt. Exception-Details werden nicht an den Storefront-Client durchgereicht.

Alternativer Weg: Der bestehende Adopt-Workflow im Account-Bereich ("Firmenadresse in mein Adressbuch übernehmen") bleibt unverändert verfügbar.

Schritt 1: Account → automatisch Firmenadressen. Klickt ein Mitarbeiter im Account-Bereich auf "Adressen" (`/account/address`), wird er ab v1.6.0 automatisch auf das Firmenadressen-Modul umgeleitet. Eine private Adressverwaltung sieht er nicht mehr. Damit ist sichergestellt, dass Mitarbeiter ausschließlich mit den von der Firma freigegebenen Adressen arbeiten.

Backend-Schutz: Direkte Standard-Save-Routen (`/account/address/create`, `/account/address/edit`) sind serverseitig mit HTTP 403 geblockt. Auch per Direct-POST oder via API-Tools kann der Mitarbeiter keine privaten Adressen anlegen.

Schritt 2: Im Checkout-Modal mit Firmenadressen-Tabs. Klickt der Mitarbeiter im Checkout auf "Adresse ändern", öffnet sich nicht mehr die Standard-Shopware-Adressverwaltung, sondern der `BronnB2bAddressManager` als Modal. Zwei Tabs stehen zur Verfügung: "Lieferadresse" und "Rechnungsadresse". Jeder Tab listet die Firmenadressen, auf die der Mitarbeiter Zugriff hat.

Initialer Tab (v1.7.3): Wird das Modal vom "Rechnungsadresse ändern"-Link geöffnet, ist der Rechnungs-Tab vorausgewählt. Das Submit-Button-Label switcht beim Tab-Wechsel passend mit ("Als Lieferadresse übernehmen" / "Als Rechnungsadresse übernehmen").

Stabilität (v1.7.2): Das Helper-Plugin `BronnB2bModalInit` re-initialisiert den `BronnB2bAddressManager` nach jedem Modal-AJAX-Load — auch beim zweiten oder dritten Öffnen bleibt das Modal funktionsfähig.

Ein Mitarbeiter sieht in der Seitennavigation nur die B2B-Menüpunkte, für die er eine Berechtigung hat. Im Vergleich zum Firmenadmin fehlen hier z.B. Mitarbeiter, Rollen & Rechte, Genehmigungen und Artikelbeschränkungen – die Navigation wird dynamisch basierend auf der zugewiesenen Rolle angezeigt.

Der Mitarbeiter sieht dieselben Dashboard-Widgets (Firmendaten, Mitarbeiterzahl, offene Genehmigungen, Budget) wie der Firmenadmin, aber im Nur-Lesen-Modus. Das Budget-Widget zeigt das persönliche Budget des Mitarbeiters.

Die Produktliste zeigt Preise und "In den Warenkorb"-Buttons, weil die Berechtigungen "Preise sehen" und "In den Warenkorb legen" in der Rolle aktiv sind. Ohne diese Berechtigungen würden Preise ausgeblendet (BronnHidePrices) bzw. Warenkorb-Buttons entfernt.

Auf der Produktdetailseite zeigt das Budget-Widget direkt den aktuellen Budget-Status: Hier ist das Budget bereits überzogen (-349,99 EUR von 500 EUR) mit dem Warnhinweis "Ihr Budget ist aufgebraucht. Neue Bestellungen erfordern eine Freigabe." Außerdem sichtbar: Staffelpreise, Mindermengenzuschlag-Hinweis und Angebotsanfrage-Button.

Der Mitarbeiter sieht die Produktliste mit Preisen und Warenkorb-Buttons dank seiner Einkäufer-Berechtigungen.

Der Offcanvas-Warenkorb zeigt das Produkt (19,99 EUR) plus den automatisch berechneten Mindermengenzuschlag (30,00 EUR). Zwei B2B-Warnhinweise sind sichtbar: (1) Diese Bestellung erfordert eine Freigabe durch den Firmenadministrator. (2) Der Warenkorbwert übersteigt das verbleibende Budget. Der Mitarbeiter kann trotzdem zur Kasse gehen.

Die Checkout-Seite zeigt alle B2B-Elemente: Warnhinweise zur Freigabe und Budgetüberschreitung, AGB-Checkbox, Budget-Widget (849,99 EUR verbraucht von 500 EUR, 170%), Kostenstellen-Auswahl, Adressen und Warenkorbpositionen. Statt des normalen Bestell-Buttons erscheint "Zur Freigabe einreichen".

Nach dem Einreichen sieht der Mitarbeiter die Bestätigung: "Ihre Bestellanfrage wurde erfolgreich zur Freigabe eingereicht. Sie werden benachrichtigt, sobald Ihr Firmenadministrator die Anfrage bearbeitet hat." Die Zusammenfassung zeigt 2 Positionen und 49,99 EUR Gesamtbetrag.

Der Firmenadmin sieht unter Genehmigungen die ausstehende Anfrage (Warenkorbanfrage von Perm Tester, 49,99 EUR, Ausstehend). Er kann über "Genehmigen" oder "Ablehnen" entscheiden. Bei Warenkorbanfragen gibt es zusätzlich "Warenkorbinhalt" zur Artikeleinsicht.

Nach Klick auf "Genehmigen" erscheint ein Kommentarfeld. Der Kommentar wird in der Benachrichtigungs-E-Mail an den Mitarbeiter angezeigt. Ein weiterer Klick auf "Genehmigen" löst die Bestellung automatisch aus.

Nach der Genehmigung wird die Bestellung automatisch im Namen des Mitarbeiters aufgegeben. Die Erfolgsmeldung bestätigt: "Bestellung wurde genehmigt und automatisch aufgegeben." Der Status wechselt auf "Genehmigt" und die Bestellung erhält die Bestellnummer 10002.