> 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/varianten-abgleichen-farbe-and-grosse.md).

# Varianten abgleichen (Farbe & Größe)

Viele Shops arbeiten mit **Variantenprodukten** – etwa einem T-Shirt in mehreren Farben und Größen. In Shopware bildet ein **übergeordnetes Produkt (Parent)** die gemeinsame Klammer, während die einzelnen **Varianten (Kind-Produkte)** die konkreten Ausprägungen darstellen. Der Connector unterstützt dieses Modell und kann vorhandene Varianten den BC-Artikeln zuordnen.

**Das Variantenmodell**

* Der **übergeordnete Artikel** (in BC als „Parent Item" geführt) kann beim Abgleich **automatisch angelegt** werden.
* Die zugehörigen **Kind-Artikel** werden mit dem Parent verknüpft.
* Die Variantenachsen werden als **Option 1, Option 2 und Option 3** abgebildet – typischerweise Farbe und Größe.

```mermaid
flowchart TD
    P[Übergeordneter Artikel T-Shirt] --> V1[Variante Rot / S]
    P --> V2[Variante Rot / M]
    P --> V3[Variante Blau / L]
```

**Farb- und Größen-Eigenschaft konfigurieren**

Damit der Connector weiß, **welche Property Group** die Farb- bzw. Größenachse darstellt, hinterlegen Sie das in der Shopware Konfiguration:

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Farb-Attribut Label</strong></td><td>Bezeichnung der Farb-Eigenschaft in Shopware (Standard: „Color").</td></tr><tr><td><strong>Größen-Attribut Label</strong></td><td>Bezeichnung der Größen-Eigenschaft in Shopware (Standard: „Size").</td></tr><tr><td><strong>Farb-Attribut ID</strong></td><td>Technische ID der Farb-Property-Group.</td></tr><tr><td><strong>Größen-Attribut ID</strong></td><td>Technische ID der Größen-Property-Group.</td></tr><tr><td><strong>Standard-Attributset</strong></td><td>Das Attributset, das für Varianten verwendet wird.</td></tr><tr><td><strong>Modell als konfigurierbar verwenden</strong></td><td>Steuert, ob das Modell als konfigurierbares (Varianten-)Produkt behandelt wird.</td></tr></tbody></table>

{% hint style="info" %}
Die **Labels** müssen zu den tatsächlichen Property-Group-Namen im Shop passen. Die **IDs** verweisen auf die konkrete Property Group und werden für die eindeutige Zuordnung genutzt.
{% endhint %}

**Voraussetzung: Attribute vorher abgleichen**

Varianten funktionieren nur, wenn die zugrunde liegenden **Property Groups** (Farbe, Größe) und deren **Optionen** korrekt verknüpft sind. Führen Sie deshalb zuerst den Attribut-Abgleich durch – siehe Attribute & Eigenschaften (Property Groups) abgleichen.

**Schritt-für-Schritt**

{% stepper %}
{% step %}
**Eigenschaften konfigurieren**

Hinterlegen Sie Label und ID für Farbe und Größe sowie das Standard-Attributset in der Konfiguration.
{% endstep %}

{% step %}
**Attribute abgleichen**

Verknüpfen Sie die Property Groups und Optionswerte.
{% endstep %}

{% step %}
**Produkte matchen**

Führen Sie den Produktabgleich aus. Übergeordnete Artikel werden angelegt, Kind-Artikel inkl. Option 1/2/3 verknüpft.
{% endstep %}

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

Kontrollieren Sie am übergeordneten Artikel, ob die Varianten korrekt zugeordnet sind.
{% endstep %}
{% endstepper %}

**Fehlerbehebung**

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Variante wird nicht erkannt</strong></td><td>Farb-/Größen-Label oder -ID falsch. Konfiguration prüfen.</td></tr><tr><td><strong>Option fehlt</strong></td><td>Optionswert wurde nicht abgeglichen – zuerst Attribute/Optionen verknüpfen.</td></tr><tr><td><strong>Parent fehlt</strong></td><td>Prüfen, ob „Modell als konfigurierbar verwenden" aktiviert ist.</td></tr></tbody></table>

### Häufige Fragen

#### Wie werden Varianten mit ihrem Hauptartikel verknüpft?

Die Verknüpfung erfolgt über das Feld „SOUSHW Parent No“, das auf den übergeordneten Artikel (SOUSHW Parent Item) verweist. Die variantenbildenden Merkmale wie Farbe und Größe werden als Property Groups (Attribute) übertragen und in Shopware als Variantenachsen genutzt.


---

# 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/varianten-abgleichen-farbe-and-grosse.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.