Skip to content

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 Refresh Shop 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 – determined from the selected sales channel.
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, Currency Code

Shop currency

If the shop sells in a currency other than the local currency, enter the BC Currency Code (e.g. PLN) – the sales price list of the shop has to be kept in this currency, nothing is converted. The prices themselves come from merchantCENTRAL, see Prices from merchantCENTRAL. Empty = local currency.

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. Three 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.
  • This shop already contains products and orders – for a shop that was live before Business Central: after closing, the Data Takeover opens with the one-time imports (products, assignments, images, cross-selling, vouchers, customers, order history). Leave it off for a shop that starts fresh.

Finish saves the shop and completes the assisted setup.

After the wizard:

  1. Sync master data (taxes, currencies, categories …) via the dashboard (Sync All Master Data).
  2. Map items to the Shopware 6 item list.
  3. Payment Mappings in the hub for SHOPWARE6.
  4. Add more shops as needed via Manage Shops (multi-shop).