Setup Wizard
Guided first-time setup of the Shopware 6 Connector in 6 steps. The wizard creates the first shop (MAIN), tests the connection, fetches the shop defaults and optionally sets up automatic synchronisation.
Opening the page
- Via Search (
Alt+Q): Assisted Setup → group "AD merchantCENTRAL – Setup" → "Set up the Shopware 6 Connector" - Via Setup (Setup Card) → action Setup Wizard
Order: hub first
The wizard only opens once the merchantCENTRAL Hub is configured (platform guard). Set up the hub first.
The 6 steps
Step 1 – Welcome
Overview and enter a shop name (e.g. your shop or brand name). The name appears in messages and lists. You can add more shops later via Manage Shops.
Step 2 – API configuration
| Field | Description |
|---|---|
| API URL | Base URL of the shop, e.g. https://myshop.com/. |
| Access Key ID | Access key from the Shopware integration. Enter via drill-down. |
| Secret Access Key | Secret key of the integration. Enter via drill-down. |
Secure storage
The secrets are stored in the central credential store (SecretText) and not shown again – the display only reads "Configured / Not configured".
Step 3 – Connection test
The action Test Connection checks the OAuth2 credentials with an authenticated call to api/_info/config. A green status confirms that orders, items and stock can be synchronised.
Step 4 – Shop defaults
The action Fetch Defaults reads from the shop:
| Field | Description |
|---|---|
| Default Tax / Default Tax Rate | Default tax rate. The drill-down lets you pick another synced tax rate. |
| Default Currency | Default currency. |
| Sales Channel | Sales channel for item visibility and SEO URLs. |
The corresponding UUID is stored automatically in each case.
Step 5 – Order & item settings
| Area | Fields |
|---|---|
| Orders | Order Import Enabled, Max Orders Per Run, Order Date Filter |
| Items | Item Sync Enabled, Price Sync Enabled, Inventory Sync Enabled, Price List Code |
All values can be changed later on the Setup Card and per shop on the Shop Card.
Step 6 – Finish
Summary including the shop name from step 1. Two options:
- Create Job Queue Entries – creates the default background tasks for automatic synchronisation (default: on).
- Open the dashboard when finished – opens the Dashboard after closing.
Finish saves the shop and completes the assisted setup.
Recommended next steps
After the wizard:
- Sync master data (taxes, currencies, categories …) via the dashboard or the Setup Card.
- Map items to the Shopware 6 item list.
- Payment method mapping in the hub under Payment Mapping for
SHOPWARE6. - Add more shops as needed via Manage Shops (multi-shop).