HQS konfigurieren

Quell-Adapter

Diese Seite beschreibt nur HQS-spezifische Felder und Dateinamen. Generischer Ablauf: Verbindungen · Adapter-Übersicht.

Die HQS-Konfiguration legt fest, wie ReadySync auf Ihre HQS-Daten zugreift und welche Import-Dateien verwendet werden sollen.

HQS-spezifische Einstellungen

Im Tab "ERP" der Verbindungskonfiguration finden Sie HQS-spezifische Felder:

Datei-Konfiguration

Delta-Import Datei (product_import_delta_file)

• Standard: ART_DELTA.txt
• Dateiname für den Delta-Import (nur geänderte Produkte)
• Diese Datei wird regelmäßig aktualisiert und enthält nur Produkte, die sich seit dem letzten Import geändert haben

Vollimport Datei (product_import_full_file)

• Standard: ART_FULL.txt
• Dateiname für den Vollimport (alle Produkte)
• Diese Datei enthält alle verfügbaren Produkte und wird für den initialen Import oder vollständige Synchronisation verwendet

Status-Datei (order_status_file)

• Standard: STATUS.txt
• Dateiname für Bestellstatus-Updates
• Diese Datei wird verwendet, um Status-Updates von Bestellungen zu HQS zurückzuschreiben

Export-Verzeichnis (export_directory)

• Optional: Pfad für Bestellexporte
• Wenn angegeben, werden exportierte Bestellungen in diesem Verzeichnis gespeichert

HQS Advanced-Einstellungen

Keine Vorbelegung mehr im Formular

Verkäufer-Nummer, Versandkosten-Artikelnummer und Dokument-Schlusstext waren bis August 2026 mit Beispielwerten vorbelegt, die der Bestellexport nie gelesen hat. Da diese Werte jetzt tatsächlich auf dem HQS-Beleg landen, wurden sie aus bestehenden Verbindungen entfernt, sofern sie unverändert der Vorbelegung entsprachen. Bitte prüfen Sie Verkäufer-Nummer und Schlusstext einmal und tragen Sie ein, was Ihre HQS-Installation erwartet. Bei den Versandkosten ändert sich nichts: Dort greift weiterhin der Standardartikel VERSAND, jetzt aber aus dem Programm statt aus dem Formular.

Verkäufer-Nummer (seller_number)

• Standard: kein Eintrag
• HQS-Verkäufer-Nummer für den Kundenauftrag; wird als <A012> übertragen
• Erlaubt ist eine reine Nummer (4) oder das historische JSON-Format {"EK":<nummer>} bzw. {"EK":<nummer>,"AB":<nummer>}
• Beim JSON-Format wird die Nummer der Preisgruppe EK übertragen. Der Bestellexport kennt die Preisgruppe der Bestellung nicht, weitere Einträge bleiben unberücksichtigt und werden im Job-Protokoll gemeldet
• Ohne Eintrag wird <A012> nicht übertragen und HQS vergibt den Verkäufer selbst

Versandkosten-Artikelnummer (shipping_cost_order_number)

• Standard: VERSAND – der Standardartikel aus HQS. Der Wert steht nicht im Formular, sondern als Vorgabe im Bestellexport (DEFAULT_SHIPPING_COST_ORDER_NUMBER in orderExportConfig.ts); das Feld bleibt leer, bis Sie etwas eintragen
• Artikelnummer für Versandkosten-Positionen in Bestellungen
• Die Versandkosten werden damit als eigene Auftragsposition exportiert. Der Artikel muss in HQS existieren, sonst weist HQS die Position mit „Der übermittelte Artikel ist nicht bekannt“ zurück
• Führt Ihre HQS-Installation die Versandkosten auf einem anderen Artikel, tragen Sie dessen Nummer hier ein
• Findet der Export gar keine Artikelnummer, erscheinen die Versandkosten nur als Textzeile im Beleg, fließen nicht in die Auftragssumme ein und werden im Job-Protokoll gemeldet

Externe Artikelbezeichnungen (external_item_names)

• Standard: aus
• Überträgt den Artikelnamen aus dem Shop als erste externe Artikelbezeichnung (<P006>, max. 30 Zeichen)
• Nur einschalten, wenn HQS externe Artikelbezeichnungen für Ihren Mandanten freigeschaltet hat – andernfalls verwirft HQS den Wert

Dokument-Schlusstext (document_closing_text)

