# DataFirefly Marketplace — Vollständige Anleitung > Vollständige Installations-, Konfigurations- und Nutzungsanleitung für das Modul DataFirefly Marketplace für PrestaShop 8 und 9. - Seite: - Sprache: de - Aktualisiert am: 2026-06-27 - Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/datafirefly-marketplace/index.md), [en](https://www.datafirefly.com/en/documentation/datafirefly-marketplace/index.md), [es](https://www.datafirefly.com/es/documentation/datafirefly-marketplace/index.md), [it](https://www.datafirefly.com/it/documentation/datafirefly-marketplace/index.md), [pl](https://www.datafirefly.com/pl/documentation/datafirefly-marketplace/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafirefly-marketplace/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafirefly-marketplace/index.md) - Index: ## Ü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. Bei der Deinstallation werden die Datentabellen bewusst **beibehalten**, damit der Verlauf von Verkäufern, Bestellungen und Provisionen nicht verloren geht. ## 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. Gemäß der P2B-Verordnung wird jede Sperrung von einer E-Mail an den Verkäufer begleitet, mit einer gesondert übermittelten Begründung. ## 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. Die Rechnung der übergeordneten Bestellung folgt dem nativen PrestaShop-Ablauf. Prüfen Sie in Ihrer Version, dass das Zahlungsmodul nicht vor der Aufteilung eine übergeordnete Rechnung über den Gesamtbetrag fixiert. ## 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. Das Modul stellt den MwSt.-Indikator bereit und zeigt ihn an, enthält jedoch keine OSS-Aufteilungs-Engine. Die feine MwSt.-Aufteilung bleibt von der Steuerkonfiguration Ihres Shops abhängig. ## 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.