> 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](https://docs.solutioo.de/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](https://docs.solutioo.de/shopware/shopware6_en_us/configuration/load-shopware-initial-data.md) and [Shopware Mapping Hub](https://docs.solutioo.de/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.solutioo.de/shopware/shopware6_en_us/reference-and-lookup/mapping-modules-reference.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
