Skip to content

Shopware 6 Connector

Overview

The merchantCENTRAL Shopware 6 Connector links one or more Shopware 6 shops directly to Microsoft Dynamics 365 Business Central. It imports orders, uploads items, prices and stock, keeps master data in sync and reports delivery, payment and order status back to the shop – directly through the Shopware 6 Admin API, with no middleware.

The connector runs entirely inside Business Central and uses the central merchantCENTRAL Hub for licensing, shipping costs, payment mapping and cross-marketplace analytics.

Server-side license

Licensing is handled centrally in Business Central per tenant + module (SHOPWARE6) via the merchantCENTRAL Hub. Without a valid license or an active demo the marketplace stays disabled. See Setup.

Feature set

Area Function
Orders Import incl. discounts/promotions, order/delivery/payment status feedback, return → credit memo, document upload
Items Upload/sync of title, prices, stock, images; per-channel visibility; custom fields; delivery time; essential characteristics
Variants Shopware variant container via an explicit variant master
Descriptions Template-based HTML descriptions from marketing text and technical data
Master data Tags, categories, manufacturers, properties, units, currencies, taxes, payment/shipping methods, sales channels, customer groups, delivery times
Documents & law Product documents into shop media, essential characteristics (§312j BGB)
Marketing Promotions, cross-selling, reviews
Customers Customer import incl. customer groups
Multi-shop Several shops per BC environment – each with its own connection, defaults and sync toggles

Architecture

flowchart LR
  subgraph SHOP["Shopware 6 (one or more shops)"]
    S1["Admin API<br>OAuth2 client credentials"]
  end
  subgraph BC["Business Central (Cloud)"]
    direction TB
    CONN["Shopware 6 Connector<br>Setup · Shops · Items · Orders · Sync"]
    HUB["merchantCENTRAL Hub<br>License · Shipping · Payment"]
    CONN --> HUB
  end
  SHOP <==>|"HTTPS / JSON · no middleware"| BC
  • Connection: OAuth2 client credentials; the access token is fetched and renewed automatically.
  • Credentials: per shop in the central credential store (SecretText), never in clear text.
  • Automation: job queue + work queue + optional webhooks (Azure Function).

Prerequisites

  • [ ] merchantCENTRAL Hub (AD merchantCENTRAL) installed and configured
  • [ ] Module license – at least a demo for module SHOPWARE6
  • [ ] Shopware 6 shop with an integration (access key ID + secret access key)
  • [ ] Permission ALN MC6 Admin (setup) or ALN MC6 User (daily work)

Order: hub first

The connector's setup wizard only opens once the hub is configured (platform guard). Set up the merchantCENTRAL Hub first.

How this help is organised

Manual as PDF

The full guide is also available as a user manual (PDF) – setup and operation in Business Central in one document. This online help is always the most up-to-date version.

Setup

Page Content
Setup wizard Guided first-time setup in 6 steps
Setup (reference) Setup Card: activation, defaults, automation, license
Shops (multi-shop) Connection, defaults and overrides per shop

Daily work

Page Content
Dashboard KPIs and quick access
Items · Item card Maintain and upload items
Variant master Variant items as a shop container
Product documents Datasheets/manuals into shop media
Essential characteristics Assign feature sets (§312j BGB)
Work queue · Log Processing and activity log

Master data

Page Content
Description templates HTML descriptions from sections
Categories · Tags · Manufacturers Catalog structure
Property sets · BC attribute mapping Properties/attributes
Tax rates · Currencies · Units Reference data
Payment methods · Shipping methods Payment & shipping
Sales channels · Customer groups · Delivery times Channels & catalogs

Marketing & automation

Page Content
Promotions · Reviews Campaigns and reviews
Item visibility Visibility per sales channel
Webhooks Real-time events via Azure Function