DataFirefly Marketplace — Vollständige Anleitung

Überblick

DataFirefly Marketplace verwandelt Ihren PrestaShop-Shop in einen Mehrverkäufer-Marktplatz. Drittanbieter registrieren sich, veröffentlichen ihre Produkte und verwalten ihre Bestellungen, während Sie Provisionen, Zahlungen und Compliance im Back Office steuern.

Das Modul deckt den gesamten Zyklus ab: Verkäuferregistrierung und -freigabe, vollständiger Verkäuferbereich, echte Bestellaufteilung in Unterbestellungen, Provisions-Engine, regulierte Splitzahlung (Mangopay und Stripe Connect), Versand pro Verkäufer, EU-Compliance (DSA, P2B, MwSt.), Bewertungen, Nachrichten, Pläne, Streitfälle und Analysen, alles in fünf Sprachen (FR, EN, ES, DE, IT).

Kompatibilität und Voraussetzungen

• PrestaShop 8.0, 8.1, 8.2 und 9.x
• PHP 8.1 oder höher
• Multishop und mehrsprachig
• Für die Splitzahlung: ein Mangopay- und/oder Stripe-Connect-Konto (Sandbox-Schlüssel zum Testen, Produktionsschlüssel für den Betrieb)

Installation

1. Gehen Sie im Back Office zu Module > Modulmanager, klicken Sie auf Modul hochladen und wählen Sie das Archiv dfmarketplace.zip.
2. Die Installation erstellt die erforderlichen Tabellen, registriert die Hooks und fügt das Menü Marketplace zum Back Office hinzu, zusammen mit einem Demo-Datensatz (Pläne und Provisionsregeln).
3. Öffnen Sie Marketplace > Konfiguration, um das Modul einzurichten.

Erste Konfiguration

Legen Sie unter Marketplace > Konfiguration die wichtigsten Parameter fest:

• Standardprovision: Satz, der angewendet wird, wenn keine spezifischere Regel existiert (standardmäßig 15 %).
• Standard-Zahlungsanbieter: Mangopay oder Stripe Connect, anschließend die entsprechenden Schlüssel.
• Hybridmodus: erlaubt dem Betreiber, eigene Produkte neben Drittanbietern zu verkaufen.
• Unterbestellungen fakturieren: erstellt eine eigene Rechnung für jede Verkäufer-Unterbestellung.
• Status für Treuhand-Freigabe: Bestellstatus, der die Freigabe der Gelder an die Verkäufer-Wallets auslöst (z. B. „Versendet“ oder „Geliefert“).
• Verkäuferidentität anzeigen (DSA): aktiviert den Identitätsblock des gewerblichen Verkäufers im Schaufenster.
• Präfix der Provisionsrechnung und P2B-Vorankündigung (Tage).
• Automatische Produktfreigabe: wenn aktiviert, werden Verkäuferprodukte ohne Moderation veröffentlicht.

Verkäuferverwaltung

Registrierung

Ein angemeldeter Kunde kann über die Registrierungsseite des Moduls (verlinkt aus seinem Konto) Verkäufer werden. Er gibt den Shopnamen, seine Rechtsform und seine rechtlichen Angaben ein. Eine Bestätigungs-E-Mail wird gesendet.

Freigabe und KYC

Unter Marketplace > Verkäufer kann der Betreiber einen Verkäufer freigeben, sperren oder ablehnen. Bei der Freigabe wird das PSP-Onboarding ausgelöst und eine Freigabe-E-Mail gesendet. Der Verkäufer kann seine KYC-Dokumente (Handelsregisterauszug, Ausweis, Bankverbindung) aus seinem Dashboard hochladen.

Verkäuferbereich

Jeder Verkäufer hat ein abgeschottetes Dashboard: Er greift nur auf seine eigenen Daten zu.

• Dashboard: Wallet-Saldo, auszuzahlender Betrag, Anzahl der Produkte, Status, Bestellungen, Hauptbuch.
• Mein Profil: Logo, Banner, Präsentation, Rückgabe- und Versandrichtlinien, öffentliche Kontaktdaten und DSA-Felder.
• Meine Produkte: Erstellung und Bearbeitung vollständiger Produktblätter (Fotos, Referenz/SKU, EAN, Zustand, Preis und MwSt., Menge, Kategorie, Gewicht und Maße, Beschreibungen).
• Versand: Auswahl der angebotenen Versanddienstleister und Kostenregeln (nach Preis oder Gewicht, nach Zone, mit Gratis-Schwelle).

Bestellaufteilung

Enthält eine Bestellung Produkte mehrerer Verkäufer, teilt das Modul sie in echte Unterbestellungen (eine pro Verkäufer) auf. Jede Unterbestellung hat eigene Versandkosten, eine fixierte Provision, eine Rechnung und eine Wallet-Gutschrift. Das logische Detail wird zur Nachvollziehbarkeit beibehalten, und die Trennung zwischen Verkäufern ist strikt.

