MSG- (Meldungen) - WEBSALE Dokumentation

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 · Referenz: Abschnitt NotifyMessages-Txt

Das Grundmuster

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

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.

{!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 · Abschnitt StandardMessages-Txt · Abschnitt LoginError-Txt · Abschnitt 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.

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

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.

{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

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 _NotifyTags 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

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.

<!--
{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

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

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.

​Das Grundmuster

​Woher die Texte kommen

​Meldungen mit Fehlercode

​Gutscheine

​Abo-Modul

​Prime-Pakete und Prime-Produkte

​Aktualisierte Online-Preise

​Adressen

​Anmeldung und Kundenkonto

​Bestellprozess

​Weitere Meldungen

​Im Shopsystem vorhanden, bisher nicht beschrieben

​Veraltete Tags

​Die Tags im Überblick

​Verwandte Themen

Das Grundmuster

Woher die Texte kommen

Meldungen mit Fehlercode

Gutscheine

Abo-Modul

Prime-Pakete und Prime-Produkte

Aktualisierte Online-Preise

Adressen

Anmeldung und Kundenkonto

Bestellprozess

Weitere Meldungen

Im Shopsystem vorhanden, bisher nicht beschrieben

Veraltete Tags

Die Tags im Überblick

Verwandte Themen