Smart-Synchronisierung des Großhändler-Feeds: Einrichtung und Hilfe

Installieren Sie die ZIP-Datei im Modulmanager Ihres Shops und klicken Sie auf Konfigurieren. Das Modul ergänzt Feed Sync im Verkaufsmenü. Das Dashboard zeigt den letzten Lauf, die Zuordnungsquote, aktive Feeds, verwaltete Produkte, ungelesene Warnungen und die letzten Läufe.

Verwenden Sie Feeds zur Feed-Konfiguration und Ausführung, Dry run für das Zuordnungsstudio und reine Einleseprüfungen, Workbench zur Artikelprüfung und für individuelle Vorgaben sowie Runs für Ausführungsdetails und das Zurücksetzen. Mappings, Category Mapping, Brand Mapping und Stock Locations verwalten die jeweiligen Beziehungen.

Wholesalers ist eine schreibgeschützte Liste. Bei der Installation wird ein gemeinsam genutzter Großhändler Corsan angelegt. Sie können einem Feed einen Großhändler zuweisen oder ihn ohne Zuordnung lassen; auf dieser Seite können Sie keine Großhändler hinzufügen oder bearbeiten.

Wählen Sie im Multishop-Betrieb zuerst einen Shop. Feed-Konfiguration, Produktvorgaben, Laufdetails und Zugangsdaten gehören zum ausgewählten Shop. Auch das Laufzeitformular ist shopspezifisch, außer den Aufbewahrungseinstellungen und Ignore Omnibus price history during rollback, die für das gesamte Modul gelten.

Der Server benötigt lesbare Quelldateien und beschreibbaren temporären Speicher. Zum Einlesen von XML ist XMLReader erforderlich, für XLSX zusätzlich ZipArchive. FTP, FTPS und SFTP benötigen PHP cURL mit Unterstützung für das gewählte Protokoll. Die HTML-Verarbeitung von Inhaltsvorlagen benötigt DOMDocument.

Öffnen Sie Feed Sync > Settings > Configuration.

Erstellen Sie unter Default pricing policy mit Add step eine Formel aus geordneten Schritten. Die Operationen sind Multiply by, Add, Subtract, Divide by und Add percent. Standardmäßig ist die Formel leer; der normalisierte Großhandelspreis bleibt daher unverändert. Beispielsweise ergibt 100 multipliziert mit 1,2 plus 5 vor dem Runden 125.

Round final price steht standardmäßig auf No rounding. Die anderen Optionen runden auf 0,01, 0,10 oder 1,00. Klicken Sie auf Save default pricing policy. Wenn Sie alle Schritte und die Rundung entfernen, wird die Standardrichtlinie gelöscht. Richtlinien mit Optionen, die dieser Editor nicht darstellen kann, werden ohne Formular zum Bearbeiten und Speichern angezeigt.

Unter Default image and gone-from-feed policies erbt jedes Steuerelement zunächst seinen Systemstandard:

Klicken Sie auf Save default image and gone policies. Feed-, Kategorie- und Produktrichtlinien können einzelne Felder überschreiben. Inherit lässt die übergeordnete Entscheidung gelten; es deaktiviert die Funktion nicht. Starten Sie nach dem Speichern der Richtlinien einen neuen Probelauf.

Das Formular Runtime settings unter Settings > Configuration enthält diese Einstellungen. Klicken Sie nach der Bearbeitung auf Save.

Die Aufbewahrungseinstellungen akzeptieren ganze Zahlen von 0 bis 1000000. Angeheftete und nicht abgeschlossene Läufe, Rücksetzungsjournale, der letzte Feed-Lauf, geprüfte Details, der letzte Probelauf und Eigentümer der Wartungssperre sind vor der Bereinigung geschützt. Beschäftigte Feeds werden bei der Aufbewahrungsbereinigung übersprungen.

Ersetzen Sie mit Regenerate token das Cron-Token des ausgewählten Shops und aktualisieren Sie anschließend die URL im Zeitplaner. Die alte Cron-URL autorisiert dann keine Anfragen mehr. Der Bestätigungsschlüssel für die Übernahme ist vom Cron-Token getrennt.

Öffnen Sie Feeds > Add new feed oder verwenden Sie Edit in einer vorhandenen Zeile. Speichern Sie Änderungen mit Save.

Mit Test connection laden Sie die Quelle herunter und sehen die Byteanzahl sowie den Anfang des Inhalts. Dabei werden keine Katalogänderungen übernommen.

Legen Sie lokale Dateien im Shopverzeichnis var/modules/mprfeedsync/import/ ab und geben Sie ihren absoluten Pfad ein. Pfade außerhalb des konfigurierten Importverzeichnisses werden abgelehnt, einschließlich symbolischer Links, die nach außerhalb führen.

Google Sheets muss einen öffentlichen CSV-Export bereitstellen. Private Tabellen, die eine interaktive Google-Anmeldung benötigen, werden von diesem Quelltyp nicht unterstützt.

Verwenden Sie Mapper bei einem gespeicherten Feed oder öffnen Sie Dry run > Feed mapping studio. Das Studio liest eine Stichprobe und speichert ein wiederverwendbares Zuordnungsprofil.

