Zum Hauptinhalt springen
B2B-spezifische Einstellungen (z. B. Gruppen, Berechtigungen, Preislogik).

b2b* - Grundstruktur

Nachfolgend der Grundaufbau des Knotens b2b:
{
  "b2b": {
    "access": {...},
	"accountVerification": {...},
    "userInvitation": {...}
  }
}

Parameterübersicht

ParameterBeschreibung
accessSteuert die Zutrittsbeschränkungen.
accountVerificationSteuert die Einladungs-E-Mail und Reminder-Logik bei der Kontoverifizierung.
userInvitationSteuert die Einladungs-E-Mail und zugehörige Reminder-Logiken.

b2b.access - Zutrittsbeschränkungen

Konfiguriert die Zutrittsbeschränkungen für B2B-Kunden, z.B. nach der Registrierung vor einer manuellen Freischaltung durch den Händler.

Beispielkonfiguration b2b.access

{
  "accessBeforeVerification": {
    "allowedTemplates": [
      "account/accountManagement.htm"
    ],
    "allowedUrls": [],
    "redirectTarget": "error.htm",
    "restricted": false
  },
  "allowedActions": [],
  "allowedTemplates": [],
  "allowedUrls": [],
  "redirectTarget": "error.htm",
  "restricted": false
}

Parameterübersicht

ParameterTypBeschreibung
accessBeforeVerificationobjectSteuert die Zugriffsbeschränkungen für Nutzer, die noch nicht verifiziert sind.
restrictedboolSchaltet die Zutrittsbeschränkung für nicht verifizierte Konten an (true) oder aus (false).
Default: false
redirectTargetstringName des Templates, auf das der Nutzer weitergeleitet wird, wenn er auf eine Seite zugreift, die den Login erfordert (z.B. error.htm).
allowedTemplateslist (string)Liste von Templates, die auch ohne Login aufgerufen werden dürfen (z.B. account/accountManagement.htm).
allowedUrlslist (string)Liste von URLs, die auch ohne Login aufgerufen werden dürfen.
restrictedboolAktiviert die manuelle Kontoverifizierung.
Der Kunde / die Firma kann sich selbst registrieren, ist aber bis zur Freischaltung durch den Händler eingeschränkt.
Default: false
redirectTargetstringName des Templates, auf das bei verweigertem Zugriff umgeleitet wird. (z.B. error.htm)
allowedTemplateslist (string)Liste von Templates, die vor der Verifizierung aufgerufen werden dürfen.
allowedUrlslist (string)Liste erlaubter Pfade, die vor der Verifizierung aufgerufen werden dürfen. (z.B. /login, /register )
allowedActionslist (string)Liste erlaubter Aktionen, die trotz aktiver Beschränkung genutzt werden dürfen (z.B. login, logout).
Bleibt die Liste leer, sind keine Aktionen explizit freigeschaltet.

b2b.userInvitation - Benutzereinladung

