Skip to content

HQS ​

Diese Seite beschreibt die HQS-Einstellungen einer Verbindung. Den allgemeinen Ablauf finden Sie unter Verbindungen. Eine Schritt-für-Schritt-Anleitung für HQS mit Shopware 6 steht unter HQS → Shopware 6 einrichten.

ReadySync tauscht mit HQS Dateien über FTP/SFTP aus: HQS legt Artikel- und Statusdateien ab, ReadySync legt die Bestellungen als HQS-Auftragsdatei ab. Die Schnittstelle folgt der HQS-Beschreibung „InternetShop-Schnittstelle“ 1.1.67.

Dateien (Tab „ERP“) ​

FeldStandardInhalt
DateiauswahlFester DateinameOder Präfix (neueste Datei) für Exporte mit Zeitstempel im Namen
Delta-Import DateiART_DELTA.txtGeänderte Artikel
Vollimport DateiART_FULL.txtKompletter Artikelstamm
Status-Datei (Bestellungen)STATUS.txtRückmeldungen zu Bestellungen, z. B. versendet. Muster wie HQSSTATUS.* für eine Datei je Intervall
Verzeichnis der Status-Datei(leer = Basis-Pfad)Eigener Ordner, absolut oder relativ, z. B. ../../import
Export-Verzeichnis(leer)Ordner, in den ReadySync die Bestellungen schreibt
Nach dem Einlesenliegen lassenOder ins Archiv verschieben (mit Zeitstempel, alte Archivdateien nach 30 Tagen gelöscht) oder löschen, siehe FTP-Zugang

Bei Präfix (neueste Datei) nimmt ReadySync die jüngste Datei, deren Name mit Ihrem Eintrag beginnt, z. B. Export_Teil_ für Export_Teil_20260819131501.csv. Maßgeblich ist das Änderungsdatum auf dem Server, ersatzweise der Zeitstempel im Namen.

Typischer Aufbau auf dem Server:

/export/
├── ART_DELTA.txt
├── ART_FULL.txt
├── STATUS.txt
└── images/          optional, als Bildverzeichnis eintragen

Bestellexport (Tab „ERP“, HQS-spezifisch) ​

FeldStandardWirkung
Verkäufer-NummerleerHQS-Verkäufer für den Auftrag. Leer: HQS vergibt den Verkäufer selbst. Erlaubt ist eine Nummer wie 4. Die ältere Schreibweise {"EK":4} versteht ReadySync weiter und überträgt dann die Nummer der Gruppe „EK“.
Versandkosten-ArtikelnummerVERSANDArtikel, auf den HQS die Versandkosten bucht. Leer lassen, wenn HQS den Standardartikel VERSAND führt. Den Artikel muss es in HQS geben, sonst weist HQS die Position zurück und die Versandkosten fehlen in der Auftragssumme.
Versandkosten als TextzeileausSchreibt die Versandkosten als reine Textzeile (<P010>, z. B. „Standardversand: 4,90 EUR“) statt als Artikelposition. Für Installationen ohne Versandartikel. Der Betrag steht dann nur als Text im Beleg und zählt nicht zur Auftragssumme.
Dokument-SchlusstextleerText am Ende des Belegs, höchstens 58 Zeichen. Leer: HQS nutzt seinen eigenen Schlusstext.
Artikelname im BestellexportausSchickt den Artikelnamen aus dem Shop als externe Artikelbezeichnung mit, höchstens 30 Zeichen. Nur einschalten, wenn HQS die externe Artikelbezeichnung für Sie freigeschaltet hat. Aus: Der Beleg zeigt die Bezeichnung aus Ihrem HQS-Artikelstamm.
Abweichende LieferanschriftausÜberträgt eine abweichende Lieferanschrift. HQS speichert jede übertragene Anschrift dauerhaft im Kundenstamm, stimmen Sie das vorher ab. Aus: HQS liefert an die Rechnungsanschrift, und das Job-Protokoll nennt jede Bestellung mit abweichender Anschrift.

Was ReadySync an HQS überträgt ​

Je Bestellung schreibt ReadySync Kunde, optional Lieferanschrift und Auftrag mit Positionen:

  • Shop-Kundennummer und Shop-Bestellnummer. Bei Shopify geht die numerische Kunden-ID an HQS, z. B. 7245567295806.
  • Rechnungsanschrift mit Länderkürzel und Anrede
  • Kundenkommentar aus der Bestellung als Freitext auf dem Beleg
  • Preise brutto, je Stück Listenpreis und Rabatt. Eine Gratis-Zugabe kommt mit gleich hohem Preis und Rabatt an.
  • je Artikel eine Position, Versandkosten als eigene Position
  • optional die Zahlungsart und das Versandunternehmen, siehe unten

