Skip to content

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:

ObjektLegt ReadySync an?Prüfen in Shopware
Steuersätze, z. B. 19 %, 7 %, 0 %NeinEinstellungen → Shop → Steuern
Maßeinheiten für den Grundpreis, z. B. ml, l, kg, gNeinEinstellungen → Shop → Maßeinheiten
Wurzelkategorie, z. B. „Deutsch“ oder „Katalog“NeinKataloge → Kategorien
Kategorien darunterJa
HerstellerJa
LieferzeitenJa
Eigenschaften für Varianten, z. B. Farbe, GrößeJa
Preisregel für StaffelpreiseJa, „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“ ​

FeldEmpfehlung
Host, Port, Benutzername, Passwortvom Betreuer Ihres HQS
Pfad (Basis)Verzeichnis der Exportdateien
BildverzeichnisVerzeichnis der Artikelbilder. Ohne diesen Eintrag findet ReadySync keine Bilder, weil die Bildnamen im Export keinen Pfad enthalten.
Vollimport DateiName des vollständigen Artikelexports, z. B. ART_FULL.txt
Delta-Import DateiName des Änderungsexports, z. B. ART_DELTA.txt
Status-Datei, Export-Verzeichnisnach Ihrer HQS-Einrichtung
Verkäufer-Nummer, Dokument-Schlusstextleer lassen, außer HQS soll feste Werte bekommen
Versandkosten-Artikelnummerleer lassen, wenn HQS den Artikel VERSAND führt
Artikelname im Bestellexportaus, außer HQS hat die externe Artikelbezeichnung für Sie freigeschaltet
Abweichende Lieferanschriftaus, bis Sie entschieden haben, ob HQS Lieferanschriften dauerhaft speichern soll

Tab „Shop“ ​

FeldEmpfehlung
Shop-URL, Access Key ID, Secret Keyaus der Shopware-Integration, siehe Shopware 6
Standard-WährungEUR
Standard-Steuersatz19 %
Bestellstatus und Zahlstatus (Filter)welche Bestellungen ins HQS sollen, z. B. offen und bezahlt
Neuer Bestellstatus nach Exportein 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“ ​

BereichEinstellungEmpfehlung
QuelldateiZeichensatzUTF-8, bei älteren Exporten CP1252
QuelldateiImportdatei einmalig zwischenspeichernein bei Dateien ab einigen tausend Zeilen
VerkaufskanäleImportierte Artikel Verkaufskanälen zuordnenein, Ihren Storefront-Kanal wählen
VariantenVarianten importierenein, wenn Sie das HQS-Textilmodul nutzen
VariantenArtikelnummer des HauptproduktsVAR-{group} (Standard)
StaffelpreiseStaffelpreise importierenein, wenn Ihr Export Staffeln enthält
StaffelpreisePreisregel-IDleer lassen
KategorienKategorien importierenein
KategorienWurzelkategorieID Ihrer Wurzelkategorie
KategorienBeim erneuten ImportZuordnungen ergänzen, damit von Hand gepflegte Zuordnungen bleiben
KategorienTrennzeichen im KategoriefeldSteuerzeichen (HQS-Standard)
Fehlende ProdukteWenn ein Artikel nicht mehr geliefert wirderst Nichts tun, nach dem geprüften Erstimport Im Shop deaktivieren
Fehlende ProdukteSicherheitsgrenze10 % (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:

ProduktfeldHQS-SpalteHinweis
Artikelnummer (SKU)Art-Nr oder Artikelnr
ProduktnameBez-1 oder Titel-1Zweite Bezeichnung mit der Transformation Zweite Spalte anhängen
BeschreibungBeschreibungTransformation HTML-Sonderzeichen auflösen
HerstellerHerstellerspalte
EAN / GTINGTIN-14 oder EAN
Verkaufspreis (brutto)Shop-Preis, Ausweichspalte VK-Preis
Streichpreis (brutto)VK-PreisTransformation Nur übernehmen, wenn andere Spalte gefüllt (Shop-Preis), damit der Streichpreis nur bei Aktionen erscheint
SteuersatzMwst%
BestandBestand oder Summe der Lagerspaltenggf. Summe mehrerer Spalten
StaffelpreisePreisstaffel
KategorienNavigationsspalte, z. B. IShop-Navi
Varianten-GruppeTextil-Nr.
Varianten-Option: Farbe / GrößeFarbe, Größe
Bilder (alle)ArtikelmultimediadateienBild-Trennzeichen :

Speichern Sie das Mapping.

4. Erstimport ​

  1. Verbindung testen: Tab Test → Test ausführen.
  2. Vollimport ohne Bilder starten: Verbindungen → Sync.
  3. Im Job-Protokoll Warnungen prüfen.
  4. Stichproben im Shop: ein Einzelartikel, eine Variantengruppe, ein Artikel mit Staffelpreis, ein Artikel mit Grundpreis. Erscheinen die Artikel in der Storefront?
  5. Bildimport Vollständig starten.
  6. Fehlende Produkte auf Im Shop deaktivieren stellen und Zeitpläne anlegen.

Was die Prüfung ergeben kann ​

BeobachtungUrsache
Keine Hauptprodukte VAR-…Varianten sind im Tab Produktimport aus oder die Varianten-Gruppe ist nicht gemappt
Keine KategorienWurzelkategorie fehlt
Nur ein Bild mit langem DateinamenBild-Trennzeichen steht noch auf Komma
Kein GrundpreisMaßeinheiten fehlen in Shopware
Artikel in der Storefront unsichtbarVerkaufskanal-Zuordnung ist aus
Artikel ohne Preis fehlenShopware 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.

ReadySync Dokumentation · Impressum