Provisionen

Die Engine wendet eine Kaskade von Regeln an, von der spezifischsten zur allgemeinsten: Produkt › Verkäufer › Kategorie › global, mit Rückfall auf die Standardprovision. Regeln können prozentual, als fester Betrag oder hybrid sein, auf Brutto- oder Nettobasis.

Monatliche Umsatzstufen werden unterstützt: zum Beispiel 15 % bis 5.000 € Monatsumsatz, dann 12 % darüber. Die Provision wird zum Bestellzeitpunkt fixiert und nie neu berechnet.

Splitzahlung, Wallet und Treuhand

Die Mangopay- und Stripe-Connect-Adapter ziehen die Gelder aufgeteilt ein und halten sie treuhänderisch. Bei Erreichen des konfigurierten Bestellstatus werden die Gelder an die Verkäufer-Wallets freigegeben.

Auszahlungen

Der Verkäufer beantragt eine Auszahlung aus seinem Dashboard. Der Betreiber führt die Auszahlungen unter Marketplace > Provisionen & Zahlungen mit einem Klick aus (SEPA-Überweisung über den PSP). Jede Bewegung wird im Wallet-Hauptbuch erfasst.

Webhooks

Konfigurieren Sie die Webhook-URL des Moduls auf PSP-Seite (Controller webhook), um die Zahlungsstatus zu synchronisieren. Die Signatur wird bei jedem Aufruf geprüft.

Versand pro Verkäufer

Jeder Verkäufer definiert seine Versanddienstleister und Kostenregeln. Beim Versand gibt er Dienstleister und Sendungsnummer in seinem Dashboard ein: Eine E-Mail wird an den Käufer gesendet, und sobald alle Unterbestellungen einer Bestellung versendet sind, wechselt die übergeordnete Bestellung automatisch in den Status „Versendet“.

EU-Compliance

• DSA: Die Identität des gewerblichen Verkäufers (Firma, Registernummer, MwSt., Kontaktstelle) wird in seinem Schaufenster angezeigt.
• Provisionsrechnungen: automatisch pro Monatsperiode erstellt, nummeriert und archiviert. Der Betreiber kann die Sammelerstellung unter Marketplace > Provisionsrechnungen starten.
• P2B: Eine Seite veröffentlicht die Verkäuferbedingungen, die Ranking-Parameter und die Vorankündigungsfrist bei Änderungen.
• MwSt. „Plattform als fiktiver Lieferant“: Ein Indikator pro Verkäufer wird angezeigt und auf die Provisionsrechnung übertragen.

Bewertungen, Nachrichten, Pläne, Streitfälle und Analysen

• Bewertungen: Käufer, die bei einem Verkäufer bestellt haben, können eine Bewertung hinterlassen, moderiert unter Marketplace > Bewertungen. Die Durchschnittsnote wird automatisch neu berechnet.
• Nachrichten: Threads zwischen Käufer, Verkäufer und Betreiber; Posteingang auf Verkäuferseite.
• Verkäuferpläne: standardmäßig Free, Pro und Premium, mit Produktkontingenten, Provisionssatz und Analysezugriff. Verwaltet unter Marketplace > Verkäuferpläne.
• Streitfälle und Rücksendungen: pro Unterbestellung eröffnet, gelöst unter Marketplace > Streitfälle & Rücksendungen, mit etwaiger Erstattung auf das Verkäufer-Wallet.
• Analysen: Betreiberansicht (GMV, Take Rate, Top-Verkäufer) unter Marketplace > Analysen und Statistiken pro Verkäufer (je nach Plan) in seinem Dashboard.

Back-Office-Reiter

Das Menü Marketplace gruppiert: Verkäufer, Verkäuferbestellungen, Provisionen & Zahlungen, Provisionsrechnungen, Bewertungen, Streitfälle & Rücksendungen, Verkäuferpläne, Analysen und Konfiguration.

FAQ und Fehlerbehebung

Die Gelder werden nicht an die Verkäufer freigegeben

Prüfen Sie, dass der „Status für Treuhand-Freigabe“ in der Konfiguration gesetzt ist und dass die betroffenen Verkäufer das PSP-Onboarding abgeschlossen haben (Wallet erstellt).

Ein Verkäuferprodukt erscheint nicht im Shop

Ein Produkt bleibt verborgen, bis es freigegeben ist. Prüfen Sie seinen Freigabestatus in der Produktliste des Verkäufers oder aktivieren Sie die automatische Freigabe.

Nach einem Update zeigt ein Admin-Bildschirm einen Fehler

Leeren Sie den PrestaShop-Cache (Ordner var/cache) nach Installation oder Update und laden Sie das Back Office neu.