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

# Weitere Informationen zur Bestellung abfragen

> Wie Sie in WEBSALE V8s Referenztexte, ein Kommentarfeld und Einwilligungen zur Werbung im Bestellablauf abfragen und in den Bestelldaten übergeben.

Nicht alles, was zu einer Bestellung gehört, steht in der Adresse. Ein Firmenkunde braucht seine Kostenstelle auf der Rechnung, ein Käufer möchte eine Lieferhinweis mitgeben, und für Werbung brauchen Sie eine dokumentierte Einwilligung.

Für diese drei Fälle bietet WEBSALE V8s eigene Felder an. Alle drei laufen mit den Bestelldaten weiter und stehen damit auch einem angebundenen Warenwirtschaftssystem zur Verfügung.

| Feld | Art | Grenze |
| - | - | - |
| Zwei Referenztexte | einzeiliges Eingabefeld | je 50 Zeichen |
| Zusatzinformation | mehrzeiliges Textfeld | 32.000 Zeichen |
| Zwei Einwilligungen zur Werbung | Auswahlkästchen | protokolliert mit IP, Datum und Uhrzeit |

Freischalten müssen Sie keines davon. Sie bauen die Felder in Ihre Templates ein, und der Shop nimmt sie entgegen.

## Referenztexte

Zwei optionale einzeilige Felder, gedacht für Angaben, die der Käufer selbst zuordnet: eine Bestellnummer aus seinem eigenen System, eine Kostenstelle, eine Projektkennung. Was er einträgt, erscheint in den Bestelldaten und kann von dort auf Rechnung oder Adressetikett wandern.

### Schritt 1: Beschriftung in den Bestelldaten festlegen

Dieser Schritt ist optional, aber ohne ihn stehen die Texte unbeschriftet in den Bestelldaten. Tragen Sie in der `shop.config` im Abschnitt `<OrderConditions>` ein, unter welcher Bezeichnung die beiden Texte dort auftauchen sollen.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<OrderConditions>
   ReferenceText-Txt  = Bestellreferenz
   ReferenceText2-Txt = zweite Bestellreferenz
</OrderConditions>
```

Diese Bezeichnung gilt für die Bestelldaten, nicht für das Template. Die Beschriftung, die der Käufer im Formular sieht, schreiben Sie selbst in Ihr HTML.

Referenz: [Abschnitt OrderConditions](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/warenkorb-und-bestellprozess.md#orderconditions)

### Schritt 2: Felder ins Template setzen

Die Felder gehören auf ein Template des Bestellablaufs, beispielsweise die Zahlungsartenseite oder die Bestellübersicht.

Anders als die meisten Eingabefelder haben die Referenztexte **kein zugehöriges `_input`-Tag**. Die Feldnamen sind fest vorgegeben und lauten `input_order_ref_text` und `input_order_ref_text2`.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{!WS-OrderRefText}
   <label for="input_order_ref_text">Ihre Bestellreferenz</label>
   <input type="text" name="input_order_ref_text" id="input_order_ref_text"
      value="~WS-OrderRefText~" maxlength="50">
{/!WS-OrderRefText}

{WS-OrderRefText}
   Ihre Bestellreferenz: ~WS-OrderRefText~
{/WS-OrderRefText}
```

Für den zweiten Text tritt überall `2` an den Namen: `{WS-OrderRefText2}` und `input_order_ref_text2`.

Das Muster dahinter ist immer dasselbe. Die negierte Klammerung `{!WS-OrderRefText}` greift, solange noch nichts eingetragen ist, und zeigt das Eingabefeld. Die einfache Klammerung `{WS-OrderRefText}` greift, sobald etwas eingetragen ist, und gibt den Text aus.

Das `value`-Attribut im Eingabefeld ist kein Widerspruch dazu. Es sorgt dafür, dass eine bereits gemachte Eingabe nicht verlorengeht, wenn die Seite wegen eines anderen Fehlers erneut angezeigt wird.

