Artikelattribute

Verwalten und synchronisieren Sie Artikelattribute zwischen Business Central und Shopware.

Artikelattribute ermöglichen es, zusätzliche Eigenschaften zu Artikeln zu definieren, die in Shopware als Produkteigenschaften oder Spezifikationen angezeigt werden.

1. Attribute in Business Central

1.1 Attribute anlegen

1. Navigieren Sie zu "Artikel" "Artikelattribute".
2. Erstellen Sie neue Attribute (z.B. Farbe, Material, Größe)
3. Definieren Sie die möglichen Werte.

1.2 Attribute zuweisen

1. Öffnen Sie die "Artikelkarte".
2. Navigieren Sie zu "Zugehörig" "Artikel" "Attribute".
3. Weisen Sie die gewünschten Attribute und Werte zu.

2. Attribut-Synchronisation

Attribut-Mapping / Zuordnung

Attribute werden automatisch zu Shopware synchronisiert, wenn:

• Das Attribut einem "Web-Artikel" zugewiesen ist.
• Das Attribut in der Mapping-Tabelle zugeordnet ist.

Mapping / Zuordnung einrichten

1. Öffnen Sie "Shopware" "Zuordnung"/"Mapping"
2. Wählen Sie "Modulname-Filter"
3. Ordnen Sie BC-Attribute den Shopware-Eigenschaften zu.

3. Attributwerte

3.1 Wertetypen

Business Central unterstützt verschiedene Wertetypen:

Typ	Beschreibung	Beispiel
Option	Auswahl aus vordefinierten Werten	Rot, Blau, Grün
Text	Freitext	"Premium Qualität"
Ganzzahl	Ganze Zahlen	42
Dezimal	Dezimalzahlen	3.14

3.2 Werte synchronisieren

Attributwerte werden automatisch zu Shopware übertragen:

1

Als Eigenschaften für Filterfunktionen.

2

In den Spezifikationen auf der Produktseite.

4. Varianten und Properties

4.1 Was sind Shopware Properties?

Shopware Properties sind Produkteigenschaften, mit denen sich Artikel in Shopware strukturiert beschreiben und filtern lassen. Sie dienen dazu, Merkmale wie Größe, Farbe, Material oder technische Spezifikationen standardisiert abzubilden.

Im Unterschied zu Varianten (z. B. Größe S, M, L als auswählbare Ausprägungen eines Produkts) sind Properties meist rein beschreibend. Sie erscheinen typischerweise in den Produktdetails und werden häufig für Filterfunktionen in Kategorien verwendet, damit Kunden gezielt nach bestimmten Merkmalen suchen können

Verwendung bspw. für:

• Filternavigation im Shop
• Produktvergleiche
• Suchergebnisse

4.2 Shopware Options (Varianten)

Für Produktvarianten (z.B. T-Shirt in verschiedenen Größen):

1. Erstellen Sie in BC einen "Stammartikel"
2. Definieren Sie "Varianten" mit unterschiedlichen Attributwerten.
3. Synchronisieren Sie den Stammartikel zu Shopware.

Die Varianten-Funktion erfordert eine entsprechende Konfiguration und ist nicht in allen Versionen verfügbar.

5. Tipps für den täglichen Umgang

Attributstruktur

• Verwenden Sie konsistente Attributnamen.
• Definieren Sie klare Wertelisten.
• Vermeiden Sie Duplikate und Ähnlichkeiten.

Performance

• Beschränken Sie die Anzahl der Attribute pro Artikel.
• Nutzen Sie Options-Attribute statt Freitext wo möglich.
• Prüfen Sie die Synchronisations-Logs auf Fehler.

Häufige Fragen

Wie lade ich einzelne bzw. alle offenen Attribute nach Shopware hoch?

Einzelne Attribute laden Sie über die Aktion „SOUSHW Upload Attribute“ hoch. Für den Massen-Upload aller noch nicht synchronisierten Attribute dient Upload_PendingItemAttributes; die Codeunit „SOUSHW Item Attribute Mgnt.“ ist zudem Job-Queue-fähig und kann den Attribut-Upload automatisiert ausführen.