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

# Webcodes für Produkte anbieten

> Wie Sie in WEBSALE V8s Webcodes aus Katalogen und Anzeigen als Eingabefeld im Shop umsetzen, wahlweise über ein eigenes Produktfeld oder über die Produktnummer.

Ein Webcode ist eine kurze Kennung, die neben einem Produkt im Katalog, in der Anzeige oder in der Broschüre abgedruckt wird. Der Leser tippt sie im Shop in ein Eingabefeld und landet beim passenden Produkt.

Der Nutzen zeigt sich bei großen Sortimenten. Statt Produktnamen abzutippen oder sich durch die Kategorien zu klicken, gibt der Käufer fünf Zeichen ein. Je mehr Produkte ein Druckerzeugnis zeigt, desto mehr lohnt sich das.

Geht es nur um wenige Produkte oder Kategorien und soll der Leser ohne Umweg über ein Eingabefeld direkt dort landen, ist eine Kurzadresse für Kampagnen das passendere Mittel. Diese richten Sie im Online-Servicebereich ein.

Technisch ist ein Webcode nichts anderes als eine Suche, die auf ein einziges Produktfeld eingeschränkt ist. Welches Feld das ist, unterscheidet die beiden möglichen Varianten.

## Variante 1: eigenes Webcode-Feld

Hier bekommt der Webcode ein eigenes Produktdatenfeld und ist damit unabhängig von der Produktnummer.

Das lohnt sich, wenn die Codes kurz und sprechend sein sollen, während die Produktnummern lang und technisch sind. Der Katalog zeigt dann `1X2Y3` statt einer vierzehnstelligen Artikelnummer.

### Einrichtung

1. Legen Sie ein freies Produktdatenfeld an und nennen Sie es sinnvollerweise `Webcode`.
2. Aktivieren Sie es im WSPManager für die Suche im Online-Shop.
3. Tragen Sie es in der `shop.config` als Suchfeld ein.
4. Pflegen Sie die Codes je Produkt in Ihrem Warenwirtschaftssystem.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<ProductItemSearch>
   FreeField1     = webcode
   FreeField1-Txt = Webcode
</ProductItemSearch>
```

Wegweiser: [Erweiterte Suche](https://dokumentation.websale.de/v8s/suche/erweiterte-suche.md)

### Eingabefeld im Template

Das Formular entspricht der Schnellsuche, wird aber über ein verstecktes Feld auf den Webcode eingeschränkt. Der Käufer bekommt keine Auswahlliste zu sehen, er soll ja nur seinen Code eintippen.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<form action="~FORM-Search~" name="Search" method="post">
   <label for="webcode">Webcode aus dem Katalog</label>
   <input type="text" id="webcode" name="~WS-Search_Input~" value="~WS-Search~">
   <input type="hidden" name="product_item" value="webcode">
   <input type="submit" value="Produkt anzeigen">
</form>
```

Der Wert des versteckten Feldes ist der technische Feldname aus der `shop.config`, hier also `webcode`.

## Variante 2: Produktnummer als Webcode

Hier entfällt das zusätzliche Feld. Als Webcode dient die Produktnummer, die im Katalog ohnehin oft schon abgedruckt ist.

Das spart die Pflege eines weiteren Feldes. Dafür sind Sie an das Format Ihrer Produktnummern gebunden, und jede Änderung an der Nummerierung entwertet die bereits gedruckten Kataloge.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<form action="~FORM-Search~" name="Search" method="post">
   <label for="webcode">Bestellnummer aus dem Katalog</label>
   <input type="text" id="webcode" name="~WS-Search_Input~" value="~WS-Search~">
   <input type="hidden" name="product_item" value="number">
   <input type="submit" value="Produkt anzeigen">
</form>
```

Schalten Sie für diese Variante die exakte Produktnummernsuche ein. Ohne sie sucht der Shop nach Teilzeichenfolgen, und ein kurzer Code wie `2345` findet auch `12345` und `123456`. Der Käufer bekäme dann eine Trefferliste statt seines Produkts.

Wegweiser: [Exakte Produktnummernsuche](https://dokumentation.websale.de/v8s/suche/exakte-produktnummernsuche.md)

## Welche Variante passt

| | Variante 1 | Variante 2 |
| - | - | - |
| zusätzliches Produktfeld | ja | nein |
| Codes frei wählbar | ja | nein |
| unabhängig von Änderungen an der Nummerierung | ja | nein |
| Pflegeaufwand | ein Feld je Produkt | keiner |

Variante 2 ist der schnellere Weg und reicht, solange Ihre Produktnummern kurz genug zum Abtippen sind. Sobald Sie kürzere oder besser lesbare Codes drucken wollen, führt kein Weg an Variante 1 vorbei.

## Worauf Sie bei den Codes achten sollten

> [!WARNING]
>
> Der Shop sucht auch im eigenen Webcode-Feld nach Teilzeichenfolgen. Ein Code, der in einem anderen Code enthalten ist, liefert deshalb mehrere Treffer. Vergeben Sie Codes mit einheitlicher Länge, dann kann dieser Fall nicht eintreten.

Zwei weitere Punkte aus der Praxis:

* Vermeiden Sie Zeichen, die sich leicht verwechseln lassen, also die Null gegen das O und die Eins gegen das kleine L. Der Code wird vom Papier abgetippt, oft ohne genaues Hinsehen.
* Bindestriche im Code sind heikel, weil der Shop sie in Leerzeichen wandelt und der Code dann als zwei Suchwörter ankommt. Bleiben Sie bei Buchstaben und Ziffern.

## Verwandte Themen

* Wegweiser: [Schnellsuche, für den Aufbau des Formulars](https://dokumentation.websale.de/v8s/suche/schnellsuche.md)
* Wegweiser: [Exakte Produktnummernsuche](https://dokumentation.websale.de/v8s/suche/exakte-produktnummernsuche.md)
* Wegweiser: [Werbemittelkennzeichen (Inserts) nutzen, wenn Sie zusätzlich erfassen wollen, aus welchem Katalog eine Bestellung stammt](https://dokumentation.websale.de/v8s/produkte/werbemittelkennzeichen-inserts-nutzen.md)


## Related topics

- [Upload-Produkte anbieten](https://dokumentation.websale.de/v8s/produkte/upload-produkte-anbieten.md)
- [Download-Produkte anbieten](https://dokumentation.websale.de/v8s/produkte/download-produkte-anbieten.md)
- [Verteilungsprodukte anbieten (Prospektservice)](https://dokumentation.websale.de/v8s/produkte/verteilungsprodukte-anbieten-prospektservice.md)
- [Gutscheine anbieten: Übersicht](https://dokumentation.websale.de/v8s/gutscheine-anbieten/gutscheine-anbieten-uebersicht.md)
- [Styles für Katalog und Produkte](https://dokumentation.websale.de/v8s/referenz/styles/katalog-und-produkte.md)


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