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.

Ä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.

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.

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.