1. Geben Sie Feed URL ein. Das Studio lädt die gespeicherte Feed-URL nicht vor und übermittelt die Feed-ID nicht bei Stichproben- und Vorschauanfragen. Eine Quelle mit gespeicherten Zugangsdaten kann deshalb im Studio fehlschlagen, obwohl Test connection beim Feed funktioniert.
2. Wählen Sie Format, anfangs auto, oder XML, CSV, JSON, XLSX oder Google Sheets. Wählen Sie optional Preset. Mitgelieferte Vorlagen decken Corsan XML, Google Shopping XML, Ceneo XML sowie generisches CSV und JSON ab.
3. Setzen Sie bei XML Record element auf das wiederholte Artikelelement, etwa o oder item, oder lassen Sie es zur Erkennung leer. Bei CSV kann Delimiter zur Erkennung leer bleiben. Bei JSON wählt Array pointer das Produktarray aus, etwa products.
4. Bei XLSX wählt Sheet ein Blatt nach Name oder Nummer und Header row die Kopfzeile. Leer verwendet die automatische Auswahl des Lesers. Die erste Anfrage Fetch sample übermittelt diese beiden Vorgaben in dieser Version nicht; geben Sie sie nach dem Laden der Stichprobe erneut ein, verwenden Sie Preview mapped products und speichern Sie das Profil, damit sie verwendet werden.
5. Klicken Sie auf Fetch sample und prüfen Sie Source fields samt Beispielen. Anfangs sind keine Felder zugeordnet; nach dem Laden der Stichprobe schlägt das Studio Zuordnungen vor.
6. Wählen Sie unter Map to product fields für jedes Feld die Quelle und klicken Sie auf Preview mapped products.
7. Klicken Sie auf Save profile und geben Sie einen Namen an. Wenn das Studio für einen Feed geöffnet wurde, wird das gespeicherte Profil mit diesem verknüpft. Andernfalls wählen Sie es später im Feld Mapping profile des Feeds aus.

Ordnen Sie EAN, SKU / Manufacturer code und Supplier ID sorgfältig zu. EAN und SKU sind die wichtigsten Katalogkennungen; Lieferanten-IDs können sich ändern. Doppelte, mehrdeutige, ignorierte und wenig zuverlässige Zeilen gelten nicht als reguläre beschreibbare Zuordnungen.

Weitere Zuordnungsziele sind Name, Price, Stock, Location quantities, Availability, Category, Brand, Images, Features und Raw attributes. Rohe Attribute können Werte für Inhaltsvorlagen liefern. Standortmengen können Paare wie PL=5;DE=2 enthalten.

Zu den Variantenzielen gehören Variant group key, Variant key, Variant attributes, Combination EAN, Combination reference, Combination price impact, Combination stock und Combination images. Die Zuordnung dieser Felder liefert Variantendaten; sie aktiviert weder die Varianten- noch die Attributsynchronisierung. Der Feed-Editor dieser Version enthält keine Steuerelemente für diese beiden standardmäßig deaktivierten Berechtigungen.

Bei gewöhnlichen Feldern laufen Transformationen in der angezeigten Reihenfolge. trim entfernt umgebende Leerzeichen, digits_only entfernt Nichtziffern, decimal_normalize wandelt einen Preis in einen Dezimalwert um, und lower sowie upper ändern die Groß-/Kleinschreibung. map_values verwendet die Wertzuordnung des Feldes. Wählen Sie in der Verfügbarkeitszuordnung für jeden Lieferantenwert verfügbar (1) oder nicht verfügbar (7).

Das Studio bietet außerdem prefix, suffix, regex_replace, split, concat und default_if_empty mit einem Argumentfeld. Diese Version überträgt dessen Inhalt nicht in die vom Transformationsprozessor erwarteten Parameter. Verlassen Sie sich daher für diese Transformationen nicht auf eingegebene Argumente; prüfen Sie vor dem Speichern die zugeordnete Vorschau.

Die Stichprobenvorschau zeigt bis zu acht zugeordnete Datensätze und eine geschätzte Zuordnungsquote. Führen Sie vor der Übernahme einen vollständigen Dry-run unter Feeds aus.

Der Mapper unterstützt Length, Width, Height, Depth, Absolute weight, Volume, Area, Paketmaße, Paketgewicht und -volumen sowie Länge, Fläche, Gewicht, Volumen und Anzahl je Einheit.

Wählen Sie für jedes zugeordnete Maß sein Wertefeld und geben Sie entweder Source unit an, wählen Sie Unit source field oder verwenden Sie einen Wert mit Einheit wie 25 cm. Einheitenfelder verwenden anfangs Unit in the value, ohne feste Quelleinheit. Eine reine Zahl benötigt eine ausdrückliche Einheit. Widersprüchliche oder ungültige Einheiten führen zur Ablehnung des Angebots.

Maßfelder verwenden keine gewöhnlichen Preis- oder Texttransformationen. Ordnen Sie eine Quelllänge nur dann Height zu, wenn sie tatsächlich die Höhe bezeichnet. Die Vorschau zeigt Quellwerte und wirksame Werte einschließlich Einheiten und Vererbung. Fehlende Maße behalten gespeicherte Werte bei; sie löschen sie nicht.

Importierte Breite, Höhe, Tiefe und Gewicht können auch die entsprechenden nativen Produktwerte in den Shopeinheiten aktualisieren. Absolute weight bezeichnet das volle physische Gewicht der Variante; das Modul berechnet daraus die native Gewichtsauswirkung relativ zum übergeordneten Produkt. Andere Maße bleiben im gemeinsam genutzten Maßspeicher.

Prüfen Sie Maße im Mapper, in Workbench-Vorschauen und auf der nativen Produktseite. Die Maßsperre des Produkts verhindert Feed-Änderungen. Zur Übernahme muss der geprüfte Maßplan weiterhin aktuell sein. Shopkonflikte oder Änderungen seit dem Probelauf erfordern eine erneute Prüfung.

