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

# MSG- (Meldungen)

> Hinweis-, Fehler- und Erfolgsmeldungen des Shopsystems im Template ausgeben, nach Fehlercode unterscheiden und die Texte in der Shopkonfiguration pflegen.

Das Shopsystem erzeugt laufend Meldungen: ein Mindestbestellwert ist nicht erreicht, eine Adresse war unvollständig, ein Gutschein ist abgelaufen, ein Kundenkonto wurde aktiviert. Die `MSG-`Tags holen diese Meldungen ins Template.

Alle Tags dieser Gruppe arbeiten gleich. Sie geben einen Text aus, der in der Shopkonfiguration hinterlegt ist, und sie greifen als Klammerung genau dann, wenn die Meldung im aktuellen Zustand zutrifft. Unterschiedlich ist nur der Anlass. Deshalb erklärt diese Seite das Muster einmal und listet die Meldungen danach nach Bereichen.

Eine Untergruppe geht darüber hinaus: Bei Gutscheinen, Abos, Prime-Paketen und aktualisierten Online-Preisen liefert das Tag einen Fehler- oder Erfolgscode, mit dem Sie je Fall einen eigenen Text formulieren.

Wegweiser: [Standardtexte](https://dokumentation.websale.de/v8s/einstellungen/standardtexte.md) · Referenz: [Abschnitt NotifyMessages-Txt](https://dokumentation.websale.de/v8s/websale-produktbewertung/produktbewertungs-modul-konfigurieren.md#was-in-der-prodrating-config-steht)

## Das Grundmuster

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{MSG-Basket_Notify}
   <p class="hinweis">~MSG-Basket_Notify~</p>
{/MSG-Basket_Notify}
```

Die Klammerung greift, wenn eine Meldung vorliegt. Das gleichnamige Einzel-Tag darin gibt den Text aus.

> [!WARNING]
>
> Setzen Sie das Einzel-Tag nie ohne Klammerung. Liegt keine Meldung vor, bleibt der Text leer, das umgebende HTML steht aber trotzdem auf der Seite. Der Besucher sieht dann einen leeren farbigen Kasten.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{!MSG-DirectOrder_Notify}
   <p>Alles in Ordnung, Sie können bestellen.</p>
{/!MSG-DirectOrder_Notify}
```

Die negative Klammerung ist der Gegenfall und eignet sich für den Normalzustand. Nicht jede Meldung braucht das, bei Erfolgsmeldungen ist der Gegenfall meist uninteressant.

## Woher die Texte kommen

Die Texte stehen nicht im Template, sondern in der Shopkonfiguration `shop.config`. Welcher Abschnitt zuständig ist, hängt von der Art der Meldung ab.

| Abschnitt | Enthält |
| - | - |
| `<NotifyMessages-Txt>` | die Hinweise auf nicht ausführbare Funktionen, also den größten Teil |
| `<StandardMessages-Txt>` | die Standardtexte, beispielsweise für den leeren Warenkorb |
| `<LoginError-Txt>` | die Fehlermeldungen rund um die Anmeldung |
| `<LoginSuccess-Txt>` | die Erfolgsmeldungen rund um die Anmeldung |

Ein `MSG-`Tag greift nur, wenn sowohl der Zustand zutrifft als auch ein Text hinterlegt ist. Bleibt eine erwartete Meldung aus, prüfen Sie deshalb zuerst, ob der zugehörige Parameter in der Shopkonfiguration gefüllt ist.

Referenz: [Abschnitt NotifyMessages-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md#notifymessages-txt) · [Abschnitt StandardMessages-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md#standardmessages-txt) · [Abschnitt LoginError-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md#loginerror-txt) · [Abschnitt LoginSuccess-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md#loginsuccess-txt)

## Meldungen mit Fehlercode

Sieben Tags liefern zusätzlich einen Code. Sie folgen alle demselben Muster: Das Einzel-Tag gibt den Code aus, die Klammerung ohne Argument greift bei jedem Code außer null, die Klammerung mit Argument nur bei genau diesem Code.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{MSG-Voucher_error}
   <p class="fehler">
      {MSG-Voucher_error(2)}Diese Gutscheinnummer ist ungültig.{/MSG-Voucher_error(2)}
      {MSG-Voucher_error(4)}Dieser Gutschein ist abgelaufen.{/MSG-Voucher_error(4)}
      {MSG-Voucher_error(5)}Dieser Gutschein wurde bereits eingelöst.{/MSG-Voucher_error(5)}
   </p>
{/MSG-Voucher_error}
```

Schreiben Sie die Einzelfälle innerhalb der Klammerung ohne Argument. So steht die Umgebung, also der farbige Kasten, nur einmal im Template, und sie erscheint auch dann, wenn ein Code auftritt, für den Sie keinen eigenen Text vorgesehen haben.

> [!WARNING]
>
> Geben Sie in diesem Fall zusätzlich den Code aus, beispielsweise in einem HTML-Kommentar. Sonst steht der Besucher vor einem leeren Kasten, und der Support hat keinen Anhaltspunkt.

### Gutscheine

`MSG-Voucher_success` kennt zwei Codes.

| Code | Bedeutung |
| - | - |
| 1 | Die Gutscheinnummer wurde übernommen |
| 2 | Der Gutschein wurde entfernt |

`MSG-Voucher_error` kennt 27 Codes.

| Code | Ursache |
| - | - |
| 1 | Die Eingabe wurde nach zu vielen Fehlversuchen gesperrt |
| 2 | Die Gutscheinnummer ist ungültig |
| 3 | Der Gutschein ist noch nicht gültig |
| 4 | Der Gutschein ist abgelaufen |
| 5 | Der Gutschein wurde bereits verwendet |
| 6 | Personalisierter Gutschein, der Käufer ist nicht angemeldet |
| 7 | Der Universalgutschein wurde bereits verwendet |
| 8 | Der Gutschein passt nicht zu den Produkten im Warenkorb |
| 9 | Personalisierter Gutschein, nur für Neukunden |
| 10 | Kundenindividueller Neukundengutschein, der Käufer ist nicht angemeldet |
| 11 | Der Gutschein gilt nur für Neukunden |
| 12 | Der Gutschein gilt nur für Neukunden, der Käufer ist nicht angemeldet |
| 13 | Die maximale Anzahl an Einlösungen ist erreicht |
| 14 | Der Gutschein passt auf kein Produkt im Warenkorb, die Bestellung ist blockiert |
| 15 | Für diese Gutscheinnummer ist eine Anmeldung nötig |
| 16 | Der Gutschein ist für dieses Kundenkonto nicht erlaubt |
| 17 | Ans Kundenkonto gebundener Universalgutschein, Anmeldung nötig |
| 18 | Ans Kundenkonto gebundener Universalgutschein, dieses Konto passt nicht |
| 19 | Für diese Gutscheinnummer ist eine Anmeldung nötig |
| 20 | Der Gutschein lässt sich nicht entfernen |
| 21 | Der Gutschein passt nicht, geprüft über ein Produktdatenfeld |
| 22 | Der Gutschein passt nicht, geprüft über den Lagerbestand |
| 23 | Der Käufer ist von Gutscheinaktionen ausgeschlossen |
| 24 | Der Gutschein ist nur in der App einlösbar |
| 25 | Für den Käufer ist bereits ein Kundenrabatt hinterlegt |
| 26 | Die Gutscheinnummer wurde mehrfach eingegeben |
| 27 | Der Gutschein ist nicht mit anderen Gutscheinen kombinierbar |

Bei Code 3 nennen `MSG-Voucher_error_validfrom` und `MSG-Voucher_error_validuntil` den Gültigkeitszeitraum.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{MSG-Voucher_error(3)}
   Dieser Gutschein ist erst ab dem ~MSG-Voucher_error_validfrom~ gültig.
{/MSG-Voucher_error(3)}
```

### Abo-Modul

`MSG-Subscription_success` kennt sieben Codes.

| Code | Bedeutung |
| - | - |
| 1 | Das Produkt wurde auf die Abo-Liste gesetzt |
| 2 | Das Abo wurde pausiert |
| 3 | Das Abo wurde reaktiviert |
| 4 | Menge oder Zeitraum wurden geändert |
| 5 | Das Abo wurde gelöscht |
| 6 | Neue Abos wurden angestoßen |
| 7 | Die Bankverbindung wurde für Abos übernommen |

`MSG-Subscription_error` kennt elf benannte Codes und zwei Bereiche.

| Code | Ursache |
| - | - |
| 1 | Der Käufer ist nicht angemeldet |
| 2 | Menge oder Zeitraum fehlen oder sind ungültig |
| 3 | Ein pausiertes Abo lässt sich nicht ändern |
| 4 | Das Produkt ist kein Abo-Produkt |
| 5 | Setprodukte werden nicht unterstützt |
| 6 | Es wurde keine Produktvariante gewählt |
| 7 | Die Produktnummer wurde nicht gefunden |
| 8 | Es liegen keine Abos im Zustand "neu" vor |
| 9 | Die gewählte Zahlungsart ist für Abos nicht erlaubt |
| 10 | Bei Lastschrift fehlt die Zuordnung der Bankverbindung |
| 11 | Die zulässige Zahl an Abos je Kundenkonto ist erreicht |
| ab 900 | interne Fehlercodes zur Diagnose |
| ab 2000 | Fehler beim sofortigen Auslösen einer Abo-Bestellung |

> [!WARNING]
>
> Die Codes ab 900 und ab 2000 sind zur Diagnose gedacht und nicht für den Besucher. Geben Sie sie nur intern aus, beispielsweise in einem HTML-Kommentar.

### Prime-Pakete und Prime-Produkte

`MSG-PrimeProduct_error` betrifft Produkte, die Prime-Kunden vorbehalten sind.

| Code | Ursache |
| - | - |
| 1 | Prime-Produkte im Warenkorb, der Käufer ist nicht angemeldet |
| 2 | Prime-Produkte im Warenkorb, dem Käufer fehlt die Berechtigung |

`MSG-PrimeShopping_error` betrifft die Prime-Pakete selbst.

| Code | Ursache |
| - | - |
| 1 | Prime-Pakete im Warenkorb, der Käufer ist nicht angemeldet |
| 2 | Mindestens eines der Pakete wurde bereits gekauft |
| 3 | Ein Paket gilt für das gewählte Rechnungsland nicht |

`MSG-PrimePackagesManage` betrifft die Verwaltung im Kundenkonto.

| Code | Bedeutung |
| - | - |
| 1 | Das Prime-Paket wurde gekündigt |
| 2 | Das Paket war bereits gekündigt oder abgelaufen |
| 3 | Das Paket wurde nicht gefunden |

Die beiden Prime-Fehlermeldungen gehören auf die Warenkorbseite, die Loginseite und die Bestellübersicht. Fehlt eine der drei, bleibt der Käufer an dieser Stelle ohne Erklärung stehen.

### Aktualisierte Online-Preise

| Code | Anlass |
| - | - |
| 1 | Der Käufer hat die Preise selbst aktualisiert |
| 2 | Die Preise wurden automatisch aktualisiert |
| 3 | Die Preise wurden während der Bestellübersicht aktualisiert |

## Adressen

Die Meldungen zur Rechnungs- und zur Lieferadresse sind symmetrisch aufgebaut. Zu jedem `MSG-Addr_`Tag gibt es ein `MSG-DelivAddr_`Tag mit derselben Aufgabe.

| Tag | Meldung |
| - | - |
| `MSG-Addr_Notify` | die zusammenfassende Meldung zur Rechnungsadresse |
| `MSG-Addr_saved` | die Rechnungsadresse wurde gespeichert |
| `MSG-Addr_InputError_SalutFirstName` | Anrede und Vorname passen möglicherweise nicht zusammen |
| `MSG-Addr_InputError_NumericZip` | die Postleitzahl enthält nicht-numerische Zeichen |
| `MSG-Addr_InputError_ZipCity` | Postleitzahl und Ort passen nicht zusammen |
| `MSG-Addr_InputError_DifferentDelivCountry` | ein abweichendes Lieferland ist nicht möglich |
| `MSG-Addr_InputError_DifferentDelivCountryVAT1` | dasselbe, begründet durch die angegebene USt-IdNr. |
| `MSG-Addr_InputError_DifferentDelivCountryVAT2` | dasselbe, zweite Variante |

| Tag | Meldung |
| - | - |
| `MSG-DelivAddr_Notify` | die zusammenfassende Meldung zur Lieferadresse |
| `MSG-DelivAddr_saved` | die Lieferadresse wurde gespeichert |
| `MSG-DelivAddr_deleted` | die Lieferadresse wurde gelöscht |
| `MSG-DelivAddr_InputError_SalutFirstName` | Anrede und Vorname passen möglicherweise nicht zusammen |
| `MSG-DelivAddr_InputError_NumericZip` | die Postleitzahl enthält nicht-numerische Zeichen |
| `MSG-DelivAddr_InputError_ZipCity` | Postleitzahl und Ort passen nicht zusammen |
| `MSG-DelivAddr_InputError_DifferentDelivCountry` | ein abweichendes Lieferland ist nicht möglich |
| `MSG-DelivAddr_InputError_DifferentDelivCountryVAT1` | dasselbe, begründet durch die angegebene USt-IdNr. |
| `MSG-DelivAddr_InputError_DifferentDelivCountryVAT2` | dasselbe, zweite Variante |

Die `_Notify`Tags fassen zusammen, die `_InputError_`Tags benennen den einzelnen Grund. Üblich ist, beides zu zeigen: oben den Hinweis, dass etwas unklar ist, und am betroffenen Feld die Einzelmeldung.

## Anmeldung und Kundenkonto

| Tag | Meldung |
| - | - |
| `MSG-Login_Notify` | die Meldungen rund um die Anmeldung |
| `MSG-UserAccount_Notify` | die Meldungen auf der Kundenkonto-Übersicht |
| `MSG-AutoLogin_success` | die automatische Anmeldung hat funktioniert |
| `MSG-AutoLogin_error` | die automatische Anmeldung ist fehlgeschlagen |
| `MSG-SubAccountCreate` | zu dieser E-Mail-Adresse besteht bereits ein Konto |
| `MSG-SetPasswordEmailSent` | die E-Mail zum Neusetzen des Passworts wurde versendet |
| `MSG-DoubleOptInNewCustomerSent` | der Aktivierungslink für ein neues Konto wurde versendet |
| `MSG-DoubleOptInNewCustomerSuccess` | das Kundenkonto wurde aktiviert |
| `MSG-DoubleOptInChangeEmailSent` | der Link zum Ändern der E-Mail-Adresse wurde versendet |
| `MSG-DoubleOptInChangeEmailSuccess` | die E-Mail-Adresse wurde übernommen |
| `MSG-DoubleOptInVoluntaryEmailVerificationSent` | die freiwillige Bestätigungsmail wurde versendet |
| `MSG-DoubleOptInVoluntaryEmailVerificationSuccess` | die E-Mail-Adresse wurde freiwillig bestätigt |
| `MSG-DoubleOptInDeleteAccountEmailSent` | der Link zum Löschen des Kontos wurde versendet |
| `MSG-DoubleOptInDeleteAccountSuccess` | das Kundenkonto wurde gelöscht |

`MSG-UserAccount_Notify` greift auf den Abschnitt `<LoginSuccess-Txt>` zu und zeigt dort die Parameter `ChangeEmail`, `ChangePW` und `PasswordSetLogin`. Die Meldung erscheint also nach einer erfolgreichen Änderung im Kundenkonto.

## Bestellprozess

| Tag | Meldung | Gehört auf |
| - | - | - |
| `MSG-Basket_Standard` | die Standardtexte des Warenkorbs | Warenkorbseite |
| `MSG-Basket_Notify` | die Hinweise im Warenkorb, beispielsweise zum Mindestbestellwert | Warenkorb und Bestellübersicht |
| `MSG-PayDeliv_Notify` | die Meldungen zu Zahlungs- und Versandart | Zahlungs- und Versandartenseite, Bestellübersicht |
| `MSG-PlaceOrder_Notify` | die Hinweise beim Abschluss der Bestellung | Bestellübersicht |
| `MSG-BankNotProofed` | die Bankdaten wurden nicht geprüft | Bestellübersicht |
| `MSG-DirectOrder_Notify` | die Meldungen der Direktbestellung | Direktbestellungsformular |
| `MSG-FastOrder_Notify` | die Meldungen zur Schnellbestellung | Registrierung zur Schnellbestellung |
| `MSG-IDS_Notify` | nicht gefundene Produktnummern der Datenschnittstelle | alle, üblicherweise der Warenkorb |
| `MSG-SessionUnlockedOnlineClearing` | eine neue Sitzung wurde gestartet, weil die alte durch einen Bezahlvorgang gesperrt ist | Warenkorb |
| `MSG-BasketUpdatedOnlinePriceProducts` | Online-Preise im Warenkorb wurden aktualisiert | alle |
| `MSG-Bank_Notify` | die Meldungen zur Bankverbindung | Bankdatenverwaltung |
| `MSG-Bank_InputError` | die Liste der fehlerhaften Eingaben bei der Bankverbindung | Bankdatenverwaltung |

## Weitere Meldungen

| Tag | Meldung | Gehört auf |
| - | - | - |
| `MSG-Notify` | die allgemeinen Fehler- und Statusmeldungen | Notify-Template |
| `MSG-InternalErrorMessage` | interne Fehlermeldungen des Shopsystems | Notify-Template |
| `MSG-Inventory_Notify` | die Meldungen zum Lagerbestand | Template mit Lagerbestandsanzeige |
| `MSG-InventoryRegister_Notify` | ein Kontaktdatenfeld wurde nicht ausgefüllt | Template der Benachrichtigungsanmeldung |
| `MSG-MemoList_Notify` | die Meldungen der Merkliste | Merkliste |
| `MSG-OrderHistory_Notify` | die Meldungen der Bestellhistorie | Bestellhistorie |
| `MSG-ProductCompare_Notify` | die Hinweise zum Produktvergleich | Produktvergleich |
| `MSG-ProductRecmd_Notify` | die Meldungen zu "Produkt weiterempfehlen" | Weiterempfehlen-Template |
| `MSG-AreaInput_Notify` | fehlende oder ungültige Maße bei einem Flächenprodukt | Produkttemplate |

> [!WARNING]
>
> `MSG-InternalErrorMessage` gehört ausschließlich in einen HTML-Kommentar. Diese Meldungen sind für die Fehlersuche gedacht und dürfen einem Besucher nicht im Klartext erscheinen.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<!--
{MSG-InternalErrorMessage}
   ~MSG-InternalErrorMessage~
{/MSG-InternalErrorMessage}
-->
```

## Im Shopsystem vorhanden, bisher nicht beschrieben

Die Tag-Tabelle des Shopsystems führt 73 Meldungen. Die folgenden elf sind vorhanden.

| Tag | Erkennbarer Zweck |
| - | - |
| `MSG-CreditCard_Notify` | die Meldungen zur Kreditkartenverwaltung, das Gegenstück zu `MSG-Bank_Notify` |
| `MSG-CreditCard_InputError` | die fehlerhaften Eingaben bei der Kreditkarte |
| `MSG-Search_Notify` | die Meldungen der Suche, beispielsweise zur Mindestlänge des Suchbegriffs |
| `MSG-Offers_Notify` | die Meldungen der Angebotsfunktion |
| `MSG-ReOrder_Notify` | die Meldungen beim Nachbestellen |
| `MSG-WishList_Notify` | die Meldungen der Wunschliste |
| `MSG-SavedBasket_Notify` | die Meldungen zu gespeicherten Warenkörben |
| `MSG-AutoOrder_Notify` | die Meldungen der automatischen Nachbestellung |
| `MSG-Employee_Notify` | die Meldungen der Mitarbeiterverwaltung |
| `MSG-PPCVault_Notify` | die Meldungen zur gespeicherten Zahlungsart bei PayPal |
| `MSG-Inquiry_Notify` | die Meldungen des Anfragemoduls |

> [!WARNING]
>
> Die Zwecke in dieser Tabelle sind aus dem Code abgeleitet. Besonders `MSG-CreditCard_Notify` und `MSG-Search_Notify` fallen auf, weil ihre Gegenstücke seit jeher beschrieben sind. Bevor eines dieser Tags in einen Wegweiser aufgenommen wird, sollte die Entwicklung es bestätigen.

## Veraltete Tags

> [!WARNING]
>
> `MSG-Addr_InputError` und `MSG-DelivAddr_InputError` gibt es im Shopsystem nicht mehr. In der Tag-Tabelle kommen beide nicht vor. Verwenden Sie stattdessen die einzelnen `_InputError_`Tags aus dem Abschnitt Adressen.

`MSG-PlaceOrder_InputError` ist ebenfalls veraltet, wird aber weiterhin unterstützt. Für neue Templates ist `MSG-PlaceOrder_Notify` der richtige Weg.

## Die Tags im Überblick

Die Tags dieser Gruppe sind durchgehend Einzel-Tag, Bereichs-Tag und negatives Bereichs-Tag. Als Schleifen-Tag lässt sich keines verwenden. Abweichungen gibt es nur bei diesen:

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag |
| - | - | - | - |
| `MSG-Bank_InputError` | – | ja | ja |
| `MSG-CreditCard_InputError` | – | ja | ja |
| `MSG-BasketUpdatedOnlinePriceProducts` | – | ja | ja |
| `MSG-SessionUnlockedOnlineClearing` | – | ja | ja |
| `MSG-SetPasswordEmailSent` | – | ja | ja |
| `MSG-DoubleOptInDeleteAccountEmailSent` | – | ja | ja |
| `MSG-DoubleOptInDeleteAccountSuccess` | – | ja | ja |

Die sieben Tags mit Fehlercode geben als Einzel-Tag den Code aus, nicht den Text. Den Text formulieren Sie selbst in der Klammerung mit Argument.

## Verwandte Themen

* Wegweiser: [Standardtexte](https://dokumentation.websale.de/v8s/einstellungen/standardtexte.md)
* Wegweiser: [Gutscheine anbieten](https://dokumentation.websale.de/v8s/gutscheine-anbieten/gutscheine-anbieten-uebersicht.md)
* Wegweiser: [Abo-Modul](https://dokumentation.websale.de/v8s/marketing-funktionen/abo-modul.md)
* Referenz: [Abschnitt NotifyMessages-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md#notifymessages-txt)


## Related topics

- [OFFER- (Kundenspezifische Angebote)](https://dokumentation.websale.de/v8s/referenz/tags/offer-kundenspezifische-angebote.md)
- [PRC- (Produktvergleich)](https://dokumentation.websale.de/v8s/referenz/tags/prc-produktvergleich.md)
- [Mehrere Adressen: Tags je Template](https://dokumentation.websale.de/v8s/referenz/tags/multiple-adressen.md)
- [IDS- (Integrierte Daten-Schnittstelle)](https://dokumentation.websale.de/v8s/referenz/tags/ids-schnittstelle.md)
- [KLARNA- (Klarna Payments)](https://dokumentation.websale.de/v8s/referenz/tags/klarna-payments.md)


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