Weitere Einstellungen im Tab „ERP“ unter HQS-spezifisch:

  • Präfix der Bestellnummer: Steht hier z. B. SHOP-, kommt die Bestellung 1001 als SHOP-1001 bei HQS an. Beim Rückimport der Statusdatei entfernt ReadySync das Präfix wieder. ReadySync überträgt die Bestellnummer so, wie der Shop sie anzeigt (bei Shopify ohne #). Vergibt Ihr Shop die Nummern schon mit Präfix, z. B. SHOP-1001, lassen Sie das Feld leer.
  • Dezimaltrennzeichen: HQS erwartet laut Schnittstelle ein Komma. Stellen Sie nur auf Punkt um, wenn Ihre HQS-Installation bisher Preise mit Punkt bekommen hat.
  • Präfix der Artikelnummer entfernen: Führt Ihr Shop denselben HQS-Artikel unter einer zweiten SKU, z. B. Auspackgeräte als AU_211896 neben der Neuware 211896, tragen Sie hier AU_ ein. ReadySync überträgt die Position dann als 211896, denn HQS kennt nur diese Nummer. Groß- und Kleinschreibung spielen keine Rolle.
  • Filiale für diese Positionen: HQS-Filiale (Feld <P012>), aus der Positionen mit dem Präfix gebucht werden, z. B. die Filiale Ihrer Auspackgeräte. Gilt nur zusammen mit dem Präfix. Ohne Eintrag entscheidet HQS.

Zahlungsart ​

HQS führt für jede Zahlungsart eine feste Nummer. Tragen Sie im Tab „ERP“ unter HQS-spezifisch je Zeile ein, welche Shop-Zahlungsart zu welcher Nummer gehört. Optional legen Sie eine Standard-Nummer für alle übrigen fest.

shopify_payments = 51
paypal = 7
Vorkasse = 4
  • Groß- und Kleinschreibung, Leerzeichen, Unterstriche und Bindestriche spielen keine Rolle.
  • Shopify nennt die Zahlungsarten z. B. shopify_payments (Karte, Apple Pay, Google Pay, Klarna), paypal, gift_card oder den Namen einer manuellen Zahlungsart. Bei Shopware gilt der Name der Zahlungsart.
  • Hat eine Bestellung mehrere Zahlungsarten, z. B. Gutschein und Karte, gilt die erste mit Eintrag.
  • Findet ReadySync keinen Eintrag und keine Standard-Nummer, geht die Bestellung ohne Zahlungsart an HQS. Das Job-Protokoll nennt sie.
  • Lassen Sie beide Felder leer, schreibt ReadySync keine Zahlungsart.

Versandunternehmen ​

HQS führt jedes Versandunternehmen unter einer festen Id (<A015>). Tragen Sie im Tab „ERP“ unter HQS-spezifisch je Zeile ein, welche Versandart des Shops zu welcher Id gehört, und optional eine Standard-Id für alle übrigen:

DHL Paket = 2
Dachser Spedition = 6
Abholung im Laden = 10
IdVersandunternehmenIdVersandunternehmen
0undefiniert11FedEx
1DPD12PARCEL ONE
2DHL13Post AT
3UPS14Post CH
4GLS15TOF
5Hermes16TNT
6Dachser17LogoiX
7Iloxx18DHL Express
8Overnite19Spedition
9Rehnus20GEL Logistik
10Selbstabholung21Eigenauslieferung
22Der Kurier
23GO
24DHL Express Economy

Fehlt ein Unternehmen, nimmt die HQS-Hotline es auf.

  • Die Versandart heißt so wie im Checkout: bei Shopify der Name des Versandtarifs, bei Shopware der Name der Versandart, bei WooCommerce der Titel der Versandmethode. Das gilt auch bei kostenlosem Versand.
  • Groß- und Kleinschreibung, Leerzeichen, Unterstriche und Bindestriche spielen keine Rolle.
  • Hat eine Bestellung mehrere Versandarten, gilt die erste mit Eintrag.
  • Die Standard-Id gilt für Versandarten ohne Eintrag. Ohne Zuordnung bekommt jeder Auftrag die Standard-Id.
  • Findet ReadySync keinen Eintrag und keine Standard-Id, setzt HQS 0 (undefiniert). Bei gepflegter Zuordnung nennt das Job-Protokoll diese Bestellungen.

Ein Bestelldatum überträgt ReadySync nicht, HQS setzt es beim Einlesen. Eine Bestellung ohne Positionen löscht HQS; ReadySync vermerkt das im Protokoll.

Bei Shopify braucht der Bestellexport das Recht read_customers, damit die Kundennummer ankommt.

Artikeldatei ​

HQS liefert semikolongetrennte Dateien. Typische Spalten:

SpalteProduktfeld
ArtikelnrArtikelnummer (SKU)
Titel-1Produktname
Vk-PreisVerkaufspreis (brutto)
MwStSteuersatz
BestandBestand
BildNameBild 1
ArtikelmultimediadateienBilder (alle), meist mit : getrennt

Die vollständige Spaltenliste Ihres Exports sehen Sie im Mapping-Editor, sobald die Datei geladen ist.

Besonderheiten ​

  • Kategorien: HQS trennt Kategorie-Ebenen mit unsichtbaren Steuerzeichen. Wählen Sie im Tab Produktimport bei Trennzeichen im Kategoriefeld die Vorgabe Steuerzeichen (HQS-Standard).
  • Lagerbestände aus mehreren Spalten (z. B. VBF(1), VBF(2)): mit der Transformation Summe mehrerer Spalten.
  • Löschzeilen: Eine Zeile mit nur einer Artikelnummer markiert HQS als gelöscht. ReadySync überspringt solche Zeilen und nennt sie im Protokoll. Zeilen, die neben der Artikelnummer z. B. nur SEO-Angaben, Keywords, Produkttyp, Rückstände oder Metafelder liefern, sind keine Löschzeilen und werden geschrieben.
  • Varianten aus dem Textilmodul: Ordnen Sie Varianten-Gruppe und Optionen wie Farbe und Größe zu und schalten Sie Varianten im Tab Produktimport ein, siehe Varianten.

Bestellstatus aus HQS ​

HQS schreibt Rückmeldungen in die Status-Datei (meist HQSSTATUS.TXT, einstellbar im Tab „ERP“ unter Status-Datei (Bestellungen)). Je Auftrag steht dort ein Block mit Auftragsnummer (S002), Statuscode (S003) und je nach Status Beleg (S005), Sendungsnummer (S006) und Versandunternehmen (S007). ReadySync arbeitet die Blöcke in der Reihenfolge der Datei ab.

HQS hängt neue Blöcke an die bestehende Datei an. Bleibt sie liegen, liest ReadySync alte Blöcke erneut; das schadet nicht, weil eine schon ausgeführte Bestellung und eine schon vorhandene Sendungsnummer übersprungen werden. Mit Status-Datei nach dem Einlesen → Ins Archiv verschieben bleibt die Datei kurz und das Job-Protokoll übersichtlich.

Schreibt HQS stattdessen alle 15 Minuten eine neue Datei mit Zeitstempel (HQSSTATUS.20261110122500), tragen Sie HQSSTATUS.* als Status-Datei ein. ReadySync liest dann alle neuen Dateien der Reihe nach, die älteste zuerst, und verschiebt jede danach ins Archiv. Siehe Status-Datei mit Muster.

Was je Statuscode passiert, steht im Tab „ERP“ unter Status-Rückmeldung. Der Abschnitt erscheint nur bei Shopify-Verbindungen, weil nur der Shopify-Adapter diese Aktionen ausführt. Ohne Einträge gilt:

CodeBedeutung bei HQSReadySync
VLieferschein oder Rechnung geschriebenBestellung im Shop ausführen, ohne Sendungsnummer
SWare versendetSendungsnummer und Versanddienst an die Ausführung hängen; ohne Ausführung mit Sendungsnummer ausführen
LAuftrag in HQS gelöschtTag „ERP: gelöscht“ an der Bestellung
K, F, P, G, MFehler beim Einlesen in HQSWarnung im Job-Protokoll
O, Bangelegt, bearbeitetüberspringen

Eigene Einträge ersetzen den Standard für ihren Code, eine Zeile je Code:

text
L = stornieren
B = tag: In Bearbeitung

Aktionen: ausführen, sendungsnummer, stornieren, tag: Text, warnung, überspringen.

Versanddienst ERP → Shop: Ohne Eintrag geht der Name aus S007 (z. B. DHL) an den Shop. Mit Eintrag übersetzt ReadySync ihn, optional mit eigenem Tracking-Link:

text
DHL = DHL Express
Dachser = Dachser | https://elogistics.dachser.com/shp2/?search={tracking}

Kunde benachrichtigen (Standard aus): Erst eingeschaltet verschickt der Shop beim Ausführen und bei neuer Sendungsnummer seine Versandbestätigung. Aus ist richtig, wenn HQS dem Kunden selbst schreibt.

Andere ERP-Dateien im Format Bestellnummer;Status;… liest ReadySync wie bisher. Welche Werte Ihr Shop dann versteht, steht auf der Seite Ihres Shops unter Shops & ERP.

ReadySync Dokumentation · Impressum