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 Dateien (CSV, JSON, XML, YAML, BMEcat, Festbreite, …), 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
Dateiauswahl	Fester Dateiname (Standard) oder Präfix (neueste Datei)
Delta-Import Datei / Präfix	Exakter Name oder Präfix für geänderte Artikel
Vollimport Datei / Präfix	Exakter Name oder Präfix 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 Dateiformat und Zeichensatz ein. Ohne Auswahl bleibt es bei getrennten Spalten mit automatischem Trennzeichen. 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, WooCommerce, Shopify oder OXID
3. Produktimport und Mapping
4. Verbindung testen