• Standard: kein Eintrag
• Text, der am Ende von Bestelldokumenten eingefügt wird (<A005>, 1. Beleg-Schlusstext)
• Maximal 58 Zeichen; längere Texte werden gekürzt
• Ohne Eintrag wird das Feld nicht übertragen und HQS verwendet seinen eigenen Schlusstext

Abweichende Lieferanschrift übertragen (delivery_address)

• Standard: aus
• Überträgt eine von der Rechnungsanschrift abweichende Lieferanschrift als eigenen <LIEFERANSCHRIFT>-Block und verknüpft sie über <A008> mit dem Auftrag
• HQS legt jede übertragene Lieferanschrift dauerhaft beim Kunden ab. Bitte vorher mit dem Händler abstimmen
• Solange die Option aus ist, meldet das Job-Protokoll jede Bestellung mit abweichender Lieferanschrift; HQS liefert dann an die Rechnungsanschrift
• Schalter im Tab "ERP" unter „HQS-spezifisch → Abweichende Lieferanschrift“

Was der Bestellexport überträgt

Der Export folgt der HQS-Schnittstellenbeschreibung „InternetShop-Schnittstelle" 1.1.58. Je Bestellung entstehen die Blöcke <KUNDEN>, optional <LIEFERANSCHRIFT> und <AUFTRAG> mit den Positionen. Wichtige Felder:

Feld	Inhalt
<K001> / <A002>	Shop-Kundennummer (beide Pflichtfelder, identischer Wert)
<K007>	Länderkürzel der Rechnungsanschrift (ISO-3166 Alpha 2)
<K043>	Anrede als Klartext („Herr", „Frau"); ohne Angabe leer
<A001>	Shop-Bestellnummer
<A003>	Kundenkommentar aus der Bestellung (Freitext auf dem Beleg)
<A014>	B – die Preise werden brutto übertragen
<POSI>	eine Position je Artikel, Versandkosten als eigene Position

Bestellungen ohne Positionen

HQS löscht einen Auftrag, der ohne Positionen übermittelt wird. Der Job protokolliert das.

Ein Bestelldatum gibt es im HQS-Auftragsblock nicht – HQS vergibt es beim Import selbst.

FTP-Verzeichnisstruktur

ReadySync erwartet folgende Struktur auf dem FTP-Server:

/export/
├── ART_DELTA.txt          # Delta-Import (geänderte Produkte)
├── ART_FULL.txt           # Vollimport (alle Produkte)
├── STATUS.txt             # Bestellstatus-Updates
└── images/                # Produktbilder (optional, konfigurierbar)
    ├── 12345.jpg
    ├── 67890.jpg
    └── ...

Hinweis

Das images/ Verzeichnis ist optional. Wenn Sie es verwenden, konfigurieren Sie den Pfad unter "ERP" → "FTP" → "Bildverzeichnis".

Standardwerte

Für neue HQS-Verbindungen werden folgende Standardwerte verwendet:

Feld	Standardwert
FTP Host	ftp.hqs-server.de
FTP Port	21
FTP Pfad	/export
Delta-Import Datei	ART_DELTA.txt
Vollimport Datei	ART_FULL.txt
Status-Datei	STATUS.txt
Versandkosten-Artikelnummer	VERSAND (greift auch ohne Eintrag im Formular)

Diese Werte können individuell angepasst werden, falls Ihre HQS-Installation abweichende Pfade oder Dateinamen verwendet.

Verkäufer-Nummer und Dokument-Schlusstext haben bewusst keinen Standardwert: Was auf dem Beleg steht, trägt der Händler ein.

CSV-Format

HQS verwendet ein semikolon-separiertes CSV-Format. ReadySync unterstützt die Standard-HQS-Felder:

• Artikelnr: Eindeutige Artikelnummer (SKU)
• Titel-1: Produktname
• Vk-Preis: Verkaufspreis (Brutto)
• MwSt: Mehrwertsteuersatz
• Bestand: Lagerbestand
• BildName: Bilddateiname (z.B. 12345.jpg)
• Artikelmultimediadateien: Mehrere Bildnamen, getrennt durch Komma oder Doppelpunkt
• ... und viele weitere Felder

Hinweis

Eine vollständige Liste der unterstützten CSV-Felder finden Sie im Mapping-Editor nach dem Laden einer Import-Datei.

Nächste Schritte

Nach der HQS-Konfiguration:

• Prüfen Sie die FTP-Zugangsdaten
• Testen Sie die Verbindung
• Konfigurieren Sie das Mapping