BigBuy Integration¶
This plugin connects your Shopware 6 shop with the BigBuy platform and enables fully automated dropshipping: products, categories, stock levels and prices are automatically imported from the BigBuy catalogue, new orders are forwarded directly to BigBuy, and tracking information is transferred back into Shopware – all without any manual effort.
Highlights
- 🛍️ Automatic import of products, categories, variants and images
- 📦 Real-time synchronisation of stock levels and prices
- 🚀 Automatic order transfer to BigBuy (dropshipping)
- 🔍 Automatic retrieval of tracking numbers and shipping status
- ⚙️ Four configurable scheduled tasks (cron jobs)
- 💰 Configurable price markup (percentage and/or fixed amount)
❓ FAQ¶
What is BigBuy?
BigBuy is a European wholesaler and dropshipping provider with over 200,000 products. Products, prices, stock levels and orders can be fully synchronised automatically via the BigBuy REST API. An active BigBuy Ecommerce Package is required.
What data is imported from BigBuy?
The plugin imports product categories, products (including names, descriptions, EAN, weight), product images, variants, attributes as well as stock levels and prices in real time.
How does order transfer work?
As soon as a Shopware order reaches the status "In Progress", it is automatically forwarded to BigBuy. BigBuy then handles picking and shipping directly to the end customer. The BigBuy order ID is stored in the custom fields of the Shopware order.
How do tracking numbers get into the shop?
The tracking cron job retrieves current shipping information from BigBuy every hour and automatically writes the tracking number into the corresponding Shopware delivery.
Can I configure a price markup?
Yes. In the plugin configuration area you can set a percentage markup (e.g. 20 %) and/or a fixed amount (e.g. €5.00). Both values are applied with every price update.
Is the BigBuy sandbox supported?
Yes. Sandbox mode can be activated in the plugin configuration to test the integration without real transactions.
Which Shopware package is required?
The plugin requires the CNK Foundation Plugin and at least Shopware 6.6. On the BigBuy side, an active Ecommerce Package that unlocks API access is required.
🔧 Installation¶
- Prerequisite: CNK Foundation Plugin (from version 3.0.4)
- Prerequisite: BigBuy Ecommerce Package with API access
- Installation via the Shopware Plugin Manager or via Composer
- Activate the plugin:
bin/console plugin:install --activate CnkPlatformBigBuyIntegration - Register scheduled tasks:
bin/console scheduled-task:register - Configure in the Shopware administration area
⚙️ Configuration¶
API Credentials¶
| Setting | Description |
|---|---|
| API Key | Bearer token from your BigBuy customer account |
| API Base URL | Default: https://api.bigbuy.eu/rest |
| Sandbox Mode | Enable test environment (no real transactions) |
The API key can be found in your BigBuy customer account under the API settings.
Product Synchronisation¶
| Setting | Description | Default |
|---|---|---|
| Product sync enabled | Enable/disable product import | On |
| Sync interval | Frequency of product import in seconds | 86400 (24 h) |
| Product language | Language of product data (de, en, fr, es, it …) | de |
| Sales Channel ID | Shopware sales channel for imported products | – |
| Default Category ID | Entry category for BigBuy categories | – |
| Import images | Download product images from BigBuy | On |
| Batch size | Number of products per API call | 100 |
Stock & Prices¶
| Setting | Description | Default |
|---|---|---|
| Stock/price sync enabled | Enable/disable synchronisation | On |
| Sync interval | Frequency of updates in seconds | 3600 (1 h) |
| Price markup (%) | Percentage markup on BigBuy prices | 0 |
| Fixed price markup (€) | Fixed amount added to every price | 0 |
Order Transfer¶
| Setting | Description | Default |
|---|---|---|
| Order transfer enabled | Enable/disable transfer to BigBuy | On |
| Automatic transfer | Forward order immediately on status "In Progress" | On |
| Status after transfer | Shopware order status after successful transfer | in_progress |
| Carrier code | BigBuy carrier code (e.g. SEUR_STANDARD, DHL) | – |
Order Tracking¶
| Setting | Description | Default |
|---|---|---|
| Tracking sync enabled | Enable/disable tracking number synchronisation | On |
| Sync interval | Frequency of tracking queries in seconds | 3600 (1 h) |
🔄 Synchronisations in Detail¶
Product Import¶
The product import runs daily (default: every 24 hours) as a background scheduled task:
- BigBuy categories are mapped to Shopware categories below the configured entry category
- Products are imported including descriptions, EAN, weight and images
- Variants and attributes are linked to Shopware property groups
- Already imported products are identified by their BigBuy product ID and updated (no duplicate imports)
Stock & Prices¶
Stock levels and prices are updated every hour. The configured price markup is recalculated and applied with every update:
Order Transfer¶
Orders containing exclusively BigBuy products are automatically forwarded to BigBuy as soon as the status "In Progress" is set. The order ID returned by BigBuy is stored in the custom field bigbuy_order_id of the Shopware order to prevent duplicate transfers.
Order Tracking¶
Every hour, all Shopware orders with a populated bigbuy_order_id field are queried at BigBuy. As soon as BigBuy returns a tracking number, it is written into the corresponding Shopware delivery and becomes available for customer emails and order details.
⏱️ Scheduled Tasks (Cron Jobs)¶
The plugin registers four scheduled tasks:
| Task name | Purpose | Default interval |
|---|---|---|
cnk_bigbuy.product_sync | Product import & categories | 24 hours |
cnk_bigbuy.stock_price_sync | Stock & prices | 1 hour |
cnk_bigbuy.order_transfer | Transfer pending orders | 15 minutes |
cnk_bigbuy.tracking_sync | Retrieve tracking numbers | 1 hour |
Intervals can be adjusted in the Shopware administration under Settings → System → Scheduled Tasks. A running Shopware message worker is required:
🛒 Typical Use Cases¶
Pure Dropshipping¶
The shop sells exclusively BigBuy products. Products, stock levels and prices are synchronised fully automatically. Orders are forwarded to BigBuy immediately; BigBuy ships directly to the end customer.
Hybrid Shop¶
The shop carries its own products alongside BigBuy products. The plugin only synchronises products linked to a BigBuy product ID. Own products remain unaffected.
Pricing with Markup¶
Using the configurable price markup, shop operators can precisely control their margin without having to adjust prices manually.
⭐ Benefits for Shop Owners¶
- No manual product maintenance – the BigBuy catalogue stays up to date automatically
- No inventory management required – BigBuy ships directly to the end customer
- Real-time stock data reduces overselling
- Centralised configuration of all sync parameters in the Shopware admin
- Full traceability through BigBuy order IDs stored in Shopware
- Tracking numbers land automatically in Shopware – fewer customer enquiries
🧩 Feature Scope¶
- Import of BigBuy categories and products including images, variants and attributes
- Real-time synchronisation of stock levels and prices
- Configurable price markup (percentage and/or fixed amount)
- Automatic order transfer to BigBuy on status change
- Fallback cron job for pending order transfers
- Automatic import of tracking numbers into Shopware deliveries
- Four independently configurable scheduled tasks
- Sandbox mode for risk-free testing
- Error logging via Shopware logging
📚 Documentation¶
Further documentation and screenshots will follow with the next versions of the plugin.
Technical API documentation from BigBuy: https://api.bigbuy.eu/rest/doc