Referenz: [WS-OrderRefText](https://dokumentation.websale.de/v8s/referenz/tags/ws/bestellprozess-adressen-und-pruefungen.md#die-tags-im-uberblick) · [WS-OrderRefText2](https://dokumentation.websale.de/v8s/referenz/tags/ws/bestellprozess-adressen-und-pruefungen.md#freie-eingaben-des-kaufers)

### Schritt 3: Zeichen herausfiltern

Referenztexte laufen in Fremdsysteme weiter, und manche davon stolpern über Sonderzeichen. Sie können deshalb Zeichen angeben, die der Shop beim Einlesen entfernt.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<OrderConditions>
   ReferenceText-RemoveSigns  = *|~%${}<>§@
   ReferenceText2-RemoveSigns = *|~%${}<>§@
</OrderConditions>
```

Die Zeichen werden entfernt, nicht beanstandet. Der Käufer bekommt keine Fehlermeldung, sein Text kommt nur gekürzt an. Nehmen Sie deshalb nur auf, was Ihr Zielsystem wirklich stört.

## Zusatzinformation in einem Kommentarfeld

Ein mehrzeiliges Feld für alles, was der Käufer sonst noch loswerden möchte: ein Lieferhinweis, eine Nachfrage, ein Geschenkvermerk. Bis zu 32.000 Zeichen.

### Schritt 1: Kommentarfeld ins Template setzen

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{!WS-OrderSpecialInput}
   <label for="~WS-OrderSpecialInput_input~">Ihre Anmerkung zur Bestellung</label>
   <textarea name="~WS-OrderSpecialInput_input~" id="~WS-OrderSpecialInput_input~"
      rows="8" maxlength="32000">~WS-OrderSpecialInput~</textarea>
{/!WS-OrderSpecialInput}

{WS-OrderSpecialInput}
   Ihre Anmerkung: ~WS-OrderSpecialInput~
{/WS-OrderSpecialInput}
```

Hier gibt es das `_input`-Tag, anders als bei den Referenztexten. Verwenden Sie es, statt den Feldnamen selbst zu schreiben.

Referenz: [WS-OrderSpecialInput](https://dokumentation.websale.de/v8s/referenz/tags/ws/bestellprozess-adressen-und-pruefungen.md#die-tags-im-uberblick) · [WS-OrderSpecialInput\_input](https://dokumentation.websale.de/v8s/referenz/tags/ws/bestellprozess-adressen-und-pruefungen.md#die-tags-im-uberblick)

### Schritt 2: Zeichen herausfiltern

Wie bei den Referenztexten, hier im eigenen Abschnitt `<OrderSpecialInput>`.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<OrderSpecialInput>
   RemoveSigns = *|~%${}<>§@
</OrderSpecialInput>
```

> [!WARNING]
>
> Der Parameter `Txt` in diesem Abschnitt hat keine Wirkung mehr. Hat der Käufer etwas eingetragen, erscheint die Zusatzinformation immer in einem eigenen Abschnitt der Bestelldaten.

Referenz: [Abschnitt OrderSpecialInput](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/warenkorb-und-bestellprozess.md#orderspecialinput)

## Einwilligung zur Werbung abfragen

Zwei getrennte Einwilligungen lassen sich abfragen: die Weitergabe der Adresse an Dritte zu Werbezwecken und die Telefonwerbung. Jede bekommt ihr eigenes Auswahlkästchen, denn sie müssen getrennt erteilt werden können.

Jede Entscheidung, die Zustimmung ebenso wie die Ablehnung, protokolliert der Shop mit IP-Adresse, Kundennummer sofern vorhanden, Datum und Uhrzeit. An ein angebundenes Warenwirtschaftssystem geht die Entscheidung mit den Bestelldaten weiter.

> [!WARNING]
>
> Die Formulierungen neben den Kästchen sind rechtlich bindende Einwilligungserklärungen. Stimmen Sie sie mit Ihrem Datenschutzbeauftragten oder Rechtsbeistand ab. Die Beispiele auf dieser Seite sind Platzhalter, keine geprüften Texte.

### Schritt 1: Kästchen ins Template setzen

Die beiden Tags geben jeweils ein vollständiges Auswahlkästchen aus. Sie schreiben nur den Text daneben.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<label>
   ~WS-CheckAddressSharing~
   Ich stimme der Weitergabe meiner Adresse an Dritte zu Werbezwecken zu.
</label>

<label>
   ~WS-CheckTeleMarketing~
   Ich willige ein, telefonisch über weitere Produkte und Angebote informiert zu werden.
</label>
```

Empfohlener Ort ist die Seite mit Rechnungs- und Lieferadresse (`ws_address_combined.htm`) und zusätzlich die Bestellübersicht (`ws_place_order.htm`), falls der Käufer sich dort noch nicht entschieden hat.

Jedes der beiden Tags gibt zwei Formularfelder aus: das sichtbare Auswahlkästchen und ein unsichtbares Feld daneben. Erst das unsichtbare Feld sagt dem Shop, dass auf dieser Seite überhaupt gefragt wurde. Beide müssen deshalb innerhalb des `<form>` stehen, das abgeschickt wird. Steht das Tag außerhalb, wertet der Shop gar nichts aus, und der bisherige Zustand bleibt unverändert.

Das Auswahlkästchen kommt bereits angehakt, wenn die Einwilligung schon vorliegt. Für eigene Gestaltung tragen die Kästchen die Klassen `check_address_sharing` beziehungsweise `check_tele_marketing`.

Referenz: [WS-CheckAddressSharing](https://dokumentation.websale.de/v8s/referenz/tags/ws/bestellprozess-adressen-und-pruefungen.md#die-tags-im-uberblick) · [WS-CheckTeleMarketing](https://dokumentation.websale.de/v8s/referenz/tags/ws/bestellprozess-adressen-und-pruefungen.md#die-tags-im-uberblick) · Styles für Zustimmung zu Werbung

### Schritt 2: Anzeige vom bisherigen Zustand abhängig machen

Wer schon zugestimmt hat, soll nicht auf jeder Seite erneut gefragt werden. Dafür gibt es die beiden Bereichs-Tags `{ST-AddressSharing(…)}` und `{ST-TeleMarketing(…)}`. In die Klammer schreiben Sie die Zustände, bei denen der Bereich erscheinen soll, mehrere davon durch Komma getrennt.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{ST-AddressSharing(0,3)}
   <label>
      ~WS-CheckAddressSharing~
      Ich stimme der Weitergabe meiner Adresse an Dritte zu Werbezwecken zu.
   </label>
{/ST-AddressSharing(0,3)}
```

Das Kästchen erscheint damit nur, solange der Käufer noch nicht zugestimmt hat.

| Zustand | Bedeutung |
| - | - |
| `0` | noch nicht gesetzt, der Käufer wurde nie gefragt |
| `2` | Einwilligung telefonisch erteilt |
| `3` | im Shop abgelehnt oder nicht erteilt |
| `4` | im Shop erteilt |

> [!WARNING]
>
> Diese beiden Tags gibt es nur als Bereichsklammerung, mit oder ohne Ausrufezeichen. Als Einzeltag oder als Schleife funktionieren sie nicht. Die Klammer mit der Zustandsliste ist außerdem Pflicht: `{ST-AddressSharing}` ohne Klammer wird nicht erkannt.

Für die Telefonwerbung gilt dasselbe mit `{ST-TeleMarketing(0,3)}`.

Referenz: [ST-AddressSharing](https://dokumentation.websale.de/v8s/referenz/tags/st/seitenzustand-und-navigation.md) · [ST-TeleMarketing](https://dokumentation.websale.de/v8s/referenz/tags/st/seitenzustand-und-navigation.md)

## Verwandte Themen

* Wegweiser: [Rechnungsadresse abfragen](https://dokumentation.websale.de/v8s/adressdaten/rechnungsadresse-abfragen.md)
* Wegweiser: [Prüfungen von Adressdaten festlegen, für Pflichtfelder und inhaltliche Prüfungen](https://dokumentation.websale.de/v8s/adressdaten/pruefungen-von-adressdaten-festlegen.md)
* Wegweiser: [Einstellungen für Rechnungs- und Lieferadressen festlegen](https://dokumentation.websale.de/v8s/adressdaten/einstellungen-fuer-rechnungs-und-lieferadressen-festlegen.md)


## Related topics

- [Bestellprozess, Adressen und Prüfungen](https://dokumentation.websale.de/v8s/referenz/tags/ws/bestellprozess-adressen-und-pruefungen.md)
- [Styles für Kunde und Adressen](https://dokumentation.websale.de/v8s/referenz/styles/kunde-und-adressen.md)
- [Rechnungsadresse abfragen](https://dokumentation.websale.de/v8s/adressdaten/rechnungsadresse-abfragen.md)
- [API Basics](https://dokumentation.websale.de/schnittstellen/admin-interface-api/api-basics.md)
- [Schnellbestellung](https://dokumentation.websale.de/v8s/weitere-funktionen-im-bestellprozess-kontext/schnellbestellung.md)


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