Öffnen Sie die Registerkarte Sync des Feeds.

Die sechs New products only-Felder bieten auch Off, Always und Inherit. Off verhindert die Feed-Synchronisierung des Feldes; Always erlaubt Erstellung und spätere Aktualisierungen. Inherit verwendet die übergeordnete Richtlinie. Ohne übergeordnete Vorgabe erlauben die Systemrechte Preis, Bestand, Marke und Verfügbarkeit und blockieren Name, Beschreibung, Bilder und Kategorien. Produktfeldsperren können Schreibzugriffe weiterhin verhindern.

Verfügbare Artikel mit positivem Bestand können ihre Menge aktualisieren und bestellbar bleiben, ohne Aktivierung oder Sichtbarkeit zu ändern. Verfügbare Artikel ohne Bestand bleiben bestellbar; dabei gilt ohne abweichende Vorgabe das Shopverhalten bei fehlendem Bestand. Für nicht verfügbare Artikel wird Bestand null geplant; die Bestellbarkeit wird nur bei aktivierter entsprechender Richtlinie deaktiviert. Unbekannte Verfügbarkeit lässt den Produktstatus unverändert. Bestands- und Verfügbarkeitsrechte können ihre jeweiligen Felder unabhängig voneinander bewahren.

Bei zugeordneten Varianten kann eine verfügbare Geschwistervariante das übergeordnete Produkt bestellbar halten, wenn eine andere Variante nicht verfügbar ist.

Verwenden Sie Content templates and manufacturer exclusions auf der Registerkarte Sync des Feeds oder öffnen Sie denselben Bereich über Workbench.

Aktivieren Sie je Sprache und für Name, Short description oder Description die Option Use this template und geben Sie die Vorlage ein. Anfangs sind keine Vorlagen vorhanden. Nicht aktivierte Sprachvorlagen erben die Vorlage der Shop-Standardsprache. Die Feed-Synchronisierungsrechte und Produktwertsperren bestimmen weiterhin, ob erzeugte Inhalte geschrieben werden.

Verfügbare Platzhalter sind:

{wholesaler_name}
{wholesaler_description}
{wholesaler_short_description}
{wholesaler_reference}
{wholesaler_brand}

Geben Sie zusätzliche Quellfeldnamen unter Selected feed fields (one per line) ein, um Platzhalter wie {feed:material} verfügbar zu machen. Verwenden Sie Insert token zum Einfügen. {{ und }} erzeugen wörtliche geschweifte Klammern. Platzhalter lesen zugeordnete Lieferantendaten; sie führen weder PHP noch Smarty aus. Namen werden zu reinem Text, und Beschreibungs-HTML wird bereinigt.

Prüfen Sie Quelle und erzeugtes Ergebnis mit Preview content. Klicken Sie im eigenständigen Workbench-Bereich auf Save import settings. Im Feed-Formular speichern Sie den Feed.

Unter Excluded manufacturers und Excluded supplier brands ist anfangs nichts ausgewählt. Wählen Sie auszuschließende Shophersteller oder geben Sie eine Lieferantenmarke je Zeile ein. Der Lieferantenmarkenabgleich ignoriert Groß-/Kleinschreibung und mehrfache Leerzeichen. Ausgeschlossene Artikel und ihre Variantengruppen bleiben unverändert und sind auch vor der Behandlung verschwundener Feed-Artikel geschützt.

Automatic maintenance during apply auf der Registerkarte Safety und im eigenständigen Importbereich steht standardmäßig auf No. Bei Aktivierung wird der ausgewählte Shop während der Katalogschreibzugriffe geschlossen; danach stellt das Modul die vorige Wartungseinstellung wieder her. Reine Einlesevorgänge und Probeläufe lassen ihn geöffnet. Der Bereich zeigt Maintenance ownership and recovery status, aktive Lauf-IDs und den letzten Zustandswechsel.

Öffnen Sie die Registerkarte Pricing des Feeds. Alle Preisrichtlinien enthalten anfangs keine Regeln. Die Berechnung beginnt mit dem Lieferantenpreis, rechnet bei entsprechender Konfiguration die Währung um und normalisiert Bruttopreise, wenn Policy JSON dies vorgibt. Die resultierende Basis ist ohne Steuern.

Die Berechnung durchläuft Shopstandard, Feed-, Kategorie- und Produktrichtlinien. Verwenden Sie die geordneten Rechenschritte des Formeleditors. Continue from the price so far wendet die Formel auf das Ergebnis der vorigen Stufe an. Restart from the original base verwirft frühere Stufenergebnisse und beginnt erneut beim normalisierten Großhandelspreis.

Die Rundung einer Regel erfolgt auf deren Stufe. Entfernen Sie eine Regel oder leeren Sie ihre Formel, um zur Vererbung zurückzukehren, soweit der Editor dies unterstützt. Speichern Sie den Feed und starten Sie einen neuen Dry-run.

Erweitern Sie in Workbench ein vorhandenes Produkt, um Product pricing policy zu bearbeiten. Standard ist Use inherited pricing. Wählen Sie Apply a product formula, dann on top of the price so far oder starting over from the wholesaler price, geben Sie Schritte ein und klicken Sie auf Save policy. Ein fester individueller Preis mit aktivierter Wertsperre hat Vorrang vor der Formelkette. Festpreise sind absolute Katalogpreise ohne Steuern. Eine feste Feldsperre blockiert Änderungen weiterhin.

