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

# Konfiguration salutation.dat

> Aufbau der Anredeliste salutation.dat: Spalten, Anredecodes, Geschlechtscodes und die Bildung der vollständigen Anredezeile über die Tags $W-Text, $W-Title und $W-LastName.

Die Konfiguration `salutation.dat` definiert die Anreden, die der Käufer bei der Eingabe seiner Rechnungsadresse und seiner abweichenden Lieferadresse auswählen kann. Dieselbe Datei legt außerdem fest, wie daraus später die vollständige Anredezeile in Briefen und Mails entsteht.

![Konfig Anrede](https://mintcdn.com/websaleag-44ee7ea6/qpKXKLTjn0wDjacH/images/konfig_anrede.png?fit=max\&auto=format\&n=qpKXKLTjn0wDjacH\&q=85\&s=2ec39ba1322026964ba2c9539c475994)

Wegweiser: [Bildung von Anreden und Titeln festlegen, Auswahllisten der Adressdaten](https://dokumentation.websale.de/v8s/adressdaten/bildung-von-anreden-und-titeln-festlegen.md) · Referenz: Konfiguration title.dat · Grundlagen: [Grundlagen zu Konfigurationen](https://dokumentation.websale.de/v8s/grundlagen-konfiguration/konfiguration-grundlagen.md)

## Wo die Datei liegt

Der Shop sucht die Datei an zwei Stellen, in dieser Reihenfolge:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
konfiguration/<Subshop-ID>/salutation.dat
konfiguration/salutation.dat
```

Zuerst gilt die Datei des Subshops. Ist dort keine vorhanden oder ist sie leer, greift der Shop auf die gemeinsame Datei eine Ebene höher zurück. So pflegen Sie eine Anredeliste für alle Subshops und weichen nur dort ab, wo es nötig ist.

> [!WARNING]
>
> Mindestens eine der beiden Dateien muss vorhanden und nicht leer sein. Findet der Shop keine von beiden oder fehlt die Kopfzeile, bricht er mit einer Fehlermeldung ab.

## Aufbau

Die Datei ist tabulatorgetrennt aufgebaut. Die erste Zeile enthält die Spaltennamen, ab der zweiten Zeile folgt je Anrede eine Zeile.

| Spalte | Bedeutung |
| - | - |
| `Salutation` | der Eintrag, wie er in der Anrede-Auswahlliste erscheint |
| `Country` | dreistelliger ISO-Ländercode. Darüber bildet WEBSALE V8s verschiedene Anredezeilen je nach Shopsprache |
| `Code` | der zweistellige Anredecode, beispielsweise `01` für "Herr" |
| `Sex` | einstelliger Code für das Geschlecht |
| `Text` | der Anredetext, der in die Anredezeile eingesetzt wird |
| `CompleteSalutation` | der Bauplan der vollständigen Anredezeile |

> [!NOTE]
>
> Die Spalten werden über ihre Namen in der Kopfzeile gefunden, nicht über ihre Position. Die Reihenfolge der Spalten ist damit frei, die Schreibweise der Namen dagegen nicht. Mehr als zehn Spalten wertet der Shop nicht aus.
>
> Das Modul für Formulare und Anfragen bricht sogar mit einer Warnung ab, wenn eine der sechs Spalten in der Kopfzeile fehlt.

### Der erste Eintrag bleibt leer

Die zweite Zeile der Datei, also der erste Dateneintrag, sollte in der Spalte `Salutation` leer bleiben. Damit beginnt die Auswahlliste im Shop mit einem leeren Eintrag, und der Käufer trifft eine bewusste Wahl, statt ungewollt die erste Anrede zu übernehmen.

Für diesen leeren Eintrag stellt der Shop dem Anredecode im Formularwert `empty_` voran, also beispielsweise `empty_00`. Beim Auswerten entfernt er das Präfix wieder. Wenn Sie in Formularwerten oder im Quelltext auf `empty_` stoßen, ist das also kein Fehler.

## Anredecode und Geschlechtscode

| Spalte | Regel |
| - | - |
| `Code` | muss für alle Länder gleich vergeben werden |
| `Sex` | muss ebenfalls für alle Länder gleich vergeben werden |

Steht im deutschen Shop "Herr" auf dem Code `01`, dann muss im englischen Shop "Mr." denselben Code `01` tragen. Dasselbe gilt für den Geschlechtscode.

Der Grund liegt in der Weiterverarbeitung: Gespeichert wird der Code, nicht der Text. Nur wenn der Code über alle Sprachen hinweg dieselbe Bedeutung hat, lassen sich Vorname und Titel später korrekt prüfen und eine passende Anrede erzeugen.

> [!WARNING]
>
> Möglicherweise müssen Sie diese Codes mit Ihrem Warenwirtschaftssystem abstimmen. Dort landen sie am Ende ebenfalls.

## Die Anredezeile

In der Spalte `CompleteSalutation` bauen Sie die vollständige Anredezeile aus drei Platzhaltern zusammen.

| Platzhalter | Wird ersetzt durch |
| - | - |
| `$W-Text` | den Inhalt der Spalte `Text` |
| `$W-Title` | den Titel des Käufers |
| `$W-LastName` | den Nachnamen des Käufers |

Die Bildung des Titels legen Sie in der Konfiguration `title.dat` fest.

Referenz: [Konfiguration title.dat](https://dokumentation.websale.de/v8s/referenz/konfigurationen/konfiguration-title-dat.md)

Daraus ergeben sich die typischen Muster:

| `CompleteSalutation` | Ergebnis |
| - | - |
| `$W-Text` | "Sehr geehrte Damen und Herren" |
| `$W-Text $W-Title $W-LastName` | "Sehr geehrter Herr Dr. Müller" |
| `$W-Text $W-LastName` | "Sehr geehrte Familie Müller" |

## Beispiel

Eine `salutation.dat` für die Sprachenkombination Deutsch und Englisch. Die erste Datenzeile ist der leere Eintrag.

| Salutation | Country | Code | Sex | Text | CompleteSalutation |
| - | - | - | - | - | - |
| | `DEU` | `00` | `0` | Sehr geehrte Damen und Herren | `$W-Text` |
| Herr | `DEU` | `01` | `1` | Sehr geehrter Herr | `$W-Text $W-Title $W-LastName` |
| Frau | `DEU` | `02` | `2` | Sehr geehrte Frau | `$W-Text $W-Title $W-LastName` |
| Firma | `DEU` | `05` | `0` | Sehr geehrte Damen und Herren | `$W-Text` |
| Familie | `DEU` | `07` | `0` | Sehr geehrte Familie | `$W-Text $W-LastName` |
| | `GBR` | `00` | `0` | Dear Sir or Madam | `$W-Text` |
| Mr. | `GBR` | `01` | `1` | Dear Mr. | `$W-Text $W-Title $W-LastName` |
| Mrs. | `GBR` | `02` | `2` | Dear Mrs. | `$W-Text $W-Title $W-LastName` |
| Ms. | `GBR` | `06` | `2` | Dear Miss | `$W-Text $W-Title` |
| Family | `GBR` | `07` | `0` | Dear Mr., Dear Mrs. | `$W-Text $W-LastName` |

An diesem Beispiel lässt sich die Code-Regel gut ablesen: `01` bedeutet in beiden Sprachblöcken dasselbe, nämlich die männliche Einzelanrede, und trägt deshalb auch in beiden denselben Geschlechtscode `1`.

Welche Sprache Ihr Shop verwendet, stellen Sie im Abschnitt `Basic` der `shop.config` ein.

Referenz: [shop.config, Grundlagen und Technik](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/grundlagen-und-technik.md)

## Änderungen an der Anredeliste

Der Shop liest die Datei einmal je Aufruf. Änderungen wirken also mit dem nächsten Seitenaufruf.

Eine Zeile, die Sie entfernen, verschwindet aus der Auswahlliste. Für Bestellungen, die den zugehörigen Anredecode bereits gespeichert haben, findet der Shop danach keinen passenden Eintrag mehr und gibt weder Anredetext noch Anredezeile aus. Löschen Sie deshalb besser nur Zeilen, deren Code nie im Einsatz war, und ändern Sie ansonsten nur den Text.


## Related topics

- [Konfiguration title.dat](https://dokumentation.websale.de/v8s/referenz/konfigurationen/konfiguration-title-dat.md)
- [A- (Rechnungsadresse)](https://dokumentation.websale.de/v8s/referenz/tags/a-rechnungsadresse.md)
- [Bildung von Anreden und Titeln festlegen](https://dokumentation.websale.de/v8s/adressdaten/bildung-von-anreden-und-titeln-festlegen.md)
- [Konfigurations-Typen](https://dokumentation.websale.de/v8s/grundlagen-konfiguration/konfigurations-typen.md)
- [Paymorrow](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/paymorrow.md)


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