Generische Datei (generic_file)

Quell-Adapter

Diese Seite beschreibt nur den Adapter Generische Datei. Generischer Ablauf: Verbindungen · Adapter-Übersicht.

Der Quell-Adapter Generisch liest Artikel- und Statusdaten als Dateien über FTP/SFTP. Es gibt keine ERP-spezifischen Defaults – Dateinamen, Encoding und Feldstruktur legen Sie selbst fest.

Wann diesen Adapter wählen?

• Die Quelle liefert CSV/TXT (oder vergleichbare Flachdateien), aber nicht im HQS-Standardformat.
• Sie brauchen freie Kontrolle über Delta-/Vollimport-Dateinamen und Exportpfade.
• Ein API-Quelladapter (z. B. für ein anderes ERP) ist noch nicht vorhanden – der dateibasierte Weg ist der Einstieg.

Konfiguration (Tab „ERP“)

Transport

Wie bei allen dateibasierten Quellen: FTP/SFTP-Zugangsdaten (Host, Port, Benutzer, Passwort, Basis-Pfad, optional Bildverzeichnis).

Dateien

Feld	Zweck
Delta-Import Datei	Dateiname für geänderte Artikel
Vollimport Datei	Dateiname für den kompletten Artikelstamm
Status-Datei	Dateiname für Bestellstatus-Updates von der Quelle
Export-Verzeichnis	Zielordner für Bestellexporte (optional)

Es gibt keine fest verdrahteten Standardnamen wie ART_DELTA.txt – tragen Sie die Namen ein, die Ihre Quelle tatsächlich schreibt.

Zeichensatz

Im Tab Produktimport stellen Sie Encoding (UTF-8 / CP1252 / Auto) ein. Falsches Encoding führt zu kaputten Umlauten.

Mapping

Nach dem ersten Dateizugriff stehen die Spaltenheader im Mapping-Editor. Ordnen Sie Quellspalten den kanonischen ReadySync-Feldern zu (sku, name, price.gross, …) – nicht den Shop-Feldern.

Adapter-spezifische Beispielmappings (HQS) gelten hier nicht; die Spaltennamen kommen aus Ihrer Datei.

Bestellexport & Status

Ob und in welchem Format Bestellungen zurückgeschrieben werden, hängt von der konkreten Quell-Schnittstelle ab. Der generische Adapter stellt den Dateitransport bereit; Format und Pflichtfelder müssen zur Quelle passen. Bei Unklarheit: Quellsystem-Dokumentation oder Support.

Abgrenzung zu HQS

	Generische Datei	HQS
Dateinamen-Defaults	keine	z. B. ART_DELTA.txt, ART_FULL.txt
Bestellexport-Felder	generisch / je nach Quelle	HQS-XML-Blöcke (<KUNDEN>, <AUFTRAG>, …)
Spezielle Optionen	—	Verkäufer-Nummer, Versandartikel, Lieferanschrift, …

→ HQS konfigurieren

Nächste Schritte

1. FTP/SFTP einrichten
2. Shop-Adapter: Shopware oder WooCommerce
3. Produktimport und Mapping
4. Verbindung testen