> 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/referenz-and-nachschlagewerk/mapping-module-referenz.md).

# Mapping-Module (Referenz)

Die **Shopware Zuordnung (Mapping)** verknüpft Werte aus Business Central mit den passenden Shopware-Entitäten. Sie ist nach **Modulen** gegliedert. Diese Referenz listet alle Module, ihren Zweck und die wichtigsten Mapping-Felder. Alle Module werden über **Shopware Erstdaten laden** mit den vorhandenen Shopware-Werten vorbefüllt.

### Basis-Module

| Modul                                                              | Zweck                                                |
| ------------------------------------------------------------------ | ---------------------------------------------------- |
| **Payment Mapping**                                                | Zahlungsarten zuordnen (Shopware ↔ BC).              |
| **Shipping Mapping**                                               | Versandarten zuordnen.                               |
| **Tax Mapping**                                                    | Steuersätze zuordnen.                                |
| **Item Tax Mapping**                                               | Artikelsteuer je MwSt.-Produktbuchungsgruppe.        |
| **Item Mapping**                                                   | Artikelzuordnung.                                    |
| **Item Attribute Mapping**                                         | Attribute/Eigenschaften und Optionen.                |
| **Customer Mapping**                                               | Kundenzuordnung.                                     |
| **Customer Group**                                                 | Kundengruppen.                                       |
| **Customer Price Mapping**                                         | Kundengruppen-/Preiszuordnung.                       |
| **Currency**                                                       | Währungen (Standard über *is Selected*).             |
| **Sales Channel**                                                  | Verkaufskanäle (Standard über *is Selected*).        |
| **Salutations**                                                    | Anreden.                                             |
| **Country**                                                        | Länder.                                              |
| **Language**                                                       | Sprachen (Grundlage der mehrsprachigen Übertragung). |
| **State Machine / State Machine State / State Machine Transition** | Bestellstatus und Statusübergänge.                   |
| **Order Status / Return Order Status**                             | Bestell- und Retourenstatus.                         |

### Erweiterte / Premium-Module

| Modul                                                       | Zweck                                                        |
| ----------------------------------------------------------- | ------------------------------------------------------------ |
| **ParentItem**                                              | Zuordnung übergeordneter Varianten-Artikel (Parent).         |
| **Wild Card Tax**                                           | Sonder-/Ausnahmesteuer über Platzhalter.                     |
| **Invoice Documents / Grouped Products / B2B / SharePoint** | Premium-Funktionen; erfordern das jeweilige Shopware-Plugin. |

### Wichtige Mapping-Felder

Jede Mapping-Zeile besitzt u. a. folgende Felder:

| Feld                                 | Bedeutung                                                                             |
| ------------------------------------ | ------------------------------------------------------------------------------------- |
| **Module Name**                      | Zugehöriges Modul (siehe oben).                                                       |
| **Shopware Code / Description / ID** | Wert und ID auf Shopware-Seite.                                                       |
| **BC Code / Description**            | Zugeordneter Wert in Business Central.                                                |
| **Use Default / Default Value**      | Standardwert, falls keine explizite Zuordnung greift.                                 |
| **is Selected**                      | Markiert den Standardwert bei **Currency**, **Sales Channel** und **Customer Group**. |
| **Use Wild Card**                    | Aktiviert eine Platzhalter-Zuordnung (z. B. bei Steuern).                             |
| **General Field 1–3**                | Zusatzfelder für modulspezifische Angaben.                                            |
| **isActive**                         | Aktiviert/deaktiviert die Zuordnung.                                                  |

### Standardwerte über „is Selected“

Für **Currency**, **Sales Channel** und **Customer Group** markiert das Feld **is Selected** den jeweiligen Standardwert. Dieser wird automatisch verwendet bzw. neu angelegten Objekten zugewiesen (z. B. der Standard-Verkaufskanal für neue Produkte oder die Standardwährung für Preise).

{% hint style="warning" %}
Eine fehlende oder falsche Zuordnung – etwa bei Zahlungs-, Versandart oder Steuer – kann dazu führen, dass Bestellungen nicht korrekt verarbeitet oder Produkte mit falschem Steuersatz angelegt werden. Prüfen Sie die Zuordnungen nach jedem Erstdaten-Download.
{% endhint %}

### Zusammenspiel mit dem Erstdaten-Download

Über die Aktion **Download Initial Data** lädt der Connector die vorhandenen Shopware-Werte (Zahlungsarten, Versandarten, Steuern, Tax Rules, Währungen, Verkaufskanäle, Kundengruppen, Anreden, Länder, Sprachen sowie State Machines und deren Übergänge) und stellt sie in den Mapping-Modulen zur Zuordnung bereit. Details unter „Shopware Erstdaten laden“ und „Shopware Mapping Hub“.


---

# 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/referenz-and-nachschlagewerk/mapping-module-referenz.md?ask=<question>&goal=<endgoal>
```

`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.