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

# SP- (Passwort neu setzen)

> Die E-Mail zum Neusetzen des Passworts aufbauen: über alle Konten zu einer Adresse laufen, sie für den Empfänger unterscheidbar machen und je Konto einen eigenen Link anbieten.

Hat ein Käufer sein Passwort vergessen, schickt ihm der Shop eine E-Mail mit einem Link, über den er ein neues setzt. Dabei gibt es eine Besonderheit: zu einer E-Mail-Adresse können mehrere Kundenkonten gehören. Der Empfänger muss dann erkennen können, um welches Konto es geht, und für jedes einen eigenen Link bekommen.

Genau dafür sind die `SP-`Tags da. Sie laufen über alle Konten zu dieser Adresse, beschreiben jedes einzelne und erzeugen je Konto den passenden Link.

Wegweiser: [Passwort vergessen](https://dokumentation.websale.de/v8s/kundenkonto/anmeldung-registrierung.md#passwort-vergessen)

Alle Tags dieser Seite gelten ausschließlich im HTML-Mailtemplate der Funktion "Passwort vergessen". Welches Template verwendet wird, steht im Abschnitt `SetPasswordMail` der Shopkonfiguration.

## Wie viele Konten gehören zu der Adresse

Drei Tags beantworten diese Frage, bevor es in die Einzelheiten geht.

| Tag | Liefert |
| - | - |
| `SP-Data` | als Einzel-Tag die Zahl der Konten, als Schleife den Durchlauf über sie |
| `SP-SingleData` | Klammerung: es ist genau ein Konto |
| `SP-SingleDataFromMultipleAccount` | Klammerung: es geht um ein einzelnes Mehrfachkonto |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{SP-SingleData}
   <p>Sie haben ein neues Passwort angefordert.</p>
{/SP-SingleData}

{!SP-SingleData}
   <p>Zu Ihrer E-Mail-Adresse gehören ~SP-Data~ Kundenkonten. Bitte wählen Sie das gewünschte aus.</p>
{/!SP-SingleData}
```

`SP-SingleData` greift, wenn genau ein Konto in der Liste steht. Das ist auch dann der Fall, wenn der Käufer aus der Übersicht seiner Mehrfachkonten heraus das Passwort für ein einzelnes davon neu setzen möchte. Welcher der beiden Fälle vorliegt, unterscheidet `SP-SingleDataFromMultipleAccount`.

Das Shopsystem fordert das nicht, das Tag arbeitet überall im Mailtemplate. Die Verschachtelung ist trotzdem sinnvoll, denn außerhalb des Einzelkontenfalls beantwortet es keine sinnvolle Frage.

## Die Schleife über die Konten

Alle Angaben zu einem einzelnen Konto stehen innerhalb der `SP-Data`-Schleife.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@SP-Data}
   <p>
      {SP-Company}~SP-Company~<br>{/SP-Company}
      ~SP-FirstName~ ~SP-LastName~<br>
      {SP-CustomerID}Kundennummer ~SP-CustomerID~<br>{/SP-CustomerID}
      {SP-LastLogin}Letzte Anmeldung: ~SP-LastLogin~{/SP-LastLogin}
   </p>
   <p><a href="~SP-SetPasswordLink~">Für dieses Konto ein neues Passwort setzen</a></p>
{/@SP-Data}
```

> [!WARNING]
>
> Die Schleife ist auch beim Einzelkontenfall nötig. `SP-SetPasswordLink` und alle Angaben zum Konto sind außerhalb der `SP-Data`-Schleife ungültige Tags, auch innerhalb von `SP-SingleData`. Schreiben Sie die Kontenangaben deshalb einmal in die Schleife und steuern Sie den Text drumherum über `SP-SingleData`.

`SP-Data` gibt es nur als Einzel-Tag und als Schleife, nicht als Klammerung. Für die Fallunterscheidung nehmen Sie `SP-SingleData`.

## Die Angaben zum Konto

| Tag | Liefert |
| - | - |
| `SP-CustomerID` | die Kundennummer |
| `SP-Company` | die Firma aus der Rechnungsadresse |
| `SP-FirstName` | den Vornamen aus der Rechnungsadresse |
| `SP-LastName` | den Nachnamen aus der Rechnungsadresse |
| `SP-LastLogin` | den Zeitpunkt der letzten Anmeldung |
| `SP-SubAccountID` | die Kennung des Unterkontos |
| `SP-SetPasswordLink` | den Link zum Neusetzen des Passworts für dieses Konto |

Alle Angaben außer dem Link greifen auch als Klammerung und zwar dann, wenn der Wert gefüllt ist. Das ist nützlich, weil Firma, Kundennummer und letzte Anmeldung nicht bei jedem Konto vorliegen.

Bei Mehrfachkonten ist diese Kennung oft das einzige Merkmal, an dem der Empfänger die Konten auseinanderhält, wenn Name und Firma gleich sind.

> [!WARNING]
>
> Die Mail geht an eine Adresse, hinter der mehrere Personen stehen können. Geben Sie deshalb nur so viele Angaben aus, wie zum Unterscheiden nötig sind. Kundennummer und Unterkontokennung reichen meist, die letzte Anmeldung ist bereits eine Information über das Verhalten des Kontoinhabers.

`SP-SetPasswordLink` ist ausschließlich ein Einzel-Tag. Jeder Durchlauf der Schleife erzeugt einen eigenen Link, der genau zu diesem Konto gehört.

Referenz: [MA- (Mehrfachkonten)](https://dokumentation.websale.de/v8s/referenz/tags/ma-mehrfachkonten.md)

## Nach Subshop unterscheiden

In einem Shopverbund darf sich ein Mehrfachkonto nicht zwingend in jedem Subshop anmelden. `SP-SubShopPermission()` prüft das je Konto.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@SP-Data}
   {SP-SubShopPermission(fachhandel)}
      <p><a href="~SP-SetPasswordLink~">Konto ~SP-CustomerID~ im Fachhandelsbereich</a></p>
   {/SP-SubShopPermission(fachhandel)}
{/@SP-Data}
```

> [!WARNING]
>
> Das Tag braucht genau einen Parameter, nämlich einen einzelnen Subshop. Ein Stern als Platzhalter wird abgelehnt, ebenso ein leerer Parameter oder mehrere Angaben. In allen drei Fällen ist das Tag ungültig.

`SP-SubShopPermission()` gibt es nur als Klammerung und nur innerhalb der `SP-Data`-Schleife.

## Die Tags im Überblick

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `SP-Data` | ja | – | – | ja |
| `SP-SingleData` | – | ja | ja | – |
| `SP-SingleDataFromMultipleAccount` | – | ja | ja | – |
| `SP-SetPasswordLink` | ja | – | – | – |
| `SP-SubAccountID` | ja | ja | ja | – |
| `SP-CustomerID` | ja | ja | ja | – |
| `SP-Company` | ja | ja | ja | – |
| `SP-FirstName` | ja | ja | ja | – |
| `SP-LastName` | ja | ja | ja | – |
| `SP-LastLogin` | ja | ja | ja | – |
| `SP-SubShopPermission()` | – | ja | ja | – |

Alle Tags gelten ausschließlich im Mailtemplate der Funktion "Passwort vergessen". `SP-Data`, `SP-SingleData` und `SP-SingleDataFromMultipleAccount` stehen dort frei, alle übrigen innerhalb der `SP-Data`-Schleife. Liegt kein Vorgang zum Neusetzen des Passworts vor, geben alle Tags nichts aus.

## Verwandte Themen

* Wegweiser: [Passwort vergessen](https://dokumentation.websale.de/v8s/kundenkonto/anmeldung-registrierung.md#passwort-vergessen)
* Wegweiser: [Anmeldung und Registrierung](https://dokumentation.websale.de/v8s/kundenkonto/anmeldung-registrierung.md)
* Referenz: [MA- (Mehrfachkonten)](https://dokumentation.websale.de/v8s/referenz/tags/ma-mehrfachkonten.md)
* Referenz: Abschnitt [`SetPasswordMail`](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/e-mails#setpasswordmail) in der Shopkonfiguration


## Related topics

- [Mehrfachkontenübersicht anbieten](https://dokumentation.websale.de/v8s/kundenkonto/mehrfachkontenuebersicht-anbieten.md)
- [Anmeldung und Registrierung](https://dokumentation.websale.de/v8s/kundenkonto/anmeldung-registrierung.md)
- [MA- (Mehrfachkonten)](https://dokumentation.websale.de/v8s/referenz/tags/ma-mehrfachkonten.md)
- [Texte und Meldungen](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md)
- [Storefront API Kundenkonto](https://dokumentation.websale.de/schnittstellen/storefront-api/storefront-api-kundenkonto.md)


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