Mit Explain price prüfen Sie Quellpreis, Umrechnung, Formeln und Endergebnis. Preisregeln allein überschreiben Sync price nicht: Bei New products only behält ein vorhandenes Produkt seinen Preis, sofern keine zulässige Produktvorgabe greift.

Öffnen Sie die Registerkarte Gone-from-feed des Feeds. Diese Regeln betreffen zuvor zugeordnete Produkte, die in späteren Läufen fehlen, nicht Datensätze mit dem Verfügbarkeitswert „nicht verfügbar“.

Report only lässt den Katalog unverändert. Unavailable deaktiviert die Bestellbarkeit. Unavailable and zero stock setzt zusätzlich die Menge auf null. Disable deaktiviert das Produkt und die Bestellbarkeit.

Änderungen wegen verschwundener Artikel werden im Probelauf geplant und bei der Übernahme geschrieben. Taucht ein Artikel wieder auf, plant das Modul die Wiederherstellung des beim Markieren als verschwunden gespeicherten Zustands. Prüfen Sie die Wiederherstellungszeilen vor der Übernahme.

Verwenden Sie für engere Regeln Category image and gone policies auf der Registerkarte Sync. Klicken Sie auf Add category policy, wählen Sie Category und setzen Sie Image strategy oder die Felder Enabled, Action, After runs, After days, Notice, Hide price, Text mode und Notice text. Anfangs werden Werte geerbt, Schwellen und Text sind leer. Precedence beginnt bei 0; höhere Werte haben Vorrang vor niedrigeren.

Produktspezifische Bildrichtlinien und Regeln für aus dem Feed verschwundene Produkte sind in erweiterten Workbench-Zeilen verfügbar. Die Felder erben anfangs. Ein ausdrückliches No oder ein leerer eigener Text überschreibt einen übergeordneten Wert ebenso wie ein ausdrückliches Yes. Produktrichtlinien haben Vorrang vor Kategorie-, Feed- und Shopstandards.

Wählen Sie unter Product image and gone-from-feed policy die Image strategy und klicken Sie auf Save image policy. Setzen Sie für verschwundene Artikel Policy, Action, After runs, After days, Notice, Price, Text mode und Notice text und klicken Sie auf Save gone policy. Leere Schwellen erben; der benutzerdefinierte Textmodus erlaubt einen ausdrücklich leeren Hinweis.

Öffnen Sie die Registerkarte Catalog des Feeds.

Manuelle Kurse laufen normalerweise nach 24 Stunden ab und können aus dem konfigurierten Wert erneuert werden. Für einen bewusst festen Kurs akzeptiert Currency settings JSON {"manual_locked":true}. Außerdem werden effective_date, expires_at, ttl_seconds und ttl_hours akzeptiert. NBP nutzt Kurse der Tabelle A, berechnet Währungsumrechnungen über PLN und speichert Kurse standardmäßig 24 Stunden zwischen. nbp_ttl_seconds oder nbp_ttl_hours ändert diese Dauer, mindestens fünf Minuten. nbp_timeout beträgt standardmäßig 10 Sekunden und nbp_connect_timeout 5 Sekunden. Fehlende oder veraltete Kurse können die Übernahme blockieren.

Neue Produkte sind standardmäßig inaktiv mit Sichtbarkeit none. Sie können sie im normalen Produkteditor prüfen und aktivieren. Für eine bewusst automatische Aktivierung unterstützt Policy JSON:

{
  "activate_created_products": true,
  "create_visibility": "both"
}

Die Sichtbarkeit bei Erstellung akzeptiert both, catalog, search oder none. Weitere unterstützte Schlüssel sind id_tax_rules_group für die Steuerregeln neuer Produkte, feed_price_tax_mode mit gross zum Herausrechnen enthaltener Steuern bei der Preisberechnung und allow_backorders für verfügbare Artikel ohne Bestand. Standardmäßig werden Preise netto interpretiert, ohne ausdrückliche Vorgabe für Bestellungen ohne Bestand.

deactivate_when_unavailable und hide_when_unavailable stehen standardmäßig auf false. Setzen Sie sie nur, wenn Lieferanten-Nichtverfügbarkeit Aktivierung oder Sichtbarkeit ändern soll. Der separate Bestellschalter steuert disable_order_when_unavailable. Automatische Kategorierichtlinien können category_max_depth, anfangs 8, und category_max_creates, anfangs 20, verwenden.

Öffnen Sie die Registerkarte Safety des Feeds. Speichern Sie diese Einstellungen vor dem Probelauf, dessen Änderungen Sie übernehmen möchten.

Der Erstellungsprozentsatz akzeptiert Verhältnisse bis 1 oder Prozentwerte über 1. Beispielsweise bedeuten 0.02 und 2 jeweils 2 %; 1 bedeutet 100 %. Sowohl Anzahl- als auch Prozentsicherungen gelten. Ein expliziter Produktumfang kann die prozentuale Freigabe auf mindestens die Produktanzahlgrenze anheben. Ein Schreiblimit entfernt andere mögliche Neuanlagen nicht automatisch aus der Erstellungssicherung.

Die Übernahme benötigt außerdem einen konfigurierten Feed, einen gültigen Bestätigungsschlüssel und einen vorherigen erfolgreichen oder mit Warnung abgeschlossenen Probelauf, der zur aktuellen Konfiguration passt. Änderungen an Richtlinien, Sicherheitslimits, Preisen, Inhaltseinstellungen oder individuellen Vorgaben können einen neuen Probelauf erfordern. Destruktive Bildvorgänge hängen zusätzlich vom geprüften Feed-Inhalt und Galeriezustand ab.

