Konfiguration

B2B+ Base bringt mehrere Plugin-Einstellungen mit, alle je Verkaufskanal schaltbar. Firmen, Mitglieder und Adressen selbst verwalten Inhaber und Administratoren im Storefront-Kontobereich oder über die API — nicht in diesen Einstellungen.

Alle Einstellungen liegen in der Shopware-Administration unter Einstellungen → Erweiterungen → B2B+ Base (oder über das Zahnrad-Symbol des Plugins) und sind nach Karten gruppiert.

Nur Firmenanmeldungen (nur B2B)

Karte „B2B+ Registrierung".

Eigenschaft	Wert
Bezeichnung	Nur Firmenanmeldungen erlauben (nur B2B)
Technischer Schlüssel	AvellonB2BPlusBase.config.onlyCompanyRegistrations
Typ	Ja/Nein (Schalter)
Standard	aus (deaktiviert)
Geltungsbereich	pro Verkaufskanal einstellbar

Hilfetext wie in der Administration:

Wenn aktiviert, ist die Registrierung auf Firmenkonten festgelegt: die Auswahl Privat/Firma entfällt, neue Kunden registrieren sich immer als Firma, und ein Firmenname ist Pflicht. Bestehende Konten und der Checkout bleiben unberührt. Gilt je Verkaufskanal.

Ausgeschaltet verhält sich das Registrierungsformular wie im Shopware-Standard, mit Auswahl zwischen Privat- und Firmenkonto. Eingeschaltet entfällt die Auswahl: jede Neuanmeldung wird ein Firmenkonto mit Pflicht-Firmenname. B2B+ Base erzwingt das serverseitig und damit auch über die Store API — die Regel lässt sich nicht umgehen. Bestehende Konten und der Gast-Checkout bleiben unberührt.

Zusammenspiel mit der Auto-Provisionierung

Da jede Anmeldung einen Firmennamen trägt, legt B2B+ Base für jeden neuen Kunden automatisch eine Firma mit Inhaber-Mitgliedschaft an (siehe Firmenkonten).

Nur Firmenadressen anzeigen

Karte „B2B+ Firmenadressen".

Eigenschaft	Wert
Bezeichnung	Bei aktiver Firma im Konto/Checkout nur Firmenadressen anzeigen
Technischer Schlüssel	AvellonB2BPlusBase.config.onlyCompanyAddresses
Typ	Ja/Nein (Schalter)
Standard	aus (deaktiviert)
Geltungsbereich	pro Verkaufskanal einstellbar

Hilfetext wie in der Administration:

Wenn aktiviert und der eingeloggte Kunde eine aktive Firma hat, zeigt das Adressbuch im Konto ausschließlich die Adressen dieser Firma im Standard-Adresskarten-Design. Die Firmenadressen werden automatisch in das eigene Adressbuch des Kunden übernommen, damit sie im Standard-Checkout auswählbar sind. Kunden ohne aktive Firma bleiben unberührt.

Ausgeschaltet filtert nichts: Konto und Checkout verhalten sich wie im Shopware-Standard, Firmenadressen lassen sich weiterhin anlegen und nutzen. Eingeschaltet sieht ein Kunde mit aktiver Firma (die mindestens eine Firmenadresse hat) im Konto-Adressbuch und im Checkout nur die Firmenadressen, im Checkout bereits vorgewählt. Ein Escape-Link erlaubt bei Bedarf andere Adressen. Das vollständige Verhalten — Materialisierung, Standard-Adressen, Escape-Hatch — steht unter Firmenadressen.

Pro Verkaufskanal

Weil die Einstellung je Verkaufskanal gilt, aktivieren Sie das Feature etwa nur im B2B-Kanal und lassen es im B2C-Kanal aus.

USt-IdNr.-Prüfung (VIES)

Karte „B2B+ USt-IdNr.-Prüfung" mit zwei Schaltern.

Eigenschaft	Wert
Bezeichnung	Firmen-USt-IdNr. über den EU-VIES-Dienst prüfen
Technischer Schlüssel	AvellonB2BPlusBase.config.validateVatViaVies
Typ	Ja/Nein (Schalter)
Standard	an (aktiviert)
Geltungsbereich	pro Verkaufskanal einstellbar

Prüft die USt-IdNr. einer Firma bei jeder Änderung gegen VIES und speichert den Status (gültig, ungültig, nicht erreichbar). Status-Werte, die Besonderheiten deutscher USt-IdNr. und die steuerliche Einordnung stehen unter USt-IdNr.-Prüfung.

Eigenschaft	Wert
Bezeichnung	Nettopreise nur für VIES-validierte Firmen (Reverse-Charge)
Technischer Schlüssel	AvellonB2BPlusBase.config.netPricesForValidatedEuB2B
Typ	Ja/Nein (Schalter)
Standard	aus (deaktiviert)
Geltungsbereich	pro Verkaufskanal einstellbar

Beschränkt Shopwares innergemeinschaftliche B2B-Steuerbefreiung auf Firmen mit VIES-Status gültig. Setzt voraus, dass unter Einstellungen → Länder die „Steuerbefreiung für Firmen" aktiviert ist. Details unter USt-IdNr.-Prüfung → Steuerliche Einordnung.

Admin-Modul (read-only)

Kunden → Firmen listet alle Firmenkonten. Ein Klick öffnet die Firma mit ihren Mitgliedern (Name, E-Mail, Rolle, Status). Den Zugriff steuert die ACL-Rolle avellon_b2b_company.viewer.

Das Modul liest nur. Angelegt und bearbeitet werden Firmen, Mitglieder und Adressen im Storefront-Kontobereich durch Inhaber und Administratoren (Konto → Firmenkonto) oder über die Shopware-Admin-API (Entitäten b2b_company, b2b_company_member, b2b_company_address, b2b_company_invite). Verwaiste Firmen, deren Inhaber gelöscht wurde, repariert der Befehl avellon:b2b:reassign-owner.

Firmen für Bestandskunden anlegen (Backfill)

Kunden, die schon vor der Installation mit Firmenname existierten, bekommen Firmen und Adressbücher nachträglich über einen Konsolenbefehl:

bin/console avellon:b2b:backfill-companies

Der Befehl ist sicher wiederholbar und überspringt Kunden, die bereits eine Mitgliedschaft haben. --dry-run zeigt nur, was angelegt würde, ohne zu schreiben. Er legt pro Kunde eine eigene Firma an und führt gleiche Firmennamen nicht zusammen. Details unter Firmenkonten → Backfill.

Einladungs-Mail anpassen

Die Einladungs-Mail läuft über eine editierbare Shopware-Mail-Vorlage. Sie bearbeiten sie unter Einstellungen → E-Mail-Vorlagen; der technische Name ist avellon_b2b_company_invitation („Firmen-Einladung (B2B+ Base)"). Verfügbare Variablen und Verhalten stehen unter Einladungen → Mail-Vorlage. Ein Plugin-Update überschreibt Ihre Änderungen nicht.

Deinstallation & Daten

Beim Deinstallieren fragt Shopware, ob es die Benutzerdaten behalten soll. Behalten Sie die Daten, bleiben alle Firmendaten und die Mail-Vorlage erhalten.

Löschen Sie die Daten, entfernt das Plugin die Firmentabellen und nimmt die von B2B+ Base gesetzten Markierungen in den Kundenadressen zurück. Firmenadressen, die in Kunden-Adressbücher kopiert wurden, bleiben als normale Kundenadressen bestehen — Kundendaten löscht das Plugin nicht. Löschen Sie später einen Kunden, entfernt Shopware dessen Mitgliedschaften ohnehin automatisch (DSGVO-freundlich).