BigBuy-Integration¶
Dieses Plugin verbindet Ihren Shopware 6 Shop mit der BigBuy-Plattform und ermöglicht vollautomatisches Dropshipping: Produkte, Kategorien, Lagerbestände und Preise werden automatisch aus dem BigBuy-Katalog importiert, neue Bestellungen direkt an BigBuy weitergeleitet und Trackinginformationen zurück in Shopware übertragen – alles ohne manuellen Aufwand.
Highlights
- 🛍️ Automatischer Import von Produkten, Kategorien, Varianten und Bildern
- 📦 Echtzeit-Synchronisierung von Lagerbeständen und Preisen
- 🚀 Automatische Bestellübertragung an BigBuy (Dropshipping)
- 🔍 Automatische Übernahme von Trackingnummern und Versandstatus
- ⚙️ Vier konfigurierbare Scheduled Tasks (Cronjobs)
- 💰 Konfigurierbarer Preisaufschlag (prozentual und/oder fix)
❓ FAQ¶
Was ist BigBuy?
BigBuy ist ein europäischer Großhändler und Dropshipping-Anbieter mit über 200.000 Produkten. Über die BigBuy REST API können Produkte, Preise, Bestände und Bestellungen vollautomatisch synchronisiert werden. Ein aktives BigBuy Ecommerce-Paket ist Voraussetzung.
Welche Daten werden von BigBuy importiert?
Das Plugin importiert Produktkategorien, Produkte (inkl. Namen, Beschreibungen, EAN, Gewicht), Produktbilder, Varianten, Attribute sowie Lagerbestände und Preise in Echtzeit.
Wie funktioniert die Bestellübertragung?
Sobald eine Shopware-Bestellung den Status „In Bearbeitung" erreicht, wird sie automatisch an BigBuy übertragen. BigBuy übernimmt anschließend die Kommissionierung und den Versand direkt an den Endkunden. Die BigBuy-Bestell-ID wird in den Custom Fields der Shopware-Bestellung gespeichert.
Wie gelangen Trackingnummern in den Shop?
Der Tracking-Cronjob ruft stündlich die aktuellen Versandinformationen von BigBuy ab und schreibt die Trackingnummer automatisch in die zugehörige Shopware-Lieferung.
Kann ich einen Preisaufschlag konfigurieren?
Ja. Im Plugin-Konfigurationsbereich können Sie einen prozentualen Aufschlag (z. B. 20 %) und/oder einen fixen Betrag (z. B. 5,00 €) einstellen. Beide Werte werden bei jeder Preisaktualisierung angewendet.
Wird BigBuy-Sandbox unterstützt?
Ja. In der Plugin-Konfiguration kann der Sandbox-Modus aktiviert werden, um die Integration ohne echte Transaktionen zu testen.
Welches Shopware-Paket wird benötigt?
Das Plugin setzt das CNK Foundation Plugin voraus und erfordert mindestens Shopware 6.6. Auf Seite von BigBuy ist ein aktives Ecommerce-Paket notwendig, das den API-Zugang freischaltet.
🔧 Installation¶
- Voraussetzung: CNK Foundation Plugin (ab Version 3.0.4)
- Voraussetzung: BigBuy Ecommerce-Paket mit API-Zugang
- Installation über den Shopware Plugin-Manager oder per Composer
- Plugin aktivieren:
bin/console plugin:install --activate CnkPlatformBigBuyIntegration - Scheduled Tasks registrieren:
bin/console scheduled-task:register - Konfiguration im Shopware-Administrationsbereich vornehmen
⚙️ Konfiguration¶
API-Zugangsdaten¶
| Einstellung | Beschreibung |
|---|---|
| API-Schlüssel | Bearer Token aus Ihrem BigBuy-Kundenkonto |
| API Base URL | Standard: https://api.bigbuy.eu/rest |
| Sandbox-Modus | Testumgebung aktivieren (kein Echtbetrieb) |
Den API-Schlüssel finden Sie in Ihrem BigBuy-Kundenkonto unter den API-Einstellungen.
Produkt-Synchronisierung¶
| Einstellung | Beschreibung | Standard |
|---|---|---|
| Produktsync aktiviert | Produktimport ein-/ausschalten | Ein |
| Sync-Intervall | Häufigkeit des Produktimports in Sekunden | 86400 (24 h) |
| Produktsprache | Sprache der Produktdaten (de, en, fr, es, it …) | de |
| Sales-Channel-ID | Shopware-Sales-Channel für importierte Produkte | – |
| Standard-Kategorie-ID | Einstiegskategorie für BigBuy-Kategorien | – |
| Bilder importieren | Produktbilder von BigBuy herunterladen | Ein |
| Batch-Größe | Anzahl Produkte pro API-Aufruf | 100 |
Bestand & Preise¶
| Einstellung | Beschreibung | Standard |
|---|---|---|
| Bestand/Preis-Sync aktiviert | Synchronisierung ein-/ausschalten | Ein |
| Sync-Intervall | Häufigkeit der Aktualisierung in Sekunden | 3600 (1 h) |
| Preisaufschlag (%) | Prozentualer Aufschlag auf BigBuy-Preise | 0 |
| Fixer Preisaufschlag (€) | Fixer Betrag der auf jeden Preis addiert wird | 0 |
Bestellübertragung¶
| Einstellung | Beschreibung | Standard |
|---|---|---|
| Bestellübertragung aktiviert | Übertragung an BigBuy ein-/ausschalten | Ein |
| Automatische Übertragung | Bestellung sofort bei Status „In Bearbeitung" übertragen | Ein |
| Status nach Übertragung | Shopware-Bestellstatus nach erfolgreicher Übertragung | in_progress |
| Versanddienstleister-Code | BigBuy-Carrier-Code (z. B. SEUR_STANDARD, DHL) | – |
Sendungsverfolgung¶
| Einstellung | Beschreibung | Standard |
|---|---|---|
| Tracking-Sync aktiviert | Trackingnummer-Synchronisierung ein-/ausschalten | Ein |
| Sync-Intervall | Häufigkeit der Tracking-Abfragen in Sekunden | 3600 (1 h) |
🔄 Synchronisierungen im Detail¶
Produktimport¶
Der Produktimport läuft täglich (Standard: alle 24 Stunden) als Scheduled Task im Hintergrund:
- BigBuy-Kategorien werden in Shopware-Kategorien unterhalb der konfigurierten Einstiegskategorie abgebildet
- Produkte werden inkl. Beschreibungen, EAN, Gewicht und Bildern importiert
- Varianten und Attribute werden mit den Shopware-Eigenschaftsgruppen verknüpft
- Bereits importierte Produkte werden anhand der BigBuy-Produkt-ID erkannt und aktualisiert (kein Duplikat-Import)
Bestand & Preise¶
Lagerbestände und Preise werden stündlich aktualisiert. Der konfigurierte Preisaufschlag wird bei jeder Aktualisierung neu berechnet und angewendet:
Bestellübertragung¶
Bestellungen, die ausschließlich BigBuy-Produkte enthalten, werden automatisch an BigBuy übertragen, sobald der Status „In Bearbeitung" gesetzt wird. Die von BigBuy zurückgegebene Bestell-ID wird im Custom Field bigbuy_order_id der Shopware-Bestellung gespeichert, um Doppelübertragungen zu verhindern.
Sendungsverfolgung¶
Stündlich werden alle Shopware-Bestellungen mit gesetztem bigbuy_order_id-Feld bei BigBuy abgefragt. Sobald BigBuy eine Trackingnummer zurückliefert, wird diese in die zugehörige Shopware-Lieferung eingetragen und ist damit für Kunden-E-Mails und Bestelldetails verfügbar.
⏱️ Scheduled Tasks (Cronjobs)¶
Das Plugin registriert vier Scheduled Tasks:
| Task-Name | Aufgabe | Standard-Intervall |
|---|---|---|
cnk_bigbuy.product_sync | Produktimport & Kategorien | 24 Stunden |
cnk_bigbuy.stock_price_sync | Bestand & Preise | 1 Stunde |
cnk_bigbuy.order_transfer | Ausstehende Bestellungen übertragen | 15 Minuten |
cnk_bigbuy.tracking_sync | Trackingnummern abrufen | 1 Stunde |
Die Intervalle können im Shopware-Administrationsbereich unter Einstellungen → System → Geplante Aufgaben angepasst werden. Voraussetzung für die Ausführung ist ein laufender Shopware-Message-Worker:
🛒 Typische Anwendungsfälle¶
Reines Dropshipping¶
Der Shop verkauft ausschließlich BigBuy-Produkte. Produkte, Bestände und Preise werden vollautomatisch synchronisiert. Bestellungen werden sofort an BigBuy weitergeleitet, BigBuy versendet direkt an den Endkunden.
Hybridshop¶
Der Shop führt eigene Produkte und BigBuy-Produkte parallel. Das Plugin synchronisiert nur Produkte, die mit einer BigBuy-Produkt-ID verknüpft sind. Eigene Produkte bleiben unberührt.
Preisgestaltung mit Aufschlag¶
Mithilfe des konfigurierbaren Preisaufschlags können Shopbetreiber ihre Marge gezielt steuern, ohne Preise manuell anpassen zu müssen.
⭐ Vorteile für Shopbetreiber¶
- Kein manueller Produktpflegeaufwand – BigBuy-Katalog bleibt automatisch aktuell
- Keine Lagerhaltung – BigBuy übernimmt Versand direkt an den Endkunden
- Echtzeit-Bestandsdaten reduzieren Überverkäufe
- Zentrale Konfiguration aller Sync-Parameter im Shopware-Admin
- Vollständige Nachvollziehbarkeit durch BigBuy-Bestell-IDs in Shopware
- Trackingnummern landen automatisch in Shopware – weniger Kundenanfragen
🧩 Funktionsumfang¶
- Import von BigBuy-Kategorien und -Produkten inkl. Bilder, Varianten und Attribute
- Echtzeit-Synchronisierung von Lagerbeständen und Preisen
- Konfigurierbarer Preisaufschlag (prozentual und/oder fix)
- Automatische Bestellübertragung an BigBuy beim Statuswechsel
- Fallback-Cronjob für ausstehende Bestellübertragungen
- Automatischer Import von Trackingnummern in Shopware-Lieferungen
- Vier unabhängig konfigurierbare Scheduled Tasks
- Sandbox-Modus für gefahrlose Tests
- Fehlerprotokollierung über Shopware-Logging
📚 Dokumentation¶
Weitere Dokumentationsinhalte und Screenshots folgen mit den nächsten Versionen des Plugins.
Technische API-Dokumentation von BigBuy: https://api.bigbuy.eu/rest/doc