Einladungen

Bestehende Firmen wachsen über Einladungen: Ein Inhaber oder Administrator lädt eine Person ein, die dann als Administrator oder Mitglied beitritt. B2B+ Base kennt zwei Ausgangslagen. Entweder hat die eingeladene Adresse schon ein Kundenkonto, oder es existiert noch keins. Der Ablauf und die Einladungs-Mail sind in beiden Fällen gleich; verschieden ist nur der Moment, in dem aus der Einladung eine Mitgliedschaft wird.

Die Inhaber-Rolle lässt sich nicht per Einladung vergeben. Sie entsteht, wenn ein Kunde bei der Registrierung eine Firma anlegt (siehe Firmenkonten), oder wenn ein Inhaber sie später einem Mitglied zuweist (siehe Mitglieder & Rollen).

Wer einladen darf

Einladen dürfen ausschließlich Inhaber und Administratoren, und nur mit einer aktiven Mitgliedschaft. Als Rolle für die eingeladene Person stehen Administrator und Mitglied zur Wahl.

Eine Einladung verschicken

Der Inhaber oder Administrator öffnet im Konto Firmenkonto → Mitarbeiter, trägt im Abschnitt Mitglied einladen die E-Mail-Adresse und die gewünschte Rolle ein und klickt auf Einladen. Die Rückmeldung hängt davon ab, ob zur Adresse schon ein Konto besteht:

• Bestehendes Konto: „Die Einladung wurde versendet."
• Kein Konto: „Zu dieser E-Mail-Adresse besteht noch kein Kundenkonto. Die Einladung wird nachgeholt, sobald ein Konto vorhanden ist."

In beiden Fällen geht dieselbe Einladungs-Mail mit einem persönlichen Annahme-Link raus.

Was gespeichert wird

Hat die eingeladene Adresse bereits ein Konto, legt B2B+ Base eine offene Mitgliedschaft im Status „Eingeladen" an. Sie trägt einen Einmal-Token, die Ziel-E-Mail und ein Ablaufdatum, wird aber erst mit der Annahme zu einer wirksamen Mitgliedschaft im Status „Aktiv". Die beiden Mitgliedschafts-Status sind unter Mitglieder & Rollen beschrieben.

Existiert noch kein Konto, kann es auch keine Mitgliedschaft geben. B2B+ Base speichert stattdessen eine kontounabhängige Einladung, adressiert an die E-Mail-Adresse, ebenfalls mit Einmal-Token und Ablaufdatum. Sie wird erst zur Mitgliedschaft, wenn sich jemand mit genau dieser Adresse registriert.

Die Einladung annehmen

Jede Einladung enthält einen persönlichen Annahme-Link:

https://<Ihre-Storefront-Domain>/b2b/company/invitation/{token}

Ruft die eingeladene Person den Link auf, prüft der Shop Token und Anmeldestatus. Wer nicht eingeloggt ist, landet zuerst auf der Login-Seite; der Token bleibt erhalten und die Einladung wird direkt nach dem Login eingelöst. Bei eingeloggtem Konto löst der Shop die Einladung ein, sofern sie nicht abgelaufen ist und die E-Mail der Einladung mit der des angemeldeten Kontos übereinstimmt. Danach meldet er „Sie sind der Firma %company% beigetreten.", und die Mitgliedschaft ist aktiv.

Registriert sich jemand mit einer eingeladenen Adresse, wandelt B2B+ Base offene Einladungen an diese E-Mail schon bei der Registrierung in aktive Mitgliedschaften um. Der Annahme-Link ist danach nur noch eine Bestätigung: Der Token ist verbraucht, und weil die Person nun Mitglied einer Firma ist, begrüßt der Shop sie mit „Ihre Einladung wurde bereits verarbeitet …" statt mit einer Fehlermeldung. Abgelaufene Einladungen wandelt die Registrierung nicht um, räumt sie aber auf.

Dieselbe Adresse erneut einladen

Wird eine Adresse noch einmal in dieselbe Firma eingeladen, erneuert B2B+ Base die vorhandene offene Einladung: frischer Token, aktualisierte Rolle, neues Ablaufdatum. Ein Duplikat entsteht nicht. Ist die Person bereits aktives Mitglied der Firma, weist der Shop die Einladung ab.

Gültigkeit

Einladungen laufen nach 7 Tagen ab

Eine Einladung ist 7 Tage gültig. Danach lässt sie sich nicht mehr annehmen und muss neu ausgestellt werden. Die Frist ist fest verdrahtet und nicht konfigurierbar.

Die Einladungs-Mail-Vorlage

B2B+ Base verschickt die Einladung über eine editierbare Shopware-Mail-Vorlage, nicht über den Flow Builder. Betreff und Inhalt bearbeiten Sie in der Administration unter Einstellungen → E-Mail-Vorlagen; die Vorlage heißt „Firmen-Einladung (B2B+ Base)" (technischer Name avellon_b2b_company_invitation).

In der Vorlage stehen diese Variablen bereit:

Variable	Inhalt
company	Die Firma, z. B. company.name.
customer	Der eingeladene Kunde. Nur gesetzt, wenn bereits ein Konto existiert — in der Vorlage mit {% if customer %} absichern.
salesChannel	Der Verkaufskanal, z. B. salesChannel.name.
invitationUrl	Der absolute Annahme-Link.
inviteEmail	Die eingeladene E-Mail-Adresse.

Ein Plugin-Update legt nur fehlende Vorlagen neu an; von Ihnen bearbeitete Inhalte bleiben unangetastet.

Scheitert der Mailversand — etwa wegen einer fehlenden Vorlage oder eines Mailserver-Fehlers —, legt der Shop die Einladung trotzdem an und protokolliert nur den Fehler. Der Annahme-Link funktioniert unabhängig vom Versand.