Mapping Modules (Reference)

The Shopware assignment (mapping) links values from Business Central with the corresponding Shopware entities. It is organized into modules. This reference lists all modules, their purpose, and the most important mapping fields. All modules are pre-filled with the existing Shopware values by Load Shopware Initial Data.

Basic modules

Module	Purpose
Payment Mapping	Map payment methods (Shopware ↔ BC).
Shipping Mapping	Map shipping methods.
Tax Mapping	Map tax rates.
Item Tax Mapping	Item tax per VAT product posting group.
Item Mapping	Item assignment.
Item Attribute Mapping	Attributes/properties and options.
Customer Mapping	Customer assignment.
Customer Group	Customer groups.
Customer Price Mapping	Customer group/price assignment.
Currency	Currencies (default set via is Selected).
Sales Channel	Sales channels (default set via is Selected).
Salutations	Salutations.
Country	Countries/regions.
Language	Languages (the basis for multilingual transfer).
State Machine / State Machine State / State Machine Transition	Order status and status transitions.
Order Status / Return Order Status	Order and return status.

Advanced / Premium modules

Module	Purpose
ParentItem	Assignment of parent variant items.
Wild Card Tax	Special/exception tax via wildcards.
Invoice Documents / Grouped Products / B2B / SharePoint	Premium functions; require the respective Shopware plugin.

Important mapping fields

Each mapping line has, among others, the following fields:

Field	Meaning
Module Name	The corresponding module (see above).
Shopware Code / Description / ID	Value and ID on the Shopware side.
BC Code / Description	The assigned value in Business Central.
Use Default / Default Value	Default value used if no explicit assignment applies.
is Selected	Marks the default value for Currency, Sales Channel, and Customer Group.
Use Wild Card	Enables a wildcard assignment (for example, for taxes).
General Field 1–3	Additional fields for module-specific information.
isActive	Enables/disables the assignment.

Default values via "is Selected"

For Currency, Sales Channel, and Customer Group, the is Selected field marks the respective default value. This value is used automatically or assigned to newly created objects (for example, the default sales channel for new products or the default currency for prices).

A missing or incorrect assignment – for example for a payment method, shipping method, or tax – can result in orders not being processed correctly or products being created with the wrong tax rate. Check the assignments after every initial data download.

Interaction with the initial data download

Using the Download Initial Data action, the connector loads the existing Shopware values (payment methods, shipping methods, taxes, tax rules, currencies, sales channels, customer groups, salutations, countries, languages, as well as state machines and their transitions) and makes them available for assignment in the mapping modules. For details, see Load Shopware Initial Data and Shopware Mapping Hub.