> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/shopware/shopware6_en_us/reference-and-lookup/mapping-modules-reference.md). # 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](/shopware/shopware6_en_us/configuration/load-shopware-initial-data.md). ### 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). {% hint style="warning" %} 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. {% endhint %} ### 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](/shopware/shopware6_en_us/configuration/load-shopware-initial-data.md) and [Shopware Mapping Hub](/shopware/shopware6_en_us/configuration/shopware-mapping-hub.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.solutioo.de/shopware/shopware6_en_us/reference-and-lookup/mapping-modules-reference.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.