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
API URL, credentials and sync toggles belong to each shop (see Shops (multi-shop)), not 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 Shopware 6 Item Card → action Settings
- 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. Next to it Data Takeover: how many steps of the one-time takeover have run, counted per enabled shop and step. Not started is the normal state of a shop that starts fresh in Business Central and stays without colour; a takeover halfway through is yellow, a complete one green. A click opens the data takeover. |
| License | License FactBox for module SHOPWARE6. |
Field reference (global defaults)
| Area | Fields |
|---|---|
| Order import | Order Import Enabled |
| Synchronisation | Item Updates per Run (empty = 100) |
| Tax & currency | Default Tax, Default Tax Rate (default 19), Default Currency |
| Description | Description Template (default template for generated descriptions) |
| Sales channel | Sales Channel (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 | Product Documents Field Name (default ad_documents), Datasheet URL Field Name (ad_datasheet_url) |
| 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, Upload Documents to Shop (PDF of the posted invoice or credit memo to the shop order) – the job queue POSTSYNC sends the shipment report after posting; it marks the order as paid only with the shipment that ships the rest of the order, not on a partial shipment, see posted shipment |
| Webhooks | Webhook Base URL (Azure Function endpoint) |
| Status | Simulation Mode (whether the enabled shops run live or in Simulation Mode; a click opens the shops), Last Order Sync, Last Item Sync, Last Sync Error (highlighted in red) and Last Sync Error DateTime – display only |
Prices: prices are not set here. They come only from the sales price list assigned to the shop's sales channel in merchantCENTRAL – see Prices from merchantCENTRAL.
Standalone shops (e.g. another country or a server of their own) have catalogues of their own: default tax, default currency and sales channel are Shopware UUIDs of the respective shop. Such a shop sets values of its own on its shop card. If it inherits a value its synced catalogue does not know, the upload stops with a configuration error that leads to the shops.
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's Payment Mappings 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. |
| Data Takeover | Opens the one-time takeover of a shop that was live before Business Central (products, assignments, images, cross-selling, promotions, customers, historical orders). |
| Test Connection | Tests the connection of the canonical shop (MAIN) with an authenticated call (api/_info/config). |
| Refresh Shop Defaults | Reads default tax, default currency and sales channel from the shop via the Shopware API and fills them in. |
| 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) runs from the dashboard, the download of all products from the shop from the Data Takeover (step All Products).
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.
- Refresh Shop Defaults – read tax/currency/channel.
- Sync All Master Data (dashboard) – synchronise master data.
- Set up the Payment Mappings in the hub for
SHOPWARE6. - Create Job Queue Entries – set up and activate automatic processing.