Shopware 6 Setup
Central setup page for the Shopware 6 Connector. It brings together activation in the hub, the company-wide defaults, the shop list, automation and the license.
Connection lives on the shop
Since the multi-shop architecture, API URL, credentials and sync toggles belong to each shop (see Shops (multi-shop)), no longer to the setup card. The setup card holds the company-wide default values; an empty shop field inherits the default.
Opening the page
- Via Search: Shopware 6 Setup
- Via the Dashboard → action Setup
- Via the marketplace card in the merchantCENTRAL Hub → Activate in Hub (reverse path)
Page structure
| Section | Content |
|---|---|
| Activation | Toggle Enabled – activates the marketplace in the hub. Requires a valid license or active demo; if neither exists, the demo registration opens. |
| Shopware 6 Settings | The company-wide default settings (see field reference). |
| Shops | Embedded shop list (identical to Manage Shops). |
| Automation | Job Queue Status – shows whether the background tasks are set up and ready. Drill-down opens the entries. |
| License | License FactBox for module SHOPWARE6. |
Field reference (global defaults)
| Area | Fields |
|---|---|
| Tax & currency | Default Tax ID, Default Tax Rate (default 19), Default Currency ID |
| Prices | Price List Code (default SHOP) |
| Description | Description Template (default template for generated descriptions) |
| Sales channel | Sales Channel ID (required for SEO URL upload) |
| Variants | Variant Container Suffix (default M) |
| Custom fields | Custom Field 1/2 (boolean) + Custom Text 1/2 – each API name and label |
| Product documents | Documents Field Name (default ad_documents), Datasheet URL Field Name (ad_datasheet_url), Upload Documents to Shop |
| Cross-selling | Cross-Selling Group Name (Accessories/Related) and (Similar) |
| Master data images | Master Data Image Mode (Disabled / Store URL / Hub Media Storage) |
| Process | Suppress Status Change on Shipping, Auto Payment Status on Ship, Auto Credit Memo on Return |
| Webhooks | Webhook Base URL (Azure Function endpoint) |
Secure credential storage
Access Key ID, Secret Access Key and OAuth2 token are stored per shop in the central credential store (SecretText) – never in clear text in the database. Entry uses the drill-down pattern (no masked field).
Shipping costs and payment methods
Shipping costs are configured centrally in the merchantCENTRAL Hub. Payment method mappings are set up via the hub table Payment Mapping for marketplace code SHOPWARE6. Discounts and promotions from Shopware are imported automatically as discount lines.
Actions
| Action | Description |
|---|---|
| Setup Wizard | Opens the guided setup wizard. |
| Manage Shops | Opens the shop list – connection and defaults per shop. |
| Test Connection | Tests the connection of the canonical shop (MAIN) with an authenticated call (api/_info/config). |
| Fetch Shop Defaults | Determines the default tax ID and currency ID automatically via the Shopware API. |
| Init Shop Price List | Rebuilds the BC price list from all Shopware 6 item prices (via the hub). |
| Create Job Queue Entries | Creates the default job queue entries for automatic synchronisation. |
| Open Job Queue Entries | Opens the connector's job queue entries. |
| Activate in Hub | Opens the Shopware 6 marketplace card in the hub (license/activation). |
Master data & dashboard
Master data synchronisation (Sync All Master Data) and the reverse import from the shop (Sync from Shop) run from the dashboard.
First-time setup (step by step)
Easiest via the setup wizard. Manually:
- Set up the hub first (platform guard).
- Turn on Enabled – if no license/demo exists, the demo registration opens.
- Manage Shops → create shop (
MAIN): API URL, Access Key ID, Secret Access Key. - Test Connection – verify the connection.
- Fetch Shop Defaults – fetch tax/currency/channel.
- Sync All Master Data (dashboard) – synchronise master data.
- Set up payment method mapping in the hub for
SHOPWARE6. - Create Job Queue Entries – set up and activate automatic processing.