Öffnen Sie Category Mapping, wählen Sie Feed und klicken Sie auf Open. Verwenden Sie Scan feed sample, um Werte aus einem konfigurierten Feed mit generischer Zuordnung zu sammeln, oder führen Sie zuerst einen Probelauf aus.

Strategy übernimmt standardmäßig Category strategy des Feeds. Wählen Sie, ob Sie die Standardkategorie, automatische Kategoriepfade oder manuelle Zuordnungen verwenden möchten, und klicken Sie auf Save strategy. Wählen Sie für jede Feed category eine Target category und klicken Sie auf Save category maps. Anfangs bestehen keine Zuordnungen.

Individuelle Produktkategorien haben Vorrang, gefolgt von aktiven Feed-Wertzuordnungen. Diese können auch gelten, wenn die Gesamtstrategie nicht manuell ist. Ohne Zuordnung fällt die manuelle Strategie auf die Standardkategorie zurück. Die automatische Pfadstrategie ermittelt oder erstellt Kategorien unter Category root innerhalb ihrer Tiefen- und Erstellungsgrenzen. Kategorieschreibzugriffe folgen weiterhin Sync categories und Feldsperren.

Öffnen Sie Brand Mapping, wählen Sie einen Feed und verwenden Sie Scan feed brands, nachdem ein Probelauf oder eine Übernahme Markenwerte gesammelt hat. Wählen Sie für jede Feed brand einen Manufacturer. Create if missing steht standardmäßig auf No; aktivieren Sie es, um ohne ausgewählten Hersteller einen Hersteller aus dem Lieferantenmarkennamen anzulegen. Klicken Sie auf Save brand maps. Der Markenabgleich normalisiert Groß-/Kleinschreibung und Leerzeichen.

Die Markenzuweisung folgt Produktvorgaben und Feed-Markenzuordnungen, danach dem Abgleich vorhandener Herstellernamen. Die Erstellung benötigt die Erstellungserlaubnis der Zuordnung. Sync brand steuert weiterhin reguläre Schreibzugriffe. Über Delete können Sie unerwünschte Markenzuordnungen aus der Liste entfernen.

Öffnen Sie Stock Locations, um Standorte vorab anzulegen oder zu bearbeiten. Neue Feed-Standortcodes können bei der Übernahme ebenfalls Standorte anlegen.

Klicken Sie auf Save location. Die Liste zeigt Standortmodus, verknüpftes Lager, Feed-Zuordnungsanzahl, Produktanzahl, Menge und Aktivität. Delete entfernt auch die Modul-Bestandsbuchzeilen dieses Standorts.

Aktivieren Sie im Feed Sync location stock und ordnen Sie Location quantities zu. Stock aggregation bestimmt die Shopmenge: Summe, Maximum, primärer oder bestimmter Standort. Warehouse settings JSON kann feed_location_map, warehouse_map, primary_location_code, specific_location_code und country_location_map enthalten.

Primary location berücksichtigt zuerst die Länder-Standort-Zuordnung, dann den konfigurierten primären Code, danach den ersten gelieferten Standort. Specific location verwendet den konfigurierten Code; fehlt dieser in den gelieferten Mengen, ist sein Aggregat null.

Um beispielsweise nur den PL-Standort des Lieferanten zu verwenden, wählen Sie Specific location und geben Sie Folgendes ein:

{"specific_location_code":"PL"}

Werden keine Standortmengen geliefert, verwendet der Abgleich die aggregierte Feed-Menge. Verschwindet ein zuvor erfasster Standort aus einer nicht leeren Standortmengenliste, wird seine erfasste Menge als null geplant. Die Sicherung gegen massenhaftes Nullsetzen je Standort kann unerwartet große Reduzierungen blockieren.

Öffnen Sie Workbench, wählen Sie Feed und klicken Sie auf Reload feed, um einen neuen Zuordnungsprobelauf zu erstellen. Suchen Sie nach Name, EAN, SKU oder Kategorie oder verwenden Sie Status-Filter wie Matched, New, Excluded, Excluded manufacturer und Ambiguous.

Die Tabelle zeigt Quellidentität, Preis, Kategorie, Zuordnungsstatus, Ausschluss und Aktionen. Produktvorgaben enthalten anfangs keine eigenen Werte, Wertsperren oder Ausschlüsse. Geben Sie einen eigenen Titel oder Preis ein und lassen Sie dessen Wertsperre aktiviert, damit er bei der Übernahme verwendet wird. Wählen Sie eine Kategorie als Vorgabe mit Vorrang vor der normalen Kategorieermittlung. Änderungen werden automatisch gespeichert; warten Sie auf die Speicherbestätigung.

Verwenden Sie Expand, um sprachabhängige Custom title, Short description und Description zu bearbeiten, ermittelte Änderungen zu prüfen und Preis- und Bildrichtlinien oder Regeln für aus dem Feed verschwundene Produkte festzulegen. Variantengruppen lassen sich bei vorhandenen Variantendaten in ihre einzelnen Zeilen aufklappen. Explain price zeigt Berechnung und Quelldetails.

Exclude ist standardmäßig aus. Bei Aktivierung lässt Skip den Artikel unverändert; Deactivate plant die Deaktivierung eines vorhandenen Produkts. Ausgewählte Zeilen lassen sich mit Exclude selected, Deactivate selected oder Clear overrides ändern. Die Deaktivierung erfolgt über den normalen Probelauf- und Übernahmeablauf, nicht sofort beim Speichern der Vorgabe.

