> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# b2b - Business-to-Business (B2B)

> B2B-spezifische Shopkonfiguration im WEBSALE: Kundengruppen, Berechtigungen sowie Preislogik für Geschäftskunden über den Konfigurationsknoten b2b.

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

***

## `b2b*` - Grundstruktur

Nachfolgend der Grundaufbau des Knotens `b2b`:

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "b2b": {
    "access": {...},
	"accountVerification": {...},
    "userInvitation": {...}
  }
}
```

#### Parameterübersicht

| **Parameter**         | **Beschreibung**                                                             |
| --------------------- | ---------------------------------------------------------------------------- |
| `access`              | Steuert die Zutrittsbeschränkungen.                                          |
| `accountVerification` | Steuert die Einladungs-E-Mail und Reminder-Logik bei der Kontoverifizierung. |
| `userInvitation`      | Steuert 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`

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "accessBeforeVerification": {
    "allowedTemplates": [
      "account/accountManagement.htm"
    ],
    "allowedUrls": [],
    "redirectTarget": "error.htm",
    "restricted": false
  },
  "allowedActions": [],
  "allowedTemplates": [],
  "allowedUrls": [],
  "redirectTarget": "error.htm",
  "restricted": false
}
```

#### Parameterübersicht

| **Parameter**              | **Typ**       | **Beschreibung**                                                                                                                                                                             |
| -------------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `accessBeforeVerification` | object        | Steuert die Zugriffsbeschränkungen für Nutzer, die noch nicht verifiziert sind.                                                                                                              |
| `restricted`               | bool          | Schaltet die Zutrittsbeschränkung für nicht verifizierte Konten an (`true`) oder aus (`false`).    <br />Default: **false**                                                                  |
| `redirectTarget`           | string        | Name des Templates, auf das der Nutzer weitergeleitet wird, wenn er auf eine Seite zugreift, die den Login erfordert (z.B. `error.htm`).                                                     |
| `allowedTemplates`         | list (string) | Liste von Templates, die auch ohne Login aufgerufen werden dürfen (z.B. `account/accountManagement.htm`).                                                                                    |
| `allowedUrls`              | list (string) | Liste von URLs, die auch ohne Login aufgerufen werden dürfen.                                                                                                                                |
| `restricted`               | bool          | Aktiviert die manuelle Kontoverifizierung.<br />Der Kunde / die Firma kann sich selbst registrieren, ist aber bis zur Freischaltung durch den Händler eingeschränkt.<br />Default: **false** |
| `redirectTarget`           | string        | Name des Templates, auf das bei verweigertem Zugriff umgeleitet wird. (z.B. error.htm)                                                                                                       |
| `allowedTemplates`         | list (string) | Liste von Templates, die vor der Verifizierung aufgerufen werden dürfen.                                                                                                                     |
| `allowedUrls`              | list (string) | Liste erlaubter Pfade, die vor der Verifizierung aufgerufen werden dürfen. (z.B. `/login`, `/register` )                                                                                     |
| `allowedActions`           | list (string) | Liste erlaubter Aktionen, die trotz aktiver Beschränkung genutzt werden dürfen (z.B. **login, logout**). <br />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 `invitationLinkValidityInHours`definierte 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`

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "email": {
    "fromAddress": "",
    "fromName": "",
    "subject": "",
    "template": ""
  },
  "invitationLinkValidityInDays": 1,
  "reminderActive": false,
  "reminderEmail": {
    "fromAddress": "",
    "fromName": "",
    "subject": "",
    "template": ""
  },
  "reminderIntervalInDays": 7
}
```

**Parameterübersicht**

| **Parameter**                  | **Typ** | **Beschreibung**                                                                                                                                                      |
| ------------------------------ | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `email`                        | object  | Konfiguration der initialen Einladungs-E-Mail.                                                                                                                        |
| `fromAddress`                  | string  | Absenderadresse, die im E-Mail-Versand versendet wird (z.B. `noreply@mein-shop.de`).                                                                                  |
| `fromName`                     | string  | Anzeigename des Absenders in der E-Mail (z.B. “Mein Onlineshop”).                                                                                                     |
| `subject`                      | string  | Betreffzeile der E-Mail, wie sie im Posteingang des Kunden angezeigt wird.                                                                                            |
| `template`                     | string  | Name oder Pfad der zu verwendenden [E-Mail-Vorlage](/konfiguration/messages-ereignisgesteuerte-e-mails). <br />Darüber werden Inhalt und Layout der E-Mail gesteuert. |
| `invitationLinkValidityInDays` | int     | Gültigkeitsdauer des Einladungslinks in Tagen.                                                                                                                        |
| `reminderActive`               | bool    | Aktiviert (`true`) oder deaktiviert (`false`) den automatischen Versand <br />von Erinnerungs-E-Mails an noch nicht angenommene Einladungen.                          |
| `reminderEmail`                | object  | Konfiguration der Erinnerungs-E-Mail. <br />Wird nur genutzt, wenn `reminderActive: true`                                                                             |
| `fromAddress`                  | string  | E-Mail-Adresse, von der die Erinnerung gesendet wird.                                                                                                                 |
| `fromName`                     | string  | Absenderadresse, die im E-Mail-Versand versendet wird (z.B. `noreply@mein-shop.de`).                                                                                  |
| `subject`                      | string  | Betreff der Erinnerungs-E-Mail.                                                                                                                                       |
| `template`                     | string  | Inhalt der Erinnerungs-E-Mail.                                                                                                                                        |
| `reminderIntervalInDays`       | int     | Intervall 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`

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "requireEmailVerification": true,
  "requireManualVerification": false,
  "verificationMerchantEmail": {
    "fromAddress": "",
    "fromName": "",
    "subject": "",
    "template": "",
    "subjectForRevocation": "",
    "templateForRevocation": ""
  },
  "permissionsBeforeVerification": {
    "viewProducts": true,
    "viewCategories": true,
    "viewPrices": false,
    "placeOrders": false
  }
}
```

**Parameterübersicht**

| Parameter                       | Typ    | Beschreibung                                                                                                                                                                                          |
| :------------------------------ | :----- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `requireEmailVerification`      | bool   | Legt fest, ob eine E-Mail-Verifizierung für neue B2B-Konten erforderlich ist.                                                                                                                         |
| `requireManualVerification`     | bool   | Legt fest, ob neue B2B-Konten zusätzlich manuell durch den Händler freigegeben werden müssen.                                                                                                         |
| `verificationMerchantEmail`     | object | Konfiguration der E-Mails bei Kontofreischaltung und -widerruf.                                                                                                                                       |
| `fromAddress`                   | string | Absenderadresse, die im E-Mail-Versand versendet wird (z.B. `noreply@mein-shop.de`).                                                                                                                  |
| `fromName`                      | string | Anzeigename des Absenders in der E-Mail (z.B. “Mein Onlineshop”).                                                                                                                                     |
| `subject`                       | string | Betreffzeile der E-Mail, wie sie im Posteingang des Kunden angezeigt wird.                                                                                                                            |
| `template`                      | string | Name oder Pfad der zu verwendenden [E-Mail-Vorlage](https://dokumentation.websale.de/konfiguration/messages-ereignisgesteuerte-e-mails). <br />Darüber werden Inhalt und Layout der E-Mail gesteuert. |
| `subjectForRevocation`          | string | Betreffzeile der E-Mail bei Widerruf der Kontofreischaltung.                                                                                                                                          |
| `templateForRevocation`         | string | Name oder Pfad der zu verwendenden [E-Mail-Vorlage](https://dokumentation.websale.de/konfiguration/messages-ereignisgesteuerte-e-mails) für die Widerrufs-E-Mail.                                     |
| `permissionsBeforeVerification` | object | Definiert, welche Aktionen ein noch nicht verifiziertes Konto im Shop ausführen darf.                                                                                                                 |
| `viewProducts`                  | bool   | Legt fest, ob Produkte für nicht verifizierte Konten sichtbar sind.                                                                                                                                   |
| `viewCategories`                | bool   | Legt fest, ob Kategorien für nicht verifizierte Konten sichtbar sind.                                                                                                                                 |
| `viewPrices`                    | bool   | Legt fest, ob Preise für nicht verifizierte Konten sichtbar sind.                                                                                                                                     |
| `placeOrders`                   | bool   | Legt fest, ob nicht verifizierte Konten Bestellungen aufgeben können.<br />Bei `false` werden auch Warenkorb-Aktionen blockiert.                                                                      |


## Related topics

- [Konfigurations-Deeplinks](/admin-interface/konfigurations-deeplinks.md)
- [API-Referenz Konfiguration](/schnittstellen/admin-interface-api/api-referenz-konfiguration.md)
- [Übersicht - Konfiguration](/konfiguration.md)
- [API-Referenz Kundendaten](/schnittstellen/admin-interface-api/api-referenz-kundendaten.md)
- [Account](/frontend/referenz/aktionen/account.md)
