actions - Benutzerkonto

Diese Seite enthält alle Aktionen, die das Benutzerkonto betreffen und enthält somit alle Meldungen und E-Mail-Vorlagen, die beim Erstellen, Ändern, Löschen und Prüfen von Kontodaten auftreten.

---

Übersicht der Aktionen

Folgend eine Auflistung aller Aktionen, die für Benutzerkonten angeboten werden.

Aktionen, die inhaltlich zu einem anderen Themenbereich gehören, finden sich in den entsprechenden Abschnitten dieser Dokumentation oder in der alphabetischen Übersicht der Aktionen.

Auszug der Grundstruktur actions

{
  "actions": {
    ...
    "accountActivate": {...},
    "accountActivateOptIn": {...},
    "accountDelete": {...},
    "accountDisplayNameUpdate": {...},
    "accountRegister": {...},
    "addressCreate": {...},
    "addressDelete": {...},
    "addressUpdate": {...},
    "creditCardDelete": {...},
    "confirmZipCode": {...},
    "emailUpdate": {...},
    "emailVerify": {...},
    "setCustomerData": {...},
    "setMainAddress": {...},
    "subAccountCreate": {...},
    "userInvitation": {...},
    ...
  }
}

Aktionsübersicht

Aktion	Beschreibung
accountActivate	Konfiguriert die Opt-In-E-Mail sowie die Fehlermeldungen bei der Aktivierung eines bestehenden Kundenkontos durch Bestandskunden.
accountActivateOptIn	Konfiguriert die Verifizierungs-E-Mail sowie die Fehlermeldungen bei der Bestätigung des Opt-In-Links im Rahmen der Bestandskundenaktivierung.
accountDelete	Konfiguriert die verwendeten E-Mail-Vorlagen für Bestätigungs- und Double-Opt-In-Mails sowie mögliche Fehlermeldungen bei der Kontolöschung.
accountDisplayNameUpdate	Hier wird festgelegt, welche Fehlertexte bei fehlenden Eingaben oder nicht angemeldeten Benutzern während der Änderung des Namens ausgegeben werden.
accountRegister	Definiert die Fehlertexte bei der Registrierung neuer Kundinnen und Kunden.
addressCreate	Definiert die Fehlermeldungen beim Erstellen neuer Adressen im Kundenkonto.
addressUpdate	Definiert die Fehlermeldungen beim Aktualisieren bestehender Adressen im Kundenkonto.
addressDelete	Definiert die Fehlermeldungen beim Löschen der Adressen im Kundenkonto.
creditCardDelete	Definiert die Fehlermeldungen beim Entfernen gespeicherter Pseudokreditkartendaten aus dem Kundenkonto.
confirmZipCode	Definiert die Fehlermeldungen bei der Überprüfung einer evtl. ungültig angegebenen Postleitzahl.
emailUpdate	Definiert die Fehlermeldungen bei der Aktualisierung der E-Mail-Adresse im Kundenkonto.
emailVerify	Definiert die Fehlermeldungen bei der Verifizierung der E-Mail-Adresse im Kundenkonto.
setCustomerData	Definiert die Fehlermeldungen beim Speichern oder Aktualisieren von Kundendaten im Shop.
setMainAddress	Definiert die Fehlermeldungen beim festlegen einer Hauptadresse im Kundenkonto.
subAccountCreate	Definiert die Fehlermeldungen beim Erstellen neuer Unterkonten innerhalb eines bestehenden Kundenkontos.
userInvitation	Definiert die Fehlermeldungen beim Einladen neuer Benutzerinnen und Benutzer, beispielsweise zu Unterkonten oder gemeinsam genutzten Kundenkonten. Hier werden sowohl die Einladungs-Mail als auch mögliche Fehlermeldungen bei der Einladungskontrolle definiert.

---

actions.account* - Benutzer

Die unter diesem Abschnitt beschriebenen Aktionen betreffen Vorgänge rund um das Benutzerkonto. Sie werden immer dann ausgelöst, wenn der Benutzer eine entsprechende Aktion im Shop ausführt - beispielsweise bei der Registrierung, bei Änderungen am Profil oder beim Löschen des Kontos.