Mappings listet Produktverknüpfungen, Zuordnungssicherheit, Ignorierstatus, gesperrte Felder und Kategorievorbelegungen. Ignore verhindert die Verwendung einer Zuordnung für normale Synchronisierungen; Unignore hebt dies auf. Category öffnet die Auswahl Override category; speichern Sie mit Save override oder entfernen Sie die Vorgabe mit Clear category an der Zuordnung. Freeze sperrt Bestand, Preis, Verfügbarkeit, Name, Beschreibung und Bilder des Produkts in diesem Shop. Unfreeze hebt seine Produktfeldsperren auf.

Korrigieren Sie vorhandene Verknüpfungen mit Remap. Product ID enthält standardmäßig das aktuelle Ziel, Combination ID die aktuelle Variante oder 0 für ein Ziel auf Produktebene. Geben Sie gültige Ziele des ausgewählten Shops ein und klicken Sie auf Save mapping. Eine Neuzuordnung kopiert die Sperren des Quellprodukts nicht auf das Zielprodukt.

Auch der native Produkteditor kennzeichnet von Feed Sync verwaltete Felder und zeigt Feldsperren. Ein gesperrtes Feld behält den aktuellen Händlerwert auch gegenüber normalen Wertvorgaben. Nach dem Entsperren steuert wieder die wirksame Synchronisierungsrichtlinie das Feld. Sperren gemeinsam genutzter Katalogfelder können Schreibzugriffe aus einem anderen Shop mit denselben Produktdaten beeinflussen.

Führen Sie nach Änderungen an Vorgaben oder Sperren einen neuen Dry-run aus, prüfen Sie ihn und übernehmen Sie ihn über Feeds.

Setzen Sie Sync images auf Always, wenn Galerien vorhandener Produkte laufend synchronisiert werden sollen, und wählen Sie die wirksame Scoped image strategy oder geerbte Richtlinie.

Öffnen Sie Images in einer Workbench-Zeile, um Produktgalerie, liefernden Feed je Bild, die Anzahl geschützter Bilder und geplante Ergänzungen oder Löschungen zu sehen. Im Modus Augment schützt Keep ein Bild vor Feed-Löschung. Positionen sind Auto (feed order), Cover (first), Position… und Last. Eine fixierte Position schützt das Bild ebenfalls. Die Rückkehr zur automatischen Reihenfolge kann den automatisch ergänzten Schutz aufheben.

Laden Sie eigene Bilder über den normalen Produkteditor hoch. Verwenden Sie Augment, um diese Bilder zu behalten und zu fixieren. Der Workbench-Bildbereich verwaltet vorhandene Bilder; er ist kein Uploadformular.

Galerie-, Positions- und Schutzänderungen können den geprüften Plan veralten lassen. Klicken Sie vor der Übernahme auf Reload feed für einen neuen Probelauf. Gemeinsame Produkte können die Galeriereihenfolge shopübergreifend teilen; der zuletzt synchronisierende Shop kann daher diese Reihenfolge bestimmen.

Verwenden Sie Dry-run in einer Feeds-Zeile, um den konfigurierten Feed abzurufen, Artikel zuzuordnen und Änderungen zu planen, ohne Änderungen in den Katalog zu schreiben. Prüfen Sie das Ergebnis in Workbench und Runs > Details.

Das separate Formular Parse-only dry run unter Dry run nimmt Configured feed oder Feed URL und Adapter entgegen. Klicken Sie auf Run dry run, um Einlesemetriken zu sammeln. Dieser reine Einlesevorgang ersetzt nicht den für die Übernahme erforderlichen Zuordnungsprobelauf.

Prüfen Sie vor der Übernahme zugeordnete, nicht zugeordnete, doppelte, mehrdeutige, ignorierte, anzulegende, zu aktualisierende und übersprungene Zeilen. Prüfen Sie Bestands- und Verfügbarkeitsreduzierungen, Preise, Kategorien, Inhalte, Maße und Bildlöschungen. Beheben Sie Quell- und Zuordnungsprobleme und erzeugen Sie nach Änderungen einen weiteren Probelauf.

Klicken Sie beim Feed auf Apply und bestätigen Sie die Rückfrage. Die Adminaktion liefert den Bestätigungsschlüssel des Shops. Apply enabled for this feed oder Enable apply in this shop muss aktiviert sein. Das Modul ruft den Feed erneut ab, plant Änderungen, prüft Sicherungen und führt erlaubte Schreibzugriffe aus.

Läufe desselben Feeds werden nacheinander ausgeführt. Ein konkurrierender Lauf kann mit Status locked enden. Eine Sicherheitsverweigerung erzeugt blocked. Ein abgeschlossener Lauf kann übersprungene, zurückgestellte oder fehlgeschlagene Zeilen enthalten; verwenden Sie daher Zeilengründe und Übernahmezahlen zur Bewertung des Ergebnisses.

Normale Schreibzugriffe können bei seit dem Probelauf geändertem Feed-Inhalt fortfahren, sofern Konfiguration und weitere Sicherungen sie weiterhin erlauben. Destruktive Bildänderungen benötigen einen passenden geprüften Feed- und Bildplan. Maßschreibzugriffe und geprüfte Inhalts- oder Markenvorgänge können bei geänderten Eingaben ebenfalls eine neue Prüfung erfordern.

