Webartikel

Überblick

Der Artikelsync überträgt Produktdaten aus der WinLine in den Shopware-Shop. Die Synchronisation erfolgt in eine Richtung (WinLine → Shopware) – Änderungen im Shop werden nicht zurück in die WinLine geschrieben.

Es stehen zwei Sync-Modi zur Verfügung:

• Differenzieller Sync – Überträgt nur Artikel, die seit dem letzten Sync geändert wurden. Dies ist der Standardmodus.
• Vollsync – Überträgt alle als Webartikel markierten Artikel, unabhängig vom Änderungsdatum.

Zusätzlich kann ein einzelner Artikel gezielt über das Management Interface synchronisiert werden.

Workflow

Der typische Ablauf für die Artikelsynchronisation:

1. Artikel in WinLine als Webartikel markieren – Die Webartikel-Eigenschaft auf 1 setzen. Artikel mit 0 oder leerem Wert werden ignoriert, Artikel mit -1 werden im Shop deaktiviert.
2. Sync starten – Über das Management Interface, einen geplanten Job oder die Kommandozeile (CLI).
3. Schnittstelle liest alle markierten Artikel aus der WinLine aus.
4. Nur geänderte Artikel werden übertragen (bei differenziellem Sync). Beim Vollsync werden alle markierten Artikel übertragen.
5. Neue Artikel werden im Shop angelegt, bestehende aktualisiert und mit -1 markierte Artikel deaktiviert.
6. Ergebnis im Shop prüfen.

Verwendung

Differenzieller Sync

Überträgt nur Änderungen seit dem letzten Sync. Empfohlen für regelmäßige bzw. geplante Syncs.

Vollsync

Überträgt alle Webartikel unabhängig vom Änderungsdatum. Wird über syncProductsAll bzw. den CLI-Befehl Artikel --all ausgelöst. Empfohlen nach Ersteinrichtung oder Mapping-Änderungen.

Einzelartikel-Sync

Ein einzelner Artikel kann über das Management Interface per Artikelnummer synchronisiert werden. Dies ist hilfreich, um einzelne Artikel gezielt zu testen oder zu aktualisieren.

WinLine

Einrichtung

Eine Einrichtung ist nicht notwendig, sofern das schon vorhandene Eigenschaftsfeld “Webartikel” verwendet wird. Es ist zu empfehlen bei der Einrichtung mit einer Testeigenschaft zu arbeiten, um den “syncAll” anhand weniger Artikel zu testen.

Die Webeigenschaft sollte immer als Typ 2 (Integer) angelegt sein. Mögliche Optionen:

Verwendung

Um Artikel an den Shop zu übermitteln, müssen diese in der WinLine als Webartikel markiert werden

Schnittstelle

config.ini

[WL]
webartikel = 5

Steuersätze

Die Schnittstelle legt keine Steuersätze an. Die in der WinLine verwendeten Steuersätze müssen vorab in Shopware angelegt werden. Artikel mit nicht vorhandenen Steuersätzen werden nicht synchronisiert. Ist kein passender Steuersatz vorhanden, wird 19% als Fallback verwendet.

In Shopware 6 werden Steuersätze unter Einstellungen > Shop > Steuern verwaltet.