# 5. Weitere Konfiguration

# Menü erweitern und Kontaktgründe pflegen

## Übersicht

Zwei kleine Konfigurationen, die die Fußzeile und das Kontaktformular des Shops betreffen.

## Eigene Menüpunkte anlegen

Über *eCom \\ Menüerweiterung* legen Sie zusätzliche Menüpunkte für den Shop an. Sie erscheinen in der **zweiten Spalte der Fußzeile** — **je Sprache getrennt**.

1. *eCom \\ Menüerweiterung* öffnen.
2. Sprache wählen.
3. Menüpunkt anlegen und befüllen.
4. Speichern und Daten bereitstellen.

Typische Beispiele aus einem laufenden System sind Menüpunkte wie *Anwenderhandbuch eCom* oder *Newsletter*.

## Kontaktgründe pflegen

Die Auswahlliste im Kontaktformular des Shops kommt aus einer Code-Tabelle.

1. *Grundkonfiguration \\ Code-Tabelle* öffnen.
2. Bereich **eCom Kontaktgrund** wählen.
3. Die gewünschten Kontaktgründe pflegen.
4. Speichern und Daten bereitstellen.

Ohne gepflegte Kontaktgründe hat der Kunde im Kontaktformular keine Auswahl.

Damit die Anfragen bei Ihnen ankommen, muss außerdem das E-Mail-Abo **eCom - Kontaktformular** eingerichtet sein.

# Auftragsvorlage für eCom freischalten

## Übersicht

Auftragsvorlagen erscheinen im Shop nur, wenn Sie sie dort freischalten. Das geschieht unter *Auftragsunterstützung \\ Auftragsvorlage* im Bereich **eCom** der jeweiligen Vorlage.

Die Felder dieses Bereichs und ihre Bedeutung stehen in der Leistungsbeschreibung.

## Vorgehen

1. *Auftragsunterstützung \\ Auftragsvorlage* öffnen und die Vorlage wählen.
2. Im Bereich **eCom** die **Anzeige** festlegen:

<table id="bkmrk-wert-wirkung-keine-e"><thead><tr><th>Wert</th><th>Wirkung</th></tr></thead><tbody><tr><td>Keine</td><td>erscheint nicht im Shop (Standard)</td></tr><tr><td>Startmenü</td><td>erscheint im Warengruppenmenü</td></tr><tr><td>Highlightmenü</td><td>erscheint im Startmenü **und** im Highlightmenü</td></tr></tbody></table>

3. Bei Bedarf **Gültig ab** und **Gültig bis** setzen. Damit steuern Sie den Shop-Zeitraum unabhängig vom Client.
4. Bei Bedarf **Prefix** und **Bezeichnung** für die Anzeige im Shop setzen.
5. Speichern und Daten bereitstellen.

## Warum eigene Termine für den Shop sinnvoll sind

Der Außendienst sieht Aktionen in der Regel einige Tage vor dem Start, um sich vorzubereiten und Termine zu planen. Für den Shop wollen Sie das meist nicht — dort soll die Aktion erst am Starttag erscheinen.

Genau dafür sind **Gültig ab** und **Gültig bis** im eCom-Bereich da: sie überschreiben den Zeitraum des Clients.

## Warum eine eigene Bezeichnung sinnvoll ist

Trägt die Auftragsvorlage eine Bezeichnung, die für den Außendienst gedacht ist — etwa mit internen Hinweisen oder Konditionsangaben —, überschreiben Sie sie über das Feld **Bezeichnung** kundenoptimiert für den Shop.

## Nur für den Shop, nicht für den Außendienst

Mit der Checkbox **Nicht für Außendienst** steht die Vorlage ausschließlich im eCom-System zur Verfügung.

## Sortiment auf eine Artikelliste begrenzen

Die Checkbox *Bei den gewählten Kunden dieser Kundenliste ausschließlich die Artikel der Artikelliste im eCom System anzeigen* wirkt wie eine geschlossene Listung: Die Kunden dieser Vorlage dürfen nur die Artikel der Artikelliste aufrufen, suchen und bestellen.

