Skip to content

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 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 multilingual names and descriptions, EAN, weight), product images, as well as stock levels and prices.

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 to the BigBuy wholesale price (your purchase price) with every price update to determine the shop's sell price.

Is the BigBuy sandbox supported?

Yes, sandbox mode can be enabled to test the order transfer and tracking flow without real transactions. Note that BigBuy's sandbox does not provide catalog data, so product, category, stock and price synchronisation cannot be tested against the sandbox — these require a production API key with Sandbox Mode disabled.

Which Shopware package is required?

The plugin requires the CNK Foundation Plugin and Shopware 6.7. 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
Sandbox Mode Use the BigBuy sandbox (api.sandbox.bigbuy.eu) instead of production (api.bigbuy.eu). No real transactions
Test connection Button that verifies the entered credentials against the BigBuy API and reports the result directly in the admin

The API key can be found in your BigBuy customer account under the API settings. Use the Test connection button to confirm the credentials are valid before saving.

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 Dropdown to select the sales channel in which imported products are made visible –
Default Category Dropdown to select the entry category under which BigBuy categories are created –
Import images Download product images from BigBuy and assign a cover image 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 Dropdown of Shopware order states; the order is set to this state after a 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:

  1. BigBuy categories are mapped to Shopware categories below the configured entry category
  2. Products are imported including descriptions, EAN, weight and images (the first image becomes the cover)
  3. Products are assigned the shop's default tax rate and, when a sales channel is configured, made visible there automatically
  4. Already imported products are identified by their BigBuy product ID and updated (no duplicate imports); downloaded images are reused on re-sync rather than fetched again

Stock & Prices

Stock levels and prices are updated every hour. The configured price markup is recalculated and applied with every update:

Shopware price (gross) = BigBuy wholesale price × (1 + markup%) + fixed markup

The markup is applied to the BigBuy wholesale (purchase) price. The resulting value is stored as the gross price; the net price is derived automatically from the shop's default tax rate.

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. After a successful transfer, the order is automatically moved to the order state selected under Status after transfer (custom order states are supported).

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:

bin/console messenger:consume async

Running a task manually (CLI)

Each task can also be triggered directly from the terminal for testing or a one-off run. The commands run the same logic as the scheduled tasks and print a summary of the results:

bin/console cnk:bigbuy:product-sync        # Product & category import
bin/console cnk:bigbuy:stock-price-sync    # Stock & price update
bin/console cnk:bigbuy:order-transfer      # Transfer pending orders
bin/console cnk:bigbuy:tracking-sync       # Retrieve tracking numbers

🛒 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 and multilingual texts
  • 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