Appearance
HQS → Shopware 6 einrichten
Diese Anleitung führt Sie durch die erste Einrichtung einer Verbindung von HQS zu Shopware 6, vom leeren Shop bis zum geprüften Erstimport. Die einzelnen Felder erklären die Seiten HQS und Shopware 6.
1. Shop vorbereiten
ReadySync legt vieles selbst an, aber nicht alles. Fehlt etwas, läuft der Import weiter und vermerkt den Ausfall nur im Protokoll. Prüfen Sie deshalb vorher:
| Objekt | Legt ReadySync an? | Prüfen in Shopware |
|---|---|---|
| Steuersätze, z. B. 19 %, 7 %, 0 % | Nein | Einstellungen → Shop → Steuern |
Maßeinheiten für den Grundpreis, z. B. ml, l, kg, g | Nein | Einstellungen → Shop → Maßeinheiten |
| Wurzelkategorie, z. B. „Deutsch“ oder „Katalog“ | Nein | Kataloge → Kategorien |
| Kategorien darunter | Ja | |
| Hersteller | Ja | |
| Lieferzeiten | Ja | |
| Eigenschaften für Varianten, z. B. Farbe, Größe | Ja | |
| Preisregel für Staffelpreise | Ja, „ReadySync – Staffelpreise“ | Einstellungen → Shop → Rule Builder |
Steuersätze: Findet ReadySync einen Satz nicht, importiert es die betroffenen Artikel mit dem Standard-Steuersatz der Verbindung. Ein 0-%-Satz für differenzbesteuerte Artikel fehlt in einer Standardinstallation meist.
Maßeinheiten: ReadySync sucht nach Kurzform oder Name. Eine Einheit mit dem Kürzel ml genügt. Fehlt sie, bekommt der Artikel keinen Grundpreis.
2. Verbindung anlegen
Neue Verbindung anlegen mit Shop-System Shopware 6 und ERP-System HQS.
Tab „ERP“
| Feld | Empfehlung |
|---|---|
| Host, Port, Benutzername, Passwort | vom Betreuer Ihres HQS |
| Pfad (Basis) | Verzeichnis der Exportdateien |
| Bildverzeichnis | Verzeichnis der Artikelbilder. Ohne diesen Eintrag findet ReadySync keine Bilder, weil die Bildnamen im Export keinen Pfad enthalten. |
| Vollimport Datei | Name des vollständigen Artikelexports, z. B. ART_FULL.txt |
| Delta-Import Datei | Name des Änderungsexports, z. B. ART_DELTA.txt |
| Status-Datei, Export-Verzeichnis | nach Ihrer HQS-Einrichtung |
| Verkäufer-Nummer, Dokument-Schlusstext | leer lassen, außer HQS soll feste Werte bekommen |
| Versandkosten-Artikelnummer | leer lassen, wenn HQS den Artikel VERSAND führt |
| Artikelname im Bestellexport | aus, außer HQS hat die externe Artikelbezeichnung für Sie freigeschaltet |
| Abweichende Lieferanschrift | aus, bis Sie entschieden haben, ob HQS Lieferanschriften dauerhaft speichern soll |
Tab „Shop“
| Feld | Empfehlung |
|---|---|
| Shop-URL, Access Key ID, Secret Key | aus der Shopware-Integration, siehe Shopware 6 |
| Standard-Währung | EUR |
| Standard-Steuersatz | 19 % |
| Bestellstatus und Zahlstatus (Filter) | welche Bestellungen ins HQS sollen, z. B. offen und bezahlt |
| Neuer Bestellstatus nach Export | ein Status, der zeigt, dass HQS die Bestellung hat, z. B. „In Bearbeitung“ |
Währung und Steuersatz sind Pflicht. Ohne sie bricht der Import ab.
Tab „Produktimport“
| Bereich | Einstellung | Empfehlung |
|---|---|---|
| Quelldatei | Zeichensatz | UTF-8, bei älteren Exporten CP1252 |
| Quelldatei | Importdatei einmalig zwischenspeichern | ein bei Dateien ab einigen tausend Zeilen |
| Verkaufskanäle | Importierte Artikel Verkaufskanälen zuordnen | ein, Ihren Storefront-Kanal wählen |
| Varianten | Varianten importieren | ein, wenn Sie das HQS-Textilmodul nutzen |
| Varianten | Artikelnummer des Hauptprodukts | VAR-{group} (Standard) |
| Staffelpreise | Staffelpreise importieren | ein, wenn Ihr Export Staffeln enthält |
| Staffelpreise | Preisregel-ID | leer lassen |
| Kategorien | Kategorien importieren | ein |
| Kategorien | Wurzelkategorie | ID Ihrer Wurzelkategorie |
| Kategorien | Beim erneuten Import | Zuordnungen ergänzen, damit von Hand gepflegte Zuordnungen bleiben |
| Kategorien | Trennzeichen im Kategoriefeld | Steuerzeichen (HQS-Standard) |
| Fehlende Produkte | Wenn ein Artikel nicht mehr geliefert wird | erst Nichts tun, nach dem geprüften Erstimport Im Shop deaktivieren |
| Fehlende Produkte | Sicherheitsgrenze | 10 % (Standard) |
Behalten Sie den festen Teil VAR- im Muster des Hauptprodukts. Daran erkennt ReadySync die Hauptprodukte beim Bestellexport und beim Abgleich fehlender Artikel.
3. Mapping
Öffnen Sie das Mapping. Bewährte Zuordnungen für HQS:
| Produktfeld | HQS-Spalte | Hinweis |
|---|---|---|
| Artikelnummer (SKU) | Art-Nr oder Artikelnr | |
| Produktname | Bez-1 oder Titel-1 | Zweite Bezeichnung mit der Transformation Zweite Spalte anhängen |
| Beschreibung | Beschreibung | Transformation HTML-Sonderzeichen auflösen |
| Hersteller | Herstellerspalte | |
| EAN / GTIN | GTIN-14 oder EAN | |
| Verkaufspreis (brutto) | Shop-Preis, Ausweichspalte VK-Preis | |
| Streichpreis (brutto) | VK-Preis | Transformation Nur übernehmen, wenn andere Spalte gefüllt (Shop-Preis), damit der Streichpreis nur bei Aktionen erscheint |
| Steuersatz | Mwst% | |
| Bestand | Bestand oder Summe der Lagerspalten | ggf. Summe mehrerer Spalten |
| Staffelpreise | Preisstaffel | |
| Kategorien | Navigationsspalte, z. B. IShop-Navi | |
| Varianten-Gruppe | Textil-Nr. | |
| Varianten-Option: Farbe / Größe | Farbe, Größe | |
| Bilder (alle) | Artikelmultimediadateien | Bild-Trennzeichen : |
Speichern Sie das Mapping.
4. Erstimport
- Verbindung testen: Tab Test → Test ausführen.
- Vollimport ohne Bilder starten: Verbindungen → Sync.
- Im Job-Protokoll Warnungen prüfen.
- Stichproben im Shop: ein Einzelartikel, eine Variantengruppe, ein Artikel mit Staffelpreis, ein Artikel mit Grundpreis. Erscheinen die Artikel in der Storefront?
- Bildimport Vollständig starten.
- Fehlende Produkte auf Im Shop deaktivieren stellen und Zeitpläne anlegen.
Was die Prüfung ergeben kann
| Beobachtung | Ursache |
|---|---|
Keine Hauptprodukte VAR-… | Varianten sind im Tab Produktimport aus oder die Varianten-Gruppe ist nicht gemappt |
| Keine Kategorien | Wurzelkategorie fehlt |
| Nur ein Bild mit langem Dateinamen | Bild-Trennzeichen steht noch auf Komma |
| Kein Grundpreis | Maßeinheiten fehlen in Shopware |
| Artikel in der Storefront unsichtbar | Verkaufskanal-Zuordnung ist aus |
| Artikel ohne Preis fehlen | Shopware verlangt für neue Artikel einen Preis. Lassen Sie solche Artikel in HQS bepreisen oder nehmen Sie sie aus dem Export. |
Unbedenkliche Meldungen
- Variantengruppen mit nur einer Zeile werden zu Einzelartikeln. Das ist normal.
- Gruppen mit doppelten Kombinationen aus Farbe und Größe importiert ReadySync als Einzelartikel und nennt sie im Protokoll. Korrigieren Sie die Daten in HQS, wenn Sie die Gruppe als Varianten brauchen.
5. Gut zu wissen
- Aktiv-Status: Ohne gemapptes Feld „Aktiv-Status“ sind importierte Artikel aktiv. Einen Artikel, den Sie in Shopware von Hand deaktivieren, aktiviert der nächste Import wieder, solange HQS ihn liefert. Steuern Sie die Sichtbarkeit deshalb in HQS oder über ein gemapptes Feld.
- Bilder der Hauptprodukte: Das Hauptprodukt einer Variantengruppe bekommt die Bilder der ersten Zeile. Prüfen Sie nach dem Erstimport eine Variantengruppe in der Storefront.
- Cross-Selling: HQS-Zubehör übernehmen Sie über das Feld Cross-Selling (Zubehör) und den Menüpunkt Cross-Selling.