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
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
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:
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).
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.
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“.