> 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/referenz-and-nachschlagewerk/feldreferenz-artikelkarte.md).

# Feldreferenz Artikelkarte

Diese Referenz listet **alle Shopware-relevanten Felder und Aktionen der Artikelkarte** (sowie der Artikelliste) im Shopware 6 API Connector. Die fachliche Erklärung finden Sie unter „(Einfache) Artikel“, „Konfigurierbare Artikel“ und den weiteren Kapiteln der Stammdatenverwaltung.

### Shopware-Felder am Artikel

Der Connector ergänzt die Artikelkarte um eigene Web-Felder (Präfix `SOUSHW`). Sie steuern Freigabe, Verknüpfung und Synchronisationsstatus.

| Feld                                                              | Bedeutung                                                                             |
| ----------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| **Web Item (Web-Artikel)**                                        | Nur bei *Ja* wird der Artikel nach Shopware übertragen.                               |
| **Web ID**                                                        | Shopware-Produkt-UUID; wird nach dem ersten erfolgreichen Upload automatisch gesetzt. |
| **isSynced (Synchronisiert)**                                     | Kennzeichnet, ob das Produkt aktuell synchronisiert ist.                              |
| **Synced At / Synced Message**                                    | Zeitpunkt und Ergebnis-/Fehlermeldung der letzten Synchronisation.                    |
| **Origin (Herkunft)**                                             | Ursprung des Datensatzes (Standard: `BC`).                                            |
| **Active (Shopware aktiv)**                                       | Steuert, ob das Produkt in Shopware aktiv ist.                                        |
| **Out Of Stock (Nicht vorrätig)**                                 | Erzwingt in Shopware den Bestand 0, unabhängig vom BC-Bestand.                        |
| **Parent No (Übergeordnete Nr.)**                                 | Verweist bei Varianten auf den übergeordneten Artikel.                                |
| **Upload Image**                                                  | Steuert den Bild-Upload für diesen Artikel.                                           |
| **isStock Synced / Stock Synced At**                              | Teil-Sync-Status für den Bestand.                                                     |
| **isPrice Synced / Price Synced At**                              | Teil-Sync-Status für den Preis.                                                       |
| **isImage Synced / Image Synced At**                              | Teil-Sync-Status für Bilder.                                                          |
| **Stock Level Ind 1 / 2**                                         | Anzeige-Indikatoren für den Bestand.                                                  |
| **Shopware Categories**                                           | Pipe-getrennte Liste der zugeordneten Kategorien (Mehrfachzuordnung möglich).         |
| **Shopware Tags**                                                 | Pipe-getrennte Liste der zugeordneten Tags.                                           |
| **Grouped Product ID / Is Grouped Product / Grouped Synced (At)** | Felder für Gruppenartikel.                                                            |
| **Include Main Product**                                          | Legt das Hauptprodukt bei Gruppenartikeln mit in den Warenkorb.                       |

{% hint style="info" %}
Ändern Sie ein synchronisationsrelevantes Feld, setzt der Connector automatisch **isSynced**, **isStock Synced** und **isPrice Synced** zurück – der Artikel wird beim nächsten Lauf erneut übertragen.
{% endhint %}

### Herkunft der Shopware-Werte (Feld-Mapping)

Diese Standard-Artikelfelder bestimmen den Inhalt in Shopware:

| BC-Feld                                        | Shopware-Feld                              |
| ---------------------------------------------- | ------------------------------------------ |
| **Nr.**                                        | `productNumber` (SKU – Matching-Schlüssel) |
| **Beschreibung**                               | `name` (Produktname)                       |
| **Marketingtext**                              | `description` (HTML-Beschreibung)          |
| **GTIN**                                       | `ean`                                      |
| **Basiseinheit**                               | Maßeinheit (`unitId`)                      |
| **MwSt.-Produktbuchungsgruppe**                | Steuersatz (`taxId`)                       |
| **Artikelkategoriecode / Shopware Categories** | Kategoriezuordnung                         |
| **Nettogewicht × Verkaufseinheit**             | `weight`                                   |

### Aktionen auf der Artikelkarte

| Aktion                                  | Funktion                                                                                    |
| --------------------------------------- | ------------------------------------------------------------------------------------------- |
| **Upload Product**                      | Lädt den Artikel einzeln hoch; setzt bei Bedarf „Web Item“ und „Active“.                    |
| **Import Default Images**               | Importiert die BC-Standardbilder als Shopware-Bilder des Artikels.                          |
| **Price List Lines**                    | Öffnet die Preiszeilen-Ansicht des Artikels.                                                |
| **Reset Sync Status**                   | Setzt die Sync-Flags für Artikel, Preiszeilen, Verkaufskanäle, Bilder und Attribute zurück. |
| **Additional Items / Grouped Products** | Verwaltet zusätzliche Artikel bzw. Gruppenartikel.                                          |
| **Sync Grouped Products**               | Synchronisiert die zugeordneten Gruppen-/Zusatzartikel.                                     |
| **Upload Documents**                    | Lädt BC-Dokumentanhänge des Artikels nach Shopware.                                         |
| **Upload SharePoint Documents**         | Lädt zugeordnete SharePoint-Dokumente nach Shopware.                                        |

### Artikelliste – Spalten & Aktionen

Die Artikelliste zeigt zusätzlich die Spalten **Web Item**, **Web ID**, **isSynced** und **Shopware Categories**.

| Aktion                          | Funktion                                                        |
| ------------------------------- | --------------------------------------------------------------- |
| **Excel Import Marketing Text** | Importiert Marketingtexte aus einer Excel-Datei (Massenpflege). |
| **Import CSV Marketing Text**   | Importiert Marketingtexte aus einer CSV-Datei.                  |
| **Import Default Images**       | Importiert Standardbilder für alle (markierten) Artikel.        |

{% hint style="success" %}
Für die Erstbefüllung markieren Sie Artikel als Web-Artikel, ordnen Kategorien zu und starten den Massen-Upload. Die Web-ID wird anschließend je Artikel automatisch gefüllt.
{% endhint %}


---

# 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/referenz-and-nachschlagewerk/feldreferenz-artikelkarte.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.