> **Achtung:** Kommt ein Kunde in **mehreren** Auftragsvorlagen mit dieser Checkbox vor, trifft das eCom-System eine **zufällige Auswahl**, welche gelten soll. Eine Mischung mehrerer Artikellisten ist nicht möglich. Stellen Sie sicher, dass jeder Kunde nur in einer solchen Vorlage vorkommt.

## Was im Shop nicht ankommt

Im eCom-System stehen **keine Module** zur Verfügung. Module, die Sie der Auftragsvorlage zugewiesen haben, werden im Shop nicht angezeigt — unabhängig davon, welche es sind.

# Mandantenwerte für eCom pflegen

## Übersicht

Einige Werte, die den Bestellabschluss im Shop steuern, liegen nicht bei eCom, sondern unter *Grundkonfiguration \\ Mandanten*.

Die Grundregel: **Mandantenwerte gelten für alle Kanäle**, also für Client und Shop gemeinsam — es sei denn, eCom weicht über eine Folgeeinstellung ab.

Zwei Wertelisten sind die Ausnahme und tragen ein eigenes **eCom-Kennzeichen**.

## Die beiden Wertelisten mit eCom-Kennzeichen

Betroffen sind **Frachtfreigrenze** und **Frachtkosten**. Beide Listen haben die Spalten `Wert`, `Währung` und `eCom`.

> Wenn aktiv, gilt der Wert nur für eCom. Wenn nicht aktiv, nur für den DeDeSales Client.

> **Achtung:** Das Kennzeichen ist eine **Weiche, kein Zusatz.** Eine Zeile gilt entweder für den Shop oder für den Client, niemals für beide. Wer beide Kanäle versorgen will, braucht **zwei Zeilen** — eine mit Kennzeichen und eine ohne. Fehlt die eCom-Zeile, hat der Shop keinen Wert.

Beide Listen führen eine Währung. Bei mehreren Währungen brauchen Sie also je Währung eine Zeile — und das wiederum je Kanal.

## Vorgehen

1. *Grundkonfiguration \\ Mandanten* öffnen und den Mandanten wählen.
2. Zur Werteliste **Frachtfreigrenze** beziehungsweise **Frachtkosten** gehen.
3. Eine Zeile für den Client anlegen — **ohne** eCom-Kennzeichen.
4. Eine Zeile für den Shop anlegen — **mit** eCom-Kennzeichen.
5. Bei mehreren Währungen für jede Währung wiederholen.
6. Speichern und Daten bereitstellen.

## Zusammenspiel Frachtfreigrenze und Frachtkosten

Unterhalb der Frachtfreigrenze werden die Frachtkosten berechnet, oberhalb nicht.

Die berechneten Frachtkosten erscheinen im Warenkorb als eigene Zeile — über den Artikel, den Sie unter *eCom \\ Einstellungen* als **Frachtkosten Artikel** hinterlegt haben. Diese Einstellung enthält also die **Artikelnummer**, nicht den Betrag.

## Werte ohne eCom-Kennzeichen

Diese Felder des Mandanten gelten für alle Kanäle:

<table id="bkmrk-feld-bekannte-wirkun"><thead><tr><th>Feld</th><th>Bekannte Wirkung</th></tr></thead><tbody><tr><td>Mindestbestellwert</td><td>**Wirkt nicht im Shop** — dieser allgemeine Wert wird im Bestellabschluss nicht gelesen, sondern nur für den Export verwendet. Für den Shop gilt der Wert im **Reiter eCom**. Siehe unten.</td></tr><tr><td>Mindestlieferzeit in Tagen</td><td>Steuert den frühestmöglichen Liefertermin.</td></tr><tr><td>Maximaler Positionswert</td><td>Wird berechnet, die Meldung erreicht den Kunden aber **nicht** — sie ist eine Rückfrage, und der Shop überspringt Rückfragen. Siehe unten.</td></tr><tr><td>Warnung ab Menge</td><td>Ebenso: wird berechnet, die Rückfrage erreicht den Kunden **nicht**. Siehe unten.</td></tr><tr><td>FeiertagsID</td><td>**Wirkt im Shop.** Bestimmt den Feiertagskalender für die Berechnung des frühestmöglichen Liefertermins — je getroffenem Feiertag kommt ein Tag hinzu.</td></tr><tr><td>Mindestauftragswert (Warnung)</td><td>**Wirkt nicht im Shop** — der Wert wird nirgends gefüllt und bliebe als Rückfrage ohnehin unsichtbar.</td></tr><tr><td>Mindestbestellmenge</td><td>**Wirkt nicht im Shop** — nur im Vertriebsclient. Siehe unten.</td></tr><tr><td>Mindestbestelleinheit</td><td>Die **Einheit**, auf die sich die Mindestbestellmenge bezieht — etwa *Stk* oder *Krt*. Kein Zahlenwert. Wirkt ebenfalls nur im Client.</td></tr></tbody></table>

