# Artikelattribute

Artikelattribute ermöglichen es, zusätzliche Eigenschaften zu Artikeln zu definieren, die in Shopware als Produkteigenschaften oder Spezifikationen angezeigt werden.

## 1. Attribute in Business Central

### 1.1 Attribute anlegen

1. Navigieren Sie zu "*Artikel"* <i class="fa-right">:right:</i> *"Artikelattribute".*
2. Erstellen Sie neue Attribute (z.B. Farbe, Material, Größe)
3. Definieren Sie die möglichen Werte.

<div align="left" data-with-frame="true"><figure><img src="/files/2zxlMT4VsdlD7IMgvkPC" alt=""><figcaption></figcaption></figure></div>

<div align="left" data-with-frame="true"><figure><img src="/files/FTLNUdb0U2rm5mMjhQo1" alt=""><figcaption></figcaption></figure></div>

### 1.2 Attribute zuweisen

1. Öffnen Sie die *"Artikelkarte".*
2. Navigieren Sie zu "*Zugehörig"* <i class="fa-right">:right:</i> *"Artikel"* <i class="fa-right">:right:</i> *"Attribute".*
3. Weisen Sie die gewünschten Attribute und Werte zu.

<div align="left" data-with-frame="true"><figure><img src="/files/BvDnOUYed39RepceVLS9" alt="" width="359"><figcaption></figcaption></figure></div>

## 2. Attribut-Synchronisation

### 2.1 Attribut-Mapping/Zuordnung

Attribute werden automatisch zu Shopware synchronisiert, wenn:

* Das Attribut einem *"Web-Artikel"* zugewiesen ist.
* Das Attribut in der Mapping-Tabelle zugeordnet ist.

### 2.2 Mapping/Zuordnung einrichten

1. Öffnen Sie *"Shopware"* <i class="fa-right">:right:</i> *"Zuordnung"/"Mapping"*
2. Wählen Sie *"Modulname-Filter"*
3. Ordnen Sie BC-Attribute den Shopware-Eigenschaften zu.

<div align="left" data-with-frame="true"><figure><img src="/files/OdCzAIprdfmXwYzmTa8q" alt=""><figcaption></figcaption></figure></div>

<div align="left" data-with-frame="true"><figure><img src="/files/O6IZmQkaD8gWBm69Y5R0" alt=""><figcaption></figcaption></figure></div>

## 3. Attributwerte

### 3.1 Wertetypen

Business Central unterstützt verschiedene Wertetypen:

<table><thead><tr><th width="105.7950439453125">Typ</th><th width="290.436767578125">Beschreibung</th><th width="176.5087890625">Beispiel</th></tr></thead><tbody><tr><td><strong>Option</strong></td><td>Auswahl aus vordefinierten Werten</td><td>Rot, Blau, Grün</td></tr><tr><td><strong>Text</strong></td><td>Freitext</td><td>"Premium Qualität"</td></tr><tr><td><strong>Ganzzahl</strong></td><td>Ganze Zahlen</td><td>42</td></tr><tr><td><strong>Dezimal</strong></td><td>Dezimalzahlen</td><td>3.14</td></tr></tbody></table>

### 3.2 Werte synchronisieren

Attributwerte werden automatisch zu Shopware übertragen:

{% stepper %}
{% step %}
Als Eigenschaften für Filterfunktionen.
{% endstep %}

{% step %}
In den Spezifikationen auf der Produktseite.
{% endstep %}
{% endstepper %}

## 4. Varianten und Properties

### 4.1 Was sind Shopware Properties?

**Shopware Properties** sind Produkteigenschaften, mit denen sich Artikel in **Shopware** strukturiert beschreiben und filtern lassen. Sie dienen dazu, Merkmale wie Größe, Farbe, Material oder technische Spezifikationen standardisiert abzubilden.

Im Unterschied zu Varianten (z. B. Größe S, M, L als auswählbare Ausprägungen eines Produkts) sind Properties meist rein beschreibend. Sie erscheinen typischerweise in den Produktdetails und werden häufig für Filterfunktionen in Kategorien verwendet, damit Kunden gezielt nach bestimmten Merkmalen suchen können

Verwendung bspw. für:

* Filternavigation im Shop
* Produktvergleiche
* Suchergebnisse

### 4.2 Shopware Options (Varianten)

Für Produktvarianten (z.B. T-Shirt in verschiedenen Größen):

1. Erstellen Sie in BC einen *"Stammartikel"*
2. Definieren Sie *"Varianten"* mit unterschiedlichen Attributwerten.
3. Synchronisieren Sie den Stammartikel zu Shopware.

{% hint style="info" %}
Die Varianten-Funktion erfordert eine entsprechende Konfiguration und ist nicht in allen Versionen verfügbar.
{% endhint %}

## 5. Best Practices

{% tabs %}
{% tab title="Attributstruktur" %}

* Verwenden Sie konsistente Attributnamen.
* Definieren Sie klare Wertelisten.
* Vermeiden Sie Duplikate und Ähnlichkeiten.
  {% endtab %}

{% tab title="Performance" %}

* Beschränken Sie die Anzahl der Attribute pro Artikel.
* Nutzen Sie Options-Attribute statt Freitext wo möglich.
* Prüfen Sie die Synchronisations-Logs auf Fehler.
  {% endtab %}
  {% endtabs %}


---

# Agent Instructions: 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:

```
GET https://docs.solutioo.de/shopware/stammdatenverwaltung/artikelattribute.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.