Öffnen Sie Runs und klicken Sie auf Details. Die Liste zeigt Modus, Status, geplante und übernommene Anzahlen, Sicherungsstatus, Dauer, Datum, Anheftstatus und Detailspeicherung. Details enthalten Gesamtzahlen, Metriken und Vorher-Nachher-Zeilen. Grenzen Sie Zeilen mit Action und Status unter Diff filters ein.

Mit Pin run schützen Sie Details vor der Aufbewahrungsbereinigung; Unpin run hebt den Schutz auf. Unter Run history retention zeigt Preview retention den Bereinigungsplan und Schutzgründe. Execute retention führt eine begrenzte Bereinigung aus. Meldet es Retention budget reached. Execute again to continue., wiederholen Sie den Vorgang für die verbleibenden Kandidaten. Abgelaufene Details zeigen Details compacted/expired under the retention policy.

Verwenden Sie zum Rückgängigmachen Rollback this run in den Details oder Rollback in der Liste. Rollback in der Feed-Zeile zielt auf den letzten geeigneten Übernahmelauf. Bestätigen Sie die Rückfrage und prüfen Sie den neuen Rücksetzungslauf.

Die Rücksetzung verwendet das aufgezeichnete Schreibjournal. Sie kann unterstützte geänderte Felder wiederherstellen und durch die Übernahme erstellte Produkte oder Varianten nur löschen, wenn Löschsicherungen dies erlauben. Spätere Katalogänderungen, geänderte Bilder oder Eigentumskonflikte können Wiederherstellung oder Löschung verhindern. Bereits zurückgesetzte Zeilen werden übersprungen. Teilweise und zurückgestellte Zeilen bleiben mit Gründen sichtbar; eine erfolgreiche Rücksetzungsanfrage bedeutet nicht, dass alle ursprünglichen Änderungen rückgängig gemacht wurden.

Die Standardeinstellung Ignore Omnibus price history during rollback erlaubt die Löschung eines ansonsten unveränderten, von Feed Sync erstellten Produkts, wenn nur die mpromnibus-Historie geändert wurde. Sie verwirft diese Historie nicht und umgeht keine anderen Produktänderungssicherungen.

Kopieren Sie Cron URL aus Settings > Configuration für den ausgewählten Shop. Ersetzen Sie beispielsweise diese Beispieladresse durch die tatsächliche URL:

0 * * * * curl -fsS "https://your-shop.example/module/mprfeedsync/cron?action=sync&token=YOUR_CRON_TOKEN"

action=sync und action=parse führen reine Einlesevorgänge aus. action=dryrun erzeugt Zuordnungsprobelaufdetails. Ergänzen Sie id_feed=123 für einen bestimmten konfigurierten Feed; ohne diesen Parameter führt der Endpunkt aktive Feeds aus. Jeder Aufruf verarbeitet die gewählten Feeds sofort. Schedule erzwingt in dieser Version keine feedbezogenen Intervalle.

Der öffentliche Endpunkt unterstützt außerdem action=status, action=prune_run_history und action=dropship_maintenance. Die Aufbewahrungsbereinigung zeigt standardmäßig eine Vorschau; ergänzen Sie execute=1 zur Ausführung. Lesen Sie das zurückgegebene JSON und die Ergebnisse je Feed, um abgeschlossene, blockierte und fehlgeschlagene Vorgänge zu unterscheiden.

action=apply benötigt den separaten Shop-Bestätigungsschlüssel als confirm oder apply_token, zusammen mit Cron-Token, konfiguriertem Feed, Übernahmeberechtigung und passendem vorherigem Probelauf. Das sichtbare Cron token allein autorisiert keine Katalogschreibzugriffe. Verwenden Sie für regelmäßige geprüfte Übernahmen Apply im Backoffice; Serveradministratoren können den Apply-Endpunkt oder die mitgelieferten CLI-Werkzeuge mit dem separaten Schlüssel konfigurieren.

Das Modul registriert gemeinsame Zeitplaneraufgaben für stündliches Feed-Einlesen, Wiederherstellung des Wartungszustands nach Importen alle fünf Minuten, stündliche Verlaufsbereinigung und Dropship-Ticket-Wartung alle fünfzehn Minuten. Ihre Ausführung hängt vom laufenden gemeinsamen Zeitplaner des Shops ab.

Serveradministratoren können einen Zuordnungsprobelauf direkt aus dem Shop-Stammverzeichnis ausführen:

php modules/mprfeedsync/bin/match-diff-dry-run.php --id-shop=1 --id-feed=123 --show-diffs

Das entsprechende Übernahmewerkzeug ist bin/apply.php mit expliziten Argumenten --id-shop, --id-feed und --confirm. Diese Werkzeuge unterstützen auch Produkt- und Feed-Schlüsselbereiche. Konfigurieren Sie Limits und Umfang, bevor Sie den für diese Übernahme vorgesehenen Probelauf erzeugen.

Öffnen Sie Dropship Orders > Supplier profile, um einen Lieferanten hinzuzufügen, oder wählen Sie die Schaltfläche eines vorhandenen Lieferanten zur Bearbeitung.

Klicken Sie auf Save supplier profile. Das Profilformular zeigt weder Bestellstatus-Auslöser noch E-Mail-Empfänger, HTTP-Endpunkt oder die für automatische Übermittlung nötigen Adapteroptionen. Die bloße Auswahl eines automatischen Adapters konfiguriert keinen Bestellversand. Manual B2B lässt sich über den folgenden Ticketablauf verwenden.