### Der Mindestbestellwert steht zweimal da

Am Mandanten gibt es den *Mindestbestellwert* **zweimal**: einmal allgemein und einmal im **Reiter eCom**. Für den Shop zählt ausschließlich der Wert im Reiter eCom — der allgemeine wird im Bestellabschluss nicht gelesen.

<table id="bkmrk-wert-wirkung-im-shop"><thead><tr><th>Wert</th><th>Wirkung im Shop</th></tr></thead><tbody><tr><td>Mindestbestellwert, **Reiter eCom**</td><td>**greift**</td></tr><tr><td>Mindestbestellwert, allgemein</td><td>keine — nur für den Export</td></tr><tr><td>Mindestbestellwert des Debitors</td><td>nur in einem Sonderfall, siehe [Bestellabschluss](https://wiki.dedesales.de/books/leistungsbeschreibung-ecom/page/bestellabschluss)</td></tr><tr><td>Mindestauftragswert (Warnung)</td><td>keine</td></tr></tbody></table>

> **Achtung:** Das ist die häufigste Verwechslung an dieser Seite. Wer die Wertgrenze für den Shop im allgemeinen Feld pflegt, wundert sich, dass nichts passiert — und findet den Fehler schwer, weil der Wert ja korrekt gespeichert ist.

### Warum zwei Felder berechnet werden, aber nichts erscheint

*Maximaler Positionswert* und *Warnung ab Menge* werden serverseitig tatsächlich ausgewertet. Ihre Meldung ist aber eine **Rückfrage** — eine Meldung, die im Vertriebsclient jemand bestätigt, um fortzufahren.

Im Shop gibt es niemanden, der das könnte. Der Shop **überspringt Rückfragen deshalb grundsätzlich**. Das ist eine bewusste Entscheidung, kein Fehler.

<table id="bkmrk-feld-vertriebsclient"><thead><tr><th>Feld</th><th>Vertriebsclient</th><th>alter Shop</th><th>neuer Shop</th></tr></thead><tbody><tr><td>Maximaler Positionswert</td><td>wirkt</td><td>Meldung war sichtbar</td><td>unsichtbar</td></tr><tr><td>Warnung ab Menge</td><td>wirkt</td><td>Meldung war sichtbar</td><td>unsichtbar</td></tr></tbody></table>

Die Felder sind also **nicht funktionslos** — sie wirken nur nicht mehr dort, wo der Kunde sie sehen würde. Wer sie für den Shop pflegt, sollte wissen, dass sie dort ohne Folgen bleiben.

### Mindestbestellmenge: ohne Wirkung im Shop

Die beiden Felder gehören zusammen — eine Prüfung findet nur statt, wenn **beide** gefüllt sind — und sie sind mit dem Debitorwert kombinierbar. Im Shop kommt davon aber nichts an:

- Beim Laden des Warenkorbs **wird** die Unterschreitung berechnet und ein Hinweistext erzeugt (*„Die Mindestbestellmenge wurde nicht erreicht …"*).
- Die Schnittstelle, über die der Warenkorb seine Hinweise abholt, gibt diesen Text aber **nicht mit heraus**. Er geht also verloren, bevor er den Shop erreicht.
- Auch der Bestellabschluss prüft nur den Mindestbestell**wert** in Euro, keine Menge. Eine Bestellung wird dadurch also nie blockiert.

Das ist keine Eigenheit des neuen Shops — die Lücke steckt schon in der bestehenden Web-Schnittstelle und galt damit genauso für den alten Shop.

**Für die Einrichtung heißt das:** Die beiden Felder dürfen gepflegt werden, sie wirken dann aber ausschließlich in der Auftragserfassung des Vertriebsclients.

# Einstellungen pflegen

## Übersicht

Unter *eCom \\ Einstellungen* stellen Sie das Verhalten des Shops ein.

Welche Einstellungen es gibt, welche Werte sie annehmen und was sie bewirken, steht in der Leistungsbeschreibung auf der Seite *Einstellungen im Überblick*. Diese Seite beschreibt nur das Vorgehen und die Stellen, an denen man sich vertut.

## Vorgehen

1. *eCom \\ Einstellungen* öffnen.
2. Einstellung ändern.
3. Speichern.
4. Daten bereitstellen.

Eine Änderung wirkt frühestens nach dem nächsten Abholintervall des Shops, also nach 15 oder 30 Minuten.

## Einstellungen, die nur zusammen mit einer anderen Stelle wirken

Das ist die häufigste Fehlerquelle: die Einstellung ist gesetzt, aber die zweite Stelle fehlt.

<table id="bkmrk-einstellung-braucht-"><thead><tr><th>Einstellung</th><th>Braucht zusätzlich</th></tr></thead><tbody><tr><td>Gutscheineingabe</td><td>einen angelegten Gutschein unter *eCom \\ Gutscheinverwaltung*</td></tr><tr><td>Frachtkosten Artikel</td><td>Frachtkosten und Frachtfreigrenze als Mandantenwerte **mit eCom-Kennzeichen**</td></tr><tr><td>Mindestbestellwert aus Debitor anwenden</td><td>gelieferte Debitor-Daten; sonst gilt der Mandantenwert</td></tr><tr><td>Default-Sprache</td><td>Artikeltexte und Warengruppentexte in der gewählten Kultur</td></tr><tr><td>Noch kein Kunde, Haken entfernt</td><td>den Textbaustein *Noch kein Zugang – Hinweis* unter *eCom \\ Texte*</td></tr></tbody></table>

## Shop-Farben über CSS ändern

Die Farbgebung liegt als Freitext im Feld **CSS**. Die Farben stehen als CSS-Variablen in HSL-Notation.

Für eine Umstellung auf Ihre Hausfarbe genügen in der Regel zwei Werte:

1. `--primary` auf Ihre Hausfarbe setzen — dunkle Ausprägung.
2. `--primary-soft` auf denselben Farbwinkel setzen, aber sehr hell.

Die HSL-Notation lautet `hsl(Farbwinkel Sättigung Helligkeit)`. Für heller oder dunkler in derselben Farbe ändern Sie nur den **letzten** Wert. Variablen mit `var(--primary)` übernehmen den Wert der Hauptfarbe automatisch.

> **Achtung:** Zu jeder Farbe gehört eine `-foreground`-Farbe, also die Schrift darauf. Achten Sie auf ausreichenden Kontrast, sonst wird Text im Shop unlesbar.

### Der Seitenhintergrund

Früher erzeugte der Shop aus `--primary` einen **Hintergrundfarbverlauf**. Der ließ sich nur abschalten, indem man seine beiden Endpunkte `--verlauf-warm` und `--verlauf-kalt` von Hand auf dieselbe Farbe setzte.

Dafür gibt es eine eigene Variable. Beide Endpunkte zeigen auf `--shop-hintergrund`, und die wiederum auf `--primary-soft`:

```css
--shop-hintergrund: var(--primary-soft);
--verlauf-warm: var(--shop-hintergrund);
--verlauf-kalt: var(--shop-hintergrund);

```

Weil beide Endpunkte **denselben** Wert haben, ist im Auslieferungszustand **kein Verlauf mehr zu sehen** — der Hintergrund ist einfarbig. Und weil der Wert an `--primary-soft` hängt, passt er sich der Hausfarbe von allein an: Wer `--primary-soft` umstellt, bekommt den passenden Hintergrund dazu.

**Einen anderen Hintergrund setzen.** Dafür genügt jetzt **eine** Zeile statt zweier:

```css
:root {
    --shop-hintergrund: hsl(0 0% 100%);
}

```

**Einen Verlauf haben wollen.** Setzen Sie `--verlauf-warm` und `--verlauf-kalt` einzeln auf zwei **verschiedene** Farben und lassen Sie `--shop-hintergrund` unberührt.

> **Hinweis zur Farbwahl:** Eine kräftige Hauptfarbe wirkt großflächig deutlich stärker als auf einer Schaltfläche. Weil der Hintergrund an `--primary-soft` hängt — also der **hellen**Ausprägung — fällt das weniger ins Gewicht als früher. Sehen Sie sich das Ergebnis trotzdem am fertigen Shop an, bevor Sie die Farbe festschreiben.

### Der Auslieferungszustand und ein Gegenbeispiel

Der Shop wird in **Orange** ausgeliefert. Daneben steht hier eine blaue Palette als Beispiel für eine Umstellung — beide bauen auf **einem** Farbwinkel auf:

<table id="bkmrk-variable-orange-%28aus"><thead><tr><th>Variable</th><th>Orange (Auslieferung)</th><th>Blau (Beispiel)</th></tr></thead><tbody><tr><td><code>&#45;&#45;primary</code></td><td><code>hsl&#40;27 87&#37; 49&#37;&#41;</code></td><td><code>hsl&#40;215 100&#37; 25&#37;&#41;</code></td></tr><tr><td><code>&#45;&#45;primary&#45;soft</code></td><td><code>hsl&#40;27 87&#37; 94&#37;&#41;</code></td><td><code>hsl&#40;215 100&#37; 94&#37;&#41;</code></td></tr><tr><td><code>&#45;&#45;secondary</code></td><td><code>hsl&#40;36 82&#37; 50&#37;&#41;</code></td><td><code>hsl&#40;211 100&#37; 40&#37;&#41;</code></td></tr><tr><td><code>&#45;&#45;accent</code></td><td>wie <code>&#45;&#45;primary</code></td><td>wie <code>&#45;&#45;primary</code></td></tr><tr><td><code>&#45;&#45;ring</code></td><td>wie <code>&#45;&#45;primary</code></td><td>wie <code>&#45;&#45;primary</code></td></tr><tr><td><code>&#45;&#45;shop&#45;hintergrund</code></td><td><code>var&#40;&#45;&#45;primary&#45;soft&#41;</code></td><td>frei wählbar</td></tr><tr><td><code>&#45;&#45;verlauf&#45;warm</code>, <code>&#45;&#45;verlauf&#45;kalt</code></td><td>beide <code>var&#40;&#45;&#45;shop&#45;hintergrund&#41;</code></td><td>beide <code>hsl&#40;0 0&#37; 100&#37;&#41;</code> — weiß, also kein sichtbarer Verlauf</td></tr></tbody></table>

Von `--primary` zu `--primary-soft` bleiben Farbwinkel und Sättigung **gleich**; nur die **Helligkeit** springt — beim Orange von 49 auf 94 Prozent, beim Blau von 25 auf 94. Genau so ist die Notation gedacht: eine Farbe, zwei Helligkeiten.

`--secondary` weicht in beiden Fällen leicht ab — ein paar Grad im Farbwinkel und eine hellere Stufe. Das genügt, damit sich zweitrangige Elemente absetzen, ohne eine zweite Farbe einzuführen.

> **Hinweis:** `--accent` und `--ring` übernehmen die Hauptfarbe. Wer sie nicht ausdrücklich anders haben will, muss sie gar nicht setzen. In der Praxis sind es also **drei** Werte: `--primary`, `--primary-soft` und `--secondary`.

Die vollständige Variablenliste steht in der Leistungsbeschreibung.