> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/shopware/daten-aus-shopware-download-and-matching/attribute-and-eigenschaften-property-groups-abgleichen.md).

# Attribute & Eigenschaften (Property Groups) abgleichen

In Shopware werden Produkteigenschaften wie Farbe, Material, Größe oder technische Merkmale als **Property Groups** (Eigenschaften) mit zugehörigen **Optionen** (Werten) abgebildet. In Business Central entsprechen diese den **Artikelattributen** (Item Attribute) und **Attributwerten** (Item Attribute Value). Damit Filter, Eigenschaftsanzeige und Varianten im Shop weiter funktionieren, müssen beide Welten **verknüpft** werden – ohne dass Attribute doppelt entstehen.

Der Connector bietet dafür die Aktion **Attribute abgleichen**. Sie ist das Gegenstück zum Upload und stellt sicher, dass bereits im Shop vorhandene Eigenschaften wiederverwendet werden.

**Was der Abgleich genau tut**

Die Aktion **Attribute abgleichen** vergleicht die vorhandenen **Shopware-Attribute** anhand ihres **Namens** mit den **BC-Artikelattributen**. Bei einer Übereinstimmung setzt der Connector am Attribut:

* die **Web-ID** (die Shopware-Property-Group-ID),
* das Kennzeichen **Web-Attribut** (das Attribut ist für Shopware relevant) und
* das Kennzeichen **Synchronisiert**.

Wichtig: Der Abgleich legt **keine neuen Attribute** an. Er verknüpft ausschließlich, was auf beiden Seiten bereits existiert. Zu jedem Attribut werden anschließend die **Optionswerte anhand ihres Werts** abgeglichen und ebenfalls verknüpft.

```mermaid
flowchart TD
    A[Attribute abgleichen] --> B{Shopware-Attributname = BC-Attributname?}
    B -->|ja| C[Web-ID, Web-Attribut, Synchronisiert setzen]
    B -->|nein| X[überspringen - keine Neuanlage]
    C --> D{Optionswert = BC-Attributwert?}
    D -->|ja| E[Optionswert verknüpfen]
    D -->|nein| Y[überspringen]
```

**Voraussetzungen für ein erfolgreiches Matching**

Da der Abgleich rein über **Namen** (Attribut) und **Werte** (Option) läuft, entscheidet die **exakte Schreibweise** über Erfolg oder Misserfolg:

* **Attributname identisch:** „Farbe" in BC muss „Farbe" in Shopware entsprechen – nicht „Farben" oder „color".
* **Groß-/Kleinschreibung & Leerzeichen** sollten übereinstimmen.
* **Optionswerte identisch:** „Rot" ↔ „Rot", nicht „rot" vs. „Rot (RAL 3020)".

{% hint style="info" %}
Planen Sie einen **einheitlichen Namensstandard** für Attribute und Werte, bevor Sie mit dem Abgleich beginnen. Das erspart spätere Nacharbeit.
{% endhint %}

**Die Mapping-Tabelle verstehen**

Für die feinere Steuerung stellt der Connector eine **Attribut-Zuordnung** bereit. Dort werden je Eintrag u. a. folgende Informationen geführt:

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Attribut-ID / Attributname</strong></td><td>Verknüpfung des BC-Attributs mit der Shopware-Property-Group.</td></tr><tr><td><strong>Attributwert-ID / Attributwert</strong></td><td>Verknüpfung des einzelnen Optionswerts.</td></tr><tr><td><strong>Attribut-Scope</strong></td><td>Geltungsbereich des Attributs.</td></tr><tr><td><strong>Datentyp &#x26; Backend-Typ</strong></td><td>Technische Ausprägung des Attributs (z. B. Text, Auswahl).</td></tr><tr><td><strong>Pflichtfeld</strong></td><td>Kennzeichnet, ob das Attribut zwingend zu füllen ist.</td></tr></tbody></table>

**Schritt-für-Schritt**

{% stepper %}
{% step %}
**Attribute in BC vorbereiten**

Legen Sie die benötigten Artikelattribute und Werte in Business Central an bzw. pflegen Sie sie. Achten Sie auf die exakte Bezeichnung wie in Shopware.
{% endstep %}

{% step %}
**Abgleich ausführen**

Starten Sie **Attribute abgleichen**. Der Connector verknüpft alle Attribute und Optionswerte, deren Namen/Werte übereinstimmen.
{% endstep %}

{% step %}
**Ergebnis prüfen**

Kontrollieren Sie, ob **Web-ID**, **Web-Attribut** und **Synchronisiert** gesetzt sind. Nicht verknüpfte Einträge deuten auf abweichende Bezeichnungen hin.
{% endstep %}

{% step %}
**Namen angleichen & wiederholen**

Korrigieren Sie abweichende Namen/Werte und führen Sie den Abgleich erneut aus.
{% endstep %}
{% endstepper %}

**Zusammenspiel mit Varianten**

Für **variantenbehaftete Produkte** ist der Attribut-Abgleich die Grundlage: Erst wenn die Property Groups für **Farbe** und **Größe** korrekt verknüpft sind, können die Variantenachsen (Option 1/2/3) sauber zugeordnet werden. Wie Sie die Farb- und Größen-Eigenschaft konfigurieren, lesen Sie unter Varianten abgleichen (Farbe & Größe).

**Fehlerbehebung**

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Attribut bleibt unverknüpft</strong></td><td>Name weicht ab. Bezeichnung exakt an Shopware angleichen und erneut abgleichen.</td></tr><tr><td><strong>Optionswert fehlt</strong></td><td>Wert stimmt nicht überein (Schreibweise/Zusatz). Wert angleichen.</td></tr><tr><td><strong>Neues Attribut in Shopware entstanden</strong></td><td>Es wurde hochgeladen statt abgeglichen. Zuerst abgleichen, dann hochladen.</td></tr></tbody></table>

{% hint style="success" %}
Nach dem erfolgreichen Abgleich werden Attribut-Änderungen künftig als **Aktualisierung** übertragen – die Verknüpfung bleibt bestehen.
{% endhint %}

### Häufige Fragen

#### Über welche API-Endpunkte werden Attribute in Shopware angelegt?

Attribute werden als Property Groups abgebildet: Die Eigenschaft (Gruppe) wird über `property-group` angelegt, die einzelnen Optionswerte über `property-group-option`. Im Connector übernehmen das die Prozeduren `Upload_ItemAttribute` (Gruppe) und `Upload_ItemAttributeValue` (Optionen).

#### Wie werden Attribut-Übersetzungen gepflegt?

Übersetzungen von Attributnamen und Optionswerten laufen über die Sprachzuordnung im „SOUSHW Mapping“ (Modul Language). Je hinterlegter Sprache wird der Wert per Sprach-Header gezielt aktualisiert, sodass die Attribute in allen aktiven Shopsprachen korrekt erscheinen.


---

# 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://docs.solutioo.de/shopware/daten-aus-shopware-download-and-matching/attribute-and-eigenschaften-property-groups-abgleichen.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.