> 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/haufige-fragen-faq/faq-artikel-and-katalog.md).

# FAQ – Artikel & Katalog

### Warum wird mein Artikel nicht nach Shopware hochgeladen?

Ein Artikel wird nur übertragen, wenn er als **Web Artikel = Ja** markiert ist. Zusätzlich müssen Beschreibung, Preis und die **MwSt.-Produktbuchungsgruppe** gepflegt sein, da daraus der Shopware-Steuersatz ermittelt wird. Den Upload starten Sie über *Aktionen → Shopware → Produkt hochladen*.

### Warum ist mein Artikel im Shop nicht sichtbar, obwohl er hochgeladen wurde?

Meist fehlt die **Verkaufskanal-Zuweisung**: Ein Produkt ist nur in den Kanälen sichtbar, denen es zugewiesen ist. Prüfen Sie außerdem, ob der Artikel in Shopware aktiv und einer Kategorie zugeordnet ist. Siehe Vertriebskanäle am Artikel.

### Kann ein Artikel mehreren Kategorien zugeordnet werden?

Ja. Über das Feld **Shopware Kategorien** ist eine **Multikategorie-Zuordnung** möglich, auch wenn Business Central nativ nur eine Kategorie vorsieht. So erscheint ein Produkt gleichzeitig in mehreren Shop-Kategorien.

### Wie übertrage ich formatierte Produktbeschreibungen (fett, Listen)?

Über den **Marketingtext** des Artikels, der als HTML an Shopware übergeben wird. Dadurch bleiben Formatierungen wie **fett**, *kursiv* oder Aufzählungen erhalten. Siehe Marketingtext & Rich-Content.

### Kann ich bereits bestehende Shopware-Produkte übernehmen, statt sie neu anzulegen?

Ja. Der Connector gleicht bestehende Produkte anhand der **SKU/productNumber** mit den BC-Artikeln ab und verknüpft die Web-ID. Bilder, Attribute und Kategorien können dabei übernommen werden. Siehe Artikel-Matching & Datenübernahme.

### Wie funktionieren Varianten bzw. konfigurierbare Artikel?

Ein übergeordneter (konfigurierbarer) Artikel bündelt die Varianten über **Option 1–3** (z. B. Farbe, Größe). Der Connector legt den übergeordneten Artikel und die zugehörigen Varianten in Shopware an. Details unter Konfigurierbare Artikel.

### Wie lade ich mehrere Produktbilder pro Artikel hoch?

Hinterlegen Sie mehrere Bilder am Artikel; der Connector überträgt sie inklusive Coverbild und Reihenfolge. Siehe Artikelbilder.

### Wie pflege ich mehrsprachige Produktdaten?

Name und Beschreibung können pro Sprache übertragen werden – auf Basis der Artikelübersetzungen und des sprachabhängigen Marketingtexts. Voraussetzung ist die Sprachzuordnung. Siehe Mehrsprachige Artikeldaten.

### Wie setze ich SEO-Metadaten (Meta-Titel und Meta-Beschreibung)?

Meta-Titel, Meta-Beschreibung und Keywords lassen sich sprachabhängig pflegen und nach Shopware übertragen – für übergeordnete Artikel und Kategorien. Siehe SEO-Metadaten.

### Wie aktualisiere ich sehr viele Artikel gleichzeitig?

Nutzen Sie den Massen-Upload-Report mit der Option *Nur offene Daten*, um ausschließlich geänderte Artikel zu übertragen. Große Kataloge übertragen Sie am besten außerhalb der Geschäftszeiten.

### Wie gebe ich einen Artikel für die Übertragung nach Shopware frei?

Setzen Sie auf der Artikelkarte in Business Central das Feld **Web-Artikel = Ja**. Nur so markierte Artikel werden vom Shopware 6 API Connector berücksichtigt. Nach dem ersten erfolgreichen Upload wird die **Web-ID** automatisch gefüllt und der Artikel ist mit dem Shopware-Produkt verknüpft.

### Warum erscheint mein Artikel nicht im Shop, obwohl er hochgeladen wurde?

Häufige Ursachen: Der Artikel ist keinem **Verkaufskanal** zugeordnet, er ist in Shopware nicht **aktiv** geschaltet, es fehlt ein **Preis** für den entsprechenden Kanal, oder er ist keiner sichtbaren **Kategorie** zugeordnet. Prüfen Sie außerdem, ob der Lagerbestand und die Sichtbarkeitseinstellungen im Verkaufskanal korrekt sind.

### Was ist der Unterschied zwischen einfachen und konfigurierbaren Artikeln?

Ein **einfacher Artikel** ist ein einzelnes Produkt ohne Varianten. Ein **konfigurierbarer Artikel** (Variantenartikel) besitzt einen übergeordneten Artikel und mehrere Kind-Artikel, die über Eigenschaften wie Farbe und Größe unterschieden werden. Der Connector bildet konfigurierbare Artikel als Shopware-Produkt mit Varianten ab. Details unter Konfigurierbare Artikel und Varianten abgleichen.

### Wie übertrage ich Artikelbilder nach Shopware?

Bilder werden aus Business Central an das Produkt in Shopware übertragen. Sie können ein **Standardbild (Cover)** sowie **zusätzliche Bilder** hinterlegen. Beim Download-Weg lassen sich außerdem bestehende Medien-Zuordnungen aus Shopware abrufen. Details unter Artikelbilder sowie Produktbilder & Medien-Infos abrufen.

### Wie synchronisiere ich mehrsprachige Produktdaten?

Pflegen Sie Übersetzungen für Name, Beschreibung und SEO-Felder je Sprache in Business Central. Der Connector überträgt die Übersetzungen an die entsprechenden Sprach-Varianten des Shopware-Verkaufskanals. So erhalten internationale Shops korrekte Inhalte je Sprache. Details unter Mehrsprachige Artikeldaten.

### Kann ich Produktbeschreibungen mit KI erstellen lassen?

Ja. Über die KI-Unterstützung (Copilot) können Sie Marketingtexte und Produktbeschreibungen direkt in Business Central generieren und anschließend nach Shopware übertragen. Das spart Zeit bei der Katalogpflege. Details unter KI-Unterstützung (Copilot).


---

# 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/haufige-fragen-faq/faq-artikel-and-katalog.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.
