Appearance
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“)
| Feld | Standard | Inhalt |
|---|---|---|
| Dateiauswahl | Fester Dateiname | Oder Präfix (neueste Datei) für Exporte mit Zeitstempel im Namen |
| Delta-Import Datei | ART_DELTA.txt | Geänderte Artikel |
| Vollimport Datei | ART_FULL.txt | Kompletter Artikelstamm |
| Status-Datei (Bestellungen) | STATUS.txt | Rü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 Einlesen | liegen lassen | Oder 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 eintragenBestellexport (Tab „ERP“, HQS-spezifisch)
| Feld | Standard | Wirkung |
|---|---|---|
| Verkäufer-Nummer | leer | HQS-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-Artikelnummer | VERSAND | Artikel, 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 Textzeile | aus | Schreibt 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-Schlusstext | leer | Text am Ende des Belegs, höchstens 58 Zeichen. Leer: HQS nutzt seinen eigenen Schlusstext. |
| Artikelname im Bestellexport | aus | Schickt 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 Lieferanschrift | aus | Ü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 alsSHOP-1001bei 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_211896neben der Neuware211896, tragen Sie hierAU_ein. ReadySync überträgt die Position dann als211896, 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_cardoder 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| Id | Versandunternehmen | Id | Versandunternehmen |
|---|---|---|---|
| 0 | undefiniert | 11 | FedEx |
| 1 | DPD | 12 | PARCEL ONE |
| 2 | DHL | 13 | Post AT |
| 3 | UPS | 14 | Post CH |
| 4 | GLS | 15 | TOF |
| 5 | Hermes | 16 | TNT |
| 6 | Dachser | 17 | LogoiX |
| 7 | Iloxx | 18 | DHL Express |
| 8 | Overnite | 19 | Spedition |
| 9 | Rehnus | 20 | GEL Logistik |
| 10 | Selbstabholung | 21 | Eigenauslieferung |
| 22 | Der Kurier | ||
| 23 | GO | ||
| 24 | DHL 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:
| Spalte | Produktfeld |
|---|---|
Artikelnr | Artikelnummer (SKU) |
Titel-1 | Produktname |
Vk-Preis | Verkaufspreis (brutto) |
MwSt | Steuersatz |
Bestand | Bestand |
BildName | Bild 1 |
Artikelmultimediadateien | Bilder (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:
| Code | Bedeutung bei HQS | ReadySync |
|---|---|---|
V | Lieferschein oder Rechnung geschrieben | Bestellung im Shop ausführen, ohne Sendungsnummer |
S | Ware versendet | Sendungsnummer und Versanddienst an die Ausführung hängen; ohne Ausführung mit Sendungsnummer ausführen |
L | Auftrag in HQS gelöscht | Tag „ERP: gelöscht“ an der Bestellung |
K, F, P, G, M | Fehler beim Einlesen in HQS | Warnung im Job-Protokoll |
O, B | angelegt, bearbeitet | überspringen |
Eigene Einträge ersetzen den Standard für ihren Code, eine Zeile je Code:
text
L = stornieren
B = tag: In BearbeitungAktionen: 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.