Smart Wholesaler Feed Sync

Was das Modul macht

MPR Feed Sync ist ein Back-Office-Modul zur Feed-Synchronisierung für PrestaShop. Es ruft Produktfeeds von Großhändlern ab, normalisiert Datensätze in ein gemeinsames Produktmodell, gleicht sie mit vorhandenen Produkten und Kombinationen ab, speichert Dry-Run-Diffs und wendet Katalogänderungen erst an, wenn die konfigurierten Safety Gates den Lauf zulassen.

Das Modul kann Bestand, Preis, Verfügbarkeit, Kategorie, Marke/Hersteller, Namen, Beschreibungen, Bilder, Kombinationen, Attribute und Features aktualisieren. Jeder Bereich wird über Schalter pro Feed gesteuert, sodass ein Feed nur auf Bestand und Preis begrenzt oder bei Bedarf auf Produkterstellung und Variantenverarbeitung erweitert werden kann.

Back-Office-Pfad

Nach der Installation verwenden Sie Sell > Feed Sync. Das Modul-Dashboard zeigt den letzten Lauf, die Match-Rate, aktive Feeds, verwaltete Produkte, offene Alerts, das nächste Zeitplan-Label, aktuelle Läufe und Schnelllinks zu Feeds, Mapper, Runs und Configuration. Beim Öffnen der Modulkonfiguration wird zum Mapper-/Preview-Controller weitergeleitet.

Globale Konfiguration

Öffnen Sie Sell > Feed Sync > Configuration, um die token-geschützte Cron-URL zu kopieren und Laufzeitlimits anzupassen.

• Global apply enabled: Hauptschalter für den Apply-Modus. Apply benötigt zusätzlich weiterhin einen frischen Dry Run und einen Bestätigungstoken.
• Fetch timeout seconds, Fetch connect timeout seconds und Fetch max bytes: Transportlimits, die beim Abrufen von Feeds verwendet werden.
• Sync lock TTL seconds: Lebensdauer der Sperre für Feed-Läufe, damit überlappende Läufe übersprungen werden, statt parallel zu schreiben.
• Product create max count, Combination create max count und Create max percent: globale Erstellungsgrenzen, die von Safety Gates verwendet werden.
• Image max count, Image max bytes, Image timeout seconds und Image connect timeout seconds: Limits für den Bildimport.

Feed erstellen

Öffnen Sie Sell > Feed Sync > Feeds und fügen Sie einen Feed hinzu. Pflichtfelder sind Feed-Name und Feed-URL/-Pfad. Wählen Sie Großhändler, Quellentyp, Adapter oder Mapping-Profil, Matching-Priorität, Prioritätsreihenfolge, Synchronisationsumfang, Kategorieverhalten, Sicherheitsschwellen, Zeitplan und Aktivstatus.

• Feed URL / path akzeptiert HTTP(S), FTP, FTPS, SFTP, Google-Sheets-URL/-ID oder einen absoluten lokalen Pfad innerhalb des konfigurierten Importverzeichnisses.
• Source type unterstützt url, ftp, ftps, sftp, file und google_sheets.
• Compression kann gzip automatisch erkennen, gzip erzwingen oder die Dekomprimierung deaktivieren.
• Source settings JSON speichert erweiterte Optionen wie Google Sheets gid und range.
• FTP/FTPS/SFTP-Authentifizierungsfelder speichern Benutzername/Passwort und optionalen SFTP-Private-Key-Pfad/Passphrase. Leere Passwort-/Passphrase-Felder behalten beim Bearbeiten das vorhandene Secret.

Feeds mappen

Verwenden Sie Sell > Feed Sync > Mapper, um eine Quelle zu prüfen, Datensätze zu sampeln, Mapping-Profile zu erstellen oder zu speichern und normalisierte Positionen vorzuschauen. Kanonische Felder umfassen ean, sku, supplier_id, name, price, stock, location_quantities, avail, category, brand, variant_group_key, variant_key, variant_attributes, features, combination_ean, combination_reference, combination_price_impact, combination_stock, combination_images, images, und rohe attrs.

Verfügbare Transformationen umfassen trim, digits_only, decimal_normalize, lower, upper, prefix, suffix, regex_replace, split, concat, default_if_empty, und map_values. Presets umfassen Corsan XML, generisches Google Shopping XML, generisches Ceneo XML, generisches CSV und generisches JSON.

Dry Runs, Apply und Rollback

Verwenden Sie Dry-run auf der Feeds-Seite oder rufen Sie den Cron-Endpunkt mit action=dryrun. Ein Dry Run ruft den Feed ab, parst ihn, baut einen Produktindex, gleicht Feed-Positionen ab, schreibt mprfeedsync_run und mprfeedsync_run_diff-Zeilen und speichert eine Konfigurationssignatur am Feed.

Verwenden Sie Apply erst nach Prüfung des Dry-Run-Ergebnisses. Der Apply-Modus erfordert aktiviertes Apply, einen gültigen Bestätigungstoken, eine frische Dry-Run-Signatur, bereite Währungskurse und bestandene Safety Gates. Apply schreibt geplante Zeilen und speichert den Status applied/skipped/error pro Diff-Zeile. Rollback-Aktionen sind auf den Seiten Feeds und Runs für Apply-Läufe verfügbar.

