> For the complete documentation index, see [llms.txt](https://pocketshop.gitbook.io/pocketshop-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pocketshop.gitbook.io/pocketshop-docs/shop/produkte.md).

# Produkte

Im **Produkte**-Modul werden alle verkäuflichen und darstellbaren Artikel des Shops verwaltet – von physischen Produkten über externe Links bis zu Gutscheinen, Tickets oder Mietartikeln. Jedes Produkt kann in mehrere Varianten (SKUs) aufgeteilt werden und ist frei mit Zusatzoptionen, Lagerbestand und Sichtbarkeitsregeln konfigurierbar.

## 🏷️ Basisdaten

* **Name** – Anzeigename des Produkts, mehrsprachig pflegbar.
* **Kategorie / Unterkategorie** – ordnet das Produkt in die Shop-Navigation ein.
* **Marke** – Hersteller- oder Markenname.
* **Beschreibung** – Rich-Text-Beschreibung; kann bei aktivierter KI-Integration per Klick automatisch generiert werden.
* **Produktbilder / Thumbnail** – Galerie-Bilder (bis zu 5) sowie ein quadratisches Vorschaubild für Listen.
* **EAN / Barcode(s)** – Barcode zum Scannen; zusätzliche alternative Barcodes können hinterlegt werden.
* **Externe ID** – Kennung zum Abgleich mit einem externen Kassen- oder Warenwirtschaftssystem.
* **Notiz** – Internes, nur für Admins sichtbares Freitextfeld.

## 🔗 Typ & externe Produkte

Über **Typ** wird festgelegt, wie sich das Produkt verhält:

| Typ                                    | Bedeutung                                                                |
| -------------------------------------- | ------------------------------------------------------------------------ |
| **Artikel**                            | Normales, im Shop verkäufliches Produkt                                  |
| **Extern**                             | Verlinkt auf eine externe Seite statt einen Checkout auszulösen          |
| **Gutschein / Fahrt / Ticket / Reise** | Nur wählbar, wenn die jeweilige Funktion für den Mandanten aktiviert ist |

{% hint style="info" %}
Bei Typ **„Extern“** erscheinen zusätzlich die Felder **Externe URL** (Link-Ziel) und **Aktionstext** (Beschriftung des Buttons).
{% endhint %}

## 💶 Preise, Steuern & Mengenrabatte

* **Preis** – regulärer Verkaufspreis.
* **Preisstaffeln** – zusätzliche Preise ab bestimmten Bestellmengen (z. B. „ab 10 Stück günstiger“), inklusive eigener Sichtbarkeitseinschränkungen je Staffel.
* **UVP / Originalpreis** – wird durchgestrichen neben dem Verkaufspreis angezeigt, um einen Rabatt sichtbar zu machen.
* **Basispreis (Grundpreis)** – Preis pro Einheit (z. B. je kg oder Liter) für die gesetzliche Grundpreisangabe.
* **Einheit** – Bezugseinheit des Grundpreises (z. B. „kg“, „Stück“).
* **MwSt** – anzuwendender Steuersatz.

## 📦 Lagerbestand

* **Auf Lager** – einfacher Schalter, ob das Produkt aktuell verfügbar ist.
* **Lagerverwaltung aktiv** – aktiviert die Mengenverfolgung für dieses Produkt (nur bei aktiver Inventar-Funktion sichtbar).
* **Menge** bzw. **Lagerbestand pro Standort** – je nachdem, ob das Modul „Standorte“ aktiv ist, wird entweder eine einzelne Gesamtmenge oder eine Aufteilung je Standort gepflegt.

## 🧩 Varianten, Zusatzoptionen & Auswahlmöglichkeiten

* **SKU-Liste** – Varianten des Produkts (z. B. Größe, Farbe), jede mit eigenem Namen, Preis, Bild und Lagerbestand.
* **Addons** – optionale, kostenpflichtige Zusatzartikel, die Kund:innen dem Produkt hinzufügen können.
* **Auswahlmöglichkeiten** – konfigurierbare Optionsgruppen (z. B. „Größe wählen“), wahlweise verpflichtend, mit eigenen Preisaufschlägen je Option.

## 🎯 Sichtbarkeit & Einschränkungen

Wie bei allen Modulen steuert der Bereich **Einschränkungen** (verfügbar ab/bis, aktive Segmente, Nutzer:innen, Client) wer das Produkt sehen und kaufen kann. Details dazu: [Filter & Zielgruppenaussteuerung](/pocketshop-docs/personen/filter-and-zielgruppenaussteuerung.md).

Zusätzlich verfügbar:

* **Bewertungen erlaubt** / **Fragen erlaubt** – aktiviert Rezensionen bzw. Kund:innenfragen zum Produkt (jeweils abhängig von der entsprechenden Shop-Funktion).
* **Featured** – hebt das Produkt in einem hervorgehobenen Bereich hervor.
* **Mietbar** – markiert das Produkt als Mietartikel statt Kaufartikel.
* **Käuflich** – legt fest, ob das Produkt tatsächlich bestellt werden kann oder nur zur Anzeige dient.
* **Mindestbestellzeit** – Vorlaufzeit, die vor Abholung/Bearbeitung mindestens eingeplant werden muss.
* **Standort & Wochentage** – verknüpft das Produkt mit einem Standort und den Wochentagen, an denen es dort verfügbar ist (z. B. für Gastronomie-Angebote).

## 💡 Best Practices

* **Thumbnail immer im Quadrat** hochladen, damit Produktlisten einheitlich aussehen.
* **Grundpreis & Einheit** konsequent pflegen, wenn gesetzlich vorgeschrieben (z. B. Lebensmittel, Kosmetik).
* **SKUs statt Duplikate**: Varianten eines Produkts (Farbe, Größe) immer als SKU anlegen, nicht als eigenständiges Produkt.
* **Externe ID** frühzeitig verknüpfen, wenn ein Kassensystem angebunden ist – erleichtert den Abgleich erheblich.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://pocketshop.gitbook.io/pocketshop-docs/shop/produkte.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
