> ## 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.

# MA- (Mehrfachkonten)

> Die Übersicht der Kundenkonten zu einer E-Mail-Adresse aufbauen, das aktive Konto hervorheben und je Konto Passwort neu setzen oder Konto löschen anbieten.

Ein Käufer kann mehrere Kundenkonten mit derselben E-Mail-Adresse haben. Das entsteht nicht nur, wenn der Shop das ausdrücklich anbietet, sondern auch durch importierte Kundendaten. Eine Übersicht dieser Konten ist deshalb in fast jedem Shop sinnvoll.

Die `MA-`Tags bedienen zwei Stellen. Im Kundenkonto steht der Einstieg, also die Prüfung, ob es überhaupt mehrere Konten gibt, und der Link dorthin. Auf der Übersichtsseite selbst steht die Schleife über die Konten mit ihren Daten und den Funktionen je Konto.

Wegweiser: [Mehrfachkontenübersicht anbieten](https://dokumentation.websale.de/v8s/kundenkonto/mehrfachkontenuebersicht-anbieten.md) · Referenz: [Abschnitt Templates](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/grundlagen-und-technik.md#templates)

> [!WARNING]
>
> Alle Tags dieser Seite setzen einen angemeldeten Käufer voraus. Ohne Anmeldung gilt jedes von ihnen als ungültiges Tag, unabhängig vom Template.

## Der Einstieg im Kundenkonto

| Tag | Liefert |
| - | - |
| `MA-Overview` | greift, wenn zu dieser E-Mail-Adresse mehr als ein Konto besteht |
| `MA-OverviewLink` | den Link auf die Übersichtsseite |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{MA-Overview}
   <a href="~MA-OverviewLink~">Ihre weiteren Kundenkonten</a>
{/MA-Overview}
```

`MA-Overview` greift erst ab zwei Konten. Bei genau einem Konto bleibt der Bereich leer, und der Einstieg erscheint nicht. Das ist auch richtig so, denn eine Übersicht mit einem einzigen Eintrag hilft niemandem.

> [!WARNING]
>
> Ist die Mehrfachkontenverwaltung für den Shop gesperrt, blendet das Shopsystem **beide** Varianten der Klammerung aus, also auch `{!MA-Overview}`. Verlassen Sie sich deshalb nicht darauf, dass der negative Bereich den Fall "genau ein Konto" abdeckt. Er deckt ihn nur ab, solange die Funktion verfügbar ist.

`MA-Overview` gilt nicht nur im Kundenkonto. Im E-Mail-Template zum Löschen eines Kontos unterscheiden Sie damit, ob der Käufer sein einziges Konto löscht oder eines von mehreren.

## Die Übersicht aufbauen

Das Template für die Übersicht tragen Sie in der Shopkonfiguration `shop.config` im Abschnitt `<Templates>` beim Parameter `MultipleAccountsOverview` ein. Nur dort arbeitet `MA-Data`.

| Tag | Liefert |
| - | - |
| `MA-Data` | die Anzahl der Konten, die Prüfung auf Vorhandensein und die Schleife |
| `MA-Position` | die laufende Nummer innerhalb der Schleife |
| `MA-ActiveAccount` | greift bei dem Konto, mit dem der Käufer gerade angemeldet ist |
| `MA-FirstName` | den Vornamen aus der Rechnungsadresse des Kontos |
| `MA-LastName` | den Nachnamen |
| `MA-Company` | die Firma |
| `MA-CustomerID` | die Kundennummer |
| `MA-SubAccountID` | die Unterkonto-Kennung |
| `MA-LastLogin` | den Zeitpunkt der letzten Anmeldung |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<p>Zu Ihrer E-Mail-Adresse ~A-E-Mail~ bestehen ~MA-Data~ Kundenkonten.</p>

<ul>
   {@MA-Data}
      <li class="{MA-ActiveAccount}aktiv{/MA-ActiveAccount}">
         <span class="nr">~MA-Position~.</span>

         {MA-ActiveAccount}<strong>Dieses Konto verwenden Sie gerade</strong>{/MA-ActiveAccount}

         Kundennummer ~MA-CustomerID~<br>
         {MA-Company}~MA-Company~<br>{/MA-Company}
         ~MA-FirstName~ ~MA-LastName~<br>
         {MA-LastLogin}Letzte Anmeldung: ~MA-LastLogin~{/MA-LastLogin}
      </li>
   {/@MA-Data}
</ul>
```

`MA-Data` als Klammerung greift bereits ab einem Konto, `MA-Overview` dagegen erst ab zweien. Die beiden sind also nicht austauschbar. Auf der Übersichtsseite ist `MA-Data` das richtige Tag, weil dort auch ein einzelnes Konto angezeigt werden soll.

Die Werttags arbeiten auch als Klammerung und greifen, wenn ein Wert vorliegt. Das lohnt sich bei Firma und letzter Anmeldung, denn beide Felder sind oft leer. Ohne Klammerung stehen dort leere Zeilen.

Es liefert die Kennung des Unterkontos und ist in Shops mit Unterkonten das Feld, an dem der Käufer seine Konten tatsächlich auseinanderhält. Kundennummer und Name sind dort häufig identisch.

## Passwort neu setzen und Konto löschen

Beide Funktionen laufen über eine Bestätigungs-E-Mail. Der Link im Template löst nur den Versand aus, geändert wird erst nach dem Klick in der E-Mail.

| Tag | Liefert |
| - | - |
| `MA-RequestSetPasswordEmailLink` | den Link, der die E-Mail zum Neusetzen des Passworts anfordert |
| `MA-RequestDeleteAccountDoubleOptInEmailLink` | den Link, der die E-Mail zum Löschen des Kontos anfordert |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{MSG-SetPasswordEmailSent}
   <p class="hinweis">Wir haben Ihnen eine E-Mail mit einem Authentifizierungslink geschickt.</p>
{/MSG-SetPasswordEmailSent}

{MSG-DoubleOptInDeleteAccountEmailSent}
   <p class="hinweis">Bitte bestätigen Sie das Löschen über den Link in der E-Mail.</p>
{/MSG-DoubleOptInDeleteAccountEmailSent}

{MSG-DoubleOptInDeleteAccountSuccess}
   <p class="hinweis">Das Konto wurde gelöscht.</p>
{/MSG-DoubleOptInDeleteAccountSuccess}

{@MA-Data}
   ...
   <a href="~MA-RequestSetPasswordEmailLink~">Passwort für dieses Konto neu setzen</a>
   <a href="~MA-RequestDeleteAccountDoubleOptInEmailLink~">Dieses Konto löschen</a>
{/@MA-Data}
```

> [!WARNING]
>
> Setzen Sie die drei Meldungen außerhalb der Schleife. Innerhalb würden sie bei jedem Konto erscheinen, obwohl sie sich auf einen einzelnen Vorgang beziehen.

Beide Funktionen müssen im Shop bereits eingerichtet sein, bevor sie in der Übersicht nutzbar sind. Die Links hier fordern nur die jeweilige E-Mail an.

## Berechtigung für einen Subshop prüfen

In einem Shop mit mehreren Subshops darf nicht jedes Konto überall hinein. `MA-SubShopPermission()` prüft das für das Konto des aktuellen Schleifendurchlaufs.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@MA-Data}
   {MA-SubShopPermission(shop-de)}
      <p>Mit diesem Konto können Sie sich im deutschen Shop anmelden.</p>
   {/MA-SubShopPermission(shop-de)}
{/@MA-Data}
```

> [!WARNING]
>
> Das Tag braucht genau einen Subshop im Argument. Mehrere Angaben, ein leeres Argument oder ein Stern als Platzhalter gelten als ungültiges Tag. Wollen Sie mehrere Subshops abfragen, schreiben Sie mehrere Klammerungen untereinander.

## Die Tags im Überblick

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `MA-Overview` | – | ja | ja | – |
| `MA-OverviewLink` | ja | – | – | – |
| `MA-Data` | ja | ja | ja | ja |
| `MA-Position` | ja | – | – | – |
| `MA-ActiveAccount` | – | ja | ja | – |
| `MA-FirstName` | ja | ja | ja | – |
| `MA-LastName` | ja | ja | ja | – |
| `MA-Company` | ja | ja | ja | – |
| `MA-CustomerID` | ja | ja | ja | – |
| `MA-SubAccountID` | ja | ja | ja | – |
| `MA-LastLogin` | ja | ja | ja | – |
| `MA-RequestSetPasswordEmailLink` | ja | – | – | – |
| `MA-RequestDeleteAccountDoubleOptInEmailLink` | ja | – | – | – |
| `MA-SubShopPermission(<Subshop>)` | – | ja | ja | – |

`MA-Overview` und `MA-OverviewLink` gehören ins Kundenkonto, `MA-Overview` zusätzlich in das E-Mail-Template zum Löschen eines Kontos. Alle übrigen Tags gelten auf dem Übersichtstemplate, die Tags ab `MA-Position` nur innerhalb der `@MA-Data`-Schleife. Die Werte werden HTML-kodiert ausgegeben.

## Verwandte Themen

* Wegweiser: [Mehrfachkontenübersicht anbieten](https://dokumentation.websale.de/v8s/kundenkonto/mehrfachkontenuebersicht-anbieten.md)
* Wegweiser: [Anmeldung und Registrierung](https://dokumentation.websale.de/v8s/kundenkonto/anmeldung-registrierung.md)
* Referenz: [DA- (Kundenkonto löschen)](https://dokumentation.websale.de/v8s/referenz/tags/da-kundenkonto-loeschen.md)
* Referenz: [SP- (Passwort setzen)](https://dokumentation.websale.de/v8s/referenz/tags/sp-passwort-neu-setzen.md)


## Related topics

- [Mehrfachkontenübersicht anbieten](https://dokumentation.websale.de/v8s/kundenkonto/mehrfachkontenuebersicht-anbieten.md)
- [SP- (Passwort neu setzen)](https://dokumentation.websale.de/v8s/referenz/tags/sp-passwort-neu-setzen.md)
- [Adressierung der Datensätze](https://dokumentation.websale.de/v8s/schnittstellen/kundendaten/ws-sftp-kunden-pro/adressierung-der-datensaetze.md)
- [Anmeldung und Registrierung](https://dokumentation.websale.de/v8s/kundenkonto/anmeldung-registrierung.md)
- [Schaltflächen für Kundenkonto und Anmeldung](https://dokumentation.websale.de/v8s/referenz/tags/bt/kundenkonto-und-anmeldung.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.