actions.accountDelete - Kontolöschung

Mithilfe der Aktion accountDelete werden die Fehlermeldungen für Anfragen zur Löschung eines Kundenkontos gesteuert. Gleichzeitig wird hier konfiguriert, welche Bestätigungs-E-Mail nach erfolgreicher Löschung versendet wird und ob zusätzlich eine Double-Opt-In-E-Mail zur Bestätigung des Löschwunsches eingesetzt wird.

Beispielkonfiguration

{
  "confirmationEmail": {
    "fromAddress": "[e-mail]",
    "fromName": "Mein Onlineshop",
    "subject": "Mein Onlineshop | Löschung ihres Kontos",
    "template": "accountDelete.htm"
  },
  "doubleOptInEmail": {
    "enabled": false,
    "fromAddress": "[e-mail]",
    "fromName": "Mein Onlineshop",
    "subject": "Mein Onlineshop | Löschung ihres Kontos",
    "template": "accountDeleteOptIn.htm"
  },
  "errorCodes": {
    "actionNotAllowed": "",
    "notLoggedIn": "Sie sind nicht eingeloggt"
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
confirmationEmail	array	Konfiguriert die Bestätigungs-E-Mail, die nach erfolgter Kontolöschung an den Kunden gesendet wird. Der Versand kann über enabled aktiviert oder deaktiviert werden. Betreff, Absender und Template werden über die allgemeinen E-Mail-Parameter gesteuert, siehe hier: E-Mails & E-Mail Einstellungen
doubleOptInEmail	array	Konfiguriert die optionale Double-Opt-In-Email, mit der der Kunde seine Kontolöschung vor der Ausführung bestätigen muss. Der Versand kann über enabled aktiviert oder deaktiviert werden. Betreff, Absender und Template werden über die allgemeinen E-Mail-Parameter gesteuert, siehe hier: E-Mails & E-Mail Einstellungen
errorCodes	array	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
notLoggedIn	string	Fehlermeldung, die ausgegeben wird, wenn der Benutzer nicht eingeloggt ist.
actionNotAllowed	string	Fehlermeldung, die ausgegeben wird, wenn die Aktion nicht erlaubt ist.

actions.accountDisplayNameUpdate - Anzeigename ändern

Mithilfe der Aktion accountDisplayNameUpdate werden die Fehlermeldungen bei der Aktualisierung des öffentlichen Anzeigenamens gesteuert. Dieser wird ausschließlich bei abgegebenen Kundenbewertungen angezeigt und ersetzt dort den echten Namen.

Beispielkonfiguration

{
  "errorCodes": {
    "missingDisplayname": "",
    "notLoggedIn": ""
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	array	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
missingDisplayName	string	Fehlermeldung, die ausgegeben wird, wenn der Anzeigename nicht übergeben wurde.
notLoggedIn	string	Fehlermeldung, die ausgegeben wird, wenn der Benutzer nicht eingeloggt ist.

actions.accountRegister - Benutzer registrieren

Die Aktion accountRegister steuert die Fehlermeldungen bei der Registrierung eines neuen Benutzerkontos im Shop. Optional kann nach erfolgreicher Registrierung eine Bestätigungs- bzw. Verifizierungsmail über verifyEmail versendet werden.

Beispielkonfiguration

{
  "errorCodes": {
    "accountAlreadyExists": "Account existiert bereits",
    "emailCheckFailed": "E-Mail ungültig",
    "missingId": "E-Mail fehlt",
    "missingPassword": "Passwort fehlt",
    "passwordCheckFailed": "Passwort ungenügend",
    "passwordMismatch": "Passwörter stimmen nicht überein"
  },
  "verifyEmail": {
    "fromAddress": "[e-mail]",
    "fromName": "Mein Onlineshop",
    "subject": "Mein Onlineshop | Registrierung",
    "template": "accountRegister.htm"
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	array	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
accountAlreadyExists	string	Fehlermeldung, die ausgegeben wird, wenn der Account bereits existiert.
emailCheckFailed	string	Fehlermeldung, die ausgegeben wird, wenn die angegebene E-Mail-Adresse als ungültig bewertet wurde.
missingId	string	Fehlermeldung, die ausgegeben wird, wenn keine E-Mail-Adresse übermittelt wurde.
missingPassword	string	Fehlermeldung, die ausgegeben wird, wenn kein Passwort übermittelt wurde.
passwordCheckFailed	string	Fehlermeldung, die ausgegeben wird, wenn das Passwort die Mindestanforderungen nicht erfüllt.
passwordMismatch	string	Fehlermeldung, die ausgegeben wird, wenn Passwort und Passwort-Bestätigung nicht übereinstimmen.
verifyEmail	object	Konfiguriert die E-Mail, über die der Kunde seine Registrierung bestätigen kann. Betreff, Absender und Template werden über die allgemeinen E-Mail-Parameter gesteuert, siehe hier: E-Mails & E-Mail Einstellungen

actions.accountActivate - Bestandskunden aktivieren

Die Aktion accountActivate steuert die Opt-In-E-Mail sowie die Fehlermeldungen bei der Aktivierung eines bereits im Shop vorhandenen Kundenkontos durch Bestandskunden. Voraussetzung ist, dass der Kundendatensatz zuvor im Shop angelegt wurde (z.B. über einen Import). Weitere Informationen zur Konfiguration der Bestandskundenregistrierung finden sich unter accounts.account.

Beispielkonfiguration

{
  "optInEmail": {
    "template": "account/activateAccountOptIn.htm",
    "subject": "Registration attempt for your Account",
    "fromAddress": "[e-mail]",
    "fromName": "Websale Shop"
  },
  "errorCodes": {
    "disabled": "Bestandskundenregistrierung ist deaktiviert.",
    "missingId": "Fehlende E-Mail Adresse",
    "missingCustomerNumber": "Fehlende Kundennummer",
    "missingPassword": "Fehlendes Passwort",
    "passwordMismatch": "Passwörter stimmen nicht überein",
    "emailCheckFailed": "E-Mail Adresse ist ungültig",
    "passwordCheckFailed": "Passwort entspricht nicht den Anforderungen",
    "accountNotFound": "Konto nicht gefunden",
    "accountAlreadyActivated": "Konto ist bereits aktiviert"
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
optInEmail	object	Konfiguriert die Opt-In-E-Mail, die nach der Aktivierung an die im Kundenkonto hinterlegte Adresse versendet wird. Der Kunde muss die Registrierung darüber nochmals bestätigen. Der Versand kann in accounts.account über requireOptIn deaktiviert werden. Betreff, Absender und Template werden über die allgemeinen E-Mail-Parameter gesteuert.
errorCodes	array	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
disabled	string	Fehlermeldung, die ausgegeben wird, wenn die Bestandskundenregistrierung deaktiviert ist.
missingId	string	Fehlermeldung, die ausgegeben wird, wenn keine E-Mail-Adresse übermittelt wurde.
missingCustomerNumber	string	Fehlermeldung, die ausgegeben wird, wenn keine Kundennummer übermittelt wurde.
missingPassword	string	Fehlermeldung, die ausgegeben wird, wenn kein Passwort übermittelt wurde.
passwordMismatch	string	Fehlermeldung, die ausgegeben wird, wenn Passwort und Passwort-Bestätigung nicht übereinstimmen.
emailCheckFailed	string	Fehlermeldung, die ausgegeben wird, wenn die angegebene E-Mail-Adresse als ungültig bewertet wurde.
passwordCheckFailed	string	Fehlermeldung, die ausgegeben wird, wenn das Passwort die Mindestanforderungen nicht erfüllt.
accountNotFound	string	Fehlermeldung, die ausgegeben wird, wenn kein Konto mit den übermittelten Daten gefunden werden konnte.
accountAlreadyActivated	string	Fehlermeldung, die ausgegeben wird, wenn das Konto bereits aktiviert wurde.

actions.accountActivateOptIn - Bestandskundenaktivierung Opt-In Bestätigung

Die Aktion accountActivateOptIn steuert die Verifizierungs-E-Mail sowie die Fehlermeldungen, die bei der Bestätigung des Opt-In-Links im Rahmen der Bestandskundenaktivierung auftreten. Diese Aktion greift, nachdem der Kunde den Opt-In-Link aus der von accountActivate versendeten E-Mail aufgerufen hat.

Beispielkonfiguration

{
  "verifyEmail": {
    "template": "account/email_verify.htm",
    "subject": "Verify your Email-Address",
    "fromAddress": "[e-mail]",
    "fromName": "Websale Shop"
  },
  "errorCodes": {
    "actionNotAllowed": "Das Opt-In Token ist für diese Aktion nicht gültig",
    "accountAlreadyExists": "Eine Aufteilung in Firmenkonten/Mitarbeiterkonten ist konfiguriert und es konnte kein Mitarbeiterkonto angelegt werden, weil die EMail schon benutzt wird."
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
verifyEmail	object	Konfiguriert die Verifizierungs-E-Mail, die nach erfolgreicher Bestätigung des Opt-In-Links an den Kunden versendet wird. Betreff, Absender und Template werden über die allgemeinen E-Mail-Parameter gesteuert.
errorCodes	array	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
actionNotAllowed	string	Fehlermeldung, die ausgegeben wird, wenn das Opt-In-Token ungültig oder abgelaufen ist.
accountAlreadyExists	string	Fehlermeldung, die ausgegeben wird, wenn eine Aufteilung in Firmen-/Mitarbeiterkonten konfiguriert ist und das Mitarbeiterkonto nicht angelegt werden konnte, weil die E-Mail-Adresse bereits vergeben ist.

---

actions.address* - Adressdaten

Dieser Abschnitt enthält alle Aktionen, die die Verwaltung von Adressdaten im Benutzerkonto betreffen. Hier werden die Meldungen dokumentiert, die beim Anlegen, Ändern oder Löschen von Rechnungs- und Lieferadressen im Shop ausgegeben werden.

actions.addressCreate - Adresse anlegen

Die Aktion addressCreate steuert die Fehlermeldungen beim Anlegen einer neuen Adresse im Kundenkonto.

Beispielkonfiguration

{
  "errorCodes": {
    "notLoggedIn": "Bitte melden Sie sich an, um eine Adresse anzulegen.",
    "emptyAddress": "Bitte füllen Sie alle erforderlichen Adressfelder aus.",
    "unknownField": "Es wurden ungültige Adressfelder übermittelt.",
    "invalidFieldType": "Mindestens ein Adressfeld enthält einen ungültigen Wert."
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	array	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
notLoggedIn	string	Fehlermeldung, die ausgegeben wird, wenn der Benutzer nicht eingeloggt ist.
emptyAddress	string	Fehlermeldung, die ausgegeben wird, wenn keine oder unvollständige Adressdaten übermittelt wurden.
unknownField	string	Fehlermeldung, die ausgegeben wird, wenn Felder übergeben wurden, die dem System nicht bekannt sind.
invalidFieldType	string	Fehlermeldung, die ausgegeben wird, wenn Felder mit einem ungültigen Dateityp gefüllt sind.

actions.addressDelete - Adresse löschen

Die Aktion addressDelete steuert die Fehlermeldungen beim Löschen einer bestehenden Adresse im Kundenkonto.

Beispielkonfiguration

{
  "errorCodes": {
    "notLoggedIn": "Bitte melden Sie sich an, um eine Adresse zu löschen.",
    "invalidAddressId": "Die ausgewählte Adresse konnte nicht gefunden werden."
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	array	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
notLoggedIn	string	Fehlermeldung, die ausgegeben wird, wenn der Benutzer nicht eingeloggt ist.
invalidAddressId	string	Fehlermeldung, die ausgegeben wird, wenn die angegebene Adress-ID ungültig ist oder die Adresse nicht gefunden werden kann.

actions.addressUpdate - Adresse bearbeiten

Die Aktion addressUpdate steuert die Fehlermeldungen, die beim Bearbeiten einer bestehenden Adresse im Kundenkonto auftreten.

Beispielkonfiguration

{
  "errorCodes": {
    "emptyAddress": "Bitte füllen Sie alle erforderlichen Adressfelder aus.",
    "invalidAddressId": "Die ausgewählte Adresse konnte nicht gefunden werden.",
    "unknownField": "Es wurden ungültige Adressfelder übermittelt.",
    "invalidFieldType": "Mindestens ein Adressfeld enthält einen ungültigen Wert.",
    "expressCheckoutNotAllowed": "Die Adresse kann im Express-Checkout nicht geändert werden.",
    "readOnlyField": "Mindestens ein Feld darf nicht geändert werden."
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	array	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
emptyAddress	string	Fehlermeldung, die ausgegeben wird, wenn keine oder unvollständige Adressdaten übermittelt wurden.
invalidAddressId	string	Fehlermeldung, die ausgegeben wird, wenn die angegebene Adress-ID ungültig ist oder die Adresse nicht gefunden werden kann.
unknownField	string	Fehlermeldung, die ausgegeben wird, wenn Felder übergeben wurden, die dem System nicht bekannt sind.
invalidFieldType	string	Fehlermeldung, die ausgegeben wird, wenn Felder mit einem ungültigen Dateityp gefüllt sind.
expressCheckoutNotAllowed	string	Fehlermeldung, die ausgegeben wird, wenn die Adresse im Rahmen eines Express-Checkouts nicht geändert werden darf.
readOnlyField	string	Fehlermeldung, die ausgegeben wird, wenn versucht wird, ein schreibgeschütztes Feld zu ändern.

---

actions.creditCardDelete - Gespeicherte Kreditkarte löschen

Die Aktion creditCardDelete definiert die Fehlermeldungen, die beim Löschen einer gespeicherten Kreditkarte ausgegeben werden.

Beispielkonfiguration

{
  "errorCodes": {
    "notLoggedIn": "Bitte melden Sie sich an, um eine gespeicherte Kreditkarte zu löschen.",
    "missingPseudoId": "Die ausgewählte Kreditkarte konnte nicht gefunden werden."
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	array	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
notLoggedIn	string	Fehlermeldung, die ausgegeben wird, wenn der Benutzer nicht eingeloggt ist.
missingPseudoId	string	Fehlermeldung, die ausgegeben wird, wenn keine oder eine ungültige Karten-Referenz übermittelt wurde bzw. die Karte nicht gefunden werden kann.

---

actions.confirmZipCode - Postleitzahl bestätigen

Die Aktion confirmZipCode definiert die Fehlermeldungen für die Prüfung, ob die übermittelte Postleitzahl zu einer angegebenen Bestellung passt.

Beispielkonfiguration

{
  "errorCodes": {
    "missingZipCode": "Bitte geben Sie Ihre Postleitzahl ein.",
    "missingOrderId": "Bitte geben Sie Ihre Bestellnummer ein.",
    "invalidZipCode": "Die angegebene Postleitzahl passt nicht zu dieser Bestellung."
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	array	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
missingZipCode	string	Fehlermeldung, die ausgegeben wird, wenn keine Postleitzahl übermittelt wurde.
missingOrderId	string	Fehlermeldung, die ausgegeben wird, wenn keine Bestellnummer übermittelt wurde.
invalidZipCode	string	Fehlermeldung, die ausgegeben wird, wenn die Postleitzahl nicht zur Bestellung passt.

---

actions.email* - E-Mail-Adresse für den Login

In diesem Abschnitt werden alle Aktionen rund um die E-Mail-Adresse für den Login behandelt. Hier können die E-Mails und Fehlermeldungen konfiguriert werden, die beim Ändern der Login-E-Mail-Adresse sowie bei der Bestätigung bzw. Verifizierung der E-Mail-Adresse über Bestätigungslinks zum Einsatz kommen.

actions.emailUpdate - E-Mail-Adresse ändern

Mit der Aktion emailUpdate werden E-Mails und Fehlermeldungen bei der Änderung der E-Mail-Adresse eines bestehenden Kundenkontos definiert. Dabei können zwei E-Mail-Typen genutzt werden: eine optionale Double-Opt-In-E-Mail und eine Bestätigungs-/Verifizierungs-E-Mail an die neue Adresse.

Beispielkonfiguration

{
  "verifyEmail": {
    "template": "email_update_verify.htm",
    "subject": "Bitte bestätigen Sie Ihre neue E-Mail-Adresse",
    "fromAddress": "[e-mail]",
    "fromName": "Mein Onlineshop"
  },
  "doubleOptInEmail": {
    "template": "email_update_double_opt_in.htm",
    "subject": "Bestätigung zur Änderung Ihrer E-Mail-Adresse",
    "fromAddress": "[e-mail]",
    "fromName": "Mein Onlineshop",
    "enabled": false
  },
  "errorCodes": {
    "missingEmail": "Bitte geben Sie eine E-Mail-Adresse an.",
    "emailCheckFailed": "Die angegebene E-Mail-Adresse ist ungültig.",
    "accountAlreadyExists": "Unter dieser E-Mail-Adresse besteht bereits ein Kundenkonto.",
    "actionNotAllowed": "Die Änderung der E-Mail-Adresse ist aktuell nicht erlaubt."
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
verifyEmail	object	Konfiguriert die E-Mail, über die der Kunde seine Änderung bestätigen kann. Betreff, Absender und Template werden über die allgemeinen E-Mail-Parameter gesteuert, siehe hier: E-Mails & E-Mail Einstellungen
doubleOptInEmail	object	Konfiguriert die optionale Double-Opt-In-Email, mit der der Kunde seine Kontolöschung vor der Ausführung bestätigen muss. Der Versand kann über enabled aktiviert oder deaktiviert werden. Betreff, Absender und Template werden über die allgemeinen E-Mail-Parameter gesteuert, siehe hier: E-Mails & E-Mail Einstellungen
errorCodes	object	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
missingEmail	string	Fehlermeldung, die ausgegeben wird, wenn keine E-Mail-Adresse übermittelt wurde.
emailCheckFailed	string	Fehlermeldung, die ausgegeben wird, wenn die angegebene E-Mail-Adresse als ungültig bewertet wurde.
accountAlreadyExists	string	Fehlermeldung, die ausgegeben wird, wenn ein Account mit dieser E-Mail-Adresse bereits existiert.
actionNotAllowed	string	Fehlermeldung, die ausgegeben wird, wenn die Aktion nicht erlaubt ist.

actions.emailVerify - E-Mail-Adresse bestätigen

Mithilfe der Aktion emailVerify können Fehlermeldungen definiert werden, die auftreten, wenn ein Kunde seine E-Mail-Adresse über einen Bestätigungslink (Double-Opt-In) verifizieren soll.

Beispielkonfiguration

{
  "errorCodes": {
    "actionNotAllowed": "Die E-Mail-Adresse konnte nicht bestätigt werden."
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	object	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
actionNotAllowed	string	Fehlermeldung, die ausgegeben wird, wenn die Aktion nicht erlaubt ist.

---

actions.set* - Datenzuweisung & Aktualisierung

Dieser Abschnitt umfasst Aktionen, mit denen im laufenden Shop-Kontext bestimmte Daten oder Werte gesetzt bzw. aktualisiert werden.

actions.setCustomerData - Kundenzusatzdaten

Mithilfe der Aktion setCustomerData können Fehlermeldungen bei der Verarbeitung zusätzlicher Kundendaten gesteuert werden. Diese Daten werden beispielsweise über Formulare im Kundenkonto oder im Checkout erfasst.

Beispielkonfiguration

{
  "errorCodes": {
    "fieldCheckFailed": "Mindestens ein Feld enthält einen ungültigen oder unvollständigen Wert.",
    "invalidNumberValue": "Bitte geben Sie in diesem Feld eine gültige Zahl ein.",
    "invalidCheckboxValue": "Der Wert für diese Auswahl ist ungültig.",
    "requiredCheckboxUnchecked": "Bitte aktivieren Sie diese Option, um fortzufahren.",
    "requiredTextfieldEmpty": "Bitte füllen Sie alle als Pflichtfeld gekennzeichneten Eingabefelder aus."
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	object	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
fieldCheckFailed	string	Fehlermeldung, die ausgegeben wird, wenn eine Feldprüfung fehlschlägt (z.B. Pflichtfeld verletzt oder Formatfehler).
invalidNumberValue	string	Fehlermeldung, die ausgegeben wird, wenn in einem Zahlenfeld kein gültiger numerischer Wert übermittelt wurde.
invalidCheckboxValue	string	Fehlermeldung, die ausgegeben wird, wenn für eine Checkbox ein ungültiger Wert übermittelt wurde.
requiredCheckboxUnchecked	string	Fehlermeldung, die ausgegeben wird, wenn eine als erforderlich markierte Checkbox nicht aktiviert wurde.
requiredTextfieldEmpty	string	Fehlermeldung, die ausgegeben wird, wenn ein erforderliches Textfeld leer gelassen wurde.

actions.setMainAddress - Hauptadresse festlegen

Mit der Aktion setMainAddress werden Fehlermeldungen definiert, die beim Festlegen der Hauptadresse im Kundenkonto auftreten.

Beispielkonfiguration

{
  "errorCodes": {
    "notLoggedIn": "Bitte melden Sie sich an, um eine Hauptadresse festzulegen.",
    "missingAddressId": "Es wurde keine Adresse ausgewählt.",
    "invalidAddressId": "Die ausgewählte Adresse konnte nicht gefunden werden."
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	object	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
notLoggedIn	string	Fehlermeldung, die ausgegeben wird, wenn der Benutzer nicht eingeloggt ist.
missingAddressId	string	Fehlermeldung, die ausgegeben wird, wenn keine Adress-ID übermittelt wurde (keine Adresse ausgewählt).
invalidAddressId	string	Fehlermeldung, die ausgegeben wird, wenn die angegebene Adress-ID ungültig ist oder die Adresse nicht gefunden werden kann.

---

actions.subAccountCreate - Unterkonten (Sub-Accounts) anlegen

Die Aktion subAccountCreate definiert Fehlermeldungen, die bei der Registrierung eines Unterkontos zu einem bestehenden Hauptkundenkonto auftreten (z. B. für Mitarbeiter-, Filial- oder Team-Accounts).

Beispielkonfiguration

{
  "errorCodes": {
    "disabled": "Die Anlage von Unterkonten ist derzeit nicht möglich.",
    "notLoggedIn": "Bitte melden Sie sich mit Ihrem Hauptkonto an, um ein Unterkonto anzulegen.",
    "missingEmail": "Bitte geben Sie eine E-Mail-Adresse für das Unterkonto an.",
    "missingPassword": "Bitte vergeben Sie ein Passwort für das Unterkonto.",
    "passwordMismatch": "Die angegebenen Passwörter stimmen nicht überein.",
    "emailCheckFailed": "Die angegebene E-Mail-Adresse ist ungültig.",
    "passwordCheckFailed": "Das Passwort erfüllt nicht die Mindestanforderungen.",
    "accountAlreadyExists": "Unter dieser E-Mail-Adresse besteht bereits ein Konto."
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	object	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
disabled	string	Fehlermeldung, die ausgegeben wird, wenn die Anlage von Unterkonten im Shop grundsätzlich deaktiviert ist.
notLoggedIn	string	Fehlermeldung, die ausgegeben wird, wenn der Benutzer nicht eingeloggt ist.
missingEmail	string	Fehlermeldung, die ausgegeben wird, wenn keine E-Mail-Adresse übermittelt wurde.
missingPassword	string	Fehlermeldung, die ausgegeben wird, wenn kein Passwort übermittelt wurde.
passwordMismatch	string	Fehlermeldung, die ausgegeben wird, wenn Passwort und Passwort-Bestätigung nicht übereinstimmen.
emailCheckFailed	string	Fehlermeldung, die ausgegeben wird, wenn die angegebene E-Mail-Adresse als ungültig bewertet wurde.
passwordCheckFailed	string	Fehlermeldung, die ausgegeben wird, wenn das Passwort die Mindestanforderungen nicht erfüllt.
accountAlreadyExists	string	Fehlermeldung, die ausgegeben wird, wenn ein Account mit dieser E-Mail-Adresse bereits existiert.

---