Konfiguriert die E-Mail, mit der ein neuer Benutzer zu einem B2B-Firmenkonto eingeladen wird. Die Mail enthält einen Aktivierungslink, über den der eingeladene Nutzer das Konto aktiviert. Optional kann eine Erinnerungs-E-Mail versendet werden, solange die Einladung noch nicht angenommen wurde. Der Einladungslink ist für die in invitationLinkValidityInHoursdefinierte Dauer gültig. Nach Ablauf muss die Einladung erneut versendet werden. Ist reminderActive: true, wird im Intervall von reminderIntervallInDays eine Erinnerungs-E-Mail an noch offene Einladungen versendet. Beispielkonfiguration b2b.userInvitation
{
  "email": {
    "fromAddress": "",
    "fromName": "",
    "subject": "",
    "template": ""
  },
  "invitationLinkValidityInDays": 1,
  "reminderActive": false,
  "reminderEmail": {
    "fromAddress": "",
    "fromName": "",
    "subject": "",
    "template": ""
  },
  "reminderIntervalInDays": 7
}
Parameterübersicht
ParameterTypBeschreibung
emailobjectKonfiguration der initialen Einladungs-E-Mail.
fromAddressstringAbsenderadresse, die im E-Mail-Versand versendet wird (z.B. noreply@mein-shop.de).
fromNamestringAnzeigename des Absenders in der E-Mail (z.B. “Mein Onlineshop”).
subjectstringBetreffzeile der E-Mail, wie sie im Posteingang des Kunden angezeigt wird.
templatestringName oder Pfad der zu verwendenden E-Mail-Vorlage.
Darüber werden Inhalt und Layout der E-Mail gesteuert.
invitationLinkValidityInDaysintGültigkeitsdauer des Einladungslinks in Tagen.
reminderActiveboolAktiviert (true) oder deaktiviert (false) den automatischen Versand
von Erinnerungs-E-Mails an noch nicht angenommene Einladungen.
reminderEmailobjectKonfiguration der Erinnerungs-E-Mail.
Wird nur genutzt, wenn reminderActive: true
fromAddressstringE-Mail-Adresse, von der die Erinnerung gesendet wird.
fromNamestringAbsenderadresse, die im E-Mail-Versand versendet wird (z.B. noreply@mein-shop.de).
subjectstringBetreff der Erinnerungs-E-Mail.
templatestringInhalt der Erinnerungs-E-Mail.
reminderIntervalInDaysintIntervall in Tagen, in dem Erinnerungen versendet werden, solange die Einladung offen und noch gültig ist.

b2b.accountVerification - Kontoverifizierung

Konfiguriert den Verifizierungsprozess für B2B-Konten. Mit requireEmailVerification und requireManualVerification wird gesteuert, welche Art der Verifizierung erforderlich ist, während verificationMerchantEmail die E-Mails definiert, die bei Freischaltung bzw. Widerruf eines Kontos versendet werden. Mit permissionsBeforeVerification werden die Berechtigungen festgelegt, die ein noch nicht verifiziertes Konto im Shop hat. Beispielkonfiguration b2b.accountVerification
{
  "requireEmailVerification": true,
  "requireManualVerification": false,
  "verificationMerchantEmail": {
    "fromAddress": "",
    "fromName": "",
    "subject": "",
    "template": "",
    "subjectForRevocation": "",
    "templateForRevocation": ""
  },
  "permissionsBeforeVerification": {
    "viewProducts": true,
    "viewCategories": true,
    "viewPrices": false,
    "placeOrders": false
  }
}
Parameterübersicht
ParameterTypBeschreibung
requireEmailVerificationboolLegt fest, ob eine E-Mail-Verifizierung für neue B2B-Konten erforderlich ist.
requireManualVerificationboolLegt fest, ob neue B2B-Konten zusätzlich manuell durch den Händler freigegeben werden müssen.
verificationMerchantEmailobjectKonfiguration der E-Mails bei Kontofreischaltung und -widerruf.
fromAddressstringAbsenderadresse, die im E-Mail-Versand versendet wird (z.B. noreply@mein-shop.de).
fromNamestringAnzeigename des Absenders in der E-Mail (z.B. “Mein Onlineshop”).
subjectstringBetreffzeile der E-Mail, wie sie im Posteingang des Kunden angezeigt wird.
templatestringName oder Pfad der zu verwendenden E-Mail-Vorlage.
Darüber werden Inhalt und Layout der E-Mail gesteuert.
subjectForRevocationstringBetreffzeile der E-Mail bei Widerruf der Kontofreischaltung.
templateForRevocationstringName oder Pfad der zu verwendenden E-Mail-Vorlage für die Widerrufs-E-Mail.
permissionsBeforeVerificationobjectDefiniert, welche Aktionen ein noch nicht verifiziertes Konto im Shop ausführen darf.
viewProductsboolLegt fest, ob Produkte für nicht verifizierte Konten sichtbar sind.
viewCategoriesboolLegt fest, ob Kategorien für nicht verifizierte Konten sichtbar sind.
viewPricesboolLegt fest, ob Preise für nicht verifizierte Konten sichtbar sind.
placeOrdersboolLegt fest, ob nicht verifizierte Konten Bestellungen aufgeben können.
Bei false werden auch Warenkorb-Aktionen blockiert.