Matching und Overrides

Matching verwendet zuerst vorhandene Modulzuordnungen, wenn sie kohärent sind, danach die konfigurierte match_priority. Eindeutige EAN- und SKU-/Referenz-Treffer haben hohes Vertrauen; Treffer nur über Lieferantenreferenzen haben geringes Vertrauen und werden für Schreibvorgänge blockiert, sofern die Policy sie nicht erlaubt. Doppelte Feed-Schlüssel, mehrdeutige Katalogkandidaten, ignorierte Zuordnungen und unsicher übersprungene Zeilen gelten nicht als schreibbare Zeilen.

Der Mappings-Controller erlaubt Admins, eine Zuordnung einzufrieren, zu entsperren, zu ignorieren/nicht mehr zu ignorieren, manuell auf eine andere Produkt-ID umzulegen oder einen Produktkategorie-Override zu setzen/löschen. Einfrieren schützt Bestand, Preis, Verfügbarkeit, Name, Beschreibung und Bilder für diese Zuordnung.

Kategorien und Marken

Die Kategoriestrategie kann default, manual oder auto_path sein. Produktkategorie-Overrides gewinnen zuerst, danach aktive Kategoriezuordnungen; die manuelle Strategie stützt sich auf diese Zuordnungen, und auto-path kann während Apply Kategoriepfade unter der konfigurierten Root-Kategorie erstellen oder auflösen.

Die Markensynchronisierung verwendet die Brand-Map-Tabelle. Eine Feed-Marke kann einem PrestaShop-Hersteller zugeordnet werden, oder Create if missing kann während Apply einen Hersteller aus dem Feed-Markenwert erstellen. Produkt-Overrides können auch einen Hersteller-Override liefern.

Bestandsstandorte

Wenn sync_location_stock aktiviert ist, werden Feed-location_quantities in Standort-Ledger des Moduls geschrieben und der Shop-Bestand aus der ausgewählten Aggregationsstrategie aktualisiert. Unterstützte Strategien sind sum, max, primary_location, und specific_location. Bestandsstandorte können virtuelle, vom Modul verwaltete Standorte sein oder mit Advanced-Stock-Management-Warenlagern verknüpft werden.

Währung und Preise

Wenn source_currency gesetzt ist und von der Shop-Währung abweicht, benötigt das Modul vor Apply einen konfigurierten Kursanbieter. Die Kursquelle kann manual or nbp sein, mit optionaler Kursmarge und Settings-JSON. Kurse werden in mprfeedsync_currency_rate gecacht; fehlende oder veraltete erforderliche Kurse blockieren Apply.

Dropship-Bestellweiterleitung

Öffnen Sie Sell > Feed Sync > Dropship Orders, um die Bestellweiterleitung pro Feed zu konfigurieren. Sie ist standardmäßig deaktiviert. Der Standardadapter generic_export schreibt ein Bestelldokument auf die Festplatte und kontaktiert keinen Lieferanten. Für externen Versand wählen Sie email_csv, email_xml oder http_post, setzen die ID des auslösenden Bestellstatus und geben bei Bedarf Lieferanten-E-Mail, Endpunkt-URL, Options-JSON oder Auth-JSON an.

Das Modul lauscht auf actionValidateOrder und actionOrderStatusPostUpdate. Wenn eine Bestellung den konfigurierten Status erreicht, löst es nur Zeilen auf, die zum Feed gehören, erstellt ein idempotentes Queue-Element pro Bestellung/Feed-Paar, versendet es und speichert Antwort-/Fehlerdaten. Die Retry-Cron-Aktion verarbeitet fällige oder fehlgeschlagene Weiterleitungsdatensätze bis zum konfigurierten Versuchslimit.

Cron-Endpunkt

Der Front-Controller ist /module/mprfeedsync/cron und benötigt den gespeicherten token. Unterstützte Aktionen sind parse, sync, dryrun, apply, status und Aliase für Weiterleitungs-Retry wie forwarding_retry. Optionale Parameter umfassen id_feed, Ad-hoc-url, adapter_key, profile, id_mapping_profile, confirm or apply_token, limit und begrenzte products.

Betriebshinweise

• Das Modul unterstützt PrestaShop von 1.7.0.0 bis zur installierten _PS_VERSION_ gemäß Modul-Konstruktor.
• Die Installation erstellt Modultabellen für Feeds, Profile, Produktzuordnungen, Overrides, Laufhistorie, Diffs, Kategorien, Marken, Währungskurse, Standorte, Bestellweiterleitung, Bilder, Preisregeln, Alerts und Sperren.
• Runtime-Schemaabgleich und Hook-Prüfungen werden, sofern verfügbar, vor Admin- und Cron-Operationen ausgeführt.
• Laufsperren werden in mprfeedsync_sync_lock gespeichert und verhindern überlappende Läufe für denselben Feed oder dieselbe Ad-hoc-URL.
• Systemintegritätsprüfungen und Wartung der Modultabellen sind über den Integrity-Controller verfügbar.