Hooks für Bestellerstellung und Bestellstatus sammeln Positionen aus gebundenen Feed-Zuordnungen in Lieferantentickets. Die Wartung kann versäumte Ticketerstellungen nachholen. Eine inaktive Feed-Synchronisierung entfernt für sich genommen keine Lieferantenbindung. Tickets für gemischte Bestellungen enthalten nur die dem Lieferanten zugeordneten Positionen.

Der Bestellcode beim Lieferanten stammt aus der zugeordneten Lieferanten-SKU. Fehlende oder mehrdeutige Codes bleiben Warnungen, statt durch Shopreferenz oder Lieferanten-ID ersetzt zu werden. Prüfen Sie vor der Lieferantenbestellung Warnungen zu Lieferantencode, Lieferung, Telefon, Rechnungsdaten, Währung oder widersprüchlichen Quellen.

Öffnen Sie ein Ticket über Dropship Orders oder den Dropship-Bereich der Bestellung. Kopieren Sie einzelne Werte oder verwenden Sie Copy whole ticket zur manuellen Eingabe im Lieferantensystem. Geben Sie danach Supplier order number ein und klicken Sie auf Mark placed.

Verwenden Sie Tracking numbers (one per line) und Shipment confirmation vor Save shipment. Wählen Sie Add parcels; keep ticket placed für eine Teillieferung oder I confirm the entire ticket has shipped zum Abschluss. Cancel ticket benötigt einen Cancellation reason. Reopen ticket und Correct ticket sind verfügbar, soweit der aktuelle Ticketstatus sie erlaubt.

Verwenden Sie bei einem noch nicht bestellten Ticket Preview refresh before placement, um den gespeicherten Stand mit aktuellen Bestell- und Quelldaten zu vergleichen, und gegebenenfalls Apply displayed changes. Bereits bestellte Stände sind eingefroren, ihre Vergleiche schreibgeschützt. Laden Sie die Seite neu, wenn sie eine Ticketänderung durch einen anderen Vorgang meldet.

Wenn mprwarehouserevolution für denselben Shop aktiv ist, erfasst Feed Sync dessen Dropship-Quelle zusammen mit den Feed-Zuordnungen. Die gemeinsame Quellenauflösung erkennt überlappende Positionen und Konflikte. Feed Sync verwaltet den kombinierten nativen Bestellbereich.

Die Dropship-Wartung lässt außerdem Empfängerdaten geschlossener Tickets nach dem gemeinsamen Standard von 180 Tagen ablaufen. Tickets mit gelöschten Empfängerdaten sind nur eingeschränkt bearbeitbar.

Beginnen Sie mit Details des Laufs, Reason der Zeile, Open alerts im Dashboard und dem Ergebnis von Test connection der Quelle. Verwenden Sie Settings > Integrity für Prüfungen erforderlicher Komponenten und der Datenbank. Settings > License, Support und Update öffnen die entsprechenden Verwaltungsseiten des Moduls.

Eine niedrige Zuordnungsquote erfordert oft korrigierte EAN- oder SKU-Zuordnungen. Wiederholte Lieferantenschlüssel können doppelte Zeilen erzeugen; mehrere Katalogkandidaten können zu mehrdeutigen Zuordnungen führen. Prüfen Sie diese Identitäten, bevor Sie sie als normale Aktualisierungen übernehmen.

Bleibt ein Feld unverändert, prüfen Sie seine Sync-Berechtigung, New products only, Produktfeldsperren, eigene Wertsperren, Ausschlüsse und Feed-Priorität. Prüfen Sie bei fehlenden Bildern zusätzlich Bildplan, wirksame Anzahlgrenze, Downloadlimits und ob ein neuer geprüfter Plan nötig ist.

Setzen Sie Active auf No, um einen Feed aus der Verarbeitung aller aktiven Feeds zu entfernen. Entfernen Sie auch Zeitplaneraufrufe oder CLI-Aufgaben, die diesen Feed ausdrücklich ansprechen, da explizite Feed-Aktionen ihn weiterhin ausführen können. Deaktivieren Sie zum Verhindern von Katalogübernahmen sowohl die Feed- als auch die shopweiten Übernahmeberechtigungen und stoppen Sie automatische Apply-Aufgaben.

Deaktivieren Sie das Modul im Modulmanager, um seine normalen Hooks zu stoppen. Entfernen Sie externe Zeitplanereinträge, wenn Sie es nicht mehr verwenden. Die Deaktivierung macht bereits übernommene Katalogänderungen nicht rückgängig.

Beenden Sie vor der Deinstallation aktive Importe und beheben Sie Probleme bei der automatischen Wiederherstellung des Wartungszustands. Solange diese Bedingungen nicht erfüllt sind, verweigert das Modul die Deinstallation mit Maintenance recovery must complete and active imports must finish before uninstalling.

Die Deinstallation entfernt Modulkonfiguration, Menüs, registrierte Cron-Aufgaben, Feed-Definitionen, Zuordnungen, Laufverlauf, Regeln, Warnungen und Sperren. Sie entfernt die Feed-Sync-Bindungen aus dem gemeinsamen Dropship-System; gemeinsame Dropship-Tabellen und der Verlauf bleiben erhalten. Die Deinstallation setzt weder importierte Katalogprodukte noch andere Katalogänderungen zurück. Führen Sie nötige Rücksetzungen vor dem Entfernen des Moduls und seiner Journale aus.

Erfordert PrestaShop ab 1.6.1.0 und PHP ab 7.1.