# Willkommen!

Hier finden Sie Ressourcen, Tutorials und Hilfe rund um die Microsoft AppSource Angebote von solutioo.

## Willkommen!

#### Onlineshop Connectoren

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><a href="https://docs.solutioo.de/shopware"><strong>Shopware 6 API Connector</strong></a></td><td>Nahtlose Datenübertragung zwischen Ihrem Shopware Onlineshop und Business Central.</td><td data-object-fit="contain"><a href="https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY1FloPYijfOE0HjO2DQZ%2Fuploads%2FfUus1rN2ikpUJsqsm8SO%2FsolutiooShopwareAPI_216px.png?alt=media&#x26;token=130ae95c-b498-499f-9bf1-68c45c6f4bbe">https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY1FloPYijfOE0HjO2DQZ%2Fuploads%2FfUus1rN2ikpUJsqsm8SO%2FsolutiooShopwareAPI_216px.png?alt=media&#x26;token=130ae95c-b498-499f-9bf1-68c45c6f4bbe</a></td></tr><tr><td><a href="https://docs.solutioo.de/magento-2-api-connector"><strong>Magento 2 API Connector</strong></a></td><td>Verbinden Sie Magento 2 mit Business Central – Katalog, Bestand, Bestellungen und Fulfillment.</td><td data-object-fit="contain"><a href="https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd1MCm1qFghp9AErbK3FZ%2Ficon%2FfUU1fPBVgMhG4NAVoB7D%2FsolutiooMagento2API_216px.png?alt=media&#x26;token=9df87cfd-2cb2-4a72-be92-d78eb1e4a45d">https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd1MCm1qFghp9AErbK3FZ%2Ficon%2FfUU1fPBVgMhG4NAVoB7D%2FsolutiooMagento2API_216px.png?alt=media&#x26;token=9df87cfd-2cb2-4a72-be92-d78eb1e4a45d</a></td></tr></tbody></table>

#### Versand Connectoren

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><a href="https://docs.solutioo.de/dhl-connector"><strong>DHL Connector</strong></a></td><td>DHL-Versandaufkleber direkt in Business Central erstellen und drucken.</td><td data-object-fit="contain"><a href="https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY1FloPYijfOE0HjO2DQZ%2Fuploads%2FQ0IJ4lFXaXD3JZJZhSkv%2FsolutiooDHLConnector.png?alt=media&#x26;token=74fe8e69-d35f-4733-aab9-133525c05f9a">https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY1FloPYijfOE0HjO2DQZ%2Fuploads%2FQ0IJ4lFXaXD3JZJZhSkv%2FsolutiooDHLConnector.png?alt=media&#x26;token=74fe8e69-d35f-4733-aab9-133525c05f9a</a></td></tr><tr><td><a href="https://docs.solutioo.de/dpdconnector"><strong>DPD Connector</strong></a></td><td>DPD-Versandaufkleber direkt in Business Central erstellen und drucken.</td><td data-object-fit="contain"><a href="https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY1FloPYijfOE0HjO2DQZ%2Fuploads%2F6PiQiLuDbZJBRp13aJ2n%2FsolutiooDPDConnector_216px.png?alt=media&#x26;token=f5244d0c-261f-4599-b06b-f0e2f68764c5">https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY1FloPYijfOE0HjO2DQZ%2Fuploads%2F6PiQiLuDbZJBRp13aJ2n%2FsolutiooDPDConnector_216px.png?alt=media&#x26;token=f5244d0c-261f-4599-b06b-f0e2f68764c5</a></td></tr><tr><td><a href="https://docs.solutioo.de/gls-connector"><strong>GLS Connector</strong></a></td><td>GLS-Versandaufkleber direkt in Business Central erstellen und drucken.</td><td data-object-fit="contain"><a href="https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY1FloPYijfOE0HjO2DQZ%2Fuploads%2FF9O6yb6AAaEayhBxl0Po%2FsolutiooGLSConnector_216px.png?alt=media&#x26;token=1297dfec-c28e-4e03-a843-741f96a09dc6">https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY1FloPYijfOE0HjO2DQZ%2Fuploads%2FF9O6yb6AAaEayhBxl0Po%2FsolutiooGLSConnector_216px.png?alt=media&#x26;token=1297dfec-c28e-4e03-a843-741f96a09dc6</a></td></tr></tbody></table>

#### Sonstige Connectoren

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><a href="https://docs.solutioo.de/mollie-integration"><strong>Mollie Integration</strong></a></td><td>Abwicklung von Zahlungen mit Mollie in Business Central.</td><td data-object-fit="contain"><a href="https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY1FloPYijfOE0HjO2DQZ%2Fuploads%2Fcm8A8m0fbdI8aB9i8iUE%2FsolutiooMollieAnbindung.png?alt=media&#x26;token=c6b92cc6-c844-4ac6-9701-660e012f1b0c">https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY1FloPYijfOE0HjO2DQZ%2Fuploads%2Fcm8A8m0fbdI8aB9i8iUE%2FsolutiooMollieAnbindung.png?alt=media&#x26;token=c6b92cc6-c844-4ac6-9701-660e012f1b0c</a></td></tr><tr><td><a href="https://docs.solutioo.de/vr-pay-integration"><strong>VR Pay Quicklink</strong></a></td><td>VR Pay Quicklink Integration für Business Central.</td><td data-object-fit="contain"><a href="https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY1FloPYijfOE0HjO2DQZ%2Fuploads%2FCsQ4YuCk2P6zYwUIaqOP%2FVRPayQuicklink.png?alt=media&#x26;token=be897fae-d7bc-4e39-9a7f-96f32b17fdf3">https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY1FloPYijfOE0HjO2DQZ%2Fuploads%2FCsQ4YuCk2P6zYwUIaqOP%2FVRPayQuicklink.png?alt=media&#x26;token=be897fae-d7bc-4e39-9a7f-96f32b17fdf3</a></td></tr><tr><td><a href="https://docs.solutioo.de/picsart-image-editing-integration"><strong>Picsart Image Editing Integration</strong></a></td><td>Bildbearbeitung mit Picsart in Business Central.</td><td data-object-fit="contain"><a href="https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY1FloPYijfOE0HjO2DQZ%2Fuploads%2FzzeYHWKoGJDaWjFJsYcV%2FPicsartImageEditingIntegration.png?alt=media&#x26;token=f2e4c179-1094-4799-b72c-9d514da4b3df">https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY1FloPYijfOE0HjO2DQZ%2Fuploads%2FzzeYHWKoGJDaWjFJsYcV%2FPicsartImageEditingIntegration.png?alt=media&#x26;token=f2e4c179-1094-4799-b72c-9d514da4b3df</a></td></tr><tr><td><a href="https://docs.solutioo.de/universal-import"><strong>Universal Import</strong></a></td><td>Daten aus Excel, CSV, XML und JSON in beliebige Business Central-Tabellen importieren.</td><td data-object-fit="contain"><a href="https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEum6ByZXqHdXycLXOkeT%2Ficon%2FyHjD0sggMiUzUrY1FQkZ%2FsolutiooUniversalImport.svg?alt=media&#x26;token=476d872c-4ea2-46df-b413-31414f4de301">https://3950346866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEum6ByZXqHdXycLXOkeT%2Ficon%2FyHjD0sggMiUzUrY1FQkZ%2FsolutiooUniversalImport.svg?alt=media&#x26;token=476d872c-4ea2-46df-b413-31414f4de301</a></td></tr></tbody></table>

#### Weitere nützliche Ressourcen

Hier finden Sie weitere nützliche Verweise

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><a href="https://appsource.microsoft.com/de-de/marketplace/apps?search=solutioo&#x26;page=1"><strong>Microsoft AppSource</strong></a></td><td>Ein externer Link zu Microsoft AppSource mit all unseren Angeboten.</td><td></td></tr><tr><td><a href="https://www.solutioo.de"><strong>solutioo Website</strong></a></td><td>Auf unserer Website finden Sie viele nützliche Informationen zu uns und unseren Leistungen.</td><td></td></tr></tbody></table>


# Einführung Shopware 6 API Connector

Der Shopware 6 API Connector von solutioo bietet eine passgenaue Anbindung von Shopware 6 Onlineshops an Business Central (komplett auf Deutsch und Englisch).

**Über den Shopware 6 API Connector von solutioo**

Der **Shopware 6 API Connector** von solutioo ist eine leistungsstarke Erweiterung für Microsoft Dynamics 365 Business Central, die eine nahtlose Integration zwischen Ihrem ERP-System und Ihrem Shopware 6 Onlineshop ermöglicht. Der Shopware 6 API-Connector eliminiert mühsame manuelle Dateneingaben und sorgt dafür, dass Produktinformationen und Verkaufsdaten stets aktuell sind.

**Features**

<table data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><strong>Artikelsynchronisation:</strong> Bidirektionale Synchronisierung zwischen BC und Shopware von Produkten, Bestellungen, Bestand, Preisen, Attributen</td></tr><tr><td><p>Unterstützung von</p><ul><li>geplanten <strong>Preis- und Produkt-aktualisierungen</strong></li><li><strong>konfigurierbaren Artikeln</strong> sowie</li><li><strong>mehrsprachigen Artikeldaten</strong></li></ul></td></tr><tr><td><strong>Bestellimport:</strong> Bestellungen aus Shopware automatisch in Business Central als Aufträge anlegen</td></tr><tr><td><p>Unterstützung von</p><ul><li><strong>verschiedener Lieferadressen</strong> und</li><li><strong>separater Rechnungsadresse</strong></li></ul></td></tr><tr><td><strong>PDF-Dokument-Upload:</strong> Rechnungen, Gutschriften und Lieferscheine als PDF zu Shopware übertragen</td></tr><tr><td><strong>Kategorien und Attribute:</strong> Artikelkategorien sowie -attribute verwalten und synchronisieren mit Multikategorien für Shopware</td></tr><tr><td><strong>Medien-Management/ Multi-Bild-Unterstützung:</strong> Mehrere Produktbilder pro Artikel hochladen und verwalten</td></tr><tr><td><strong>Vertriebskanal-Handling:</strong> Verwalten Sie mehrere Vertriebskanäle über einen Connector.</td></tr><tr><td><strong>Transparenz</strong>: Umfassende Fehlerprotokollierung und API-Anforderungsverfolgung</td></tr></tbody></table>

{% hint style="info" %}
Die oben genannten Funktionen sind in der Basis-Anwendung enthalten und werden in dieser Dokumentation behandelt. Für Custom Funktionen erhalten Sie eine individuelle Dokumentation mit Auslieferung.
{% endhint %}

**Systemvoraussetzungen**

* Microsoft Dynamics 365 Business Central (Cloud oder On-Premise)
* Shopware 6 (Version 6.4 oder höher empfohlen)
* API-Zugang zum Shopware-Shop (Admin-API)

{% hint style="success" %}
**Sie interessieren sich für den Shopware 6 API Connector?**

In der folgenden Dokumentation finden Sie alle wichtigen Informationen und Tipps zum Shopware 6 API Connector von solutioo. Jedoch richtet sie sich vor allem an Inhaber einer Lizenz.

Gerne können Sie das Handbuch auch nutzen, um sich einen ersten Überblick über die Funktionalität der Applikation zu verschaffen, wir empfehlen Ihnen jedoch unser Team zu kontaktieren und einen unverbindlichen Termin zur Demonstration der Anbindung zu vereinbaren. So erhalten Sie einen guten Überblick und direkte Antworten auf Ihre Fragen. Wir freuen uns sehr von Ihnen zu hören!

supportkontakte
{% endhint %}

**Weiterführende Informationen**

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><strong>Microsoft AppSource</strong></td><td>Ein externer Link zu Microsoft AppSource mit all unseren Angeboten</td><td><a href="https://appsource.microsoft.com/de-de/marketplace/apps?search=solutioo&#x26;page=1">https://appsource.microsoft.com/de-de/marketplace/apps?search=solutioo&#x26;page=1</a></td><td><a href="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FSzMU6gyF2JqmnhiVvlDC%2FBildschirmfoto%202025-11-13%20um%2017.36.39.png?alt=media&#x26;token=22609b1d-2e13-4064-8380-8a0f2c96e2cc">https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FSzMU6gyF2JqmnhiVvlDC%2FBildschirmfoto%202025-11-13%20um%2017.36.39.png?alt=media&#x26;token=22609b1d-2e13-4064-8380-8a0f2c96e2cc</a></td></tr><tr><td><strong>solutioo Website</strong></td><td>Auf unserer Website finden Sie viele nützliche Informationen zu uns und unseren Leistungen</td><td><a href="https://www.solutioo.de/">https://www.solutioo.de/</a></td><td data-object-fit="fill"><a href="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2F6ziqsk6R4fPsHRX04yWp%2FBildschirmfoto%202025-11-13%20um%2017.37.04.png?alt=media&#x26;token=a469b263-1f60-4dba-854d-8c0722745a5b">https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2F6ziqsk6R4fPsHRX04yWp%2FBildschirmfoto%202025-11-13%20um%2017.37.04.png?alt=media&#x26;token=a469b263-1f60-4dba-854d-8c0722745a5b</a></td></tr></tbody></table>

**Dokumentations-Landkarte**

Diese Dokumentation ist in thematische Bereiche gegliedert. Nutzen Sie die folgende Übersicht als Einstieg:

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Erste Schritte</strong></td><td>Überblick, Systemvoraussetzungen, Schnellstart und Architektur. Öffnen</td></tr><tr><td><strong>Konfiguration</strong></td><td>Verbindung, Authentifizierung, Erstdaten und alle Zuordnungen. Öffnen</td></tr><tr><td><strong>Stammdaten</strong></td><td>Artikel, Varianten, Kategorien, Bilder, Texte, SEO und mehr. Öffnen</td></tr><tr><td><strong>Preise &#x26; Bestand</strong></td><td>Preislisten, Staffel-/Sonderpreise, Bestandsberechnung. Öffnen</td></tr><tr><td><strong>Bestellabwicklung</strong></td><td>Order-Dashboard, Bestelleingang und Statusrückmeldung. Öffnen</td></tr><tr><td><strong>Kundenverwaltung &#x26; B2B</strong></td><td>Kunden-Upload, B2B-Benutzer und Gastkunden. Öffnen</td></tr><tr><td><strong>Download &#x26; Matching</strong></td><td>Daten aus Shopware holen und Produkte per SKU abgleichen. Öffnen</td></tr><tr><td><strong>Onboarding &#x26; Best Practices</strong></td><td>Von der Ersteinrichtung bis zum täglichen Betrieb. Öffnen</td></tr><tr><td><strong>Häufige Fragen (FAQ)</strong></td><td>Antworten zu Verbindung, Artikeln, Preisen, Bestellungen u. v. m. Öffnen</td></tr></tbody></table>

{% hint style="info" %}
**Neu:** Die Dokumentation wurde umfassend erweitert – u. a. um Onboarding-Leitfäden, ein Referenz-Nachschlagewerk, einen FAQ-Bereich sowie Bereiche zu Monitoring, PDF-Dokumenten, Automatisierung und Download/Matching.
{% endhint %}


# WAS GIBT ES NEUES

{% updates format="full" %}
{% update date="2026-07-01" tags="coming-soon" %}

## PDF (Produkt-Datenblatt) aus Artikel

* Mit dem neuen Report **„SOUSHW Item Datasheet“** kann direkt aus der Artikelkarte ein Produkt-Datenblatt im DIN-A4-Querformat als PDF erstellt werden. Das **Datenblatt enthält das Coverbild und eine Bildergalerie aus den in Shopware hinterlegten Artikelbildern** sowie den **Marketingtext** des Artikels.
* Zusätzlich kann die Herkunftsangabe **„Made in …“** inklusive Länderflagge dargestellt werden. Die Länder DE, ENG und FRA sind bereits integriert; **weitere Länder** können individuell **konfiguriert** werden.
* **Frei konfigurierbare Attribut-Datenblöcke** ermöglichen eine **flexible Darstellung der Produktinformationen**. Ergänzend werden **feste Angaben** wie Artikelnummer, EAN/GTIN, Verpackungseinheit und empfohlener Verkaufspreis ausgegeben.
* Über eine **eigene Einrichtungsseite** können die verwendeten Attribute, Abschnittsüberschriften, das Logo und die Fußzeile individuell konfiguriert werden. Beim Download wird der **Artikelname automatisch als Dateiname** der PDF-Datei verwendet.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2026-06-01" %}

## Kontakte als B2B-Benutzer zu Shopware

* Kontakte eines Debitors können als anmeldbare **B2B-Benutzer** hochgeladen werden (Basis bleibt der Debitor).
* *NEW*: Für jeden Kontakt kann künftig festgelegt werden, welche Rolle er hat: *Anzeige*, *Besteller* oder *Freigabe*. Die Zuordnung erfolgt über die Customer-ID. Falls keine eindeutige Customer-ID vorhanden ist, wird die E-Mail-Adresse als Fallback verwendet.
* Die Kontakt- und Debitorenkarten werden um neue Funktionen erweitert. Dazu gehören **zusätzliche Konfigurationsmöglichkeiten für Rollen-IDs, Sprache** und **Fallback-Domain** sowie ein **Aktivitätslog zur Nachverfolgung** der Vorgänge. Außerdem steht der Report „*Shopware Upload Data*“ zur Verfügung.
* **Verbesserung (14.6.):**
  * Fallback-GUIDs bei leerer Konfiguration
  * E-Mail-Warnung beim interaktiven Upload
  * neue Aktion *„B2B-Benutzer prüfen (API)*".

***

## Attribut-Abgleich (match attributes)

* Die Aktion **„Attribute abgleichen“** vergleicht bereits vorhandene Shopware-Attribute anhand ihres Namens mit den Artikelattributen in BC. Bei einer Übereinstimmung werden die Felder **Web-ID**, **Web-Attribut** und **Synchronisiert** entsprechend gesetzt. Dabei werden **keine neuen Attribute angelegt**. Die zugehörigen Optionswerte werden anhand ihres jeweiligen Werts abgeglichen.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2026-05-01" %}

## Artikelabgleich und Datenübernahme aus Shopware

* **BC-Version auf 27.5 angehoben.**
* **Artikel-Matching**: Beim Artikelabgleich werden Shopware-Produkte anhand der **SKU** beziehungsweise **productNumber** den entsprechenden BC-Artikeln zugeordnet.
* **Varianten-Unterstützung**: Übergeordnete Artikel können automatisch angelegt und die zugehörigen Kind-Artikel inklusive **Option 1, Option 2 und Option 3** verknüpft werden.
* **Bilder-Download:** Zusätzlich können Bilder aus Shopware heruntergeladen werden. Dabei wird sowohl das Coverbild als auch weitere Artikelbilder übernommen; das Coverbild wird automatisch als Standardbild in BC gesetzt.
* Außerdem können **Attribute**, **Property Groups** und **deren Optionen** aus Shopware geladen und den Artikeln zugeordnet werden.
* Ergänzend stehen Funktionen für die Kategorien- und Sales-Channel-Zuordnung, den Excel-Import sowie die Bereinigung doppelter Web-IDs über **„Fix Duplicated Web IDs“** zur Verfügung.

***

## **Shopware Mapping Hub**

* Der **Shopware Mapping Hub** ist eine **eigenständige Übersichtsseite** mit Informationen zum angebundenen Webshop. Über Kacheln werden die wichtigsten Bereiche wie erforderliche Zuordnungen und Stammdaten übersichtlich dargestellt. Die **automatische Zuordnungslogik (Auto-Assign-Logik)** wurde aus dem bisherigen Ablauf **ausgelagert** und zentral im Mapping Hub gebündelt.

***

## Getrennte Verwaltung von Webnamen und Beschreibungen

* **Web Name** und **Description** werden künftig getrennt verwaltet. Mehrsprachige Produktnamen sowie HTML-Beschreibungen stehen auf der Artikelkarte in separaten Tabellen beziehungsweise ListParts zur Verfügung.

***

## Export und Import der Shopware-Konfiguration als JSON

* Die vollständige Shopware-Konfiguration inklusive aller Zuordnungen kann als JSON-Datei exportiert und wieder importiert werden.

***

## Erweiterte Funktionen: Meta-Info, Marktplätze, Widerrufe

* Für jeden Artikel können sprachabhängige **SEO-Metadaten** wie *Titel*, *Beschreibung* und *Keywords* gepflegt werden.
* Im Rahmen der **Channable-Integration** werden Bestellungen aus den Marktplätzen Kaufland, Amazon, eBay und Otto automatisch erkannt (**Marktplatz-Erkennung**) und über die **Marketplace Order ID** sowie die **Marketplace Source** zugeordnet.
* Zusätzlich können Bestellungen gezielt anhand ihrer Bestellnummer heruntergeladen werden. Das *Order-Dashboard* stellt weitere Bestellinformationen übersichtlich dar.
* Auch **Widerrufsinformationen** werden in deutscher Sprache und mit der zugehörigen SKU (Artikelnummer) ausgegeben.

***

## Überarbeiteter Preislistenabgleich und Preis-Upload

* **EUR-Währungsfilter:** Der Preislistenabgleich und der Upload von Preisen wurden vollständig überarbeitet. Dabei werden nun ausschließlich EUR-Preise berücksichtigt, wodurch Verwechslungen zwischen USD und EUR vermieden werden. Zusätzlich wurde das Matching über mehrere Preislisten hinweg verbessert.
* **Web-ID-Vererbung:** Web-IDs werden bei Preisänderungen übernommen und per **PATCH** aktualisiert, statt neue Datensätze per **POST** anzulegen. Dadurch entstehen beim Wechsel von Preisperioden keine Duplikate mehr.
* Ergänzend stehen die Aktionen „*Neueste Preise hochladen (Erzwingen)*“ und „*Alle Shopware-Preise löschen*“ zur Verfügung.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2026-04-01" %}

## Preislisten-Übersicht

* Die **Preislistenverwaltung** wurde um eine **neue Übersicht mit aktuellem Synchronisationsstatus** erweitert.
* **Kundengruppen** können nun **inklusive Brutto-/Netto-Einstellung** direkt **über die API** angelegt werden.
* Zusätzlich wurde der **Bild-Upload** **überarbeitet**.
* Und die **MwSt.-Auflösung** **beim Preis-Upload** verbessert.
* Für die Bereinigung beziehungsweise Neuinitialisierung stehen passende **Reset-Aktionen** zur Verfügung.

***

## Hauptprodukt bei Gruppenartikel im Warenkorb

* Für Gruppenartikel wurde die Option **includeMainProduct** ergänzt. Über den Schalter **„Hauptprodukt mit in Warenkorb“** kann festgelegt werden, ob das Hauptprodukt gemeinsam mit den zugehörigen Artikeln in den Warenkorb übernommen wird. Die Einstellung wird beim Erstellen, Aktualisieren und Herunterladen (create, update und download) von Gruppenartikeln synchronisiert.
  {% endupdate %}
  {% endupdates %}


# Lizenzerwerb

Für Administratoren: Erwerben Sie eine Lizenz für den Shopware 6 API Connector über AppSource

{% hint style="info" %}
Das Icon <i class="fa-screwdriver-wrench">:screwdriver-wrench:</i> beschreibt jene Kapitel der Dokumentation, die vorrangig für Administratoren relevant sind.
{% endhint %}

Den Shopware 6 API Connector von solutioo können Sie über Microsoft AppSource erwerben. Dies ist jedoch nur nach vorheriger Kontaktaufnahme mit unserem Team möglich.\
Um unseren Kunden eine optimale Benutzererfahrung zu ermöglichen, bietet unser Team Ihnen einen kostenfreien Termin per Microsoft Teams an, um den Shopware 6 API Connector kennenzulernen.

#### **In diesem Erstgespräch erfahren Sie...**

{% stepper %}
{% step %}
...welche Funktionen der Shopware 6 API Connector bietet und wo Sie diese finden.
{% endstep %}

{% step %}
...wie der Workflow mit dem Shopware 6 API Connector aussieht.
{% endstep %}

{% step %}
...welche Anpassungen vorgenommen werden können, damit der Connector die Bedürfnisse Ihres Unternehmens erfüllt.
{% endstep %}

{% step %}
...wie eine Testumgebung eingerichtet werden kann, damit Sie den Shopware 6 API Connector vor dem Kauf testen können.
{% endstep %}
{% endstepper %}


# Benutzerrollen und Rechte

Für Administratoren: Verwalten Sie Benutzerrollen und Rechte für den Shopware 6 API Connector.

{% hint style="info" %}
Das Icon <i class="fa-screwdriver-wrench">:screwdriver-wrench:</i> beschreibt jene Kapitel der Dokumentation, die vorrangig für Administratoren relevant sind.
{% endhint %}

Der Shopware 6 API Connector nutzt das standardmäßige Berechtigungssystem von Microsoft Dynamics 365 Business Central. Hier erfahren Sie, welche Berechtigungen für die Nutzung des Connectors erforderlich sind.

## 1. Berechtigungen zuweisen

Mit der Installation des Shopware 6 API Connectors wird automatisch ein Berechtigungssatz erstellt:

> **SOUSHW PERM:** Vollzugriff auf alle Shopware-Funktionen

Einzelnem Benutzer zuweisen

* Geben Sie in die Suchfunktion von Business Central *"Benutzer"* ein und öffnen Sie diese.
* Wählen Sie den gewünschten Benutzer.
* Klicken Sie auf "*Berechtigungssätze".*
* Fügen Sie *"SOUSHOPWAREAPICONNEC"* hinzu.

<div align="left"><figure><img src="/files/EgGza68nPzAZPHGFhXvJ" alt=""><figcaption></figcaption></figure> <figure><img src="/files/0gOrLoAZkuS1FysjiRsD" alt=""><figcaption></figcaption></figure></div>

## 2. Erforderliche Basisberechtigungen

Zusätzlich zum Shopware-Berechtigungssatz benötigen Benutzer folgende Standardberechtigungen:

<table><thead><tr><th width="184.93798828125">Bereich</th><th width="225.18212890625">Erforderliche Berechtigung</th></tr></thead><tbody><tr><td>Artikel</td><td>Lesen, Schreiben</td></tr><tr><td>Kunden</td><td>Lesen, Schreiben</td></tr><tr><td>Verkaufsaufträge</td><td>Lesen, Schreiben</td></tr><tr><td>Verkaufsrechnungen</td><td>Lesen</td></tr><tr><td>Verkaufsgutschriften</td><td>Lesen</td></tr><tr><td>Verkaufslieferungen</td><td>Lesen</td></tr></tbody></table>

{% hint style="info" %}
Für den PDF-Upload benötigen Benutzer zusätzlich Leserechte auf "*Gebuchte Verkaufsbelege"*.
{% endhint %}

## 3. Empfohlene Benutzerrollen

{% tabs %}
{% tab title="Administrator" %}

* Vollzugriff auf alle Funktionen
* Kann Konfiguration ändern
* Kann API-Verbindung verwalten
* Kann Mapping-Tabellen bearbeiten
  {% endtab %}

{% tab title="Standard-Benutzer" %}

* Kann Artikel synchronisieren
* Kann Bestellungen importieren
* Kann Preise und Bestände aktualisieren
* **Keine** Änderung der Konfiguration
  {% endtab %}

{% tab title="Nur-Lesen" %}

* Kann Aktivitätsprotokolle einsehen
* Kann Bestellübersicht anzeigen
* **Keine** Synchronisationsfunktionen
  {% endtab %}
  {% endtabs %}

## 4. Shopware API-Berechtigungen

Auch auf der Shopware-Seite müssen entsprechende Berechtigungen vorhanden sein:

{% tabs %}
{% tab title="Bei Integration-Access" %}
Die Integration benötigt folgende Berechtigungen:

* `product:read`, `product:write`
* `category:read`, `category:write`
* `media:read`, `media:write`
* `customer:read`
* `order:read`, `order:write`
* `solutioo_invoice_document:read`, `solutioo_invoice_document:write` (für PDF-Modul)
  {% endtab %}

{% tab title="Bei Benutzer-Access" %}
Der verwendete Admin-Benutzer sollte volle Admin-Rechte haben.

{% hint style="warning" %}
Eingeschränkte Berechtigungen in Shopware können zu Fehlern bei der Synchronisation führen!
{% endhint %}
{% endtab %}
{% endtabs %}


# Überblick über die Anwendung

Der **Shopware 6 API Connector** ist nahtlos in **Dynamics 365 Business Central** integriert und bildet die Brücke zwischen Ihrem ERP-System und Ihrem Onlineshop.\
In diesem Abschnitt erhalten Sie einen kompakten Überblick über den Aufbau, die Hauptfunktionen und den grundlegenden Arbeitsablauf der Anwendung.

Für eine Auflistung aller Funktionen siehe readme.

**1. Aufbau der Benutzeroberfläche**

Der Connector besteht aus mehreren Hauptbereichen, die Sie über das Menü in Business Central erreichen:

* **Auftrags-Dashboard**

  Startpunkt der Anwendung mit einer Übersicht aller Aufträge, die von Shopware zu Business Central synchronisiert wurden.
* **Daten hochladen**

  Dieser Button ermöglicht es Ihnen von einem Ort aus Updates von Business Central zu Shopware durchzuführen; z.B. bei Preisänderungen.
* **Bestellungen herunterladen**

  Manueller Download von neuen Bestellungen von Shopware zu Business Central. In der Regel findet dies jedoch über eine Aufgabenwarteschlange statt.
* **Aktivitätsprotokoll**

  Zeigt alle durchgeführten Synchronisationen und deren Ergebnis.
* **API-Aufrufprotokoll**

  Eine Liste aller API-Aufrufe und Informationen dazu.
* **Zuordnung**

  Direkter Link zu den Zuordnungstabellen, für die Zuweisung von Daten zwischen Business Central und Shopware.
* **Konfiguration**

  Hier hinterlegen Sie unter anderem Ihre API-Zugangsdaten und definieren, welche Shopware-Instanz angebunden wird.
* **Zugehörig**

  Shortcut zu verschiedenen Tabellen, die in Verbindung mit dem Shopware Connector benötigt werden. Zum Beispiel auch zum Anlegen von Artikelvarianten.

Neben den Funktionen des durch den Connector neu hinzugefügten Reiters "*Shopware*" erweitert der Connector viele Bereiche der Business Central-Umgebung:

* Erweiterung von Artikelkarten, Kategorien und Attributen um die Option, diese zu Shopware hochzuladen.
* Ergänzung des Artikelbildes, um eine Funktion zur Verwaltung mehrerer Artikelbilder.
* Ergänzung der Artikelkarte, um die Auswahl einer Verkaufskanal-Zuweisung.
* uvm.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Fe6qjJ6NT84AIrHOPktQu%2FBildschirmfoto%202026-01-22%20um%2010.25.16.png?alt=media&#x26;token=8b595b4a-b882-4b17-9451-f3bbf9545cf6" alt=""><figcaption></figcaption></figure></div>

**2. Grundlegende Fragestellungen**

{% columns %}
{% column %}
**Führendes System**

Der Shopware 6 Connector ist so ausgelegt, dass das ERP-System als führendes System genutzt wird. Er bietet jedoch auch die Möglichkeit bestimmte Daten über Shopware zu pflegen, so zum Beispiel:

* Bilddaten
* Shopware-Kategorien

Weitere Möglichkeiten finden Sie in der konfiguration sowie in der stammdatenverwaltung.
{% endcolumn %}

{% column %}
**Bestehende Systeme**

Der Connector kann mit bestehenden Business Central Umgebungen sowie mit bestehenden Shopware-Systemen arbeiten. Ein Initialdownload von Shopware mit allen Daten einschließlich Artikel-, Kunden- und Bestelldaten ist möglich.
{% endcolumn %}
{% endcolumns %}

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Aufgabenwarteschlangen</strong></td><td>Sie können in Business Central selbstständig Aufgabenwarteschlangen anlegen, um Prozesse für Ihre eigenen Anforderungen zu automatisieren.</td></tr><tr><td><strong>Updatefähigkeit</strong></td><td>Business Central bleibt voll update-fähig, nachdem der Connector nicht in bestehende Tabellen eingreift, sondern darauf aufbaut.</td></tr><tr><td><strong>Individualisierung</strong></td><td><p>Sie nutzen eine individuell erweiterte Business Central Umgebung oder der Connector bildet Ihre individuellen Anforderungen nicht ab?</p><p>Gerne programmieren wir eine individuelle Erweiterung für Ihre Anforderungen.</p><p>Kontaktieren Sie uns:</p><p>supportkontakte</p></td></tr></tbody></table>

**3. Nächste Schritte**

<table data-card-size="large" data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td>Folgen Sie dem Kapitel authentifizierung-zum-onlineshop, um die erste Synchronisation vorzubereiten.</td></tr><tr><td>Lesen Sie die stammdatenverwaltung, um zu verstehen, welche Informationen wie synchronisiert werden.</td></tr></tbody></table>


# Schnellstart in 10 Minuten

Dieser Schnellstart bringt Sie in wenigen Minuten von der frisch installierten App zur **ersten erfolgreichen Synchronisation**. Die einzelnen Schritte werden in den jeweiligen Fachkapiteln ausführlich erklärt – hier geht es um den schnellsten Weg zum Erfolgserlebnis.

{% hint style="info" %}
**Voraussetzung:** Die App ist installiert und Sie besitzen einen Shopware-6-Zugang mit Administrationsrechten (Admin-API). Details unter Installation und Systemvoraussetzungen & Kompatibilität.
{% endhint %}

{% stepper %}
{% step %}
**Verbindung einrichten**

Öffnen Sie die **Shopware Konfiguration** und hinterlegen Sie **Website-URL**, **API-Modulpfad** (üblich `/api`) sowie Ihre Zugangsdaten. Wählen Sie die passende Authentifizierungsmethode: Passwort-Grant oder Integrationszugang.
{% endstep %}

{% step %}
**Verbindung testen**

Klicken Sie auf **Verbindung testen**. Erscheint eine Erfolgsmeldung, ist der Token-Abruf erfolgreich. Andernfalls prüfen Sie URL, Pfad und Zugangsdaten – siehe Verbindung testen & Diagnose.
{% endstep %}

{% step %}
**Erstdaten laden**

Klicken Sie auf **Shopware Erstdaten laden**. Der Connector holt Zahlungs- und Versandarten, Steuern, Währungen, Verkaufskanäle, Kundengruppen, Länder, Sprachen und Statusverwaltung aus Shopware. Diese bilden die Basis für alle Zuordnungen.
{% endstep %}

{% step %}
**Zuordnungen prüfen**

Öffnen Sie **Shopware Zuordnung** und markieren Sie den Standard-**Verkaufskanal**, die **Währung** und die **Kundengruppe** (Feld *is Selected*). Ordnen Sie Ihre **MwSt.-Produktbuchungsgruppen** den Shopware-Steuersätzen zu.
{% endstep %}

{% step %}
**Ersten Artikel hochladen**

Öffnen Sie einen Artikel, setzen Sie **Web Artikel = Ja**, pflegen Sie Beschreibung, Preis und MwSt.-Produktbuchungsgruppe und klicken Sie auf **Aktionen → Shopware → Produkt hochladen**. Nach dem Upload füllt sich die **Web-ID** automatisch.
{% endstep %}

{% step %}
**Ergebnis prüfen**

Kontrollieren Sie in Shopware, ob das Produkt erscheint. Bei Problemen zeigt das Aktivitätsprotokoll die Ursache.
{% endstep %}
{% endstepper %}

**Und dann?**

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Katalog initial übertragen</strong></td><td>Größeren Katalog strukturiert nach Shopware bringen.</td><td></td></tr><tr><td><strong>Automatisierung</strong></td><td>Uploads per Aufgabenwarteschlange planen.</td><td></td></tr><tr><td><strong>Bestellungen holen</strong></td><td>Shopware-Bestellungen als BC-Aufträge anlegen.</td><td></td></tr></tbody></table>

{% hint style="success" %}
**Tipp:** Legen Sie sich zunächst über die Konfiguration **Testdaten** an (Demo-Artikel, -Kunden, -Varianten) und üben Sie den Ablauf, bevor Sie Echtdaten übertragen.
{% endhint %}


# Systemvoraussetzungen & Kompatibilität

Damit der Shopware 6 API Connector zuverlässig arbeitet, sollten die folgenden Voraussetzungen erfüllt sein.

**Business Central**

* **Microsoft Dynamics 365 Business Central** – Cloud (SaaS) **oder** On-Premise.
* Aktuelle unterstützte Plattform-/Anwendungsversion (die App wird laufend an neue BC-Releases angepasst).
* Berechtigungen zum Installieren von Extensions bzw. zum Zuweisen des mitgelieferten Berechtigungssatzes.

**Shopware 6**

* **Shopware 6**, empfohlen **Version 6.4 oder höher**.
* Erreichbare **Admin-API** unter `https://<ihr-shop>/api`.
* Ein API-Zugang – entweder ein **Administrationsbenutzer** (Passwort-Grant) oder ein **Integrationszugang** (Access Key ID / Secret Access Key).

{% hint style="info" %}
Die beiden Zugangsvarianten und ihre Vor-/Nachteile sind unter Authentifizierungsmethoden im Detail beschrieben.
{% endhint %}

**Netzwerk & Erreichbarkeit**

| Anforderung                 | Beschreibung                                                                                   |
| --------------------------- | ---------------------------------------------------------------------------------------------- |
| Ausgehende HTTPS-Verbindung | Business Central muss die Shopware-Admin-API per HTTPS erreichen können.                       |
| Gültiges Zertifikat         | Die Shopware-Instanz sollte über ein gültiges TLS-Zertifikat verfügen.                         |
| Stabile Basis-URL           | Die Website-URL sollte sich nicht laufend ändern (sonst müssen Zugangsdaten angepasst werden). |

**Premium-Module**

Einige Funktionen (z. B. **PDF-Dokument-Upload**, **Gruppenartikel**, **SharePoint-Dokumente**) setzen zusätzliche Shopware-Plugins von solutioo voraus. Welche Funktion welche Voraussetzung hat, lesen Sie unter Editionen & Module.

{% hint style="warning" %}
Bei **On-Premise**-Installationen von Business Central müssen ausgehende Webdienste (Outbound HTTP) für die Extension freigegeben sein.
{% endhint %}

**Häufige Fragen**

<details>

<summary>Funktioniert der Connector mit Shopware 6 Cloud (SaaS)?</summary>

Ja, sofern die Admin-API erreichbar ist und Sie einen Integrationszugang oder Administrationsbenutzer anlegen können.

</details>

<details>

<summary>Benötige ich zwingend Shopware 6.4+?</summary>

6.4 oder höher wird empfohlen. Ältere Versionen können abweichende API-Felder haben; sprechen Sie im Zweifel unser Team an.

</details>


# Architektur & Datenfluss

Der Shopware 6 API Connector verbindet Business Central als **führendes ERP-System** mit Shopware 6 als **Onlineshop**. Die Kommunikation erfolgt ausschließlich über die **Shopware-Admin-API** (REST) mit einem Bearer-Token.

**Rollen der Systeme**

* **Business Central** ist in der Regel die **führende Datenquelle** für Artikel, Preise, Bestände und Kunden.
* **Shopware 6** ist das **Verkaufsfrontend** und liefert **Bestellungen** zurück.

**Datenfluss**

```mermaid
flowchart LR
    subgraph BC[Business Central]
        Items[Artikel/Preise/Bestand]
        Cust[Kunden/Kontakte]
        Orders[Verkaufsaufträge]
        Log[Aktivitätsprotokoll]
    end
    subgraph SW[Shopware 6]
        Prod[Produkte]
        Prices[Preise/Regeln]
        SWO[Bestellungen]
    end
    Items -->|Upload| Prod
    Items -->|Upload| Prices
    Cust -->|Upload| SW
    SWO -->|Download| Orders
    Orders -->|Status/Lieferung/Rechnung| SWO
    Prod -.->|Matching/Import| Items
    BC <-->|Admin-API + Bearer-Token| SW
    SW --> Log
```

**Was wird in welche Richtung übertragen?**

| Objekt                                 | Richtung      | Auslöser                     |
| -------------------------------------- | ------------- | ---------------------------- |
| Artikel, Bilder, Attribute, Kategorien | BC → Shopware | Upload (manuell / geplant)   |
| Preise & Preislisten                   | BC → Shopware | Upload (manuell / geplant)   |
| Bestände                               | BC → Shopware | Upload (manuell / geplant)   |
| Kunden & B2B-Benutzer                  | BC → Shopware | Upload (manuell / geplant)   |
| Bestellungen                           | Shopware → BC | Download (manuell / geplant) |
| Liefer-/Rechnungsstatus                | BC → Shopware | beim Buchen                  |
| PDF-Dokumente                          | BC → Shopware | Upload (Premium)             |

**Zuordnungen als Bindeglied**

Damit BC-Werte und Shopware-Werte zueinanderfinden, pflegt der Connector **Zuordnungen (Mappings)** – z. B. für Steuern, Zahlungsarten, Währungen und Verkaufskanäle. Diese werden einmalig über **Shopware Erstdaten laden** befüllt und in der Shopware Zuordnung gepflegt.

**Protokollierung**

Jeder API-Aufruf kann protokolliert werden. Fachliche Ereignisse landen im Aktivitätsprotokoll, technische Details (mit *Developer Log*) im API Call Log.


# Editionen & Module (Basis vs. Premium)

Der Shopware 6 API Connector besteht aus einer **Basis-Anwendung** und optionalen **Premium-Modulen**. Diese Dokumentation beschreibt vorrangig die Basis-Funktionen; Premium-Funktionen sind entsprechend gekennzeichnet.

**Basis-Anwendung**

In der Basis enthalten und in dieser Dokumentation behandelt:

* Artikelsynchronisation (Upload von Artikeln, Preisen, Beständen, Attributen, Kategorien, Bildern)
* Konfigurierbare Artikel (Varianten) und mehrsprachige Artikeldaten
* Bestellimport aus Shopware inkl. abweichender Liefer- und Rechnungsadressen
* Kundenverwaltung und Zuordnungen (Steuern, Zahlung, Versand, Währung, Kanäle)
* Verkaufskanal-Handling über einen Connector
* Umfassende Protokollierung (Aktivitätsprotokoll, API Call Log)

**Premium-Module**

{% hint style="info" %}
Premium-Funktionen erfordern zusätzliche **Shopware-Plugins von solutioo** und/oder eine gesonderte Freischaltung. Sprechen Sie uns gerne an.
{% endhint %}

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>PDF-Dokument-Upload</strong></td><td>Rechnungen, Gutschriften und Lieferscheine als PDF ins Kundenportal übertragen.</td></tr><tr><td><strong>Gruppenartikel / Produktpakete</strong></td><td>Mehrere Artikel als Paket bündeln, optional inkl. Hauptprodukt im Warenkorb.</td></tr><tr><td><strong>SharePoint-Dokumente</strong></td><td>Produktdokumente aus SharePoint automatisch nach Shopware übertragen.</td></tr><tr><td><strong>B2B-Benutzer</strong></td><td>Kontakte als anmeldbare B2B-Benutzer mit Rollen (Anzeige, Besteller, Freigabe).</td></tr></tbody></table>

**Individuelle Erweiterungen**

Darüber hinaus setzen wir **kundenspezifische Anforderungen** um (z. B. besondere Textbausteine, Marktplatz-Anbindungen oder Report-Layouts). Solche Erweiterungen werden bei Auslieferung **individuell dokumentiert** und sind nicht Teil dieser allgemeinen Doku.

**Woran erkenne ich, welche Module aktiv sind?**

In der **Shopware Konfiguration** finden Sie unter **Shopware Module** die Schalter für Dokumenten-Upload, Gruppenartikel und SharePoint. Ist ein Schalter nicht sichtbar oder nicht aktivierbar, ist das Modul nicht lizenziert.


# Glossar

Kompakte Erklärungen der zentralen Begriffe dieser Dokumentation.

<table><thead><tr><th width="183.591796875">Begriff</th><th width="509.622802734375">Bedeutung</th></tr></thead><tbody><tr><td><strong>Admin-API</strong></td><td>Programmierschnittstelle von Shopware 6, über die der Connector alle Daten austauscht.</td></tr><tr><td><strong>Bearer-Token</strong></td><td>Zeitlich begrenztes Zugangs-Token, das der Connector automatisch abruft und für API-Aufrufe verwendet.</td></tr><tr><td><strong>Web-Artikel</strong></td><td>Ein Artikel, der für die Übertragung nach Shopware markiert ist (<code>Web Artikel = Ja</code>).</td></tr><tr><td><strong>Web-ID</strong></td><td>Die eindeutige ID eines Objekts in Shopware (z. B. Produkt-ID). Wird nach dem ersten Upload automatisch gefüllt.</td></tr><tr><td><strong>Mapping / Zuordnung</strong></td><td>Verknüpfung eines Shopware-Werts mit einem BC-Wert (z. B. Steuersatz, Zahlungsart, Verkaufskanal).</td></tr><tr><td><strong>Erstdaten laden</strong></td><td>Einmaliger Download von Stammdaten aus Shopware (Steuern, Währungen, Kanäle …) als Basis für Zuordnungen.</td></tr><tr><td><strong>Verkaufskanal (Sales Channel)</strong></td><td>Ein Shopware-Vertriebskanal (z. B. Storefront). Artikel können mehreren Kanälen zugewiesen werden.</td></tr><tr><td><strong>Parent-/ Variantenartikel</strong></td><td>Übergeordneter Artikel (Konfigurator) mit untergeordneten Varianten (z. B. Größe/Farbe).</td></tr><tr><td><strong>Property Group</strong></td><td>Shopware-Eigenschaftsgruppe, in die BC-Artikelattribute übersetzt werden.</td></tr><tr><td><strong>Auto-Increment</strong></td><td>Fortlaufende Nummer einer Shopware-Bestellung; steuert den inkrementellen Bestellungsdownload.</td></tr><tr><td><strong>Rule (Preisregel)</strong></td><td>Shopware-Regel, die einen Preis an eine Kundengruppe und optional an einen Zeitraum bindet.</td></tr><tr><td><strong>Developer Log</strong></td><td>Optionale technische Protokollierung von Request und Response je API-Aufruf.</td></tr><tr><td><strong>Aktivitätsprotokoll</strong></td><td>Fachliches Protokoll aller Synchronisationen mit Erfolg/Fehler-Status.</td></tr><tr><td><strong>Job Queue / Aufgaben-warteschlange</strong></td><td>BC-Mechanismus, um Uploads/Downloads zeitgesteuert auszuführen.</td></tr><tr><td><strong>B2B-Benutzer</strong></td><td>Anmeldbarer Ansprechpartner eines Firmenkunden mit einer Rolle (Anzeige, Besteller, Freigabe).</td></tr></tbody></table>


# Authentifizierung zum Onlineshop

Hier finden Sie alle Informationen rund um das Einstiges-Setup des Shopware API Connectors.

## 1. Initial-Setup

Sobald der Shopware 6 API Connector auf Ihrem Business Central System installiert ist, kann die Verbindung zum Onlineshop aufgebaut werden.

Sie werden feststellen, dass ein neuer Reiter in Business Central hinzugefügt wurde. Wenn Sie den Reiter *"Shopware"* auswählen, öffnet sich ein Untermenü:

<div align="left" data-with-frame="true"><figure><img src="/files/NXKQ4f8WlyP1soYb3GEl" alt="" width="563"><figcaption></figcaption></figure></div>

Nach Auswahl des Reiters *"Konfiguration"* öffnet sich das Menü, mit dem Sie sowohl die Verbindung zu Shopware herstellen können, also auch viele weitere Einstellungen treffen können.\
Um diese bearbeiten zu können, müssen Sie in den *Editier-Modus* wechseln, den Sie mittig oben im Fenster finden (das Stiftsymbol):

<div align="left" data-with-frame="true"><figure><img src="/files/KGS8zXeDtAGDX5kKW9N9" alt="" width="563"><figcaption></figcaption></figure></div>

Anschließend können Sie alle Einstellungen bearbeiten.

#### 1.1 Ersteinrichtung

Folgende Informationen, die Sie unter *"Shopware Informationen"* finden, sind für das Initial-Setup nötig:

* **Webshop-Code**\
  Ein von Business Central intern genutzter Code, der Ihren Shop einzigartig kennzeichnet.
* **Webshop-Name**\
  Ein beschreibender Name Ihres Onlineshops.
* **Website-URL**\
  Die URL zu Ihrem Shopware Shop mit https\://
* **API-Modulpfad**\
  In der Regel endet der Pfad auf /api
* **Integrationszugriff**\
  Hier legen Sie fest auf welche Art die Verbindung zwischen Business Central und Shopware stattfinden soll.\
  *JA* <i class="fa-right">:right:</i> Es werden eine *"Shopware Access Key ID"* und ein *"Shopware Secret Access Key"* benötigt.\
  *NEIN* <i class="fa-right">:right:</i> Sie benötigen einen *"Shopware Benutzername"* / *"Shopware User Name*" sowie das dazugehörige *"Shopware Benutzerpasswort"* / *"Shopware User Passwort"* mit Admin-Rechten.
* **Entwicklerprotokoll aktivieren**\
  *JA* <i class="fa-right">:right:</i> Wird nur benötigt, wenn Fehler bei *Sync* auftreten sollten, z.B. weil Daten nicht oder falsch im Shop ankommen. Mit dem Entwicklerprotokoll kann genau abgelesen werden, welche API-Calls getätigt werden und wo Fehler auftauchen.
* **Aktivieren**\
  Entscheidet ob der Shop aktiv ist (*JA*) oder nicht (*NEIN*). Das ist vor allem für Multishop (COMING SOON) eine relevante Einstellung.

<div align="left" data-with-frame="true"><figure><img src="/files/ykGjMsBS3ygULiG5guK4" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Möchten Sie den Integrationszugriff anstelle eines Benutzernamens und Passwort verwenden, können Sie diesen im Shopware-Backend erstellen:

*Settings* <i class="fa-right">:right:</i> *Users & permissions* <i class="fa-right">:right:</i> einen Admin auswählen <i class="fa-right">:right:</i> Unter "*Integrations*" einen neuen Access Key erstellen.
{% endhint %}

#### 1.2 Verbindungsaufbau

Anschließend können Sie einen Verbindungstest starten. Klicken Sie auf "Verbindung testen". Sind alle Daten korrekt ausgefüllt, erscheint eine Erfolgsmeldung.

<div align="left" data-with-frame="true"><figure><img src="/files/dsPukCbMl92rnLLsJ5Hh" alt="" width="375"><figcaption></figcaption></figure></div>

Tritt eine **Fehlermeldung** auf, kann dies verschiedene Ursachen haben.

* Prüfen Sie, ob alle Felder korrekt gefüllt sind.
* Testen Sie einen anderen Admin-Nutzer für Shopware bzw. eine andere Version des *"Integration Access".*
* Prüfen Sie, ob Ihr Server die Verbindung zulässt. Eine häufige Ursache für fehlgeschlagene Verbindungen zwischen Business Central und Shopware sind spezielle Serverkonfigurationen.
* Sofern Ihr Shop noch in Entwicklung ist, stellen Sie sicher, dass kein Passwortschutz aktiv ist.

## 2. Initialdownload <a href="#initialdownload" id="initialdownload"></a>

Der Initialdownload lädt alle relevanten Daten von Shopware nach Business Central und ist erforderlich, um die Werte zwischen beiden Systemen korrekt zuzuordnen.

Sie befinden sich immernoch in der Shopware-Konfiguration. Bevor der Initialdownload möglich ist, müssen noch zwei wichtige Werte gefüllt werden. Zu finden sind diese unter *"Bestandskonfiguration"*:

* Übergeordnete Kategorie-ID
* Bildordner-ID

<div align="left" data-with-frame="true"><figure><img src="/files/UbpIXbDILRYzImkXWRGs" alt="" width="563"><figcaption></figcaption></figure></div>

#### 2.1 Übergeordnete Kategorie-ID

Die <sup>*"*</sup>*Übergeordnete Kategorie-ID"* legt fest, welche Kategorien aus Shopware importiert werden sollen und wo neu erstellte Kategorien hinzugefügt werden. Die ID finden Sie in Shopware.\
Wechseln Sie dafür in den **Backend-Bereich Ihres Shopware-Shops**.

<div align="left" data-with-frame="true"><figure><img src="/files/Lvo536kz4qrrDQhU8RUn" alt="" width="375"><figcaption></figcaption></figure></div>

Unter dem Reiter "***Kataloge"*** <i class="fa-right">:right:</i> ***"Kategorien"*** wählen Sie jene Kategorie aus, die Sie als die übergeordnete Kategorie festlegen möchten. In der Regel ist das die oberste Ebene bzw. "Home".

Wählen Sie diese Kategorie aus.

<div align="left" data-with-frame="true"><figure><img src="/files/9g9FcX1Q2hJLTagDNYKN" alt="" width="375"><figcaption></figcaption></figure></div>

In der URL finden Sie nun zwischen zwei Schrägstrichen eine lange ID, die aus Buchstaben und Zahlen besteht. Kopieren Sie diese und fügen Sie diese ID in Business Central ein.

<div align="left" data-with-frame="true"><figure><img src="/files/pY9NIJhs9GweUM2g8vmz" alt="" width="563"><figcaption></figcaption></figure></div>

#### 2.2 Bilder Ordner-ID

Für die *"Bildordner-ID"* verfahren Sie ähnlich. Wechseln Sie zuerst in den **Backend-Bereich Ihres Shopware-Shops**.

<div align="left" data-with-frame="true"><figure><img src="/files/AMzMRzTl5yeBxYvCHlRN" alt="" width="375"><figcaption></figcaption></figure></div>

Unter dem Reiter *"Inhalte"* <i class="fa-right">:right:</i> *"Medien"* wählen Sie den Ordner aus, in dem die Produktbilder gespeichert werden sollen. In der Regel ist das der "*Product Media*" Ordner.

<div align="left" data-with-frame="true"><figure><img src="/files/43AV3KFTca890Qo7ZX8B" alt="" width="375"><figcaption></figcaption></figure></div>

In der URL finden Sie nun zwischen zwei Schrägstrichen eine lange ID, die aus Buchstaben und Zahlen besteht. Kopieren Sie diese und fügen Sie diese ID in Business Central ein.

<div align="left" data-with-frame="true"><figure><img src="/files/4vY0mYmVgR75ypugsICg" alt="" width="563"><figcaption></figcaption></figure></div>

#### 2.3 Initialdownload starten

Nun ist alles für den Initial-Download vorbereitet. Sie scrollen nach oben immernoch in der "Shopware-Konfiguration". Dort ist der Reiter *"Shopware-Erstdownload"* zu finden, damit starten Sie diesen.

<div align="left" data-with-frame="true"><figure><img src="/files/XfbTe26qnSn8kAtMp8mH" alt="" width="375"><figcaption></figcaption></figure></div>


# Grundeinstellungen

Die Grundeinstellungen umfassen alle Optionen im Einstellungs-Menü des Connectors.

Nach der erfolgreichen authentifizierung-zum-onlineshop sollten Sie die Grundeinstellungen vornehmen. Natürlich können Sie diese jederzeit anpassen, um Ihren Anforderungen optimal zu entsprechen.

{% hint style="warning" %}
Ohne die Grundeinstellungen wird die Verwendung des Shopware Connectors Fehlermeldungen aufwerfen und seine Funktion schwer beeinträchtigt.
{% endhint %}

#### 1. Shopware Konfiguration

Die Grundeinstellungen nehmen Sie im *"Konfiguration"***-**&#x4D;enü des Shopware 6 API Connectors in Business Central vor.

{% hint style="info" %}
Wo ist das?

Unter authentifizierung-zum-onlineshop finden Sie eine detaillierte Schritt-für-Schritt-Anleitung mit Bildern, wie Sie das "Konfiguration"-Menü finden können.
{% endhint %}

Die folgenden Unterseiten beschreiben die Reiter der *"Einstellung"*-Seite:

* **Shopware-Informationen** wurden bei authentifizierung-zum-onlineshopbesprochen.
* **Bestellkonfiguration** nehmen Sie unter bestellungen vor.
* **Kundenkonfiguration** nehmen Sie unter kunden vor.
* **Bestandskonfiguration** nehmen Sie unter lagervor.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FE4lmSy9jhwiSLPBEDTYO%2FBildschirmfoto%202026-04-27%20um%2014.40.45.png?alt=media&#x26;token=727074ce-f784-4148-9f16-af3b05241c7a" alt=""><figcaption></figcaption></figure></div>

#### 2. Shopware-Zuordnung

Zusätzlich zu den Grundeinstellungen müssen Sie die Shopware *"Zuordnung"* konfigurieren. Diese ordnen Werte zwischen Business Central und Shopware zu.

{% hint style="info" %}
Fügen Sie zu Shopware beispielsweise eine neue Versandart oder einen anderen Zahlungsdienstleister hinzu, ist es nötig einen neuen Initialdownload zu starten und die neuen Informationen zu matchen. Bereits bestehende Zuordnungen werden davon nicht beeinträchtigt.
{% endhint %}

{% hint style="warning" %}
**ACHTUNG**

Bevor Sie diese Einstellungen vornehmen können, muss zuerst ein erfolgreicher *"Shopware-Erstdownload"* stattgefunden haben. Nähere Informationen zum *"Shopware-Erstdownload"* finden Sie hier: ​\
\#initialdownload
{% endhint %}

Öffnen Sie dieses über *"Shopware"* <i class="fa-right">:right:</i> *"Zuordnung"* in der Aktionsleiste im BC.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FGv1g7mdGTxxU5Py1Yn1z%2FBildschirmfoto%202026-01-22%20um%2013.17.57.png?alt=media&#x26;token=5a6053f6-e8b3-45f5-94cc-74a5874655f2" alt="" width="563"><figcaption></figcaption></figure></div>

Im geöffneten Fenster muss nun der "*Modulname-Filter"* konfiguriert werden. Dieser zeigt an, in welchem Unterpunkt Sie sich gerade befinden. Über das Dropdown-Menü rechts daneben können Sie durch die verschiedenen Kategorien navigieren.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2F9a7OaTm0Kz2tsOnRTJMB%2FBildschirmfoto%202026-01-22%20um%2013.18.07.png?alt=media&#x26;token=45e3aa3c-db5c-4728-bf35-a908bbb1b2dc" alt="" width="563"><figcaption></figcaption></figure></div>

Weisen Sie allen für Sie relevanten Shopware-Funktionen den passenden Business Central Code zu und umgekehrt.

Im Folgenden werden die einzelnen "*Modulname-Filter"* genauer beschrieben:

**2.1 Zahlungs-Zuordnung**

In dieser Tabelle muss jede Zahlungsmethode aus Shopware einmalig einer Zahlungsmethode in BC zugeordnet werden, damit diese Informationen korrekt verarbeitet werden können.\
Fügen Sie zu einem späteren Zeitpunkt eine neue Zahlungsmethode zu Ihrem Onlineshop hinzu, muss auch diese gematched werden. Dafür muss zuerst ein neuer Initialdownload durchgeführt werden.

**2.2 Versand-Zuordnung**

In dieser Tabelle muss jede Versandmethode, die in Shopware verfügbar ist, einer Versandmethode, einem Versandagenten (z.B. DHL, DPD...) und einem Service des Agenten (z.B. Standard, Express) zugeordnet werden.\
Fügen Sie zu einem späteren Zeitpunkt eine neue Versandmethode zu Ihrem Onlineshop hinzu, muss auch diese gematched werden. Dafür muss zuerst ein neuer Initialdownload durchgeführt werden.

**2.3 MwSt.-Zuordnung**

In dieser Tabelle werden die Steuersätze aus Shopware einer Geschäftsbuchungsgruppe und einer Produktbuchungsgruppe in Business Central zugeordnet, damit die Steuern der Posten in Business Central richtig verarbeitet werden können.

Fügen Sie zu einem späteren Zeitpunkt neue Steuersätze zu Ihrem Onlineshop hinzu (z.B. wenn in ein neues Land verkauft wird) müssen auch diese gematched werden. Dafür muss zuerst ein neuer Initialdownload durchgeführt werden.

**2.4 Artikel-MwSt.-Zuordnung**

In dieser Tabelle müssen die Produkt Steuerbuchungsgruppen einem Shopware Code zugewiesen werden, damit auch hier die Steuerzuweisung der einzelnen Posten passt.

**2.5 Währung**

In dieser Tabelle wird der Währungscode von Shopware und Business Central zugewiesen. Aktuell wird nur eine Währung unterstützt. Setzen Sie hier den Haken bei "*ist ausgewählt*" der gewünschten Währung.

**2.6 Verkaufskanal**

In dieser Tabelle muss nichts gefüllt werden. Sie können jedoch ungewünschte Verkaufskanäle über den Haken bei *"ist ausgewählt"* ausblenden.

**2.7 Anreden**

Zuweisung von Anreden aus Shopware zu Anreden in Business Central. Das ist dann relevant, wenn Sie Kunden hochladen und besonders im B2B-Bereich gängig.

**2.8 Kundengruppen**

Hier ordnen Sie eine Shopware Kundengruppe einer Kundengruppe aus Business Central zu.

**2.9 Land**

In dieser Tabelle muss nichts gefüllt werden.

**2.10 Sprache**

Prüfen Sie die korrekte Zuordnung der Sprachen.

**2.11 Statusverwaltung**

Hier sehen Sie den Status der Bestellung.

**2.12 Statusübergang**


# Bestellkonfiguration

Konfigurieren Sie die Bestellungs-Einstellungen für den Import von Shopware-Bestellungen.

Die Bestellungs-Einstellungen legen fest, wie Bestellungen aus Shopware in Business Central angelegt werden.

## Einstellungen der Bestellungen

Navigieren Sie zu *"Shopware"* <i class="fa-right">:right:</i> *"Konfiguration"* und wechseln Sie in den Editier-Modus, indem Sie das "Stift-Symbol" oben im neu geöffneten Fenster anklicken. Die Bearbeitung ist somit aktiviert.

<div align="left" data-with-frame="true"><figure><img src="/files/LWyrW96xmD15AecwWivu" alt=""><figcaption></figcaption></figure></div>

<div align="left" data-with-frame="true"><figure><img src="/files/ghDFJjuspZC2hZyKinZ1" alt=""><figcaption></figcaption></figure></div>

* **Bestellungs-Download erlauben**\
  *JA* <i class="fa-right">:right:</i> Für jede neue Shopware Bestellung wird ein Bestellauftrag in Business Central mit allen Daten der Bestellung angelegt.
* **Bestellungen herunterladen mit**\
  Zur Auswahl stehen: *Angebot/Auftrag/Rechnung*\
  Diese Einstellung beeinflusst, wie eine Bestellung aus Shopware in Business Central ankommt.\
  Wird als Zahlungsmethode zum Beispiel nur Direktzahlungen für digitale Güter angeboten, macht es Sinn direkt Verkaufsrechnungen zu erstellen. Die Auswahl hängt also von den individuellen Anforderungen Ihres Unternehmens ab.
* **Bestellungen erstellen**

  *JA* <i class="fa-right">:right:</i> Erlaubt Bestellungen vom Typ "Download",
* **Unbekannten Artikel erstellen**

  *JA* <i class="fa-right">:right:</i> Artikel, die in Shopware verfügbar sind, aber nicht in Business Central, werden beim Herunterladen einer Bestellung automatisch erstellt.
* **Preis inkl. MwSt.**\
  *JA* <i class="fa-right">:right:</i> Wenn dies aktiviert ist, wird der Preis der Bestellung inklusive MwSt. berechnet.
* **Shopware-Preis verwenden**

  *JA* <i class="fa-right">:right:</i> Bitte deaktivieren Sie diese Option, wenn Sie beim Herunterladen von Bestellungen den BC-Kundenpreis verwenden möchten. Wenn nicht aktiviert, ignoriert das System den Shopware-Bestellpreis und wendet stattdessen die Standard-BC-Preise an.
* **Shopware Eröffnungs-AutoIncrement**\
  In diesem Feld kann festgelegt werden, welches die erste Bestellnummer der aus Shopware herunter zu ladenden Bestellung ist. Sind z.B. bereits Testbestellungen auf dem System gewesen, kann man somit beim Initialdownload mit der ersten "echten" Bestellung anfangen und Testbestellungen werden nicht zu Business Central heruntergeladen.
* **Bestellungen erstellen in**\
  Definiert das Lager, in denen die Aufträge erstellt werden. So kann festgelegt werden, dass der Onlineshop nur aus einem oder mehreren Lagern Waren beziehen darf.
* **Verkaufsauftrags-Nummernserie**\
  Nummernserie, die für die von Shopware kommenden Bestellungen verwendet werden soll. Dieses Feld muss nur einmal gesetzt werden und benötigt nach der ersten Konfiguration keine Aktualisierung.\
  In der Regel: "*V-AUFTR"*

<div align="left" data-with-frame="true"><figure><img src="/files/JIdXgwn3U5lv1bXfZifY" alt="" width="563"><figcaption></figcaption></figure></div>

#### **Steuereinstellungen**

* **MwSt. verwenden /** **Use VAT**\
  *JA* <i class="fa-right">:right:</i> Auf JA setzen, wenn man mit Steuern arbeiten möchte.
* **MwSt.-Geschäftsbuchungsgruppe**\
  Auswahl der Standard Geschäftsbuchungsgruppe für die eingehenden Bestellungen, die bei jedem Auftrag automatisch gesetzt wird. z.B: *"INLAND"*
* **MwSt.-Produktbuchungsgruppe**\
  Wählen Sie die Produktbuchungsgruppe aus, die für Shopware-Bestellungen verwendet wird; z.B. *"VAT19"*.
* **Steuerfreie Gruppe**\
  Geben Sie die Steuergruppe für steuerfreie Artikel an.

<div align="left" data-with-frame="true"><figure><img src="/files/9usqa3QaYBZDj9qIMMaP" alt="" width="563"><figcaption></figcaption></figure></div>

#### **Lieferung & Bestellstatus**

* **Lieferungs-Upload erlauben**\
  *JA* <i class="fa-right">:right:</i> Erlaubt das Hochladen einer Lieferung von Business Central zu Shopware; zum Beispiel für Bestellstatus-Aktualisierungen.
* **Bestellstatus bei Lieferung /** **Order status on shipment**

  Zeigt den Status der Lieferung an.
* **Bestellstatus bei Rechnungserstellung /** **Order status on invoice creation**

  Der Bestellstatus, der in Shopware gesetzt wird, wenn eine Rechnung erstellt wird.
* **Bestellstatus-E-Mail senden /** **Send Order Status Email**

  *JA* <i class="fa-right">:right:</i> Sendet eine E-Mail-Benachrichtigung an den Kunden, wenn sich der Bestellstatus in Shopware ändert.

<div align="left" data-with-frame="true"><figure><img src="/files/yLRxmjTudMnDHGOsZJUV" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}

### Automatisierter Import

1. Erstellen Sie einen *"*[*Aufgabenwarteschlangenposten*](/shopware/automatisierungen-und-zeitplane/aufgabenwarteschlangenposten)*"*.
2. Wählen Sie die "*Codeunit*" bei Bestelldownloa&#x64;*.*
3. Legen Sie das Intervall fest (z.B. alle 15 Minuten).
   {% endhint %}


# Kundenkonfiguration

Konfigurieren Sie die Kunden-Einstellungen für die Synchronisation.

Die Kunden-Einstellungen bestimmen, wie Kundendaten zwischen Shopware und Business Central synchronisiert werden.

## 1. Kunden-Einstellungen

Navigieren Sie zu *"Shopware"* <i class="fa-right">:right:</i> *"Konfiguration"* und wechseln Sie in den Editier-Modus, indem Sie das "Stift-Symbol" oben im neu geöffneten Fenster anklicken. Die Bearbeitung ist somit aktiviert.

<div align="left" data-with-frame="true"><figure><img src="/files/LWyrW96xmD15AecwWivu" alt=""><figcaption></figcaption></figure></div>

<div align="left" data-with-frame="true"><figure><img src="/files/L4ErWCfJFxy7umvg135B" alt=""><figcaption></figcaption></figure></div>

* **Unbekannten Kunden erstellen**\
  *JA* <i class="fa-right">:right:</i> JA ermöglicht es einen unbekannten Kunden in Business Central zu erstellen, das ist vor allem relevant für B2C Shops, die nicht für jede Gastbestellungen einen Debitor in BC erstellen wollen.
* **Gastkunde erstellen**

  *JA* <i class="fa-right">:right:</i> Bei JA wird erlaubt, dass ein Gastkunde in Business Central angelegt wird, wenn eine Webbestellung ohne Shopware-Kundenkonto erfolgt.
* **Standard-Gastkunde**\
  Hier legen Sie den Standard Debitor für Gastbestellungen an. Es wird bei jeder Bestellung ein neuer Kontakt im Debitor erstellt.
* **Standard-Angemeldeter Kunde**\
  Wählen Sie das Kundenkonto, das für die Erstellung aller Shopware-Bestellungen verwendet wird. Aber nur wenn der Kunde ein Shopware-Konto hat und nicht mit einem Business Central-Konto synchronisiert ist.
* **Kundenvorlage**\
  Die Kundenvorlage wird verwendet, wenn "*Unbekannten Kunden erstellen*" auf *JA* steht und kein *"Standard Gast"* / *"Angemeldeter Kunde"* festgelegt ist. Standard-Kundenvorlage für Business Central-Konten, die aus Shopware erstellt wurden.
* **Kunden-Standardpasswort** (Wird im nächsten Software-Update entfernt aufgrund von Redundanz)
* **Shopware Zahlungsmethoden-ID**\
  Hier legen Sie die Standard Zahlungsmethode für Shopware fest. Falls ein Kunde keine Zahlungsmethode im Debitor festgelegt hat wird diese mit übermittelt. Die ID finden Sie im Shopware-Backend unter "*Settings*" <i class="fa-right">:right:</i> "*Tax*" <i class="fa-right">:right:</i> "*Standard rate*"<i class="fa-right">:right:</i> URL Endung nach detail/\ <img src="/files/UBbgZQH4QDBJ5FVPs8tv" alt="" data-size="line">

## 2. B2B vs. B2C Kunden

{% tabs %}
{% tab title="B2C-Kunden (Privatkunden)" %}

* Werden typischerweise einem Sammelkonto zugeordnet.
* Oder als einzelne Debitoren angelegt.
  {% endtab %}

{% tab title="B2B-Kunden (Geschäftskunden)" %}

* Werden immer als individuelle Debitoren angelegt.
* Können eigene Preisgruppen haben.
* Zahlungsbedingungen können abweichen.

Weitere Informationen finden Sie unter [Besonderheiten bei B2B-/B2C-Kunden](/shopware/kundenverwaltung/besonderheiten-bei-b2b-b2c-kunden)
{% endtab %}
{% endtabs %}

## 3. Kundendaten synchronisieren

{% tabs %}
{% tab title="Von Shopware nach BC" %}
Bei Bestellimport werden Kundendaten automatisch aktualisiert oder neue Kunden angelegt.
{% endtab %}

{% tab title="Von BC nach Shopware" %}
Aktuell keine automatische Synchronisation von BC nach Shopware. Änderungen an Kundendaten müssen manuell in Shopware vorgenommen werden.
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
Ändern Sie die **Kundennummer** nicht nachträglich, da dies die Zuordnung zwischen den Systemen unterbricht!
{% endhint %}


# Bestandskonfiguration

Konfigurieren Sie die Lager-Einstellungen für die Bestandssynchronisation.

Die Lager-Einstellungen bestimmen, wie Lagerbestände zwischen Business Central und Shopware synchronisiert werden.

## 1. Lager-Einstellungen

Navigieren Sie zu *"Shopware"* <i class="fa-right">:right:</i> *"Konfiguration"* und wechseln Sie in den Editier-Modus, indem Sie das "Stift-Symbol" oben im neu geöffneten Fenster anklicken. Die Bearbeitung ist somit aktiviert.

<div align="left" data-with-frame="true"><figure><img src="/files/LWyrW96xmD15AecwWivu" alt=""><figcaption></figcaption></figure></div>

<div align="left" data-with-frame="true"><figure><img src="/files/MXXzqjegUQdSc0vnzjEs" alt=""><figcaption></figcaption></figure></div>

* **Artikel-Upload erlauben**\
  *JA* <i class="fa-right">:right:</i> Erlaubt das Hochladen von Artikeln aus Business Central zu Shopware.
* **Negative Artikelmenge hochladen**\
  *JA* <i class="fa-right">:right:</i> Wenn ein Artikel in Business Central eine negative Menge hat, legen Sie hiermit fest, dass diese dennoch zu Shopware hochgeladen werden darf.\
  *NEIN* <i class="fa-right">:right:</i> Ist diese Option deaktiviert, so wird keine negative Menge zu Shopware hochgeladen. Stattdessen wird der Wert "0" und "Auf Lager" übermittelt.
* **Regulären Preis hochladen**\
  *JA* <i class="fa-right">:right:</i> Lädt den Standard Unit Price aus dem Artikel in Business Central in Shopware hoch, unabhängig von rollenbasierten Preisen.
* **Price API Limit**\
  Hier legen Sie fest, wie viele Preise aus der Preistabelle mit einer API-Anfrage übermittelt werden.\
  Werden viele Preise auf einmal angepasst, lohnt es sich den Wert nach oben zu setzen, um eine möglichst schnelle Aktualisierung zu gewährleisten.
* **Kategorie-Upload**\
  *JA* <i class="fa-right">:right:</i> Erlaubt das Hochladen von Artikelkategorien zu Shopware.
* **Unbekannten Artikel erstellen**\
  Hier wird eine Vorlage hinterlegt, die genutzt wird, sofern Artikel aus Bestellungen von Shopware heruntergeladen werden, weil sie NICHT in Business Central vorhanden sind. In der Regel ist dies: *"ARTIKEL"*
* **Gewicht in Kg**
* **Bestand hochladen**\
  *JA* <i class="fa-right">:right:</i> Ermöglicht das Hochladen von Lagerbeständen zu Shopware.
* **Standard-Lagerort verwenden**\
  *JA* <i class="fa-right">:right:</i> Ignoriert die Lagerorte und verwendet den definierten festen Bestand.
* **Standard-Bestandsmenge**\
  Standard-Bestandsmenge, die für alle Artikel verwendet wird, wenn "*Standard-Lagerort verwenden*" aktiviert ist.
* **Bestandslagerort-IDs**\
  Hier legen Sie die Lager fest, die mit in den Shopware-Shop hochgeladen werden sollen. So können Sie genau verwalten aus welchem Lager/welchen Lagern der Shop Produkte bezieht.\
  Beispiel:\
  Lager 1 und Lager 2: Ware für Onlineshop DE\
  Lager 3: Ware für Ladengeschäft\
  Lager 4: Ware für Onlineshop AT
* **Name(n) der Bestandslagerorte**\
  Dieses Feld wird automatisch gefüllt basierend auf den Daten von "*Lagerstandort-IDs*" und sorgt lediglich für eine übersichtlichere Darstellung bei wenig aussagekräftigen IDs.
* **Übergeordnete Kategorie-ID**\
  Shopware ID für die übergeordnete Kategorie (siehe [Authentifizierung zum Onlineshop](/shopware/konfiguration/authentifizierung-zum-onlineshop))
* **Standard-Steuer-ID**\
  Shopware ID für die Standard Steuer ID (siehe [Authentifizierung zum Onlineshop](/shopware/konfiguration/authentifizierung-zum-onlineshop))
* **Bildordner-ID**\
  Shopware ID für den Standard Artikelbilder Ordner (siehe [Authentifizierung zum Onlineshop](/shopware/konfiguration/authentifizierung-zum-onlineshop))

## 2. ID Fehler finden

### 2.1 Übergeordnete Kategorie-ID

1. Öffnen Sie das *Shopware-Backend.*
2. Navigieren Sie zu *Kataloge → Kategorien.*
3. Klicken Sie auf die gewünschte Kategorie (z.B. "Home").
4. Die ID finden Sie in der URL:

   ```
   https://ihr-shop.de/admin#/sw/category/index/[KATEGORIE-ID]/
   ```

### 2.2 Bilder Ordner-ID

1. Öffnen Sie das *Shopware-Backend.*
2. Navigieren Sie zu *Inhalte → Medien.*
3. Klicken Sie auf den gewünschten Ordner (z.B. "Product Media").
4. Die ID finden Sie in der URL:

   ```
   https://ihr-shop.de/admin#/sw/media/index/[ORDNER-ID]/
   ```

## 3. Staffelpreis-Import

Das *Staffelpreis-Limit* legt fest, wie viele Staffelstufen pro Produkt beim Import maximal übernommen werden dürfen.

{% hint style="info" %}
Setzen Sie das Limit entsprechend Ihren Geschäftsanforderungen. Ein zu hohes Limit kann die Performance beeinträchtigen.
{% endhint %}

## 4. Tipps für den täglichen Umgang

{% tabs %}
{% tab title="Bestandsgenauigkeit" %}

* Führen Sie regelmäßige Inventuren durch.
* Prüfen Sie die Bestandsdifferenzen zwischen den Systemen.
* Nutzen Sie das Aktivitätsprotokoll für die Fehleranalyse.
  {% endtab %}

{% tab title="Performance" %}

* Synchronisieren Sie Bestände außerhalb der Stoßzeiten.
* Begrenzen Sie die Anzahl gleichzeitig synchronisierter Artikel.
* Nutzen Sie Filter für selektive Updates.
  {% endtab %}
  {% endtabs %}


# Hinweise zu Preisen

Konfigurieren Sie die Preis-Einstellungen für die Synchronisation.

Die Preis-Einstellungen bestimmen, wie Preise zwischen Business Central und Shopware synchronisiert werden.

## 1. Zuordnungs-/Mapping-Tabellen

{% tabs %}
{% tab title="MwSt.-Zuordnung" %}
Ordnen Sie Business Central MwSt.-Buchungsgruppen den Shopware-Steuersätzen zu:

1. Öffnen Sie *"Shopware"* <i class="fa-right">:right:</i> *"Mapping"*
2. Wählen Sie *"MwSt.-Zuordnung"*
3. Ordnen Sie jede MwSt.-Produktbuchungsgruppe zu.

Weitere Informationen unter [#mwst.-zuordnung](#mwst.-zuordnung "mention").

Bsp.:

VOLL <i class="fa-right">:right:</i> Standard-Steuersatz (19%), REDUZIERT <i class="fa-right">:right:</i> Reduzierter Steuersatz (7%), FREI <i class="fa-right">:right:</i> Steuerfrei (0%)
{% endtab %}

{% tab title="Währungen" %}
Falls Sie mehrere Währungen verwenden:

1. Öffnen Sie *"Shopware"* <i class="fa-right">:right:</i> *"Mapping"*
2. Wählen Sie *"Währungen"*
3. Ordnen Sie BC-Währungscodes den Shopware-Währungen zu
   {% endtab %}
   {% endtabs %}

## 2. Preisarten

{% tabs %}
{% tab title="Standardpreise" %}
Der Standardpreis wird für alle Kunden verwendet, die keiner speziellen Preisgruppe zugeordnet sind.
{% endtab %}

{% tab title="Kundenpreise" %}
Individuelle Preise für bestimmte Kunden:

1. Öffnen Sie die *"Verkaufspreise"* in BC.
2. Erstellen Sie Preise für bestimmte Kunden.
3. Diese werden bei der Synchronisation berücksichtigt.
   {% endtab %}

{% tab title="Staffelpreise" %}
Mengenabhängige Preise:

1. Erstellen Sie *"Verkaufspreise"* mit Mindestmengen.
2. Diese werden als Staffelpreise zu Shopware übertragen.

Weitere Informationen unter [#staffelpreise](#staffelpreise "mention").
{% endtab %}
{% endtabs %}

## 3. Preissynchronisation

{% tabs %}
{% tab title="Automatische Synchronisation" %}

* Erstellen Sie einen *"*[*Aufgabenwarteschlangenposten*](/shopware/automatisierungen-und-zeitplane/aufgabenwarteschlangenposten)*".*
* Wählen Sie die Codeunit *"Preisupload".*
* Legen Sie das Intervall fest.
  {% endtab %}

{% tab title="Manuelle Synchronisation" %}

* Öffnen Sie die *"Artikelkarte"*
* Klicken Sie auf *"Aktionen"* <i class="fa-right">:right:</i> *"Preis zu Shopware"*
  {% endtab %}
  {% endtabs %}

## 4. Tipps für den täglichen Umgang

{% tabs %}
{% tab title="Preiskonsistenz" %}

* Prüfen Sie regelmäßig die Preise in beiden Systemen.
* Achten Sie auf korrekte MwSt.-Zuordnung.
* Dokumentieren Sie Ihre Preisregeln.
  {% endtab %}

{% tab title="Rundung" %}

* Shopware und BC können unterschiedliche Rundungsregeln haben.
* Prüfen Sie Centbeträge bei der Synchronisation.
  {% endtab %}
  {% endtabs %}

{% hint style="warning" %}
Änderungen an Preisen in Shopware werden bei der nächsten Synchronisation überschrieben!
{% endhint %}


# Verbindung testen & Diagnose

Bevor Sie Daten synchronisieren, sollte die Verbindung zur Shopware-Admin-API einwandfrei funktionieren. Diese Seite zeigt, wie Sie die Verbindung prüfen und Fehler eingrenzen.

### **Verbindung testen**

In der **Shopware Konfiguration** stehen zwei hilfreiche Aktionen bereit:

* **Verbindung testen** – ruft ein frisches Token bei Shopware ab. Erscheint eine Erfolgsmeldung, sind URL, Pfad und Zugangsdaten korrekt.
* **Passwort anzeigen** – zeigt die hinterlegten Zugangsdaten zur Kontrolle an.

{% stepper %}
{% step %}
**Zugangsdaten prüfen**

Stellen Sie sicher, dass **Website-URL** (z. B. `https://shop.example.com`) und **API-Modulpfad** (üblich `/api`) korrekt sind. Ein abschließender Schrägstrich wird automatisch entfernt.
{% endstep %}

{% step %}
**Test ausführen**

Klicken Sie auf **Verbindung testen**. Der Connector fordert ein Token unter `…/oauth/token` an.
{% endstep %}

{% step %}
**Ergebnis auswerten**

Bei Erfolg erscheint eine Bestätigung. Bei Misserfolg prüfen Sie die untenstehenden Ursachen und aktivieren Sie ggf. den **Developer Log**.
{% endstep %}
{% endstepper %}

### **Typische Ursachen bei Verbindungsfehlern**

| Symptom                             | Mögliche Ursache                           | Lösung                                                |
| ----------------------------------- | ------------------------------------------ | ----------------------------------------------------- |
| „UserName or Password is incorrect“ | Falsche Zugangsdaten / falscher Auth-Modus | Zugangsdaten und Schalter *Integrationszugang* prüfen |
| Kein Token / leere Antwort          | URL oder API-Pfad falsch                   | Website-URL und API-Modulpfad korrigieren             |
| Zeitüberschreitung                  | Shop nicht erreichbar / Firewall           | Erreichbarkeit und ausgehende HTTPS-Verbindung prüfen |
| Zertifikatsfehler                   | Ungültiges TLS-Zertifikat                  | Gültiges Zertifikat im Shop hinterlegen               |

{% hint style="info" %}
Aktivieren Sie zur Fehlersuche vorübergehend **Enable Developer Log**. Anschließend sehen Sie im API Call Log die exakte Anfrage-URL und die Serverantwort.
{% endhint %}

**Checkliste**

<details>

<summary><strong>Verbindung schlägt fehl? Was prüfen?</strong></summary>

1. Ist **Aktivieren** in der Konfiguration gesetzt?
2. Stimmen **Website-URL** und **API-Modulpfad**?
3. Passt der **Authentifizierungsmodus** zu Ihren Zugangsdaten? Siehe Authentifizierungsmethoden im Detail.
4. Ist die Shopware-Admin-API von außen erreichbar?
5. Zeigt der **Developer Log** eine konkrete Fehlermeldung?

</details>


# Authentifizierungsmethoden im Detail

Der Connector authentifiziert sich über **OAuth** an der Shopware-Admin-API und erhält ein **Bearer-Token**, das für alle weiteren Aufrufe verwendet wird. Es gibt zwei Verfahren, umgeschaltet über den Schalter **Shopware Integrationszugang**.

**Verfahren im Vergleich**

{% tabs %}
{% tab title="Integrationszugang (empfohlen)" %}
**Schalter&#x20;*****Integrationszugang*****&#x20;= aktiv.**

* Sie hinterlegen **Access Key ID** und **Secret Access Key** aus einer Shopware-Integration.
* Technisch: `grant_type = client_credentials`.
* Vorteil: nicht an einen persönlichen Benutzer gebunden, ideal für automatisierte Prozesse.

**So legen Sie eine Integration in Shopware an:** Administration → Einstellungen → System → Integrationen → *Integration hinzufügen*. Kopieren Sie *Access key ID* und *Secret access key*.
{% endtab %}

{% tab title="Passwort-Grant" %}
**Schalter&#x20;*****Integrationszugang*****&#x20;= inaktiv.**

* Sie hinterlegen **Benutzername** und **Passwort** eines Shopware-Administrators.
* Technisch: `grant_type = password`, `client_id = administration`.
* Vorteil: schnell eingerichtet. Nachteil: an einen Benutzer und dessen Passwort gebunden.
  {% endtab %}
  {% endtabs %}

{% hint style="success" %}
**Empfehlung:** Nutzen Sie für den produktiven, automatisierten Betrieb den **Integrationszugang**. Er ist stabiler und unabhängig von Benutzer-Passwortänderungen.
{% endhint %}

**Felder in der Konfiguration**

| Feld                   | Bei Integrationszugang | Bei Passwort-Grant |
| ---------------------- | ---------------------- | ------------------ |
| Shopware User Name     | Access Key ID          | Benutzername       |
| Shopware User Password | Secret Access Key      | Passwort           |
| Integrationszugang     | aktiv                  | inaktiv            |

**Sicherheit**

* Zugangsdaten werden **maskiert** gespeichert.
* Das Token wird bei Bedarf automatisch neu abgerufen.
* Vergeben Sie der Integration in Shopware nur die **erforderlichen Rechte** (Schreibzugriff auf die relevanten Bereiche).

{% hint style="warning" %}
Wenn Sie das Passwort des Administrationsbenutzers ändern, schlägt der Passwort-Grant fehl, bis Sie das neue Passwort hinterlegen. Der Integrationszugang ist davon nicht betroffen.
{% endhint %}

### Häufige Fragen

#### Welchen Endpunkt und welchen Grant-Type nutzt der Connector für die Anmeldung?

Die Anmeldung erfolgt am Endpunkt `oauth/token`. Beim Integrationszugang verwendet der Connector `grant_type=client_credentials` mit Client ID und Client Secret; beim Admin-Benutzer `grant_type=password` mit `client_id=administration`, Benutzername und Passwort. Das zurückgegebene Bearer-Token wird bei allen weiteren Aufrufen im Header `Authorization: Bearer {token}` mitgesendet und bei Ablauf automatisch erneuert.

#### Was prüft die Aktion „Test Connection“ genau?

„Test Connection“ ruft intern die Token-Anmeldung (`GetToken`) auf. Gelingt der Token-Abruf, ist die Kombination aus Website-URL, API-Modulpfad und Zugangsdaten korrekt. Schlägt er fehl, protokolliert der Connector bei aktivem „Developer Log“ die genaue Serverantwort im API Call Log.


# Shopware Erstdaten laden

Damit der Connector Business-Central-Werte den passenden Shopware-Werten zuordnen kann, müssen die **Shopware-Stammdaten** einmalig geladen werden. Das erledigt die Aktion **Shopware Erstdaten laden** in der Konfiguration.

**Was wird geladen?**

Der Initial-Download liest u. a. folgende Bereiche aus Shopware und legt sie als Zuordnungseinträge an:

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Zahlungsarten</strong></td><td>payment-method</td></tr><tr><td><strong>Versandarten</strong></td><td>shipping-method</td></tr><tr><td><strong>Steuern &#x26; Steuerregeln</strong></td><td>tax, tax-rule</td></tr><tr><td><strong>Währungen</strong></td><td>currency</td></tr><tr><td><strong>Verkaufskanäle</strong></td><td>sales-channel</td></tr><tr><td><strong>Kundengruppen</strong></td><td>customer-group</td></tr><tr><td><strong>Anreden &#x26; Länder</strong></td><td>salutation, country</td></tr><tr><td><strong>Sprachen</strong></td><td>language</td></tr><tr><td><strong>Statusverwaltung</strong></td><td>state-machine (+ Transitions)</td></tr></tbody></table>

Zusätzlich wird aus Ihren BC-**MwSt.-Produktbuchungsgruppen** ein **Item-Tax-Mapping** vorbereitet.

{% stepper %}
{% step %}
**Verbindung sicherstellen**

Führen Sie zuerst Verbindung testen aus.
{% endstep %}

{% step %}
**Erstdaten laden**

Klicken Sie in der Konfiguration auf **Shopware Erstdaten laden**. Der Vorgang kann je nach Datenmenge einige Sekunden dauern.
{% endstep %}

{% step %}
**Zuordnungen pflegen**

Öffnen Sie anschließend die Shopware Zuordnung und markieren Sie Standardwerte (Verkaufskanal, Währung, Kundengruppe) sowie die Steuerzuordnung.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Führen Sie **Erstdaten laden** erneut aus, wenn Sie in Shopware neue Zahlungsarten, Kanäle, Steuern o.ä. angelegt haben – damit die neuen Werte als Zuordnung verfügbar sind.
{% endhint %}

**Häufige Fragen**

<details>

<summary>Überschreibt der erneute Download meine gepflegten Zuordnungen?</summary>

Nein. Der Download ergänzt fehlende Werte. Bereits gepflegte BC-Zuordnungen bleiben erhalten. Für einen bewussten Neuaufbau nutzen Sie die Reset-Funktionen.

</details>


# Shopware Zuordnung & Mapping

Die **Shopware Zuordnung** (Mapping) ist das Bindeglied zwischen Shopware und Business Central. Hier legen Sie fest, welcher Shopware-Wert welchem BC-Wert entspricht – etwa welcher Shopware-Steuersatz zu welcher MwSt.-Produktbuchungsgruppe gehört.

**Aufbau der Zuordnungsseite**

Die Seite ist nach **Modulen** gegliedert. Je nach gewähltem Modul werden die passenden Spalten eingeblendet.

| Modul                      | Zweck                                        |
| -------------------------- | -------------------------------------------- |
| Payment Mapping            | Zahlungsarten Shopware ↔ BC                  |
| Shipping Mapping           | Versandarten ↔ Versandagent/Service          |
| Tax Mapping                | Steuersätze ↔ MwSt.-Buchungsgruppen          |
| Item Tax Mapping           | Artikelsteuer je MwSt.-Produktbuchungsgruppe |
| Currency                   | Währungen (Standard über *is Selected*)      |
| Sales Channel              | Verkaufskanäle (Standard über *is Selected*) |
| Customer Group             | Kundengruppen                                |
| Salutations                | Anreden                                      |
| Country                    | Länder                                       |
| Language                   | Sprachen                                     |
| State Machine / Transition | Statusverwaltung & Statusübergänge           |

**Wichtige Felder**

* **Shopware ID / Code / Beschreibung** – die Shopware-Seite der Zuordnung.
* **BC Code / Beschreibung** – der zugeordnete Business-Central-Wert.
* **is Selected** – markiert den **Standardwert** (z. B. Standard-Verkaufskanal, Standard-Währung, Standard-Kundengruppe).
* **isSync / Synced At** – Synchronisationsstatus des Eintrags.

{% hint style="info" %}
Die Zuordnungen werden über Shopware Erstdaten laden mit den vorhandenen Shopware-Werten vorbefüllt. Sie müssen anschließend nur noch die BC-Seite und die Standardmarkierungen pflegen.
{% endhint %}

**Empfohlene Reihenfolge**

{% stepper %}
{% step %}
**Standardwerte markieren**

Setzen Sie *is Selected* für den Standard-**Verkaufskanal**, die Standard-**Währung** und die Standard-**Kundengruppe**.
{% endstep %}

{% step %}
**Steuern zuordnen**

Verknüpfen Sie unter Steuern & Steuerzuordnung Ihre MwSt.-Produktbuchungsgruppen mit den Shopware-Steuersätzen.
{% endstep %}

{% step %}
**Zahlung & Versand**

Ordnen Sie Zahlungsarten und Versandarten zu.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Einen komfortablen Gesamtüberblick über alle erforderlichen Zuordnungen bietet der Shopware Mapping Hub.
{% endhint %}


# Shopware Mapping Hub

Der **Shopware Mapping Hub** ist eine eigenständige Übersichtsseite mit allen wichtigen Informationen zum angebundenen Webshop. Über Kacheln werden die zentralen Bereiche – erforderliche Zuordnungen und Stammdaten – übersichtlich dargestellt.

**Was bietet der Hub?**

* **Bündelung der Zuordnungen:** Alle erforderlichen Mappings (Steuern, Zahlung, Versand, Kanäle, Kundengruppen …) sind zentral erreichbar.
* **Auto-Assign-Logik:** Die automatische Zuordnungslogik wurde aus den einzelnen Abläufen ausgelagert und im Hub gebündelt. So werden Standardwerte konsistent gesetzt.
* **Statusblick:** Sie erkennen schnell, welche Bereiche vollständig gepflegt sind und wo noch Handlungsbedarf besteht.

{% hint style="info" %}
Der Mapping Hub ergänzt die klassische Shopware Zuordnung. Nutzen Sie den Hub für den Überblick und die Detailseite für die Feinpflege einzelner Einträge.
{% endhint %}

**Typischer Einsatz**

1. Nach dem Erstdaten-Laden den Hub öffnen.
2. Offene/unvollständige Bereiche identifizieren.
3. Zuordnungen ergänzen, Standardwerte setzen.
4. Vor dem ersten großen Upload den Hub als Kontroll-Checkliste verwenden.


# Steuern & Steuerzuordnung

Eine korrekte Steuerzuordnung ist Voraussetzung für fehlerfreie Preise und Bestellungen. Der Connector verbindet die BC-**MwSt.-Produktbuchungsgruppen** mit den Shopware-**Steuersätzen**.

**Grundprinzip**

```mermaid
flowchart LR
    A[MwSt.-Produktbuchungsgruppe in BC] --> B[Item Tax Mapping]
    B --> C[Shopware Steuersatz taxId]
    D[Artikel] -->|verweist auf| A
    D -->|Upload| C
```

Beim Artikel-Upload ermittelt der Connector über die MwSt.-Produktbuchungsgruppe des Artikels den passenden Shopware-Steuersatz (`taxId`). Fehlt eine Zuordnung, greift die **Standard-Steuer-ID** aus der Konfiguration.

**Einrichtung**

{% stepper %}
{% step %}
**Steuern laden**

Mit Shopware Erstdaten laden werden die Shopware-Steuersätze und -regeln importiert.
{% endstep %}

{% step %}
**Item-Tax-Mapping pflegen**

Ordnen Sie in der Shopware Zuordnung (Modul *Item Tax Mapping*) jeder MwSt.-Produktbuchungsgruppe die passende Shopware-Steuer-ID zu.
{% endstep %}

{% step %}
**Standard-Steuer setzen**

Hinterlegen Sie in der Konfiguration eine **Standard-Steuer-ID** als Fallback.
{% endstep %}
{% endstepper %}

**Steuerfreie Produkte & Bestell-Steuer**

* Für **steuerfreie** Produkte kann eine eigene **Steuerfreie Gruppe** hinterlegt werden.
* Für Bestellungen bestimmen die Einstellungen **MwSt. verwenden**, **MwSt.-Geschäftsbuchungsgruppe** und **MwSt.-Produktbuchungsgruppe**, wie Steuern beim Beleg berechnet werden. Details unter Bestellkonfiguration.

{% hint style="warning" %}
Prüfen Sie die Steuerzuordnung **vor** dem ersten großen Artikel-Upload. Eine falsche Zuordnung führt sonst zu falschen Preisen im Shop.
{% endhint %}

{% hint style="info" %}
Mit der Aktion **MwSt-Zuordnung zurücksetzen** in der Konfiguration können Sie die Steuerzuordnungen bei Bedarf neu aufbauen.
{% endhint %}


# Zahlungsarten zuordnen

Damit Bestellungen mit der korrekten **Zahlungsart** (z. B. Rechnung, PayPal, Kreditkarte, Vorkasse) importiert werden, ordnen Sie die Shopware-Zahlungsarten den entsprechenden BC-Werten zu.

**Einrichtung**

{% stepper %}
{% step %}
**Erstdaten laden**

Über Shopware Erstdaten laden werden die im Shop verfügbaren Zahlungsarten geladen.
{% endstep %}

{% step %}
**Zuordnung vornehmen**

Verknüpfen Sie jede Shopware-Zahlungsart mit dem passenden BC-Wert (z. B. Zahlungsform/-bedingung). So wird die Zahlungsinformation beim Bestellimport korrekt gesetzt.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Eine nicht zugeordnete Zahlungsart kann dazu führen, dass Bestellungen nicht korrekt verarbeitet werden. Prüfen Sie die Zuordnung vor dem ersten Bestellimport.
{% endhint %}

**Verwandte Themen**

* Versandarten zuordnen
* Shopware Erstdaten laden
* Shopware Mapping-Hub

### Häufige Fragen

#### Was passiert bei einer nicht zugeordneten Zahlungsart im Bestellimport?

Eine nicht zugeordnete Zahlungsart kann dazu führen, dass die Bestellung nicht korrekt verarbeitet wird. Prüfen Sie daher vor dem ersten Bestellimport, dass jede in Shopware aktive Zahlungsart einem passenden Business-Central-Wert zugeordnet ist.

#### Wo lade ich die verfügbaren Zahlungsarten aus Shopware?

Über „Shopware Erstdaten laden“ werden die im Shop verfügbaren Zahlungsarten in die Zuordnungstabelle geladen. Anschließend verknüpfen Sie sie im Mapping-Hub mit den entsprechenden Zahlungsformen bzw. -bedingungen in Business Central.


# Versandarten zuordnen

Jede Shopware-Bestellung enthält eine **Versandart**. Damit diese beim Import korrekt in Business Central abgebildet wird, ordnen Sie die Shopware-Versandarten den entsprechenden BC-Werten zu.

**Einrichtung**

{% stepper %}
{% step %}
**Erstdaten laden**

Über Shopware Erstdaten laden werden die im Shop definierten Versandarten in die Zuordnungstabelle geladen.
{% endstep %}

{% step %}
**Zuordnung vornehmen**

Verknüpfen Sie jede Shopware-Versandart mit der passenden BC-Versandmethode. So werden Lieferbedingungen und Versandkosten beim Bestellimport richtig übernommen.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Die Versandkosten einer Bestellung werden als eigene Position übernommen. Wie das konfiguriert wird, hängt von Ihren Einstellungen zu Versandkosten ab.
{% endhint %}

**Verwandte Themen**

* Zahlungsarten zuordnen
* Shopware Erstdaten laden
* Shopware Mapping-Hub

### Häufige Fragen

#### Wie werden die Versandkosten einer Bestellung übernommen?

Die Versandkosten einer Shopware-Bestellung werden als eigene Position in den Verkaufsauftrag übernommen. Wie genau das verbucht wird, hängt von Ihren Einstellungen zu Versandkosten ab. Die Versandart selbst wird über das Mapping der passenden BC-Versandmethode zugeordnet.

#### Was, wenn im Shop eine neue Versandart hinzukommt?

Laden Sie die Erstdaten erneut, damit die neue Versandart in der Zuordnungstabelle erscheint, und verknüpfen Sie sie mit der passenden BC-Versandmethode. Erst danach wird sie beim Bestellimport korrekt abgebildet.


# Währungen

Damit Preise und Bestellungen mit dem richtigen **Währungscode** übertragen werden, müssen die Währungen beider Systeme einander zugeordnet sein. Der Connector lädt die in Shopware definierten Währungen als Teil der Erstdaten und stellt sie zur Zuordnung bereit.

**Einrichtung**

{% stepper %}
{% step %}
**Erstdaten laden**

Über Shopware Erstdaten laden werden die vorhandenen Währungen aus Shopware in die Zuordnungstabelle geladen.
{% endstep %}

{% step %}
**Zuordnung prüfen**

Ordnen Sie im Mapping-Hub jede Shopware-Währung der passenden BC-Währung zu (z. B. EUR ↔ EUR).
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Die **Mandantenwährung (LCY)** in Business Central bleibt führend für die Buchhaltung. Für den Shop zählt die zugeordnete Shopware-Währung.
{% endhint %}

**Zusammenspiel**

* Preise werden in der zugeordneten Währung nach Shopware übertragen.
* Beim Bestellimport wird die Währung der Bestellung berücksichtigt.

**Verwandte Themen**

* Shopware Erstdaten laden
* Shopware Mapping-Hub

### Häufige Fragen

#### Was passiert, wenn eine Shopware-Währung keiner BC-Währung zugeordnet ist?

Ohne Zuordnung können Preise oder Bestellungen in dieser Währung nicht korrekt verarbeitet werden. Ordnen Sie daher jede in Shopware genutzte Währung im Mapping-Hub der passenden Business-Central-Währung zu, bevor Sie Preise hochladen oder Bestellungen importieren.

#### Bleibt die Mandantenwährung von Business Central führend?

Ja. Die Mandantenwährung (LCY) bleibt für die Buchhaltung führend. Für den Shop ist die zugeordnete Shopware-Währung maßgeblich; Preise werden in der zugeordneten Währung übertragen und beim Bestellimport entsprechend berücksichtigt.


# Verkaufskanäle einrichten

Mit dem Connector betreiben Sie **mehrere Verkaufskanäle** über eine Anbindung. Zunächst werden die Shopware-**Sales Channels** zugeordnet; anschließend lassen sich Artikel gezielt einzelnen oder mehreren Kanälen zuweisen.

**Grundeinrichtung**

{% stepper %}
{% step %}
**Kanäle laden**

Mit Erstdaten laden werden die Shopware-Verkaufskanäle importiert.
{% endstep %}

{% step %}
**Standardkanal markieren**

In der Shopware Zuordnung (Modul *Sales Channel*) markieren Sie mit **is Selected** die Standardkanäle. Fehlende Standardkanäle werden Artikeln automatisch zugewiesen.
{% endstep %}

{% step %}
**Artikel zuweisen**

Auf der Artikelkarte weisen Sie unter **Verkaufskanal** einzelne Artikel gezielt Kanälen zu. Details im Kapitel Vertriebskanäle am Artikel.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Damit ein Produkt im Shop sichtbar ist, muss es einem Verkaufskanal zugewiesen sein. Der Connector setzt dabei die Sichtbarkeit automatisch.
{% endhint %}

**Mehr-Kanal-Betrieb**

Wie Sie mehrere Kanäle sinnvoll organisieren, zeigt der Leitfaden Mehrere Verkaufskanäle betreiben.


# Kundengruppen & Preisgruppen

Über **Kundengruppen** steuern Sie im Shop, welche Kunden welche Preise und Konditionen sehen – etwa unterschiedliche Preise für **B2B** und **B2C**. Der Connector lädt die Shopware-Kundengruppen und ermöglicht die Verknüpfung mit den Preisstrukturen in Business Central.

**Einrichtung**

{% stepper %}
{% step %}
**Erstdaten laden**

Über Shopware Erstdaten laden werden die Kundengruppen aus Shopware geladen.
{% endstep %}

{% step %}
**Zuordnung vornehmen**

Verknüpfen Sie die Kundengruppen mit den passenden Preis-/Kundengruppen in BC. Damit lassen sich kundengruppenabhängige Preise gezielt übertragen.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Für gruppenabhängige Preise nutzt der Connector die erweiterten Preisregeln (Rules). Details finden Sie im Preisbereich unter „Kundengruppen-Preise (Rules)".
{% endhint %}

**Verwandte Themen**

* Shopware Erstdaten laden
* Shopware Mapping-Hub


# Anreden & Länder

Für saubere Kunden- und Adressdaten müssen **Anreden** (z. B. Herr, Frau) und **Länder** zwischen Shopware und Business Central zugeordnet sein. Der Connector lädt beide Wertelisten aus Shopware und stellt sie zur Zuordnung bereit.

**Einrichtung**

{% stepper %}
{% step %}
**Erstdaten laden**

Über Shopware Erstdaten laden werden Anreden und Länder aus Shopware geladen.
{% endstep %}

{% step %}
**Anreden zuordnen**

Verknüpfen Sie die Shopware-Anreden mit den Anreden/Feldwerten in BC.
{% endstep %}

{% step %}
**Länder zuordnen**

Ordnen Sie die Shopware-Länder den BC-Ländercodes (Ländercode/Region) zu – wichtig für Steuern und Versand.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Fehlt eine Länderzuordnung, können Adressen beim Kunden- oder Bestellimport nicht korrekt gebildet werden. Prüfen Sie die Zuordnung, bevor Sie Bestellungen herunterladen.
{% endhint %}

**Verwandte Themen**

* Shopware Erstdaten laden
* Steuern & Steuerzuordnung
* Shopware Mapping-Hub


# Statusverwaltung & Bestellstatus

Shopware verwaltet Bestellzustände über eine **State Machine** (Statusverwaltung) mit definierten **Status­übergängen** (Transitions). Der Connector nutzt diese, um den Bestellstatus bei bestimmten Ereignissen in BC automatisch zurückzumelden.

**Einrichtung**

1. Statusverwaltung und Übergänge mit Erstdaten laden importieren.
2. In der Konfiguration festlegen:
   * **Bestellstatus bei Lieferung** – welcher Übergang bei einer gebuchten Lieferung ausgelöst wird.
   * **Bestellstatus bei Rechnungserstellung** – welcher Übergang bei einer gebuchten Rechnung ausgelöst wird.
   * **Bestellstatus-E-Mail senden** – ob Shopware bei der Statusänderung eine E-Mail an den Kunden versendet.

{% hint style="info" %}
Die Auswahl der Status erfolgt über einen Lookup auf die geladenen Status­übergänge. Sind hier keine Werte verfügbar, führen Sie zuerst **Erstdaten laden** aus.
{% endhint %}

**Ablauf der Rückmeldung**

```mermaid
flowchart LR
    A[Lieferung in BC buchen] --> B[Status Lieferung an Shopware]
    C[Rechnung in BC buchen] --> D[Status Rechnung an Shopware]
    B --> E{E-Mail senden?}
    D --> E
    E -->|ja| F[Shopware benachrichtigt Kunden]
```

Mehr dazu unter Statusrückmeldung an Shopware.


# Versandkosten einrichten

Beim Bestellimport übernimmt der Connector die in Shopware berechneten **Versandkosten** als eigene Belegzeile. Sie legen fest, ob diese Zeile ein **Artikel** oder ein **Sachkonto** ist.

**Einstellungen**

| Feld                        | Bedeutung                                                |
| --------------------------- | -------------------------------------------------------- |
| **Versandkosten Typ**       | *Artikel* oder *Sachkonto*                               |
| **Versandkosten Artikel**   | Artikelcode für die Versandkostenzeile (bei Typ Artikel) |
| **Versandkosten Sachkonto** | Sachkonto für die Versandkostenzeile (bei Typ Sachkonto) |

**Ablauf**

{% stepper %}
{% step %}
**Typ wählen**

Entscheiden Sie, ob Versandkosten als Artikel (z. B. „VERSAND") oder als Sachkonto gebucht werden sollen.
{% endstep %}

{% step %}
**Referenz hinterlegen**

Hinterlegen Sie den passenden Artikelcode bzw. das Sachkonto in der Konfiguration.
{% endstep %}

{% step %}
**Automatische Übernahme**

Beim Bestellimport wird der Versandbetrag aus Shopware automatisch als Zeile ergänzt (sofern größer 0).
{% endstep %}
{% endstepper %}

{% hint style="success" %}
**Empfehlung:** Ein dedizierter Versandkosten-Artikel erleichtert Auswertungen und die MwSt.-Behandlung im Vergleich zur reinen Sachkontobuchung.
{% endhint %}


# Konfiguration exportieren & importieren

Die vollständige Shopware-Konfiguration – **inklusive aller Zuordnungen** – lässt sich als **JSON-Datei** exportieren und wieder importieren. Das ist ideal für Backups und für die Übertragung von einer Test- in eine Produktivumgebung.

**Anwendungsfälle**

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Backup</strong></td><td>Sichern Sie Ihre Einrichtung vor größeren Änderungen.</td></tr><tr><td><strong>Test → Produktiv</strong></td><td>Übertragen Sie eine geprüfte Konfiguration in die Live-Umgebung.</td></tr><tr><td><strong>Mehrere Mandanten</strong></td><td>Verteilen Sie eine Basiseinrichtung als Vorlage.</td></tr></tbody></table>

{% hint style="warning" %}
Nach einem Import in eine andere Umgebung sollten Sie **Zugangsdaten** und umgebungsspezifische IDs prüfen. Führen Sie anschließend Verbindung testen aus.
{% endhint %}

**Vorgehen**

1. In der Konfiguration die **Export**-Funktion aufrufen und die JSON-Datei speichern.
2. In der Zielumgebung die **Import**-Funktion aufrufen und die Datei einlesen.
3. Verbindung testen und Zuordnungen im Mapping Hub prüfen.


# (Einfache) Artikel

#### 1. Upload zu Shopware

Damit Artikel zu Shopware hochgeladen werden können, wurde die Artikelkarte um zusätzliche Funktionen erweitert.

Standardmäßige Zuordnung der Felder zwischen BC und Shopware:

<table><thead><tr><th width="135.221435546875">BC-Feld</th><th width="272.06494140625">Shopware-Feld</th></tr></thead><tbody><tr><td>Nr.</td><td>Artikelnummer (productNumber)</td></tr><tr><td>Beschreibung</td><td>Name</td></tr><tr><td>Marketingtext</td><td>Beschreibung (HTML)</td></tr><tr><td>Einstandspreis</td><td>Einkaufspreis</td></tr><tr><td>VK-Preis</td><td>Preis</td></tr><tr><td>GTIN</td><td>EAN</td></tr><tr><td>Basiseinheit</td><td>Einheit</td></tr></tbody></table>

Um die Übersicht aller Artikel in Business Central aufzurufen, navigieren Sie über folgenden Pfad: "*Verkauf"* <i class="fa-right">:right:</i> "*Artikel"*.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FDhc260Cj3EhlJBPLdHRa%2FBildschirmfoto%202026-02-25%20um%2009.22.43.png?alt=media&#x26;token=6f69c46d-d48e-4084-9944-0e10a6d44bb4" alt=""><figcaption></figcaption></figure></div>

Um die folgenden Einstellungen vorzunehmen, wählen Sie einen **bestehenden Artikel** aus oder legen einen **neuen Artikel** in Business Central an.

{% hint style="info" %}
**Wie lege ich einen Artikel richtig an?**

Bei Microsoft direkt finden Sie eine umfangreiche Anleitung und Hinweise zur Artikelanlage in Business Central. Folgen Sie hierfür dem Link:

<a href="https://learn.microsoft.com/de-de/dynamics365/business-central/inventory-how-register-new-items" class="button primary">Artikel anlegen</a>
{% endhint %}

Die Artikelattribute werden angezeigt. Die beiden folgenden Screenshots zeigen eine Standardansicht eines Artikels mit allen editierbaren Eigenschaften. Diese können je nach Einstellung individuell angepasst werden. Diese Erklärung geht von der Standardansicht aus.

Im Folgenden werden die einzelnen Merkmale erläutert.

<div data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2F37cgAhNfXvDcL46N9xyw%2FBildschirmfoto%202025-12-10%20um%2017.25.36.png?alt=media&#x26;token=8d4bc5fc-fbc2-442d-8358-642a1d9d77cf" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FCSNLLgzSjv8e4u7aNvEz%2FBildschirmfoto%202025-12-10%20um%2017.26.18.png?alt=media&#x26;token=0b065158-d7c2-448f-becf-91620c09ec54" alt=""><figcaption></figcaption></figure></div>

Der Upload eines Artikels zu Shopware ist möglich, wenn Folgendes bei der Artikelkarte ausgefüllt ist:

* **Nr.**: Der Inhalt dieses Feldes wird zur Artikelnummer in Shopware.
* **Beschreibung**: Der Inhalt dieses Feldes wird zum Artikelnamen in Shopware.
* **Gesperrt**: Dieses Feld bestimmt, ob der Artikel im Onlineshop angezeigt wird oder deaktiviert bleibt.
* **Basiseinheit**: Der Inhalt dieses Feldes wird zur Maßeinheit in Shopware (zu finden unter "Spezifikation").
* **GTIN** *(sichtbar bei Anwählen von "Mehr anzeigen")*: Legt die GTIN in Shopware fest.
* **Artikelkategoriecode**: Die hier hinterlegte Kategorie ist die BC-native. In der Regel wird sie nur benutzt, um den Artikel in Business Central zu sortieren. Jedoch ist es auch möglich eine Kategorie zu hinterlegen, die als Web-Kategorie zu Shopware hochgeladen wurde.
* **Shopware Kategorien**: Hier lassen sich für Shopware Artikelkategorien hinterlegen. Es ist auch möglich einen Artikel mehreren Kategorien zuzuordnen, was BC-seitig im Standard sonst nicht möglich ist.\
  Mehr erfahren Sie unter artikelkategorien

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Fq85mZp6OquuIa16wIclP%2FBildschirmfoto%202026-02-25%20um%2009.32.50.png?alt=media&#x26;token=898e4f44-89cf-4c4b-8b35-fea15274d109" alt=""><figcaption></figcaption></figure></div>

#### 2. Beschreibung Artikelkarte

{% hint style="info" %}
In der Standardansicht, befinden sich *Bild*, *Marketingtext* und *Artikelattribute* auf der rechten Seite im BC Fenster.
{% endhint %}

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><strong>Bild</strong></td><td>Die Bearbeitung wird im Unterpunkt artikelbilder beschrieben. Für mehr Informationen wechseln Sie bitte zu diesem Punkt.</td><td data-object-fit="contain"><a href="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FcljgJVkibQswBHEoNhL5%2FBildschirmfoto%202025-12-10%20um%2017.32.40.png?alt=media&#x26;token=7dd730f8-8cbf-4622-b988-fb7bdd1a3667">https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FcljgJVkibQswBHEoNhL5%2FBildschirmfoto%202025-12-10%20um%2017.32.40.png?alt=media&#x26;token=7dd730f8-8cbf-4622-b988-fb7bdd1a3667</a></td></tr><tr><td><strong>Marketingtext</strong></td><td>Der Marketingtext wird zur Artikelbeschreibung in Shopware. Er wird als HTML-Code übergeben, daher sind auch Formatierungen wie <strong>bold</strong> oder <em>cursive</em> möglich.</td><td data-object-fit="contain"><a href="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FeSyPMCHVgGAMG2T0NrCj%2FBildschirmfoto%202025-12-10%20um%2017.33.53.png?alt=media&#x26;token=5bf59def-5c2e-49f4-b4de-9dfccabe9c0a">https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FeSyPMCHVgGAMG2T0NrCj%2FBildschirmfoto%202025-12-10%20um%2017.33.53.png?alt=media&#x26;token=5bf59def-5c2e-49f4-b4de-9dfccabe9c0a</a></td></tr><tr><td><strong>Artikelattribute</strong></td><td>Die Bearbeitung wird im Unterpunkt artikelattribute beschrieben. Für mehr Informationen wechseln Sie bitte zu diesem Punkt.</td><td data-object-fit="contain"><a href="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FACwduOu508dGDUTu6rwS%2FBildschirmfoto%202025-12-10%20um%2017.36.10.png?alt=media&#x26;token=61996cfa-975e-45b8-9ef5-5d0d18f6445e">https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FACwduOu508dGDUTu6rwS%2FBildschirmfoto%202025-12-10%20um%2017.36.10.png?alt=media&#x26;token=61996cfa-975e-45b8-9ef5-5d0d18f6445e</a></td></tr></tbody></table>

{% hint style="info" %}
Für erweiterte Artikelbeschreibungen, z.B. durch Attribut-basierte Textbausteine, kontaktieren Sie bitte unser Support-Team: supportkontakte
{% endhint %}

**Lagerbestand**

Das Feld Lagerbestand übernimmt auf Basis der in der Konfiguration hinterlegten Lagereinstellungen den verfügbaren Bestand für den Shop.

* **Lagerbestand:**\
  Das Feld "*Lagerbestand*" füllt anhand der eingerichteten Lagereinstellungen in der Konfiguration den Lagerbestand im Shop.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FTnjnRJNQHVTEYGtmSxX6%2FBildschirmfoto%202026-02-25%20um%2009.54.17.png?alt=media&#x26;token=9cc05af0-7b52-4356-8857-9fae5810706e" alt=""><figcaption></figcaption></figure></div>

**Einstandpreise und Buchung**

* **Einstandspreis**\
  Für die Ansicht im Onlineshop nicht relevant, da es sich hier um den Einkaufspreis handelt. Dieser wird nicht übertragen und ist somit auch nicht im Shop zu finden.
* **MwSt.-Produktbuchungsgruppe** (sichtbar bei Anwählen von *"Mehr anzeigen"*):\
  Ist für die Zuweisung des Steuersatzes in Shopware zuständig.

{% hint style="warning" %}
Die MwSt.-Zuordnung ist in denbestellungenbeschrieben. Diese Zuordnung muss einmal erfolgen!

<img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FqoevtawMTH0JUregIRZW%2FBildschirmfoto%202026-02-25%20um%2010.37.45.png?alt=media&#x26;token=4d754d64-805a-4aca-a009-d53a830abc8f" alt="" data-size="original">
{% endhint %}

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FfBLm2eFwEkzp5d2o5kXd%2FBildschirmfoto%202026-02-25%20um%2009.54.28.png?alt=media&#x26;token=99eb2f9c-fa68-44d2-8140-33e29a2e8421" alt=""><figcaption></figcaption></figure></div>

**Shopware Informationen**

* **Web Artikel**\
  \&#xNAN;*JA:* Nur wenn Web Artikel auf *JA* gesetzt ist, kann der Artikel zum Shop hochgeladen werden.

{% hint style="warning" %}
Achtung! Der Artikel wird dadurch nicht automatisch zu Shopware hochgeladen, dies nehmen Sie unter ***Aktionen*** <i class="fa-right">:right:</i> ***Shopware*** <i class="fa-right">:right:</i> ***Produkt hochladen*** vor.
{% endhint %}

* **Übergeordnete Nr.**\
  Insofern dieser Artikel als *Variante* angelegt ist, finden Sie hier den übergeordneten Artikel.
* **Shopware aktiv**\
  JA: Der Artikel wird nicht nur zu Shopware hochgeladen, sondern dort auch aktiviert.
* **Nicht vorrätig**\
  JA: Der Artikel wird unabhängig vom Lagerbestand in BC in Shopware auf "*nicht vorrätig*" gesetzt.
* **Web-ID**\
  Die Web-ID wird nach erfolgreichem Upload zu Shopware automatisch gefüllt.
* **Importiert**\
  JA: der Artikel ist importiert, ansonsten *NEIN*.
* **Synchronisiert am**\
  Datum der letzten Synchronisation mit Shopware.
* **Bestandsmenge synchronisiert**
* **Bestandsmenge synchronisiert am**\
  Datum der letzten Synchronisation mit Shopware.
* **Preis synchronisiert**
* **Preis synchronisiert am**\
  Datum der letzten Synchronisation mit Shopware.
* **Synchronisierungsnachricht**\
  Es wird angezeigt, ob die letzte Synchronisierung mit Shopware erfolgreich war. Ist sie fehlgeschlagen, wird angegeben, welcher Fehler aufgetreten ist.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2F2Pol8VQ0SGhlpDjTiGZp%2FBildschirmfoto%202026-02-25%20um%2010.19.27.png?alt=media&#x26;token=893f4733-661f-4ad4-9af6-11e67bf90dfb" alt=""><figcaption></figcaption></figure></div>

**Verkaufskanal**

Unter dem Reiter Verkaufskanal können Sie festlegen, für welchen Shopware-Verkaufskanal das Produkt gedacht ist. Auch das Zuweisen eines Artikels zu mehreren Verkaufskanälen ist hier möglich.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Fxhbk6w6JUnAdeB5Lnz8e%2FBildschirmfoto%202025-12-10%20um%2017.53.36.png?alt=media&#x26;token=f306d0db-c1f0-4345-9983-c32b271cf021" alt=""><figcaption></figcaption></figure></div>

**Preis und Verkauf, Beschaffung, Planung, Artikelverfolgung und Lager**

Der folgende Screenshot veranschaulicht die Standard-Darstellung der weiteren Unterpunkte. Diese Merkmale sind:

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FE8IfT4sQ58KDWPgIEsVg%2FBildschirmfoto%202026-02-25%20um%2010.26.17.png?alt=media&#x26;token=6b8fb2e4-a654-4fdd-b1ca-7a7f02ccdb2c" alt="" width="563"><figcaption></figcaption></figure></div>

***

#### 3. Weitere Optionen

Um die **Einheiten eines Artikels** genauer zu definieren, folgen Sie dem Pfad:

*Zugehörig* <i class="fa-right">:right:</i> *Artikel* <i class="fa-right">:right:</i> *Einheiten*

Es können beispielsweise das *Gewicht* oder die *Stückzahl* pro Artikel (z.B. bei "3er Sets" etc.) bestimmt werden.

<div align="left"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FDtXWGRRlgPP43H7IGguS%2FBildschirmfoto%202025-12-10%20um%2017.56.38.png?alt=media&#x26;token=b0bed41c-93bb-457e-8ce9-3cefc8c37b3e" alt=""><figcaption></figcaption></figure> <figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Fj3yuAYSITUcTjlKiKcOs%2FBildschirmfoto%202025-12-10%20um%2017.56.07.png?alt=media&#x26;token=f81f04c0-e6b5-4a8a-910c-27168bccddb1" alt=""><figcaption></figcaption></figure></div>

Unter dem Reiter *Aktionen* <i class="fa-right">:right:</i> *Shopware* finden Sie nicht nur den Button *"Produkt hochladen"* für den Produkt-Upload zu Shopware, sondern noch weitere Funktionen:

* **Standardbilder importieren** ~~COMING SOON~~
* **Preislistenzeile** ~~COMING SOON~~
* **Synchronisierungsstatus zurücksetzen** ~~COMING SOON~~

{% updates format="full" %}
{% update date="2026-06-01" tags="update" %}

## Shopware Upload in der Artikelkarte

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FtOVy70l8EZ1NmP03npWv%2FBildschirmfoto%202026-07-06%20um%2011.05.07.png?alt=media&#x26;token=9d29dec6-e65a-4ffe-850e-fd2eae5c8f9a" alt="" width="563"><figcaption></figcaption></figure></div>
{% endupdate %}
{% endupdates %}

#### 4. Zusammenfassung

<details>

<summary><strong>Web-Artikel kennzeichnen</strong></summary>

Damit ein Artikel zu Shopware synchronisiert werden kann, muss er als **Web-Artikel** gekennzeichnet sein:

1. Öffnen Sie die **Artikelkarte.**
2. Scrollen Sie zum Bereich **Shopware Informationen.**
3. Setzen Sie **Web Artikel** auf **Ja.**

</details>

<details>

<summary><strong>Einzelnen Artikel hochladen</strong></summary>

1. Öffnen Sie die **Artikelkarte.**
2. Klicken Sie auf **Aktionen** <i class="fa-right">:right:</i> **Artikel zu Shopware**

</details>

<details>

<summary><strong>Mehrere Artikel hochladen</strong></summary>

1. Öffnen Sie die **Artikelliste.**
2. Wählen Sie die gewünschten Artikel aus.
3. Klicken Sie auf **Artikel zu Shopware.**

</details>

<details>

<summary><strong>Automatische Synchronisation</strong></summary>

1. Erstellen Sie einen **Aufgabenwarteschlangenposten.**
2. Wählen Sie die Codeunit **Artikelupload.**
3. Legen Sie das Intervall fest.

</details>

#### 5. Tipps für den täglichen Umgang

{% tabs %}
{% tab title="Datenqualität" %}

* Pflegen Sie vollständige Artikeldaten (Name, Beschreibung, Bilder).
* Verwenden Sie aussagekräftige Artikelnummern.
* Prüfen Sie die MwSt.-Zuordnung vor dem Upload.
  {% endtab %}

{% tab title="Performance" %}

* Laden Sie große Kataloge außerhalb der Geschäftszeiten hoch.
* Nutzen Sie Filter für selektive Updates.
* Überwachen Sie das Aktivitätsprotokoll.
  {% endtab %}
  {% endtabs %}

{% hint style="info" %}
Neue Artikel müssen in Shopware ggf. noch einem Verkaufskanal zugeordnet werden, bevor sie im Shop sichtbar sind.
{% endhint %}


# Konfigurierbare Artikel

Um einen konfigurierbaren Artikel zu erstellen müssen zuerst alle Varianten als artikel angelegt werden.

Diese Erklärung geht von der Standardansicht aus. Den folgenden Pfad folgen, um einen neuen Artikel (Masterartikel) anzulegen:

*Shopware* <i class="fa-right">:right:</i> *Zugehörig* <i class="fa-right">:right:</i> *Verbundene Artikel (übergeordnet)*

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FGxfBrwRT3ywCmfMQqyUk%2FBildschirmfoto%202025-12-17%20um%2017.39.29.png?alt=media&#x26;token=1672deff-34ca-4f52-a4b2-b93575dd70f6" alt=""><figcaption></figcaption></figure></div>

Bei der neu geöffneten Seite zuerst *„+ Neu“* anklicken, um anschließend alle Produktdetails einzutragen.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FPwYEr56Ex5kw0qWGWfzQ%2FBildschirmfoto%202025-12-17%20um%2017.40.16.png?alt=media&#x26;token=5aea747d-5444-4cce-ac9d-59f4b12d7754" alt=""><figcaption></figcaption></figure></div>

Die Produktdetails werden angezeigt. Die beiden folgenden Screenshots zeigen eine Standardansicht mit allen editierbaren Eigenschaften. Diese können je nach Einstellung individuell angepasst werden.

Im Folgenden werden die einzelnen Merkmale erläutert.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FqrDBixkgQJhvvveulTMN%2FBildschirmfoto%202026-02-25%20um%2010.45.11.png?alt=media&#x26;token=db86e7a1-8847-4741-95b4-e271c4a55a43" alt=""><figcaption></figcaption></figure></div>

#### 1. Allgemein

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FgBrPxbBWZRqkOLfe4YMj%2FBildschirmfoto%202026-02-25%20um%2010.47.14.png?alt=media&#x26;token=e3964120-4181-4f54-a9b0-12c96c28e278" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Bitte beachten, dass zuerst die Nummern (Artikelnummern) angelegt werden, um im Anschluss Namen (Produktnamen) zu vergeben.
{% endhint %}

#### 2. Varianten

Dem Artikel können bis zu drei Option-Attribute zugewiesen werden. Mindestens ein Attribut muss vergeben werden. Abhängig von der Auswahl erfolgt die entsprechende Verknüpfung des Produkts.

{% hint style="danger" %}
Wichtig! Das Simple Produkt muss ebenfalls das entsprechende verbindende Attribut enthalten, andernfalls wird eine Fehlermeldung ausgegeben.
{% endhint %}

Beispiel mit einem Attribut: ![](https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FOszf42Yhg61mEz7qTwgH%2FBildschirmfoto%202025-12-17%20um%2017.42.01.png?alt=media\&token=0bfe4899-3c8a-48a8-ad6d-7beb0e0c754b)

Beispiel mit zwei Attributen: ![](https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FxyFndMPtFam66gXZEYK2%2FBildschirmfoto%202025-12-17%20um%2017.42.20.png?alt=media\&token=02cf2929-dce7-4ce3-8dba-35fc5bea69ee)

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Fui9kFnhYz7ghE5ZYxlDm%2FBildschirmfoto%202025-12-17%20um%2017.50.41.png?alt=media&#x26;token=e3c8e138-2009-4dd2-93b8-bef64799ed3d" alt=""><figcaption></figcaption></figure></div>

#### 3. Shopware Informationen

Hier lässt sich einsehen, ob das Produkt bereits zu Shopware synchronisiert wurde und zu welchem Zeitpunkt dies erfolgt ist. Außerdem werden die zugehörige Shopware-ID sowie der jeweilige Statusgrund übersichtlich dargestellt.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2F4FHcYTuy6sbPfwhjggrM%2FBildschirmfoto%202025-12-17%20um%2017.51.25.png?alt=media&#x26;token=9cdfe47b-b4fd-424c-ac5b-0bc83fc75488" alt=""><figcaption></figcaption></figure></div>

#### 4. Verkaufskanal

Der Verkaufskanal zeigt an, in welchem Shop das Produkt verfügbar ist. Die Auswahl in welchen Shop der Artikel angeboten wird, kann selbst entschieden werden.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Fslt8sesaOtahyanXypqV%2FBildschirmfoto%202025-12-17%20um%2017.52.02.png?alt=media&#x26;token=93179031-098c-4909-8295-d2e9fd6e1852" alt=""><figcaption></figcaption></figure></div>

#### 5. Shopware-Produktbilder

Folgen Sie dem Pfad *Shopware-Produktbilder* <i class="fa-right">:right:</i> *Liste*. Dort werden alle Produktbilder auch von den simplen Artikeln aufgelistet. Wählen Sie hier das Titelbild aus indem Sie in der Liste dieses mit einem Hacken versehen.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FaNO8RqCNt3WNBCfv3Su8%2FBildschirmfoto%202026-02-25%20um%2010.50.48.png?alt=media&#x26;token=88d319da-86f9-4d16-bcea-8561a51e4da6" alt=""><figcaption></figcaption></figure></div>

Fall noch keine Bilder vorhanden sind, wählen Sie oben in der Leiste *"+ Neu"* und anschließend rechts *"Shopware-Produktbilder"* aus. Im geöffneten Dropdown-Menü "*Importieren"* anklicken. Ziehen Sie das gewünschte Bild direkt in das geöffnete Fenster oder laden Sie dieses über die Funktion *"Durchsuchen"* hoch.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Fk9wN8944FXv25Xl53hWr%2FBildschirmfoto%202025-12-17%20um%2017.52.38.png?alt=media&#x26;token=0f20b6e2-ca78-4928-8162-2c0a9a0d4b92" alt=""><figcaption></figcaption></figure></div>

#### 6. Zuweisung und Upload

Nach Eingabe aller notwendigen Details muss der Artikel einer Kategorie zugewiesen werden. Dies passiert, indem man den Button *"Einfache Produkte zuweisen"* betätigt. Bei erfolgreichem Upload taucht das Produkt anschließend in der Liste *"Einfaches Produkt"* auf.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2F9OROMMumfTKZ4wzCypVX%2FBildschirmfoto%202025-12-17%20um%2017.53.25.png?alt=media&#x26;token=d8b42b4e-6df8-495d-8183-72b0e9499623" alt=""><figcaption></figcaption></figure></div>


# Varianten aus dem MODUS Configurator nach Shopware

Der Shopware 6 API Connector kann Artikelvarianten, die im **MODUS M365 Configurator** in Business Central erzeugt werden, **nativ als konfigurierbares Shopware-Produkt** uebertragen. Dabei wird der Basisartikel zum konfigurierbaren Shopware-Vater und **jede BC-Artikelvariante (Item Variant) zu einem Shopware-Kindprodukt**. Die variantenbildenden Merkmale (Sachmerkmale/Auspraegungen) werden zu Shopware **Property Groups** und **Property Group Options**.

{% hint style="info" %}
Dieses Modell ergaenzt das klassische Vater/Kind-Modell ueber die Tabelle Konfigurierbare Artikel (SOUSHW Parent Item). Beide Wege lassen sich parallel nutzen. Der Unterschied: Hier ist der **Basisartikel selbst** der Shopware-Vater und die Kinder sind **echte BC-Artikelvarianten** - kein separater Artikel je Variante.
{% endhint %}

### Architektur im Ueberblick

* **Vater** = Basisartikel: erhaelt das Feld configuratorSettings (Vereinigung aller Auspraegungen ueber alle Varianten).
* **Kind** = jede Item Variant: erhaelt parentId (Shopware-ID des Vaters), options und properties (die Auspraegungen dieser Variante) sowie **Bestand, Preis und Gewicht je Variante**.

### Voraussetzungen

* Der Basisartikel besitzt in Business Central **Artikelvarianten** (Standardtabelle Item Variant), z. B. aus dem MODUS M365 Configurator.
* Die Mengeneinheit des Artikels ist zu Shopware hochgeladen (wie bei einfachen Artikeln).
* Eine aktive Shopware-Konfiguration mit Artikelupload = aktiviert.

### Einrichtung in Business Central

{% stepper %}
{% step %}

#### Artikel als Variantenartikel markieren

Oeffnen Sie die **Artikelkarte** und aktivieren Sie im Inforegister Shopware Informationen das Feld **Variantenartikel (konfigurierbar)** (SOUSHW Variant Master). Der Artikel wird dadurch als konfigurierbarer Shopware-Vater behandelt.
{% endstep %}

{% step %}

#### Hochladen

Klicken Sie auf der Artikelkarte auf **Als konfigurierbaren Artikel (Varianten) hochladen**. Der Connector legt zuerst die benoetigten Property Groups/Options an, laedt den Vater hoch und erzeugt anschliessend fuer jede Artikelvariante ein Shopware-Kindprodukt.
{% endstep %}

{% step %}

#### Status pruefen

Oeffnen Sie die **Artikelvarianten** des Artikels. Dort sehen Sie je Variante die Shopware-Sync-Spalten: aktiv, synchronisiert, Web-ID, synchronisiert am und Meldung.
{% endstep %}
{% endstepper %}

Fuer Massenlaeufe steht im Report **Shopware Upload** zusaetzlich die Option **Variantenartikel (konfigurierbar)** zur Verfuegung. Variantenartikel werden ausserdem automatisch im normalen Produkt-Upload beruecksichtigt.

### Was genau wird hochgeladen?

| Element                  | Shopware-Feld        | Herkunft in BC                                                                      |
| ------------------------ | -------------------- | ----------------------------------------------------------------------------------- |
| Vater                    | configuratorSettings | Vereinigung aller Auspraegungen aller Varianten                                     |
| Kind Artikelnummer       | productNumber        | Artikelnr. + Bindestrich + Variantencode                                            |
| Kind Zuordnung zum Vater | parentId             | Shopware-ID des Basisartikels                                                       |
| Kind Achsen              | options, properties  | Sachmerkmal/Auspraegung der Variante                                                |
| Kind Bestand             | stock                | Lagerbestand je Variantencode (Item Ledger Entry) abzueglich offener Verkaufsmengen |
| Kind Preis               | price                | Basisartikel-Preis bzw. Standard-Preisliste                                         |
| Kind Gewicht             | weight               | variantenspezifisch (Configurator) oder Artikelgewicht                              |

### Sachmerkmale und Auspraegungen (Achsen)

Jedes **Sachmerkmal** wird zu einer Shopware **Property Group** (property-group), jede **Auspraegung** zu einer **Property Group Option** (property-group-option). Die Shopware-IDs werden im Mapping (Modul Configurator Attribute) gespeichert und wiederverwendet, damit keine Duplikate entstehen. Der Zusammenhang zum klassischen Attribut-Abgleich ist unter [Attribute und Eigenschaften (Property Groups) abgleichen](/shopware/daten-aus-shopware-download-and-matching/attribute-and-eigenschaften-property-groups-abgleichen) beschrieben.

{% hint style="warning" %}
**Herkunft der Merkmale:** Sind die Symbole des MODUS M365 Configurator noch nicht in der Erweiterung eingebunden, verwendet der Connector einen **Fallback**: Es wird genau eine Achse namens Variante mit der Variantenbeschreibung erzeugt. Vater/Kind-Struktur und der Bestand je Variante funktionieren dann bereits vollstaendig. Zum Aktivieren der echten mehrachsigen Sachmerkmale werden die Configurator-Symbole benoetigt.
{% endhint %}

### Abgrenzung: welches Variantenmodell waehle ich?

* **Basisartikel + BC-Artikelvarianten (diese Seite):** ideal, wenn die Varianten im MODUS Configurator als echte Item Variant gefuehrt werden. Ein Artikel, viele Varianten.
* **Konfigurierbare Artikel ueber SOUSHW Parent Item:** ideal, wenn jede Variante ein **eigener BC-Artikel** ist. Siehe [Konfigurierbare Artikel](/shopware/stammdatenverwaltung/konfigurierbare-artikel).

Fuer das nachtraegliche Verknuepfen bestehender Shopware-Varianten lesen Sie [Varianten abgleichen (Farbe und Groesse)](/shopware/daten-aus-shopware-download-and-matching/varianten-abgleichen-farbe-and-grosse).

### Haeufige Fragen

#### Wie werden MODUS-Configurator-Varianten nach Shopware uebertragen?

Der Basisartikel wird als konfigurierbarer Shopware-Vater hochgeladen und jede BC-Artikelvariante (Item Variant) als eigenes Shopware-Kindprodukt mit parentId. Aktivieren Sie dazu auf der Artikelkarte das Feld **Variantenartikel (konfigurierbar)** und nutzen Sie die Aktion **Als konfigurierbaren Artikel (Varianten) hochladen**.

#### Woraus entstehen die Variantenachsen in Shopware?

Aus den Sachmerkmalen und Auspraegungen: Jedes Sachmerkmal wird zu einer Shopware Property Group, jede Auspraegung zu einer Property Group Option. Der Connector legt fehlende Gruppen/Optionen automatisch an und speichert deren Shopware-IDs, um Duplikate zu vermeiden.

#### Wie lautet die Artikelnummer (SKU) einer Variante in Shopware?

Die productNumber des Kindprodukts setzt sich aus der Artikelnummer des Basisartikels und dem Variantencode zusammen (Artikelnr. + Bindestrich + Variantencode). Dadurch ist jede Variante eindeutig identifizierbar.

#### Wird der Bestand je Variante berechnet?

Ja. Der Bestand wird je Variantencode aus den Artikelposten (Item Ledger Entry) ermittelt und um offene Verkaufsmengen dieser Variante reduziert. Ueber Nicht vorraetig je Variante laesst sich der Bestand gezielt auf 0 setzen.

#### Muss ich das bestehende Vater/Kind-Modell umstellen?

Nein. Das Modell ueber SOUSHW Parent Item (eigener Artikel je Variante) bleibt unveraendert nutzbar. Das neue Modell ist additiv und wird ausschliesslich fuer Artikel mit gesetztem Kennzeichen **Variantenartikel (konfigurierbar)** verwendet.

#### Was passiert, wenn die MODUS-Configurator-Symbole noch nicht eingebunden sind?

Dann greift ein Fallback mit einer einzigen Achse Variante (Wert = Variantenbeschreibung). Die konfigurierbare Vater/Kind-Struktur und der Bestand je Variante funktionieren bereits vollstaendig; die mehrachsigen Sachmerkmale werden aktiviert, sobald die Configurator-Symbole verfuegbar sind.


# Artikelattribute

Verwalten und synchronisieren Sie Artikelattribute zwischen Business Central und Shopware.

Artikelattribute ermöglichen es, zusätzliche Eigenschaften zu Artikeln zu definieren, die in Shopware als Produkteigenschaften oder Spezifikationen angezeigt werden.

### 1. Attribute in Business Central

#### 1.1 Attribute anlegen

1. Navigieren Sie zu "*Artikel"* <i class="fa-right">:right:</i> *"Artikelattribute".*
2. Erstellen Sie neue Attribute (z.B. Farbe, Material, Größe)
3. Definieren Sie die möglichen Werte.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FRygLNRN72fPkZUN3W6Ta%2FBildschirmfoto%202026-02-25%20um%2011.00.49.png?alt=media&#x26;token=781d291a-de5d-4480-9862-362d51549e24" alt=""><figcaption></figcaption></figure></div>

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FoB13fTu844cz8HHo5mFI%2FBildschirmfoto%202026-02-25%20um%2010.59.29.png?alt=media&#x26;token=75de11ab-d384-4586-917a-004959d4fa20" alt=""><figcaption></figcaption></figure></div>

#### 1.2 Attribute zuweisen

1. Öffnen Sie die *"Artikelkarte".*
2. Navigieren Sie zu "*Zugehörig"* <i class="fa-right">:right:</i> *"Artikel"* <i class="fa-right">:right:</i> *"Attribute".*
3. Weisen Sie die gewünschten Attribute und Werte zu.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FIoOSayQ7uhMIebLUYL9s%2FBildschirmfoto%202026-02-25%20um%2011.04.56.png?alt=media&#x26;token=1b7f0057-adcf-49e4-ab91-3bb159a44280" alt="" width="359"><figcaption></figcaption></figure></div>

### 2. Attribut-Synchronisation

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><h4>Attribut-Mapping / Zuordnung</h4></td><td><p>Attribute werden automatisch zu Shopware synchronisiert, wenn:</p><ul><li>Das Attribut einem <em>"Web-Artikel"</em> zugewiesen ist.</li><li>Das Attribut in der Mapping-Tabelle zugeordnet ist.</li></ul></td></tr><tr><td><h4>Mapping / Zuordnung einrichten</h4></td><td><ol><li>Öffnen Sie <em>"Shopware"</em> <i class="fa-right">:right:</i> <em>"Zuordnung"/"Mapping"</em></li><li>Wählen Sie <em>"Modulname-Filter"</em></li><li>Ordnen Sie BC-Attribute den Shopware-Eigenschaften zu.</li></ol></td></tr></tbody></table>

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Ff89WGKyQiBQDtWibPGHV%2FBildschirmfoto%202026-02-25%20um%2011.13.57.png?alt=media&#x26;token=dbce3c88-836f-4a07-bfca-3c466c0e5344" alt=""><figcaption></figcaption></figure></div>

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FqT2ao6kKQYRghslJL3mu%2FBildschirmfoto%202026-02-25%20um%2011.11.21.png?alt=media&#x26;token=96c0c8fb-d187-4437-8dfd-c7589b0b1b70" alt=""><figcaption></figcaption></figure></div>

### 3. Attributwerte

#### 3.1 Wertetypen

Business Central unterstützt verschiedene Wertetypen:

<table><thead><tr><th width="105.7950439453125">Typ</th><th width="290.436767578125">Beschreibung</th><th width="176.5087890625">Beispiel</th></tr></thead><tbody><tr><td><strong>Option</strong></td><td>Auswahl aus vordefinierten Werten</td><td>Rot, Blau, Grün</td></tr><tr><td><strong>Text</strong></td><td>Freitext</td><td>"Premium Qualität"</td></tr><tr><td><strong>Ganzzahl</strong></td><td>Ganze Zahlen</td><td>42</td></tr><tr><td><strong>Dezimal</strong></td><td>Dezimalzahlen</td><td>3.14</td></tr></tbody></table>

#### 3.2 Werte synchronisieren

Attributwerte werden automatisch zu Shopware übertragen:

{% stepper %}
{% step %}
Als Eigenschaften für Filterfunktionen.
{% endstep %}

{% step %}
In den Spezifikationen auf der Produktseite.
{% endstep %}
{% endstepper %}

### 4. Varianten und Properties

#### 4.1 Was sind Shopware Properties?

**Shopware Properties** sind Produkteigenschaften, mit denen sich Artikel in **Shopware** strukturiert beschreiben und filtern lassen. Sie dienen dazu, Merkmale wie Größe, Farbe, Material oder technische Spezifikationen standardisiert abzubilden.

Im Unterschied zu Varianten (z. B. Größe S, M, L als auswählbare Ausprägungen eines Produkts) sind Properties meist rein beschreibend. Sie erscheinen typischerweise in den Produktdetails und werden häufig für Filterfunktionen in Kategorien verwendet, damit Kunden gezielt nach bestimmten Merkmalen suchen können

Verwendung bspw. für:

* Filternavigation im Shop
* Produktvergleiche
* Suchergebnisse

#### 4.2 Shopware Options (Varianten)

Für Produktvarianten (z.B. T-Shirt in verschiedenen Größen):

1. Erstellen Sie in BC einen *"Stammartikel"*
2. Definieren Sie *"Varianten"* mit unterschiedlichen Attributwerten.
3. Synchronisieren Sie den Stammartikel zu Shopware.

{% hint style="info" %}
Die Varianten-Funktion erfordert eine entsprechende Konfiguration und ist nicht in allen Versionen verfügbar.
{% endhint %}

### 5. Tipps für den täglichen Umgang

{% tabs %}
{% tab title="Attributstruktur" %}

* Verwenden Sie konsistente Attributnamen.
* Definieren Sie klare Wertelisten.
* Vermeiden Sie Duplikate und Ähnlichkeiten.
  {% endtab %}

{% tab title="Performance" %}

* Beschränken Sie die Anzahl der Attribute pro Artikel.
* Nutzen Sie Options-Attribute statt Freitext wo möglich.
* Prüfen Sie die Synchronisations-Logs auf Fehler.
  {% endtab %}
  {% endtabs %}

### Häufige Fragen

#### Wie lade ich einzelne bzw. alle offenen Attribute nach Shopware hoch?

Einzelne Attribute laden Sie über die Aktion „SOUSHW Upload Attribute“ hoch. Für den Massen-Upload aller noch nicht synchronisierten Attribute dient `Upload_PendingItemAttributes`; die Codeunit „SOUSHW Item Attribute Mgnt.“ ist zudem Job-Queue-fähig und kann den Attribut-Upload automatisiert ausführen.


# Artikelkategorien

Verwalten und synchronisieren Sie Artikelkategorien zwischen Business Central und Shopware.

Artikelkategorien strukturieren Ihren Produktkatalog und werden zwischen Business Central und Shopware synchronisiert.

### 1. Kategorien in Business Central

#### 1.1 Kategoriestruktur

Business Central verwendet Kategorien zur Strukturierung. Die Kategorien werden hierarchisch angezeigt. Geben Sie in das Suchfeld "*Kategorien"* ein und Sie gelangen in das dazugehörige Menü.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FNxt0vz17iiAQpkODvxjY%2FBildschirmfoto%202026-02-25%20um%2011.58.29.png?alt=media&#x26;token=27e778b2-63cf-4319-b14c-50d2e7d247d7" alt="" width="375"><figcaption></figcaption></figure></div>

#### 1.2 Kategorien anlegen

Geben Sie im Suchfeld von Business Central den Begriff *„Artikelkategorien“* ein, um direkt in das entsprechende Menü zu gelangen. Dort klicken Sie auf *„+ Neu“,* um eine neue Kategorie anzulegen. Anschließend füllen Sie die Felder *„Code“, „Beschreibung“* und (sofern erforderlich) *„Übergeordnete Kategorie“* aus. Technisch ausreichend ist bereits die Angabe des *"Codes"*, die weiteren Felder dienen der besseren Strukturierung und Übersicht.

<table data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><strong>Code</strong>: Eindeutiger Kategoriencode</td></tr><tr><td><strong>Beschreibung:</strong> Kategoriename für Anzeige</td></tr><tr><td><strong>Übergeordnete Kategorie:</strong> Elternkategorie für Hierarchie</td></tr></tbody></table>

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FtRrMOuNg58guh4IXvIvH%2FBildschirmfoto%202026-02-25%20um%2011.40.18.png?alt=media&#x26;token=b06be49b-f02f-4357-8725-6e4f7c3c8df2" alt=""><figcaption></figcaption></figure></div>

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FMHObbwRgbt2pbWw7qBxm%2FBildschirmfoto%202026-02-25%20um%2011.44.48.png?alt=media&#x26;token=bfb5831e-259e-4c28-b892-fed33f1d6f37" alt=""><figcaption></figcaption></figure></div>

#### 1.3 Kategorie zuweisen

* Öffnen Sie die [*"Artikelkarte"*](#upload-zu-shopware) des gewünschten Produkts, welches Sie einer Kategorie zuweisen möchten.
* Wählen Sie unter *"Artikelkategoriecode"* die gewünschte Kategorie aus.
* Wie lege ich eine Kategorie an? Siehe hierfür den vorherigen Punkt: ["1.2 Kategorie anlegen"](#id-1.2-kategorien-anlegen)

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FNG3rFSWY7WHf9SmAKRzj%2FBildschirmfoto%202026-02-26%20um%2009.26.40.png?alt=media&#x26;token=d64799e4-86de-4724-9841-26c3bd8c8cd5" alt=""><figcaption><p>Menüpunkt Artikelkarte</p></figcaption></figure></div>

### 2. Kategoriesynchronisation

#### Initial-Download

Beim Initial-Download werden alle Kategorien aus Shopware nach Business Central importiert:

{% stepper %}
{% step %}
Die Shopware-Kategorien werden abgerufen.
{% endstep %}

{% step %}
Entsprechende BC-Artikelkategorien werden erstellt.
{% endstep %}

{% step %}
Die Shopware-ID wird für das Mapping / die Zuordnung gespeichert.
{% endstep %}
{% endstepper %}

#### Upload zu Shopware

Neue Kategorien aus BC können zu Shopware hochgeladen werden:

{% columns %}
{% column %}
{% stepper %}
{% step %}
Erstellen Sie eine neue [*"Artikelkategorie"*](#id-1.-kategorien-in-business-central) in BC.
{% endstep %}

{% step %}
Öffnen Sie im Bereich **Artikelkategoriekarte:** *"Aktionen"* <i class="fa-right">:right:</i> *"Shopware"* <i class="fa-right">:right:</i> *"Kategorie Hochladen"*
{% endstep %}

{% step %}
Die Kategorie wird unter der konfigurierten übergeordneten Kategorie erstellt.
{% endstep %}
{% endstepper %}
{% endcolumn %}

{% column %}

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FtRPF2yBV3jqogIRgBnFZ%2FBildschirmfoto%202026-04-07%20um%2011.12.01.png?alt=media&#x26;token=5d28acb4-db01-4dd4-9fbe-8b3a34ce8a08" alt="" width="375"><figcaption></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
Die **Übergeordnete Kategorie-ID** in den Lager-Einstellungen bestimmt, wo neue Kategorien in Shopware angelegt werden.
{% endhint %}

### 3. Shopware-Erweiterungen

Die Artikelkategorie-Karte wurde um folgende Felder erweitert:

<table data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><p><strong>Shopware ID:</strong></p><p>Zugeordnete Shopware-Kategorie-ID</p></td></tr><tr><td><p><strong>Web Kategorie:</strong></p><p>Markiert die Kategorie für Shopware</p></td></tr></tbody></table>

### 4. Kategorie-Mapping / Kategorie-Zuordnung

{% tabs %}
{% tab title="Automatisches Mapping" %}
Nach dem Initial-Download werden Kategorien automatisch gemappt/zugeordnet basierend auf:

* **Shopware-ID** (höchste Priorität)
* **Kategorienname** (falls ID nicht vorhanden)
  {% endtab %}

{% tab title="Manuelles Mapping" %}

* Öffnen Sie die *"Artikelkategorie-Karte"*.
* Geben Sie die *"Shopware ID"* manuell ein.
* Speichern Sie die Änderungen.
  {% endtab %}
  {% endtabs %}

### 5. Tipps für den täglichen Umgang

{% tabs %}
{% tab title="Kategoriestruktur" %}

* Halten Sie die Hierarchie flach (max. 3-4 Ebenen).
* Verwenden Sie aussagekräftige Namen.
* Vermeiden Sie Sonderzeichen in Codes.
  {% endtab %}

{% tab title="Synchronisation" %}

* Erstellen Sie Kategorien zuerst in Shopware.
* Nutzen Sie den Initial-Download für das Mapping.
* Prüfen Sie regelmäßig die Kategorie-Zuordnungen.
  {% endtab %}
  {% endtabs %}

### Häufige Fragen

#### Kann ein Artikel mehreren Shopware-Kategorien zugeordnet werden?

Ja. Das Feld „SOUSHW Shopware Categories“ speichert mehrere Kategorien pipe-getrennt (Feldlänge bis 2000 Zeichen). Beim Upload werden alle hinterlegten Kategorien dem Produkt zugeordnet; per DrillDown sehen Sie die vollständigen Kategoriepfade, per AssistEdit öffnen Sie die Kategorieauswahl.


# Artikelbilder

Verwalten und synchronisieren Sie Artikelbilder zwischen Business Central und Shopware.

Artikelbilder sind essentiell für einen professionellen Onlineshop. Der Shopware 6 API Connector ermöglicht das Hochladen und Verwalten von Produktbildern direkt aus Business Central.

**1. Bilder in Business Central**

**1.1 Hauptbild zuweisen**

Das Hauptbild eines Artikels wird über die **Artikelkarte** verwaltet:

{% columns %}
{% column %}
{% stepper %}
{% step %}
Öffnen Sie die *Artikelkarte*.
{% endstep %}

{% step %}
Klicken Sie im Bild-Bereich (in der Standardansicht rechts) auf das *"Bild"*-Symbol.
{% endstep %}

{% step %}
Wählen Sie *"Importieren"* und laden Sie ein Bild hoch.
{% endstep %}
{% endstepper %}
{% endcolumn %}

{% column %}

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FrOkWNNVT0mGiUtaqVDEI%2FBildschirmfoto%202026-04-07%20um%2011.45.23.png?alt=media&#x26;token=1f061538-a1e4-458f-9a1c-dee431c66753" alt="" width="375"><figcaption></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

{% hint style="success" %}
Das Titelbild kann jederzeit in BC angepasst werden. Nach der Synchronisation werden die Änderungen automatisch in Shopware übernommen.
{% endhint %}

**1.2 Zusätzliche Bilder**

Für zusätzliche Produktbilder (Galerie):

{% stepper %}
{% step %}
Öffnen Sie die Artikelkarte.
{% endstep %}

{% step %}
Wieder im rechten Bereich (Standardansicht) finden Sie den Menüpunkt *"Bild"*. Klicken Sie dort auf die Zahl, die rechts neben *"Shopware Additional images"* steht.

{% hint style="info" %}
Wenn keine zusätzlichen Bilder zum Titelbild hochgeladen wurden, wird **0** angezeigt. Andernfalls entspricht die angezeigte Zahl der **Gesamtanzahl der zusätzlich hochgeladenen Bilder**.
{% endhint %}

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FJcuW6w8nnvgK5Fm5gKuH%2FBildschirmfoto%202026-04-09%20um%2009.33.00.png?alt=media&#x26;token=b1e15933-7a1c-46cc-884d-444bbc6495eb" alt="" width="121"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Es öffnet sich ein neues Fenster "Additional Shopware Images". Nun können Sie zusätzliche Bilder hochladen aber auch Bilder bearbeiten oder wieder löschen.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FlTE0nrbL4EjYVTtQl5bm%2FBildschirmfoto%202026-04-09%20um%2009.33.23.png?alt=media&#x26;token=5c802819-275a-43ae-bdfe-58153765c96e" alt="" width="563"><figcaption><p><em>"Additional Shopware Images"</em> Menü, nur Ansicht</p></figcaption></figure></div>

Um die Bearbeitung zu aktivieren, klicken Sie auf *„+ Neu“* oder *„Liste bearbeiten“**.*** Klicken Sie anschließend rechts auf *„Shopware Product Images“* und wählen Sie *„Import“*, um ein weiteres Bild zum bestehenden Titelbild hochzuladen.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FItiD5ytB4ze8nER4FGMA%2FBildschirmfoto%202026-04-09%20um%2009.33.45.png?alt=media&#x26;token=e3998d3f-a7a7-4f68-874f-799e00410042" alt="" width="563"><figcaption><p><em>"Additional Shopware Images"</em> Menü, in Bearbeitung</p></figcaption></figure></div>
{% endstep %}

{% step %}

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FIEf2ub7hnU3NOMxWJPhk%2FBildschirmfoto%202026-04-09%20um%2009.33.53.png?alt=media&#x26;token=155a7a78-3899-45fc-b041-88ee3e60898c" alt="" width="219"><figcaption><p>Geöffnetes Fenster für den Bilderupload</p></figcaption></figure></div>
{% endstep %}

{% step %}
Wiederholen Sie die Schritte 3 und 4, um weitere Bilder hochzuladen (ein Bild pro Zeile). Im Beispiel wurden neben dem Titelbild drei zusätzliche Bilder hochgeladen. Individuelle Bezeichnungen können in der Spalte *„Image SEO Description“* vergeben werden.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FdgOkugoDyAvxotNUVyAl%2FBildschirmfoto%202026-04-09%20um%2009.35.14.png?alt=media&#x26;token=c06c6419-473c-48c8-9671-2dd7120cbc59" alt="" width="513"><figcaption><p>Upload von drei Bildern und angepasster Beschreibung</p></figcaption></figure></div>
{% endstep %}

{% step %}
👉 Nach dem Verlassen des Menüs wird in der Artikelkarte die Anzahl der zusätzlichen Bilder als Zahl angezeigt.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FHVI8pBVvaTKhQ3NPaiNr%2FBildschirmfoto%202026-04-09%20um%2009.35.35.png?alt=media&#x26;token=42b64f0d-c9f5-4100-a8a4-2d25dbf2d89d" alt="" width="120"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Auch hier gilt: Die Bilder können jederzeit in BC angepasst werden. Nach der Synchronisation werden die Änderungen automatisch in Shopware übernommen.
{% endhint %}

{% hint style="warning" %}
Manuell in Shopware hinzugefügte Bilder werden bei der Synchronisation nicht automatisch gelöscht.
{% endhint %}

**2. Unterstützte Bildformate**

<table data-view="cards"><thead><tr><th align="center"></th><th align="center"></th><th align="center"></th></tr></thead><tbody><tr><td align="center">✅ Ja</td><td align="center"><p><i class="fa-file-jpg">:file-jpg:</i> <i class="fa-file-png">:file-png:</i> <i class="fa-newspaper">:newspaper:</i></p><p><strong>JPEG, PNG, WebP</strong></p></td><td align="center">5 MB</td></tr><tr><td align="center">⚠️ Eingeschränkt</td><td align="center"><p><i class="fa-gif">:gif:</i></p><p><strong>GIF</strong></p></td><td align="center">2 MB</td></tr><tr><td align="center"></td><td align="center">Empfohlene Auflösung: mindestens <strong>800x800 Pixel</strong> für eine gute Darstellung in Shopware.</td><td align="center"></td></tr></tbody></table>

**2. Bildsynchronisation**

**2.1 Konfiguration**

{% stepper %}
{% step %}
Öffnen Sie die *"Shopware"* <i class="fa-right">:right:</i> "*Einstellungen"*.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FT8ErsghIhhJiFeo53xED%2FBildschirmfoto%202026-04-09%20um%2010.15.47.png?alt=media&#x26;token=ec7e2431-8b62-42a4-b48a-be5d366cf22d" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Dort in den *"Lager-Einstellungen"* muss die ***„Bilder Ordner-ID“*** ***/ "Picture Folder ID"*** entsprechend konfiguriert sein. Geben Sie unter *"Bilder Ordner-ID" / "Picture Folder ID"* die ID des Shopware-Medienordners ein

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FZu8g5diR5Kq5IIDrBMU8%2FBildschirmfoto%202026-04-09%20um%2010.20.41.png?alt=media&#x26;token=2aafc402-7461-4861-883c-e6489f8a197e" alt=""><figcaption><p>Lagereinstellungen: <em>"Bilder Ordner-ID" / "Picture Folder ID"</em></p></figcaption></figure></div>
{% endstep %}
{% endstepper %}

**2.2 Einzelnes Bild hochladen**

{% stepper %}
{% step %}
Öffnen Sie die Artikelkarte.
{% endstep %}

{% step %}
Klicken Sie auf *"Aktionen"* <i class="fa-right">:right:</i> *"Shopware"* <i class="fa-right">:right:</i> *"*<i class="fa-up">:up:</i> *Produkt hochladen"*

Das Hauptbild und alle zusätzlichen Bilder werden hochgeladen.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FFhAGc4cpwaaEouZ7VaEJ%2FBildschirmfoto%202026-04-09%20um%2010.38.29.png?alt=media&#x26;token=3fc6aec5-f2b8-434b-8f29-2a27829d1de0" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

**2.3 Mehrere Artikel-Bilder hochladen**

{% stepper %}
{% step %}
Öffnen Sie die Artikelliste (*"Verkauf"* <i class="fa-right">:right:</i> *"Artikel")*
{% endstep %}

{% step %}
Wählen Sie die gewünschten Artikel aus. Klicken Sie auf *"Aktionen"* <i class="fa-right">:right:</i> *"Shopware"* <i class="fa-right">:right:</i> *"Import Default Images".* Die Artikelbilder der ausgewählten Bilder werden hochgeladen.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Fz9UYsiZfwwgX0V5xh4Yj%2FBildschirmfoto%202026-04-09%20um%2010.41.52.png?alt=media&#x26;token=f5814e4d-3a86-453a-aaa8-ce7dbc6f48ff" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

**3. Shopware-Medienordner**

{% columns %}
{% column %}
**Ordnerstruktur**

Bilder werden im konfigurierten Medienordner gespeichert:

```
Medien/
├── Product Media/
│   ├── artikelbild-001.jpg
│   ├── artikelbild-002.jpg
│   └── ...
```

{% endcolumn %}

{% column %}
**Ordner-ID finden**

1. Öffnen Sie das **Shopware-Backend**
2. Navigieren Sie zu **Inhalte** → **Medien**
3. Klicken Sie auf den gewünschten Ordner.
4. Die ID finden Sie in der URL.
   {% endcolumn %}
   {% endcolumns %}

**4. Tipps für den täglichen Umgang**

{% tabs %}
{% tab title="Bildqualität" %}

* Verwenden Sie hochauflösende Bilder (min. 800x800 px).
* Achten Sie auf einheitliche Bildgrößen.
* Optimieren Sie Bilder für das Web (Komprimierung).
  {% endtab %}

{% tab title="Dateibenennung" %}

* Verwenden Sie aussagekräftige Dateinamen.
* Vermeiden Sie Sonderzeichen und Umlaute.
* Beispiel: `artikelnr-001-frontal.jpg`
  {% endtab %}

{% tab title="Performance" %}

* Laden Sie Bilder außerhalb der Stoßzeiten hoch.
* Komprimieren Sie große Bilder vor dem Upload.
* Überwachen Sie das Aktivitätsprotokoll.
  {% endtab %}
  {% endtabs %}

### Häufige Fragen

#### Wie gelangen die Bilder aus Business Central nach Shopware?

`ImportBaseImages` übernimmt die BC-Standardbilder als „SOUSHW Item Picture“. Anschließend laden `Upload_ItemImages` bzw. `Upload_Media` die Dateien über die Endpunkte `media` und `product-media` nach Shopware und ordnen sie dem Produkt zu; `SetCoverImage` legt das Titelbild fest.

#### Verhindert der Connector, dass dasselbe Bild mehrfach hochgeladen wird?

Ja. Vor dem Upload prüft `isFileNameAlreadyUploaded` über `search/media` anhand des Dateinamens, ob das Bild in Shopware bereits vorhanden ist. Dadurch werden identische Medien nicht doppelt angelegt.


# Gruppenartikel & Produktpakete

{% hint style="info" %}
**Premium-Modul.** Gruppenartikel erfordern das entsprechende Shopware-Plugin von solutioo und den aktivierten Schalter **Gruppenartikel aktivieren** in der Konfiguration.
{% endhint %}

Mit **Gruppenartikeln** bündeln Sie mehrere Artikel zu einem Paket – ideal für Sets, Zubehörpakete oder Bundles.

**Funktionsweise**

* Ein Gruppenartikel besteht aus einem **Hauptprodukt** und mehreren **zugeordneten Artikeln**.
* Über den Schalter **Hauptprodukt mit in Warenkorb** (`includeMainProduct`) legen Sie fest, ob das Hauptprodukt gemeinsam mit den zugehörigen Artikeln in den Warenkorb übernommen wird.
* Die Einstellung wird beim Erstellen, Aktualisieren und Herunterladen der Gruppenartikel synchronisiert.

**Einrichtung**

{% stepper %}
{% step %}
**Modul aktivieren**

Aktivieren Sie in der Konfiguration **Gruppenartikel aktivieren**.
{% endstep %}

{% step %}
**Gruppenartikel anlegen**

Definieren Sie das Hauptprodukt und ordnen Sie die zugehörigen Artikel zu.
{% endstep %}

{% step %}
**Warenkorb-Verhalten wählen**

Entscheiden Sie über **Hauptprodukt mit in Warenkorb**, ob das Hauptprodukt mitgeliefert wird.
{% endstep %}

{% step %}
**Hochladen**

Übertragen Sie den Gruppenartikel nach Shopware.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Zum Ausprobieren können Sie über die Konfiguration einen **Demo-Gruppenartikel** erzeugen (Aktion „Gruppenartikel erstellen“ – nur sichtbar bei aktiviertem Modul).
{% endhint %}


# Hersteller

Der Connector überträgt **Hersteller** (Manufacturer) automatisch nach Shopware, sobald ein Artikel mit einem Hersteller hochgeladen wird.

**Funktionsweise**

* Jeder BC-Hersteller erhält nach dem ersten Upload eine **Web-ID** (Shopware-Manufacturer-ID).
* Beim Produkt-Upload wird der Hersteller des Artikels automatisch als `manufacturerId` gesetzt.
* Der Sync-Status wird je Hersteller mitgeführt.

**Zurücksetzen**

Mit der Aktion **Hersteller-IDs zurücksetzen** in der Konfiguration löschen Sie die Shopware-Verknüpfungen – beim nächsten Upload werden die Hersteller neu angelegt.

{% hint style="info" %}
Sie müssen Hersteller nicht manuell hochladen – das geschieht automatisch im Rahmen des Artikel-Uploads.
{% endhint %}

### Häufige Fragen

#### Muss ich Hersteller vor dem Artikel-Upload manuell in Shopware anlegen?

Nein. Der Shopware 6 API Connector legt den Hersteller (Manufacturer) automatisch in Shopware an, sobald ein Artikel mit diesem Hersteller hochgeladen wird, und speichert die Web-ID am Business-Central-Hersteller. Eine manuelle Vorab-Anlage ist nicht nötig.

#### Was passiert, wenn ich einen Herstellernamen in Business Central ändere?

Der Hersteller bleibt über seine Web-ID mit dem Shopware-Manufacturer verknüpft. Eine Namensänderung wird beim nächsten Upload aktualisiert. Möchten Sie die Verknüpfung komplett neu aufbauen, nutzen Sie die Aktion „Hersteller-IDs zurücksetzen“.


# Einheiten & Maße

Maßeinheiten und physische Eigenschaften eines Artikels werden beim Upload automatisch nach Shopware übertragen.

**Was wird übertragen?**

| BC                             | Shopware                            |
| ------------------------------ | ----------------------------------- |
| Basiseinheit                   | Einheit (`unitId`), Referenzeinheit |
| Nettogewicht × Verkaufseinheit | `weight` (kg oder g)                |
| Abmessungen der Einheit        | `height`, `width`, `length`         |
| Verkaufseinheit                | `purchaseUnit`, `packUnit`          |

**Gewichtseinheit**

Die Konfigurationseinstellung **Weight in Kg** bestimmt, ob das Gewicht in **Kilogramm** (aktiv) oder **Gramm** (inaktiv) übertragen wird.

**Einheiten definieren**

Weitere Einheiten eines Artikels pflegen Sie über *Zugehörig → Artikel → Einheiten*. Dort legen Sie z. B. Gewicht oder Stückzahl je Verkaufseinheit fest (etwa bei 3er-Sets).

{% hint style="info" %}
Einheiten erhalten wie andere Stammdaten eine **Web-ID** und werden bei Bedarf automatisch angelegt. Mit **Einheiten-IDs zurücksetzen** lässt sich die Verknüpfung neu aufbauen.
{% endhint %}

### Häufige Fragen

#### Wird das Produktgewicht in Kilogramm oder Gramm übertragen?

Das hängt von der Einstellung „Weight in Kg“ ab: Ist sie aktiv, überträgt der Connector das Gewicht in Kilogramm, andernfalls in Gramm. Das übertragene Gewicht ergibt sich aus Nettogewicht × Verkaufseinheit.

#### Wie hinterlege ich Grundpreisangaben (z. B. Preis pro Liter)?

Grundpreisangaben basieren auf der Referenzeinheit und den Maßeinheiten des Artikels. Pflegen Sie die Basiseinheit und die zugehörigen Werte in Business Central – der Connector überträgt Einheit und Referenzeinheit nach Shopware, sodass der Grundpreis korrekt berechnet wird.


# Tags

**Tags** (Schlagworte) helfen dabei, Produkte in Shopware zu gruppieren, zu filtern und im Merchandising einzusetzen.

**Einrichtung**

1. Aktivieren Sie in der Konfiguration **Tag-Upload**.
2. Hinterlegen Sie am Artikel die gewünschten **Shopware Tags** (mehrere möglich).
3. Beim Produkt-Upload werden die Tags in Shopware angelegt (falls noch nicht vorhanden) und dem Produkt zugewiesen.

{% hint style="info" %}
Tags werden nur berücksichtigt, wenn **Tag-Upload** in der Konfiguration aktiviert ist.
{% endhint %}

**Tipp**

Nutzen Sie Tags konsistent (z. B. „Neu", „Sale", „Bestseller"), um im Shop Automatismen wie dynamische Produktgruppen zu befüllen.

### Häufige Fragen

#### Warum werden meine Tags nicht nach Shopware übertragen?

Tags werden nur übertragen, wenn in der Konfiguration die Option „Tag-Upload“ aktiviert ist und am Artikel unter „Shopware Tags“ mindestens ein Tag hinterlegt wurde. Prüfen Sie beide Punkte, falls die Tags im Shop fehlen.

#### Legt der Connector fehlende Tags in Shopware automatisch an?

Ja. Beim Produkt-Upload werden noch nicht vorhandene Tags automatisch in Shopware angelegt und dem Produkt zugewiesen. Bereits existierende Tags werden wiederverwendet, sodass keine Duplikate entstehen.


# Vertriebskanäle am Artikel

Jeder Artikel kann **einem oder mehreren Verkaufskanälen** zugewiesen werden – unabhängig davon, ob es sich um einen einfachen Artikel oder einen übergeordneten Variantenartikel handelt.

**Bedienung**

Auf der Artikelkarte finden Sie den Bereich **Verkaufskanal** mit einer Unterliste:

| Feld                                 | Bedeutung                                 |
| ------------------------------------ | ----------------------------------------- |
| **Sales Channel ID / Name**          | Zugewiesener Shopware-Kanal               |
| **UnAssign**                         | Markierung, um die Zuweisung zu entfernen |
| **Type**                             | Artikel oder übergeordneter Artikel       |
| **isSync / Sync At / Status Reason** | Synchronisationsstatus                    |

**Kanal zuweisen oder entfernen**

{% stepper %}
{% step %}
**Kanal auswählen**

Öffnen Sie die Kanalauswahl (AssistEdit) und wählen Sie einen Kanal aus der Zuordnung.
{% endstep %}

{% step %}
**Hochladen**

Beim nächsten Produkt-Upload wird die Sichtbarkeit im gewählten Kanal gesetzt.
{% endstep %}

{% step %}
**Entfernen**

Um einen Kanal zu entfernen, setzen Sie **UnAssign** und laden erneut hoch. Bereits hochgeladene Zuweisungen sollten nicht direkt gelöscht, sondern über *UnAssign* entfernt werden.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Fehlende Standardkanäle (in der Zuordnung mit *is Selected* markiert) werden dem Artikel automatisch hinzugefügt – unter anderem beim Öffnen der Artikelkarte und nach dem Upload.
{% endhint %}

Grundlagen zur Kanal-Einrichtung finden Sie unter Verkaufskanäle einrichten.


# Mehrsprachige Artikeldaten

Der Connector unterstützt **mehrsprachige Produktdaten**. Name und Beschreibung können pro Sprache nach Shopware übertragen werden.

**Grundlage**

* Die **Sprachzuordnung** (Modul *Language*) verbindet BC-Sprachen mit Shopware-Sprachen.
* Als Übersetzungsquelle dienen die **Artikelübersetzungen** in BC sowie der sprachabhängige **Marketingtext**.

**Was wird sprachabhängig übertragen?**

| BC-Quelle                         | Shopware-Feld   |
| --------------------------------- | --------------- |
| Artikelübersetzung (Beschreibung) | `name`          |
| Marketingtext (Entity Text)       | `description`   |
| Artikelnummer                     | `productNumber` |

Die Übertragung erfolgt als sprachspezifische Aktualisierung (PATCH) mit dem passenden Sprach-Header.

{% hint style="info" %}
**Web Name** und **Beschreibung** werden getrennt verwaltet. Mehrsprachige Produktnamen und HTML-Beschreibungen stehen auf der Artikelkarte in separaten Bereichen zur Verfügung.
{% endhint %}

**Vorgehen**

1. Sprachen mit Erstdaten laden importieren und im Modul *Language* zuordnen.
2. Artikelübersetzungen in BC pflegen.
3. Sprachabhängigen Marketingtext hinterlegen (siehe Marketingtext & Rich-Content).
4. Artikel hochladen – die Sprachvarianten werden mitübertragen.

### Häufige Fragen

#### Welche Voraussetzung gibt es für die mehrsprachige Übertragung?

Die BC-Sprachen müssen im Modul „Language“ den Shopware-Sprachen zugeordnet sein. Laden Sie dazu zunächst die Erstdaten und pflegen Sie anschließend die Zuordnung. Ohne Sprachzuordnung werden keine Übersetzungen übertragen.

#### Woher stammen Name und Beschreibung je Sprache?

Der sprachabhängige Produktname stammt aus den Artikelübersetzungen in Business Central, die Langbeschreibung aus dem sprachabhängigen Marketingtext. Beide werden beim Upload als Sprachvariante (PATCH mit Sprach-Header) an Shopware übergeben.


# Artikel-Matching & Datenübernahme aus Shopware

Wenn Sie den Shopware 6 API Connector in einem **bereits befüllten Shop** in Betrieb nehmen, sind dort in der Regel schon Produkte, Bilder, Eigenschaften und Kategorien vorhanden. Diese müssen **nicht neu angelegt** werden. Stattdessen ordnet der Connector die vorhandenen Shopware-Objekte den passenden Artikeln in Business Central zu („Matching") und übernimmt bei Bedarf zusätzliche Daten. Das ist der wichtigste Schritt, um Duplikate zu vermeiden und beide Systeme sauber zu verheiraten.

Diese Seite beschreibt den vollständigen Ablauf ausführlich: vom grundlegenden Prinzip über die einzelnen Übernahme-Bausteine (Bilder, Attribute, Varianten, Kategorien) bis hin zur Fehlerbehebung.

**Warum Matching so wichtig ist**

Jedes Objekt in Shopware besitzt eine eindeutige technische Kennung – die **ID**. In Business Central wird diese Kennung als **Web-ID** am jeweiligen Datensatz gespeichert (z. B. `SOUSHW Web ID` am Artikel). Solange keine Web-ID gesetzt ist, betrachtet der Connector das Objekt als „noch nicht verknüpft" und würde es beim nächsten Upload **neu anlegen**. Genau das führt zu Dubletten. Das Matching sorgt dafür, dass die richtige Web-ID gesetzt wird, **bevor** der erste Upload läuft.

```mermaid
flowchart LR
    S[(Shopware-Shop mit Bestandsdaten)] -->|Matching| BC[(Business Central Artikelstamm)]
    BC -->|Web-IDs gesetzt| U[Sichere Aktualisierung per PATCH]
```

{% hint style="warning" %}
**Reihenfolge beachten:** Führen Sie das Matching immer **vor** dem ersten großen Upload durch. Wird zuerst hochgeladen, können bereits Duplikate entstanden sein, die anschließend aufwändiger zu bereinigen sind (siehe Abschnitt „Doppelte Web-IDs bereinigen").
{% endhint %}

**Schritt 1 – Produkte per SKU zuordnen**

Grundlage ist der Abgleich über die **Artikelnummer**. Der Connector sucht in Shopware nach einem Produkt, dessen **`productNumber` (SKU)** exakt der Artikelnummer in Business Central entspricht, und übernimmt dessen Shopware-ID als Web-ID.

{% stepper %}
{% step %}
**Nummern prüfen**

Stellen Sie sicher, dass die **Artikelnummer in BC** und die **SKU/productNumber in Shopware** übereinstimmen. Nur dann kann der automatische Abgleich greifen.
{% endstep %}

{% step %}
**Abgleich starten**

Starten Sie den Artikelabgleich. Der Connector ruft die Shopware-Suche (`search/product`) mit dem Filter `productNumber = Artikelnummer` auf.
{% endstep %}

{% step %}
**Web-ID wird gesetzt**

Wird genau ein Treffer gefunden, wird die **Shopware-Produkt-ID als Web-ID** gespeichert. Der Artikel gilt danach als verknüpft; künftige Änderungen gehen als **PATCH**.
{% endstep %}
{% endstepper %}

Den technischen Ablauf mit Flussdiagramm beschreibt die Seite Produkt-Matching per SKU & Web-ID.

**Schritt 2 – Varianten und übergeordnete Artikel**

Besitzt ein Produkt in Shopware **Varianten** (z. B. Farbe/Größe), kann der Connector den **übergeordneten Artikel** (Parent) automatisch anlegen und die zugehörigen **Kind-Artikel** verknüpfen. Die Variantenachsen werden dabei als **Option 1, Option 2 und Option 3** abgebildet. Welche Property Group die Farb- bzw. Größenachse darstellt, steuern Sie über die Konfiguration (Label und ID der Farb-/Größen-Eigenschaft). Details unter Varianten abgleichen (Farbe & Größe).

**Schritt 3 – Attribute & Eigenschaften abgleichen**

Damit Filter und Eigenschaften im Shop weiter funktionieren, sollten die **Attribute (Property Groups)** und deren **Optionen** verknüpft werden, statt sie doppelt anzulegen. Die Aktion **Attribute abgleichen** vergleicht vorhandene Shopware-Attribute anhand ihres **Namens** mit den BC-Artikelattributen. Bei einer Übereinstimmung werden **Web-ID**, **Web-Attribut** und **Synchronisiert** gesetzt – es werden **keine neuen Attribute** angelegt. Die zugehörigen Optionswerte werden anhand ihres **Werts** abgeglichen.

Eine ausführliche Anleitung inklusive Namens- und Wert-Matching, Mapping-Feldern und Stolperfallen finden Sie unter Attribute & Eigenschaften (Property Groups) abgleichen.

**Schritt 4 – Was kann sonst noch übernommen werden?**

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Bilder &#x26; Medien</strong></td><td>Coverbild und weitere Artikelbilder werden zugeordnet; das Coverbild wird als Standardbild in BC gesetzt. Bilder-Download</td></tr><tr><td><strong>Attribute &#x26; Optionen</strong></td><td>Property Groups und ihre Optionen werden per Namens-/Wert-Abgleich verknüpft. Attribute abgleichen</td></tr><tr><td><strong>Kategorien &#x26; Kanäle</strong></td><td>Vorhandene Kategorien und Verkaufskanäle werden zugeordnet, damit die Sichtbarkeit erhalten bleibt. Kategorien</td></tr></tbody></table>

**Hilfsfunktionen**

* **Excel-Import:** Unterstützt die Datenübernahme, indem größere Zuordnungslisten strukturiert eingelesen werden.
* **Doppelte Web-IDs bereinigen („Fix Duplicated Web IDs"):** Sind versehentlich mehrere BC-Artikel mit derselben Shopware-ID verknüpft, bereinigt diese Funktion die Dubletten.

**Doppelte Web-IDs bereinigen**

Duplikate entstehen typischerweise, wenn vor dem Matching bereits hochgeladen wurde oder wenn Artikelnummern nicht eindeutig waren. Gehen Sie so vor:

{% stepper %}
{% step %}
**Ursache eingrenzen**

Prüfen Sie im Aktivitätsprotokoll, welche Artikel als Neuanlage statt als Update übertragen wurden.
{% endstep %}

{% step %}
**Bereinigung ausführen**

Nutzen Sie **Fix Duplicated Web IDs**, um doppelte Verknüpfungen aufzulösen.
{% endstep %}

{% step %}
**Nummern korrigieren**

Sorgen Sie für eindeutige, konsistente Artikelnummern und wiederholen Sie den Abgleich für die betroffenen Artikel.
{% endstep %}
{% endstepper %}

**Empfohlenes Vorgehen (Best Practice)**

1. **Erstdaten laden** (Zahlungs-/Versandarten, Steuern, Kanäle, Kundengruppen usw.) – siehe Shopware Erstdaten laden.
2. **Kategorien und Tags** aus Shopware herunterladen, damit die Zuordnung steht.
3. **Attribute abgleichen**, damit Eigenschaften/Filter verknüpft sind – siehe Attribute & Eigenschaften abgleichen.
4. **Produkte per SKU matchen** und Varianten verknüpfen.
5. **Testlauf mit wenigen Artikeln**, Ergebnis prüfen, dann in Wellen ausrollen.

{% hint style="warning" %}
Führen Sie den Abgleich zunächst mit **wenigen Artikeln** durch und prüfen Sie das Ergebnis, bevor Sie große Mengen übernehmen.
{% endhint %}

**Fehlerbehebung**

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Produkt wird doppelt angelegt</strong></td><td>SKU/productNumber stimmen nicht überein – Nummern angleichen und vorhandenes Produkt matchen.</td></tr><tr><td><strong>Attribut nicht verknüpft</strong></td><td>Name weicht ab (Groß-/Kleinschreibung, Leerzeichen). Namen angleichen und erneut abgleichen.</td></tr><tr><td><strong>Variante fehlt</strong></td><td>Farb-/Größen-Eigenschaft nicht korrekt konfiguriert – Label/ID prüfen.</td></tr><tr><td><strong>Bild nicht übernommen</strong></td><td>Medien-Infos abrufen bzw. Standardbild neu setzen.</td></tr></tbody></table>

### Häufige Fragen

#### Wie unterscheidet der Connector zwischen Aktualisieren und Neuanlegen eines Produkts?

Die Entscheidung fällt über die „SOUSHW Web ID“: Ist sie gefüllt, wird das bestehende Shopware-Produkt per PATCH aktualisiert. Ist sie leer, legt der Connector das Produkt neu an (POST) – nach einer vorherigen Duplikatsuche per `search/product` auf die Artikelnummer.

#### Werden nicht mehr zugewiesene Kategorien, Tags oder Attribute in Shopware entfernt?

Ja. Bei einer Aktualisierung ruft der Connector `Product_UnAssign_Categories`, `Product_UnAssign_Tags` und `Product_UnAssign_Properties` auf und entfernt Zuordnungen, die in Business Central nicht mehr gesetzt sind. So entspricht die Zuordnung in Shopware exakt dem aktuellen BC-Stand.


# Marketingtext & Rich-Content

Die **Produktbeschreibung** in Shopware wird aus dem **Marketingtext** des Artikels gespeist. Dieser wird als **HTML** übergeben – Formatierungen wie **fett** oder *kursiv* sind also möglich.

**Web Name vs. Beschreibung**

* **Web Name** = Artikelbeschreibung (`Description`) bzw. deren Übersetzung → Shopware `name`.
* **Beschreibung** = Marketingtext (Entity Text) → Shopware `description` (HTML).

Beide werden getrennt verwaltet, sodass Sie Namen und Langbeschreibung unabhängig pflegen können.

**Marketingtext bearbeiten**

Auf der Artikelkarte finden Sie den **Marketingtext** (in der Standardansicht rechts). Über **Bearbeiten** öffnen Sie den Editor.

**Massenpflege per Import**

Für viele Artikel bieten sich Importe an:

* **CSV-Import Marketingtext**
* **Excel-Import Marketingtext**

Diese Funktionen finden Sie in der Artikelliste.

{% hint style="info" %}
Sprachabhängige Marketingtexte werden beim Upload als Sprachvariante übertragen (siehe Mehrsprachige Artikeldaten).
{% endhint %}

{% hint style="success" %}
Für erweiterte, attributbasierte Textbausteine unterstützt Sie unser Team gern mit einer individuellen Lösung.
{% endhint %}

### Häufige Fragen

#### Kann die Produktbeschreibung HTML-Formatierungen enthalten?

Ja. Der Marketingtext wird als HTML an das Shopware-Feld „description“ übergeben. Formatierungen wie Fett, Kursiv, Listen und Überschriften bleiben erhalten. Achten Sie auf sauberes, sinnvoll strukturiertes HTML – das hilft Leser:innen und Suchmaschinen.

#### Wie pflege ich Marketingtexte für viele Artikel effizient?

Für die Massenpflege stehen der CSV-Import und der Excel-Import für Marketingtexte in der Artikelliste zur Verfügung. Damit lassen sich Beschreibungen für viele Artikel gleichzeitig einspielen, statt sie einzeln zu bearbeiten.


# SEO-Metadaten

Für eine gute Auffindbarkeit im Shop und in Suchmaschinen können **SEO-Metadaten** gepflegt und nach Shopware übertragen werden.

**Verfügbare Felder**

| Feld                  | Shopware          |
| --------------------- | ----------------- |
| **Meta-Titel**        | `metaTitle`       |
| **Meta-Beschreibung** | `metaDescription` |
| **Keywords**          | `keywords`        |

Diese Metadaten können **sprachabhängig** gepflegt werden – also je Sprache ein eigener Titel, eine eigene Beschreibung und eigene Keywords.

**Wo werden SEO-Daten gepflegt?**

* **Übergeordnete (konfigurierbare) Artikel** verfügen über dedizierte Meta-Felder.
* **Kategorien** können ebenfalls Meta-Titel, -Beschreibung und Keywords erhalten.
* **Bilder** transportieren über ihre Beschreibung einen Alt-Text (wichtig für Bild-SEO).

{% hint style="success" %}
**SEO-Tipp:** Formulieren Sie pro Sprache einen prägnanten Meta-Titel (ca. 55–60 Zeichen) und eine aussagekräftige Meta-Beschreibung (ca. 150–160 Zeichen) mit dem wichtigsten Keyword am Anfang.
{% endhint %}

**Bezug zur Produktbeschreibung**

Die eigentliche Produktbeschreibung stammt aus dem Marketingtext. Achten Sie auf sinnvolle Überschriften und Struktur – das hilft sowohl Leser:innen als auch Suchmaschinen.

### Häufige Fragen

#### Kann ich Meta-Titel und Meta-Beschreibung je Sprache unterschiedlich pflegen?

Ja. Meta-Titel, Meta-Beschreibung und Keywords lassen sich sprachabhängig pflegen und werden je Sprachvariante des Verkaufskanals nach Shopware übertragen. So erhält jede Sprache ihre eigenen, optimierten SEO-Felder.

#### Wie lang sollten Meta-Titel und Meta-Beschreibung sein?

Als Richtwert gilt: Meta-Titel ca. 55–60 Zeichen, Meta-Beschreibung ca. 150–160 Zeichen. Platzieren Sie das wichtigste Keyword möglichst weit vorne. Für Bilder ist zusätzlich ein aussagekräftiger Alt-Text (Bildbeschreibung) wichtig.

#### Werden auch Kategorien mit SEO-Metadaten versehen?

Ja. Neben Produkten können auch Kategorien Meta-Titel, Meta-Beschreibung und Keywords erhalten. Das verbessert die Auffindbarkeit der Kategorieseiten im Shop und in Suchmaschinen.


# KI-Unterstützung (Copilot)

Der Connector kann optional **KI-gestützt** bei der Erstellung von Produkttexten unterstützen (z. B. Entwürfe für den Marketingtext).

**Einrichtung**

In der Konfiguration im Bereich **KI / Copilot** hinterlegen Sie:

| Feld              | Bedeutung                                   |
| ----------------- | ------------------------------------------- |
| **API Schlüssel** | Zugangsschlüssel des KI-Dienstes (maskiert) |
| **API URL**       | Endpunkt des KI-Dienstes                    |
| **Modell**        | Zu verwendendes Sprachmodell                |

**Nutzung**

Beim Bearbeiten eines Textes können Sie einen KI-Entwurf erstellen lassen und diesen anschließend anpassen.

{% hint style="warning" %}
Prüfen Sie KI-generierte Texte stets redaktionell, bevor Sie sie veröffentlichen. Die KI liefert Entwürfe – die inhaltliche Verantwortung bleibt bei Ihnen.
{% endhint %}

{% hint style="info" %}
Die KI-Funktion ist optional. Ohne hinterlegten API-Schlüssel bleibt sie inaktiv.
{% endhint %}


# Produkt-Datenblatt als PDF

{% hint style="info" %}
Diese Funktion wird als Erweiterung bereitgestellt. Sprechen Sie uns an, ob sie für Ihre Installation verfügbar ist.
{% endhint %}

Direkt aus der Artikelkarte lässt sich ein **Produkt-Datenblatt** im DIN-A4-Querformat als PDF erstellen – ideal für Vertrieb, Katalog und Kundenanfragen.

**Inhalte des Datenblatts**

* **Coverbild** und **Bildergalerie** aus den in Shopware hinterlegten Artikelbildern.
* **Marketingtext** des Artikels.
* Optionale Herkunftsangabe **„Made in …“** inklusive Länderflagge (DE, ENG und FRA integriert; weitere Länder konfigurierbar).
* **Frei konfigurierbare Attribut-Datenblöcke** für eine flexible Darstellung der Produktinformationen.
* **Feste Angaben** wie Artikelnummer, EAN/GTIN, Verpackungseinheit und empfohlener Verkaufspreis.

**Konfiguration**

Über eine eigene Einrichtungsseite lassen sich die verwendeten Attribute, die Abschnittsüberschriften, das Logo und die Fußzeile individuell konfigurieren.

{% hint style="success" %}
Beim Download wird der **Artikelname automatisch als Dateiname** der PDF-Datei verwendet.
{% endhint %}


# Kundendaten-Synchronisation

Erfahren Sie, wie Kundendaten zwischen Shopware und BC synchronisiert werden.

Die Kundendaten-Synchronisation stellt sicher, dass Ihre Kundenstammdaten in beiden Systemen konsistent sind.

#### 1. Synchronisationsrichtung

{% columns %}
{% column %}
**Shopware → BC**

Kundendaten werden primär von Shopware nach Business Central synchronisiert:

**Bestellimport**

* Bei jeder Bestellung werden Kundendaten aktualisiert.

**Manueller Download**

* Kundendaten können manuell abgerufen werden.
  {% endcolumn %}

{% column %}
**BC → Shopware**

Aktuell werden Kundendaten **nicht** automatisch von BC nach Shopware übertragen. Änderungen müssen manuell erfolgen.
{% endcolumn %}
{% endcolumns %}

#### 2. Synchronisierte Felder

{% tabs %}
{% tab title="Stammdaten" %}

<table data-search="false"><thead><tr><th width="118.6300048828125">BC-Feld</th><th width="293.3887939453125">Shopware-Feld</th></tr></thead><tbody><tr><td>Nr.</td><td>Kundennummer (customerNumber)</td></tr><tr><td>Name</td><td>Vorname + Nachname</td></tr><tr><td>Adresse</td><td>Straße</td></tr><tr><td>PLZ</td><td>Postleitzahl</td></tr><tr><td>Ort</td><td>Stadt</td></tr><tr><td>Ländercode</td><td>Land</td></tr><tr><td>E-Mail</td><td>E-Mail-Adresse</td></tr><tr><td>Telefonnr.</td><td>Telefon</td></tr></tbody></table>
{% endtab %}

{% tab title="Rechnungsadresse" %}
Die Rechnungsadresse wird als Hauptadresse in BC übernommen.
{% endtab %}

{% tab title="Lieferadressen" %}
Abweichende Lieferadressen werden als separate **Lief. an Adressen** angelegt:

1. Die Lieferadresse aus der Bestellung wird geprüft.
2. Falls unterschiedlich zur Rechnungsadresse, wird eine neue Lieferadresse erstellt.
3. Diese wird dem Debitor zugeordnet.
   {% endtab %}
   {% endtabs %}

#### 3. Kunden-Mapping / Kunden-Zuordnung

**3.1 Mapping-Typen / Zuordnungs-Typen**

In den Kunden-Einstellungen können Sie den Mapping-Typ festlegen:

<table><thead><tr><th width="164.3604736328125">Typ</th><th width="273.883056640625">Beschreibung</th><th width="199.0538330078125">Empfehlung</th></tr></thead><tbody><tr><td><strong>Kundennummer</strong></td><td>Zuordnung über Kundennummer</td><td>Standard für B2B</td></tr><tr><td><strong>E-Mail</strong></td><td>Zuordnung über E-Mail-Adresse</td><td>Flexibel für B2C</td></tr><tr><td><strong>Shopware-ID</strong></td><td>Zuordnung über interne ID</td><td>Technisch zuverlässig</td></tr></tbody></table>

**3.2 Neukunden**

Wenn kein passender Kunde gefunden wird, sind die folgenden zwei Szenarien möglich:

<table data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><p><strong>Automatische Neuanlage</strong> (wenn aktiviert)</p><p><i class="fa-right-long">:right-long:</i> Neuer Debitor wird erstellt.</p></td></tr><tr><td><strong>Manuelle Zuordnung</strong>: Bestellung wird mit Fehler markiert, Kunde muss manuell zugeordnet werden.</td></tr></tbody></table>

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FcnqUgYxvfnWaDVc6KxeD%2FBildschirmfoto%202026-04-09%20um%2011.27.15.png?alt=media&#x26;token=9fffec16-5b50-4754-9e7e-32c773863f39" alt=""><figcaption></figcaption></figure></div>

#### 4. Debitorenvorlage

Bei der Neuanlage von Kunden wird die *Debitorenvorlage* verwendet. Suchen Sie in BC nach "Debitorenvorlage" und Sie gelangen in das entsprechenden Menü.

{% columns %}
{% column width="33.33333333333333%" %}
Die Vorlage definiert:

* Buchungsgruppen
* Zahlungsbedingungen
* Standard-Einstellungen
  {% endcolumn %}

{% column width="66.66666666666667%" %}
{% hint style="warning" %}
Felder, die mit einem roten Stern gekennzeichnet sind, müssen zwingend ausgefüllt werden. Es wird jedoch empfohlen, möglichst viele Informationen zu hinterlegen, um eine detaillierte und aussagekräftige Vorlage zu erstellen.
{% endhint %}
{% endcolumn %}
{% endcolumns %}

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Fu0ve4tmDRfVelhHqOXzf%2FBildschirmfoto%202026-04-16%20um%2010.04.14.png?alt=media&#x26;token=3002692e-4261-478e-a519-cd7119238622" alt=""><figcaption></figcaption></figure></div>

***

Die Debitorenvorlage wird in den Konfigurationen hinterlegt. Navigieren Sie dazu in die Shopware-Einstellungen und scrollen Sie zum Bereich „Kunden-Einstellungen“. Wählen Sie anschließend unter „Kundenvorlage“ die gewünschte Vorlage aus.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FHYVGhdzO1Zelu3lYTum3%2FBildschirmfoto%202026-04-16%20um%2009.36.40.png?alt=media&#x26;token=a4d1d5b3-c963-4d88-b71b-d1031292e8a1" alt=""><figcaption></figcaption></figure></div>

#### 5. Praxisbeispiel

{% columns %}
{% column width="50%" %}
**Bestellimport Neukunde**

{% stepper %}
{% step %}
Kunde bestellt erstmals in Shopware.
{% endstep %}

{% step %}
Bestellung wird in BC importiert.
{% endstep %}

{% step %}
System sucht nach bestehendem Debitor (E-Mail oder Kd.nummer)
{% endstep %}

{% step %}
Kein Debitor gefunden <i class="fa-right">:right:</i> neuer Debitor wird angelegt.
{% endstep %}

{% step %}
Bestellung wird dem neuen Debitor zugeordnet.
{% endstep %}
{% endstepper %}
{% endcolumn %}

{% column width="50%" %}
**Bestellimport Bestandskunde**

{% stepper %}
{% step %}
Bestandskunde bestellt in Shopware.
{% endstep %}

{% step %}
Bestellung wird in BC importiert.
{% endstep %}

{% step %}
System findet bestehenden Debitor.
{% endstep %}

{% step %}
Kundendaten werden aktualisiert (falls geändert).
{% endstep %}

{% step %}
Bestellung wird dem Debitor zugeordnet.
{% endstep %}
{% endstepper %}
{% endcolumn %}
{% endcolumns %}

{% hint style="success" %}
Achten Sie auf die Verwendung **einheitlicher Kundennummern**, halten Sie **E-Mail-Adressen aktuell** und **vermeiden** Sie die Anlage von **Duplikaten**.

Des Weiteren **prüfen** Sie regelmäßig die **Kundenzuordnungen**, **führen** Sie eine **Dublettenprüfung** **durch** und **bereinigen** Sie **inaktive Kunden**.
{% endhint %}

{% hint style="warning" %}
Ändern Sie die Kundennummer nicht nachträglich in einem der Systeme, da dies die Zuordnung unterbricht!
{% endhint %}


# Neuanlage und Aktualisierung von Kunden

Erfahren Sie, wie neue Kunden angelegt und bestehende aktualisiert werden.

#### 1. Automatische Kundenanlage

**1.1 Voraussetzungen:**

<table data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><em><strong>"Kunden automatisch anlegen</strong>"</em> muss in den Einstellungen aktiviert sein.</td></tr><tr><td>Eine <em><strong>"Debitorenvorlage"</strong></em> muss konfiguriert sein.</td></tr><tr><td>Eine <em><strong>"Kundennummern-Serie"</strong></em> muss festgelegt sein.</td></tr></tbody></table>

**1.2 Angelegte Daten**

Bei der Neuanlage werden folgende Daten übernommen:

<table><thead><tr><th width="166.5970458984375">Feld</th><th width="416.524169921875">Quelle</th></tr></thead><tbody><tr><td>Nr.</td><td>Aus Nummernserie oder Shopware-Kundennummer</td></tr><tr><td>Name</td><td>Vor- und Nachname aus Shopware</td></tr><tr><td>Adresse</td><td>Rechnungsadresse aus Shopware</td></tr><tr><td>E-Mail</td><td>E-Mail aus Shopware</td></tr><tr><td>Telefon</td><td>Telefonnummer aus Shopware</td></tr><tr><td>Buchungsgruppen</td><td>Aus Debitorenvorlage</td></tr></tbody></table>

#### 2. Manuelle Kundenanlage

**2.1 In Business Central**

{% stepper %}
{% step %}
Erstellen Sie einen neuen Debitor.

<a class="button primary">Debitorvorlage erstellen</a>
{% endstep %}

{% step %}
Tragen Sie die relevanten Daten ein

{% hint style="info" %}
Verwenden Sie die gleiche Kundennummer oder E-Mail wie in Shopware
{% endhint %}
{% endstep %}
{% endstepper %}

**2.2 Kundenzuordnung herstellen**

{% stepper %}
{% step %}
Öffnen Sie die Debitorenkarte.
{% endstep %}

{% step %}
Stellen Sie sicher, dass **E-Mail** oder **Nr.** mit Shopware übereinstimmen.
{% endstep %}

{% step %}
Bei der nächsten Bestellung wird der Kunde automatisch erkannt.
{% endstep %}
{% endstepper %}

#### 3. Kundendaten aktualisieren

{% columns %}
{% column width="50%" %}
**Automatische Aktualisierung**

Bei jedem Bestellimport werden Kundendaten aktualisiert:

* Adresse, Telefonnummern, Änderungen
  {% endcolumn %}

{% column width="50%" %}
**Manuelle Aktualisierung (BC)**

1. Öffnen Sie die [**Debitorenkarte**](#id-5.-debitorenvorlage)**.**
2. Bearbeiten Sie die gewünschten Felder.
3. Speichern
   {% endcolumn %}
   {% endcolumns %}

{% hint style="info" %}
Änderungen in BC werden **nicht** automatisch zu Shopware übertragen!
{% endhint %}

#### 4. Lieferadressen

**4.1 Lieferadressen eines Kunden**

{% hint style="success" %}
Abweichende Lieferadressen aus Shopware-Bestellungen werden automatisch als ***"Lief. an Adressen"*** angelegt.
{% endhint %}

**Zu finden:** In der Suche von BC *"Debitor"* eingeben. Im geöffneten Menü dem Pfad folgen: *"Weitere Optionen"* <i class="fa-right">:right:</i> *"Zugehörig"* <i class="fa-right">:right:</i> *"Debitor"* <i class="fa-right">:right:</i> *"Lief.an Adressen"*

Das System vergleicht die Liefer- und Rechnungsadresse miteinander. Bei Abweichungen wird automatisch eine neue Lieferadresse erstellt. Diese Lieferadresse wird anschließend dem entsprechenden Debitor zugeordnet.

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FBE9BSU4Z1WaMmEEz6LAB%2FBildschirmfoto%202026-04-16%20um%2010.33.36.png?alt=media&#x26;token=23487207-8242-44ba-a46b-2ce4c26a0249" alt=""><figcaption></figcaption></figure></div>

Die Lieferadressen können hier verwaltet werden. Zusätzlich besteht die Möglichkeit, neue Adressen anzulegen sowie bestehende Adressen zu aktualisieren oder zu ergänzen.

<div data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FUf7bux3o3pUWb9n35Oog%2FBildschirmfoto%202026-04-27%20um%2015.19.44.png?alt=media&#x26;token=79337f02-5f7c-4066-915d-46c8a4b9c4a1" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2F8IJTFtiT3s45Ceqsc3q4%2FBildschirmfoto%202026-04-27%20um%2015.20.08.png?alt=media&#x26;token=2c22d947-3d25-4b4a-b241-58ea6e5014aa" alt=""><figcaption></figcaption></figure></div>

**4.2 Lieferadressen aller Kunden**

Im Debitoren Menü können auch alle Lieferadressen angezeigt werden. Der Pfad hierfür ist: *Debitoren-Menü* <i class="fa-right">:right:</i> *"..."* <i class="fa-right">:right:</i> *"Abfragen"* <i class="fa-right">:right:</i> *"Lieferadressen des Debitors"*

<div data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Fb79N6B1M0nSiLbCqKwZ4%2FBildschirmfoto%202026-04-27%20um%2015.20.54.png?alt=media&#x26;token=a8bfba31-77ff-4878-9d25-ea47e37272ab" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2F30wMtaeSsTNw8P2LoZ97%2FBildschirmfoto%202026-04-27%20um%2015.21.29.png?alt=media&#x26;token=27924491-c06c-4cc6-be28-991cb960db6e" alt=""><figcaption></figcaption></figure></div>


# Besonderheiten bei B2B-/B2C-Kunden

Erfahren Sie die Unterschiede bei der Verarbeitung von B2B- und B2C-Kunden.

#### 1. B2C-Kunden

(Privatkunden)

**1.1 Verarbeitungsoptionen**

{% columns %}
{% column %}
**Individuelle Debitoren**

Jeder B2C-Kunde erhält einen eigenen Debitor:

**Vorteile:**

* Vollständige Kundenhistorie
* Individuelle Konditionen möglich

**Nachteile:**

* Viele Debitorenstammsätze
* Mehr Verwaltungsaufwand
  {% endcolumn %}

{% column %}
**Sammelkonto**

Alle B2C-Kunden werden auf einem Sammelkonto gebucht:

**Vorteile:**

* Übersichtliche Debitorenliste
* Weniger Stammdatenpflege

**Nachteile:**

* Keine individuelle Kundenhistorie
* Kein Mahnwesen auf Kundenebene
  {% endcolumn %}
  {% endcolumns %}

**1.2 Konfiguration für B2C**

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><i class="fa-album-collection-circle-user">:album-collection-circle-user:</i></td><td>Erstellen Sie einen <strong>Sammelkunden</strong> (z.B. "WEBSHOP-B2C").</td></tr><tr><td><i class="fa-camera-rotate">:camera-rotate:</i></td><td>Oder aktivieren Sie die <strong>automatische Kundenanlage.</strong></td></tr><tr><td><i class="fa-book-user">:book-user:</i></td><td>Wählen Sie eine passende <strong>Debitorenvorlage.</strong></td></tr></tbody></table>

#### 2. B2B-Kunden

(Geschäftskunden)

B2B-Kunden sollten grundsätzlich als **individuelle Debitoren angelegt werden**. Dies ist erforderlich, um spezifische Anforderungen wie individuelle Zahlungsbedingungen, Kreditlimits sowie kundenspezifische Preise abzubilden. Darüber hinaus ermöglicht diese Vorgehensweise die korrekte Berücksichtigung von Skonti und Rabatten sowie ein gezieltes Mahnwesen.

Für die **Konfiguration** von B2B-Kunden aktivieren Sie zunächst die *"automatische Kundenanlage"* im System. Anschließend wählen Sie eine geeignete *"B2B-Debitorenvorlage"* aus. Abschließend ist das "Kundengruppen-Mapping" entsprechend zu konfigurieren, um eine korrekte Zuordnung sicherzustellen.

#### 3. Kundengruppen in Shopware

{% columns %}
{% column width="50%" %}
**Shopware-Kundengruppen**

Shopware unterstützt verschiedene Kundengruppen:

<table><thead><tr><th width="115.083984375">Gruppe</th><th width="176.29736328125">Beschreibung</th></tr></thead><tbody><tr><td>Standard-kunden</td><td><p>Normal registrierte</p><p>Kunden</p></td></tr><tr><td>Händler</td><td><p>B2B-Kunden mit</p><p>Händlerstatus</p></td></tr><tr><td>VIP</td><td>Kunden mit Sonder-konditionen</td></tr></tbody></table>
{% endcolumn %}

{% column width="50%" %}
**Mapping zu Business Central**

1. Öffnen Sie **Shopware** → **Mapping**
2. Wählen Sie **Kundengruppen.**
3. Ordnen Sie Shopware-Gruppen BC-Preisgruppen zu.

<table><thead><tr><th width="150.2342529296875">Shopware-Gruppe</th><th width="131.086669921875">BC-Preisgruppe</th></tr></thead><tbody><tr><td>Standardkunden</td><td>STANDARD</td></tr><tr><td>Händler</td><td>HAENDLER</td></tr><tr><td>VIP</td><td>VIP</td></tr></tbody></table>
{% endcolumn %}
{% endcolumns %}

#### 4.USt-IdNr. Verarbeitung

<table data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><i class="fa-business-time">:business-time:</i></td><td><strong>B2B-Kunden</strong></td><td><p>Für B2B-Kunden mit USt-IdNr.:</p><ol><li>USt-IdNr. wird aus Shopware übernommen</li><li>Entsprechende MwSt.-Buchungsgruppe wird zugewiesen.</li><li>Ggf. Steuerbefreiung bei EU-Lieferungen.</li></ol></td></tr><tr><td><i class="fa-sack-dollar">:sack-dollar:</i></td><td><strong>Steuerbefreiung</strong></td><td><p>Bei gültiger USt-IdNr. und EU-Lieferung:</p><ol><li>Prüfen Sie die USt-IdNr. Validität.</li><li>Weisen Sie die entsprechende Buchungsgruppe zu.</li><li>Stellen Sie Nettorechnung aus.</li></ol></td></tr></tbody></table>


# Kunden-Upload (BC nach Shopware)

Debitoren können aus Business Central nach Shopware übertragen werden, um dort z. B. B2B-Konten mit hinterlegten Konditionen bereitzustellen.

**Voraussetzung**

Der Debitor muss als **Web-Kunde** markiert sein (`SOUSHW Web Customer = Ja`). Erst dann steht der Upload zur Verfügung.

**Pflichtangaben (Prüfung vor Upload)**

Vor dem Upload prüft der Connector u. a.:

* E-Mail-Adresse und Name
* **Kundengruppe** (`GroupId`)
* **Anrede** (`SalutationId`)
* **Verkaufskanal**
* **Länder-Zuordnung**

{% hint style="warning" %}
Fehlt eine dieser Angaben, bricht der Upload mit einer Meldung ab. Pflegen Sie zuvor die Zuordnungen für Anreden & Länder und Kundengruppen.
{% endhint %}

**Ablauf**

{% stepper %}
{% step %}
**Debitor vorbereiten**

Setzen Sie **Web-Kunde = Ja** und pflegen Sie Kundengruppe, Anrede und Verkaufskanal.
{% endstep %}

{% step %}
**Hochladen**

Öffnen Sie die Debitorenkarte und wählen Sie **Kunde hochladen**. Nach Erfolg wird die **Web-ID** gefüllt.
{% endstep %}

{% step %}
**Folgesynchronisation**

Anschließend werden **Lieferadressen** und ggf. die **Kundenpreisliste** automatisch synchronisiert.
{% endstep %}
{% endstepper %}

**Felder auf der Debitorenkarte**

| Feld                                  | Bedeutung                        |
| ------------------------------------- | -------------------------------- |
| Web-ID                                | Shopware-Kunden-ID (nach Upload) |
| Web-Kunde                             | Für Upload markiert              |
| Verkaufskanal / Anrede / Kundengruppe | Zuordnungswerte                  |
| Kontotyp                              | Business oder Private            |
| Synchronisiert / am / Meldung         | Sync-Status                      |

{% hint style="info" %}
Wird ein Debitor geändert, wird er automatisch als *nicht synchronisiert* markiert und beim nächsten Lauf erneut übertragen.
{% endhint %}

### Häufige Fragen

#### Über welchen Endpunkt werden Kunden und Adressen übertragen?

Kunden werden über `customer` angelegt (POST) bzw. aktualisiert (PATCH), Lieferadressen über `customer-address`. Nach erfolgreichem Upload wird die „SOUSHW Web ID“ am Debitor gesetzt und – falls vorhanden – die Kundenpreisliste automatisch nachsynchronisiert.

#### Welche Angaben müssen vor dem Kunden-Upload gepflegt sein?

Der Connector prüft vor dem Upload E-Mail und Name sowie die Zuordnungen Kundengruppe (`GroupId`), Anrede (`SalutationId`), Verkaufskanal und Land. Fehlt eine dieser Angaben, bricht der Upload mit einer Meldung ab – pflegen Sie zuvor die entsprechenden Mappings.


# B2B-Benutzer aus Kontakten

Im B2B-Geschäft bestellt nicht „eine Person“, sondern eine **Firma mit mehreren Ansprechpartnern**. Der Connector bildet genau das ab: Das **Firmenkonto** ist der **Debitor**, die anmeldbaren Benutzer sind die **Kontakte** dieses Debitors – jeweils mit einer Rolle.

**Debitor & Kontakt – das Zusammenspiel**

```mermaid
flowchart TD
    D[Debitor = Firmenkonto in Shopware] --> K1[Kontakt A - Rolle: Freigabe]
    D --> K2[Kontakt B - Rolle: Besteller]
    D --> K3[Kontakt C - Rolle: Anzeige]
    K1 --> S[Anmeldbare B2B-Benutzer im Shop]
    K2 --> S
    K3 --> S
```

* Der **Debitor** muss als Web-Kunde hochgeladen sein – er bildet das Firmenkonto in Shopware.
* Jeder **Kontakt** des Debitors kann als eigener, anmeldbarer **B2B-Benutzer** übertragen werden.
* Die Zuordnung Kontakt → Firmenkonto erfolgt über die **Customer-ID** des Debitors; ist diese nicht eindeutig, wird die **E-Mail-Adresse** als Fallback verwendet.

{% hint style="info" %}
Grundlage bleibt immer der Debitor. Legen Sie also zuerst den Kunden-Upload an, bevor Sie Kontakte als B2B-Benutzer hochladen.
{% endhint %}

**Rollen**

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Anzeige</strong></td><td>Darf sehen und zur Freigabe weitergeben.</td></tr><tr><td><strong>Besteller</strong></td><td>Darf sehen und Bestellungen anlegen.</td></tr><tr><td><strong>Freigabe</strong></td><td>Darf sehen, anlegen und freigeben.</td></tr></tbody></table>

Details zum Freigabeprozess: B2B-Rollen & Freigabeprozess.

**Einrichtung (Konfiguration)**

Im Bereich **B2B-Kontakte** der Shopware Konfiguration:

| Feld                                    | Bedeutung                                                        |
| --------------------------------------- | ---------------------------------------------------------------- |
| **Kontakte als B2B-Benutzer hochladen** | Master-Schalter der Funktion                                     |
| **B2B Sprach-ID**                       | Sprache neuer B2B-Benutzer                                       |
| **B2B-Rollen-ID (Anzeige)**             | Shopware-Rollen-ID für „Anzeige“                                 |
| **B2B-Rollen-ID (Besteller)**           | Shopware-Rollen-ID für „Besteller“                               |
| **B2B-Rollen-ID (Freigabe)**            | Shopware-Rollen-ID für „Freigabe“                                |
| **B2B E-Mail Ersatz-Domain**            | Domain für die Ersatz-E-Mail, falls der Kontakt keine E-Mail hat |

**Login-E-Mail (mit Fallback)**

* Primär wird die **E-Mail des Kontakts** als Login verwendet.
* Fehlt sie, bildet der Connector eine **Ersatzadresse** nach dem Muster `{KontaktNr}@{DebitorNr}.{Ersatz-Domain}`.

{% hint style="warning" %}
Ohne konfigurierte **Ersatz-Domain** können Kontakte ohne eigene E-Mail nicht angelegt werden. Hinterlegen Sie die Domain, wenn Sie auch Kontakte ohne E-Mail übertragen möchten.
{% endhint %}

**Ablauf**

{% stepper %}
{% step %}
**Debitor als Web-Kunde hochladen**

Setzen Sie **Web-Kunde = Ja** und führen Sie den Kunden-Upload aus. Der Debitor erhält eine Web-ID.
{% endstep %}

{% step %}
**Rollen zuordnen**

Weisen Sie den Kontakten die gewünschte Rolle (Anzeige, Besteller, Freigabe) zu.
{% endstep %}

{% step %}
**B2B-Benutzer hochladen**

Nutzen Sie **B2B-Benutzer hochladen** – verfügbar sowohl auf der **Debitorenkarte** (alle Kontakte) als auch auf der **Kontaktkarte** (einzelner Kontakt).
{% endstep %}

{% step %}
**Prüfen**

Mit **B2B-Benutzer prüfen (API)** lesen Sie den Benutzer aus Shopware zurück und verifizieren die Anlage.
{% endstep %}
{% endstepper %}

**Wo finde ich die Aktionen?**

| Ort                | Aktionen                                                       |
| ------------------ | -------------------------------------------------------------- |
| **Debitorenkarte** | B2B-Benutzer aller Kontakte hochladen, Aktivitätslog           |
| **Kontaktkarte**   | Rolle setzen, einzelnen B2B-Benutzer hochladen, per API prüfen |

{% hint style="info" %}
Ein Aktivitätslog auf den Kontakt-/Debitorenkarten hilft bei der Nachverfolgung der Uploads. Fehler erscheinen zusätzlich im Aktivitätsprotokoll.
{% endhint %}

**Troubleshooting**

<details>

<summary>B2B-Benutzer wird nicht angelegt</summary>

* Ist der **Debitor** als Web-Kunde hochgeladen (Web-ID vorhanden)?
* Ist **Kontakte als B2B-Benutzer hochladen** aktiviert?
* Sind die **Rollen-IDs** hinterlegt?
* Hat der Kontakt eine E-Mail – oder ist eine **Ersatz-Domain** konfiguriert?

</details>

<details>

<summary>Kontakt wird dem falschen Firmenkonto zugeordnet</summary>

Prüfen Sie die **Customer-ID**-Verknüpfung des Kontakts zum Debitor. Ist sie nicht eindeutig, greift der E-Mail-Fallback – achten Sie dann auf eindeutige E-Mail-Adressen.

</details>

<details>

<summary>Anmeldung im Shop funktioniert nicht</summary>

Die Login-E-Mail entspricht der Kontakt-E-Mail bzw. der gebildeten Ersatzadresse. Prüfen Sie, welche Adresse tatsächlich übertragen wurde (über **B2B-Benutzer prüfen (API)**).

</details>

**Verwandte Themen**

* Kunden-Upload (BC nach Shopware)
* B2B-Rollen & Freigabeprozess
* B2B-Shop aufsetzen
* Kundengruppen-Preise (Rules)


# Lieferadressen synchronisieren

Zu jedem Web-Kunden können mehrere **Lieferadressen** nach Shopware übertragen werden.

**Ablauf**

* Beim Kunden-Upload werden vorhandene Lieferadressen automatisch mit synchronisiert.
* Ändern Sie eine Adresse, wird der Debitor als *nicht synchronisiert* markiert und beim nächsten Lauf aktualisiert.
* Jede Lieferadresse erhält eine eigene **Web-ID** und einen Sync-Status.

**Felder je Lieferadresse**

| Feld                          | Bedeutung                |
| ----------------------------- | ------------------------ |
| Web-ID                        | Shopware-Adress-ID       |
| Synchronisiert / am / Meldung | Sync-Status              |
| Herkunft                      | Ursprung des Datensatzes |

{% hint style="info" %}
Bei importierten Bestellungen werden abweichende Liefer- und Rechnungsadressen ebenfalls berücksichtigt – siehe Bestelleingang.
{% endhint %}

### Häufige Fragen

#### Kann ein Kunde mehrere Lieferadressen im Shop haben?

Ja. Zu jedem Web-Kunden können mehrere Lieferadressen nach Shopware übertragen werden. Beim Kunden-Upload werden vorhandene Lieferadressen automatisch mitsynchronisiert; jede Adresse erhält eine eigene Web-ID und einen Sync-Status.

#### Was passiert, wenn ich eine Lieferadresse in Business Central ändere?

Bei einer Adressänderung wird der Debitor als „nicht synchronisiert“ markiert und beim nächsten Synchronisationslauf automatisch in Shopware aktualisiert. So bleiben die Adressen zwischen beiden Systemen konsistent.


# Gastkunden & Standardkunden

Nicht jede Bestellung stammt von einem angemeldeten, synchronisierten Kunden. Der Connector bietet dafür flexible Regeln.

**Einstellungen (Konfiguration)**

| Feld                             | Bedeutung                                                      |
| -------------------------------- | -------------------------------------------------------------- |
| **Unbekannten Kunden erstellen** | Legt bei neuen Shopware-Kunden automatisch einen BC-Debitor an |
| **Gastkunde anlegen**            | Legt für Gastbestellungen einen Kunden an                      |
| **Standard-Gastkunde**           | Fallback-Debitor für Gastbestellungen                          |
| **Standard-Kunde (angemeldet)**  | Fallback für angemeldete, aber nicht synchronisierte Kunden    |
| **Kundenvorlage**                | Vorlage für neu angelegte Kunden                               |

**Entscheidungslogik beim Bestellimport**

```mermaid
flowchart TD
    A[Bestellung] --> B{Kundenkonto vorhanden?}
    B -->|nein| G[Standard-Gastkunde]
    B -->|ja| C{per Web-ID/E-Mail gefunden?}
    C -->|ja| D[bestehender Debitor]
    C -->|nein| E{Unbekannten Kunden erstellen?}
    E -->|ja| F[neuen Debitor anlegen]
    E -->|nein| H[Standard-Kunde angemeldet]
```

{% hint style="success" %}
**Empfehlung:** Legen Sie feste Standard-Debitoren für Gast- und Sammelbuchungen an. So bleiben Ihre Auswertungen sauber, auch wenn nicht für jede Bestellung ein eigener Debitor entsteht.
{% endhint %}


# B2B-Rollen & Freigabeprozess

Für Firmenkunden vergibt der Connector je Kontakt eine **Rolle**. Sie steuert, was der jeweilige B2B-Benutzer im Shop darf.

**Die drei Rollen im Überblick**

| Rolle         | Sehen | Bestellen | Freigeben |
| ------------- | :---: | :-------: | :-------: |
| **Anzeige**   |   ✓   |     –     |     –     |
| **Besteller** |   ✓   |     ✓     |     –     |
| **Freigabe**  |   ✓   |     ✓     |     ✓     |

* **Anzeige:** Darf Sortiment/Preise sehen und einen Warenkorb zur Freigabe weitergeben – aber nicht selbst verbindlich bestellen.
* **Besteller:** Darf sehen und Bestellungen anlegen.
* **Freigabe:** Darf zusätzlich Bestellungen freigeben (z. B. Einkäufe von Kolleg:innen genehmigen).

**Typischer Freigabeprozess**

```mermaid
flowchart LR
    A[Anzeige/Besteller legt Warenkorb an] --> B{Freigabe erforderlich?}
    B -->|ja| C[Freigabe-Benutzer prüft]
    C -->|genehmigt| D[Bestellung wird ausgelöst]
    C -->|abgelehnt| E[zurück an Ersteller]
    B -->|nein| D
    D --> F[Bestelleingang in BC]
```

Die ausgelöste Bestellung gelangt über den normalen Bestelleingang nach Business Central.

**Einrichtung**

1. Rollen-IDs in der Konfiguration hinterlegen (Bereich **B2B-Kontakte**).
2. Kontakten die passende Rolle zuweisen.
3. Kontakte als B2B-Benutzer hochladen.

{% hint style="info" %}
Die eigentliche Darstellung von Freigabe-Workflows erfolgt im Shopware-B2B-Umfeld. Der Connector sorgt dafür, dass die richtigen Benutzer mit der richtigen Rolle im Firmenkonto angelegt werden.
{% endhint %}

{% hint style="success" %}
**Empfehlung:** Vergeben Sie die Rolle **Freigabe** bewusst sparsam – idealerweise an Einkäufer:innen oder Führungskräfte, die Bestellungen verantworten.
{% endhint %}


# Preisaktualisierungen

Erfahren Sie, wie Sie Preise zwischen Business Central und Shopware synchronisieren.

Die Preissynchronisation stellt sicher, dass Ihre Artikelpreise in Business Central und Shopware konsistent sind.

## 1. Preissynchronisation

Die Preise werden aus Business Central in Shopware synchronisiert. Dabei fungiert Business Central als führendes System für die Preisverwaltung. Änderungen, die in BC vorgenommen werden, werden automatisch zu Shopware übertragen. Preisänderungen, die direkt in Shopware durchgeführt werden, werden bei der nächsten Synchronisation durch die Daten aus Business Central überschrieben.

<table><thead><tr><th width="143.939453125">Preisart</th><th width="267.3792724609375">Synchronisation</th></tr></thead><tbody><tr><td><strong>Standardpreis</strong></td><td>VK-Preis aus der Artikelkarte</td></tr><tr><td><strong>Staffelpreise</strong></td><td>Mengenabhängige Preise</td></tr><tr><td><strong>Kundenpreise</strong></td><td>Individuelle Kundenpreise</td></tr><tr><td><strong>Aktionspreise</strong></td><td>Zeitlich begrenzte Sonderpreise</td></tr></tbody></table>

## 2. <mark style="background-color:yellow;">Manuelle Preissynchronisation</mark>

### Einzelner Artikel

1. Öffnen Sie die **Artikelkarte.**
2. Klicken Sie auf **Aktionen** → **Preis zu Shopware**
3. Der Preis wird aktualisiert.

<div align="left" data-with-frame="true"><figure><img src="/files/qkPpiE5OaNuraJJBarpW" alt="" width="563"><figcaption></figcaption></figure></div>

### Mehrere Artikel

1. Öffnen Sie die **Artikelliste.**
2. Wählen Sie die gewünschten Artikel.
3. Klicken Sie auf **Preise zu Shopware.**

<div align="left" data-with-frame="true"><figure><img src="/files/qvlVuWTL43ijlr3zIfw9" alt=""><figcaption></figcaption></figure></div>

## 3. Automatische Preissynchronisation

### 3.1 Aufgabenwarteschlange

Öffnen Sie die [Aufgabenwarteschlangen](/shopware/automatisierungen-und-zeitplane/aufgabenwarteschlangenposten)-Erklärung, um dort die Konfiguration der automatischen Preissynchronisation anzupassen.

<table data-view="cards"><thead><tr><th data-type="number"></th><th></th></tr></thead><tbody><tr><td>1</td><td>Erstellen eines <strong>Aufgabenwarte-schlangenposten.</strong></td></tr><tr><td>2</td><td>Wählen Sie die Codeunit <strong>Preisupload.</strong></td></tr><tr><td>3</td><td>Legen Sie das Intervall fest (z.B. täglich).</td></tr></tbody></table>

### 3.2 Trigger-basiert

Preise können auch bei Änderungen automatisch aktualisiert werden:

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><i class="fa-sack-dollar">:sack-dollar:</i></td><td>Bei Änderung des VK-Preises.</td></tr><tr><td><i class="fa-list-ul">:list-ul:</i></td><td>Bei Anlage neuer Preiszeilen.</td></tr><tr><td><i class="fa-money-bills">:money-bills:</i></td><td>Bei Änderung von Staffelpreisen.</td></tr></tbody></table>

## 4. Preiskonfiguration

{% columns %}
{% column width="50%" %}

### Preisfeld

In den *Einstellungen / Konfiguration* legen Sie fest, welches Feld für den Shopware-Preis verwendet wird:

<table><thead><tr><th width="150.0235595703125">Option</th><th width="169.2327880859375">Beschreibung</th></tr></thead><tbody><tr><td>VK-Preis</td><td>Standardverkaufs-preis</td></tr><tr><td>Einstandspreis</td><td>Einkaufspreis</td></tr><tr><td>Preis inkl. MwSt.</td><td>Bruttopreis</td></tr></tbody></table>
{% endcolumn %}

{% column width="50%" %}

### Netto/Brutto

Konfigurieren Sie, ob Preise netto oder brutto übertragen werden:

* **Netto**:
  * Für B2B-Shops
* **Brutto**:
  * Für B2C-Shops
    {% endcolumn %}
    {% endcolumns %}

<div align="left" data-with-frame="true"><figure><img src="/files/iktroslcbRDLkusl2RSx" alt=""><figcaption></figcaption></figure></div>

## 5. MwSt.-Zuordnung

{% columns %}
{% column width="50%" %}
Die korrekte MwSt.-Zuordnung ist essentiell:

1. Öffnen Sie *"Shopware"* <i class="fa-right">:right:</i> *"Mapping"* <i class="fa-right">:right:</i> *"MwSt.-Zuordnung"*
2. Ordnen Sie Business Central-MwSt.-Gruppen den Shopware-Steuersätzen zu.
   {% endcolumn %}

{% column width="50%" %}

<table><thead><tr><th width="133.1644287109375">BC MwSt.-Gruppe</th><th width="125.65966796875">Shopware-Steuersatz</th></tr></thead><tbody><tr><td>VOLL</td><td>19%</td></tr><tr><td>REDUZIERT</td><td>7%</td></tr><tr><td>FREI</td><td>0%</td></tr></tbody></table>
{% endcolumn %}
{% endcolumns %}

<div align="left" data-with-frame="true"><figure><img src="/files/DRS9dyJKCEPpypyZPsfx" alt=""><figcaption></figcaption></figure></div>

## 6. Währungen

Bei mehreren Währungen:

1. Konfigurieren Sie das **Währungs-Mapping.**
2. Preise werden in der jeweiligen Währung übertragen.
3. Wechselkurse aus BC werden verwendet.

<div align="left" data-with-frame="true"><figure><img src="/files/oa6VkEJ842aGHz473fVr" alt=""><figcaption></figcaption></figure></div>

<details>

<summary><strong>Tipps für den täglichen Umgang</strong></summary>

**Preiskonsistenz**

* Führen Sie Preise zentral in BC.
* Vermeiden Sie manuelle Preisänderungen in Shopware.
* Dokumentieren Sie Preisstrategien.

**Timing**

* Synchronisieren Sie Preise außerhalb der Stoßzeiten.
* Planen Sie Preisänderungen für verkehrsarme Zeiten.
* Kommunizieren Sie größere Preisänderungen.

**Kontrolle**

* Prüfen Sie stichprobenartig die Preise in beiden Systemen.
* Überwachen Sie das Aktivitätsprotokoll.
* Reagieren Sie schnell auf Fehler.

</details>


# Staffelpreise

Erfahren Sie, wie Sie Staffelpreise zwischen Business Central und Shopware synchronisieren.

Staffelpreise ermöglichen mengenabhängige Preise, die bei größeren Bestellmengen Rabatte gewähren.

## 1. Staffelpreise in Business Central

{% columns %}
{% column width="41.66666666666667%" %}

### Verkaufspreise anlegen

1. Öffnen Sie *"Verkaufspreise"* über die Suchfunktion (oder über die Artikelkarte)
2. Erstellen Sie Preiszeilen mit unterschiedlichen Mindestmengen:
   {% endcolumn %}

{% column width="58.33333333333333%" %}

### Preislisten verwenden

Ab "*BC 2020 Wave 2"* mit *"Verkaufspreislisten":*

1. Öffnen Sie *"Verkaufspreislisten".*
2. Erstellen oder bearbeiten Sie eine Preisliste.
3. Fügen Sie Staffelzeilen hinzu.
   {% endcolumn %}
   {% endcolumns %}

<div align="left" data-with-frame="true"><figure><img src="/files/B2kRswTZJhmItRTbyPvF" alt="" width="563"><figcaption><p>Verkaufspreise</p></figcaption></figure></div>

<div align="left" data-with-frame="true"><figure><img src="/files/JUKpuEOLTXCUMID3kR2D" alt="" width="563"><figcaption><p>Preisliste</p></figcaption></figure></div>

{% hint style="info" %}
Bei der Preissynchronisation werden Staffelpreise automatisch übertragen. Preiszeilen mit Mindestmengen werden dabei automatisch erkannt. Jede Staffel wird an Shopware übergeben und dort als Preisstaffel angezeigt.
{% endhint %}

### Staffelpreis-Limit

{% columns %}
{% column width="41.66666666666667%" %}
In den Einstellungen können Sie ein Limit festlegen:

1. Öffnen Sie "*Shopware"* <i class="fa-right">:right:</i> *"Einstellung"*
2. Unter *"Price API Limit" / "Staffelpreis Limit"* definieren Sie die maximale Anzahl.
   {% endcolumn %}

{% column width="58.33333333333333%" %}

<div align="left" data-with-frame="true"><figure><img src="/files/cHzQIkQ17V2oaFBPEnBG" alt="" width="375"><figcaption></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

{% hint style="warning" %}
Ein zu hohes Limit kann die Performance beeinträchtigen. Empfohlen: max. 5-10 Staffeln pro Artikel.
{% endhint %}

## 2. Shopware-Darstellung

{% columns %}
{% column %}

### Produktseite

In Shopware werden Staffelpreise auf der Produktseite angezeigt:

<table><thead><tr><th width="114.6195068359375">Ab Menge</th><th width="146.238525390625">Preis pro Stück</th></tr></thead><tbody><tr><td>1</td><td>100,00 €</td></tr><tr><td>10</td><td>90,00 €</td></tr><tr><td>50</td><td>80,00 €</td></tr></tbody></table>
{% endcolumn %}

{% column %}

### Warenkorb

Im Warenkorb wird automatisch der günstigste Staffelpreis angewendet:

* Kunde legt 15 Stück in den Warenkorb.
* System erkennt Staffel ab 10 Stück.
* Preis von 90,00 € pro Stück wird angewendet.
  {% endcolumn %}
  {% endcolumns %}

## 3. Kundenspezifische Staffelpreise

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><h3>Für bestimmte Kunden</h3></td><td><p>Sie können Staffelpreise für <strong>bestimmte Kunden</strong> anlegen:</p><ol><li>Erstellen Sie Verkaufspreise mit <strong>Verk. an-Art</strong> = Debitor</li><li>Legen Sie die Staffeln für den spezifischen Kunden an.</li><li>Diese werden nur für diesen Kunden synchronisiert. Der Kunde wird bei <em>"Zuweisen zu Nr. (benutzerdefiniert)"</em> ausgewählt.</li></ol></td></tr><tr><td><h3>Für Kundengruppen</h3></td><td><p>Staffelpreise für <strong>Kundengruppen</strong>:</p><ol><li>Erstellen Sie Verkaufspreise mit <strong>Verk. an-Art</strong> = Debitorenpreisgruppe</li><li>Ordnen Sie die Preisgruppe in Shopware zu.</li><li>Alle Kunden dieser Gruppe sehen die Staffelpreise.</li></ol></td></tr></tbody></table>

<div align="left"><figure><img src="/files/lkAELUabvyZ4vsLo2wCa" alt=""><figcaption><p>Staffelpreis für einen Kunden</p></figcaption></figure> <figure><img src="/files/jwyRMLOYJ0a1A8fsQHdN" alt=""><figcaption><p>Staffelpreis für Kundengruppe</p></figcaption></figure></div>

<details>

<summary><strong>Tipps für den täglichen Umgang</strong></summary>

<table data-card-size="large" data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><p><strong>Staffelstruktur</strong></p><ul><li>Halten Sie Staffeln übersichtlich (3-5 Stufen).</li><li>Verwenden Sie logische Mengenstufen.</li><li>Bieten Sie attraktive Rabatte.</li></ul></td></tr><tr><td><p><strong>Kommunikation</strong></p><ul><li>Zeigen Sie Staffelpreise prominent.</li><li>Weisen Sie auf Sparmöglichkeiten hin.</li><li>Nutzen Sie Shopware-Widgets zur Darstellung.</li></ul></td></tr></tbody></table>

**Beispiel-Struktur**

<table><thead><tr><th width="89.642822265625">Stufe</th><th width="94.3209228515625">Menge</th><th width="91.5550537109375">Rabatt</th></tr></thead><tbody><tr><td>1</td><td>1-9</td><td>0%</td></tr><tr><td>2</td><td>10-49</td><td>10%</td></tr><tr><td>3</td><td>50-99</td><td>20%</td></tr><tr><td>4</td><td>100+</td><td>30%</td></tr></tbody></table>

</details>


# Sonderpreise

Erfahren Sie, wie Sie Sonderpreise und Aktionen zwischen BC und Shopware synchronisieren.

Sonderpreise ermöglichen **zeitlich begrenzte** Aktionen und individuelle Kundenpreise.

## 1. Sonderpreise in Business Central

### 1.1 Zeitlich begrenzte Preise

{% stepper %}
{% step %}
Öffnen Sie *"Verkaufspreise"* oder *"Verkaufspreislisten"* über die BC-Suche.
{% endstep %}

{% step %}
Erstellen Sie einen Preis mit Gültigkeitsdatum.
{% endstep %}
{% endstepper %}

<div align="left"><figure><img src="/files/n314UAoHXRCII5A33l6N" alt=""><figcaption><p>Suchfeld in BC</p></figcaption></figure> <figure><img src="/files/KlI7C9xlG8GUZEdbWaP0" alt=""><figcaption><p>Fenster für Eingabe zeitlich begrentzer Preise/Aktionen</p></figcaption></figure></div>

### 1.2 Kundenspezifische Preise

Für individuelle Kundenpreise sind folgende Felder auszufüllen:

* Beschreibung: *Ihre aussagekräftige Beschreibung*
* Zuweisen zu Typ: "*Debitor"*
* Zuweisen zu Nr. (benutzerdefiniert): *Hier den Kunden auswählen.*
* Start- und Enddatum: *Legen Sie den Zeitraum fest, falls gewünscht.*
* Unter "*Shopware"* finden Sie die "*Zeilen"*, in denen Sie die Sonderpreise und Artikel auswählen.

<div align="left" data-with-frame="true"><figure><img src="/files/6caqrGWlRE7flB4oqNlI" alt="" width="563"><figcaption></figcaption></figure></div>

## 2. Synchronisation zu Shopware

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><h3>Aktionspreise</h3></td><td><p>Aktionspreise mit Gültigkeitsdatum werden zu Shopware übertragen:</p><ul><li>Startdatum und Enddatum werden übernommen.</li><li>Shopware zeigt den reduzierten Preis an.</li><li>Nach Ablauf gilt wieder der Normalpreis.</li></ul></td></tr><tr><td><h3>Anzeige in Shopware</h3></td><td><ul><li>Durchgestrichener Originalpreis</li><li>Aktueller Aktionspreis hervorgehoben</li><li>Ggf. Countdown bis Aktionsende</li></ul></td></tr></tbody></table>

## 3. Kundengruppen-Preise

### 3.1 Preisgruppen in BC

{% stepper %}
{% step %}
Erstellen Sie *"Debitorenpreisgruppen"* in BC. Am schnellsten gelangen Sie in das Menü über die BC-Suche.

<div align="left" data-with-frame="true"><figure><img src="/files/vFgJFboieb7nVGW0fY16" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Weisen Sie dem Kunden eine Preisgruppe zu. Öffnen Sie dazu in der Debitorenkarte des jeweiligen Kunden den Bereich *"Fakturierung"*. Wählen Sie anschließend im Feld *"Debitorenpreisgruppe"* die passende Vorlage aus dem Drop-down-Menü aus.

<div align="left" data-with-frame="true"><figure><img src="/files/lEsCLR3RvgCVUwdsc6J5" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Erstellen Sie Preise für die Preisgruppen. Siehe hierzu auch [Sonderpreise in Business Central](#id-1.-sonderpreise-in-business-central).
{% endstep %}
{% endstepper %}

### 3.2 Mapping zu Shopware

* Öffnen Sie **Shopware** <i class="fa-right">:right:</i> **Mapping** <i class="fa-right">:right:</i> **Kundengruppen**
* Ordnen Sie BC-Preisgruppen den Shopware-Kundengruppen zu:

{% columns %}
{% column width="58.333333333333336%" %}

<div align="left" data-with-frame="true"><figure><img src="/files/cufXI2X09A2igIhPskUZ" alt="" width="375"><figcaption></figcaption></figure></div>
{% endcolumn %}

{% column width="41.666666666666664%" %}

<table><thead><tr><th width="144.8192138671875">BC-Preisgruppe</th><th width="145.387451171875">Shopware-Kundengruppe</th></tr></thead><tbody><tr><td>HAENDLER</td><td>Händler</td></tr><tr><td>VIP</td><td>VIP-Kunden</td></tr><tr><td>GROSSHANDEL</td><td>Großhandel</td></tr></tbody></table>
{% endcolumn %}
{% endcolumns %}

## 4. Rabatte

### 4.1 Positionsrabatte

#### **Rabatte auf Artikelebene:**

Erstellen Sie die Verkaufszeilenrabatte direkt in Business Central. Diese werden anschließend als prozentuale Rabatte an Shopware übertragen.

Dadurch wird sichergestellt, dass die in Business Central gepflegten Rabattinformationen konsistent an Shopware übergeben und dort für die entsprechenden Verkaufs- oder Artikeldaten verwendet werden können.

#### **Wie gelangt man zur Preislistenzeile?**

1. **Entweder über die Artikelansicht**

In der Artikelliste wählen Sie zunächst den Artikel aus, für den ein Rabatt hinterlegt werden soll. Markieren Sie den gewünschten Artikel durch Anklicken, sodass dieser farblich hervorgehoben wird.

Anschließend öffnen Sie über den Menüpunkt *„Preise und Rabatte“* <i class="fa-right">:right:</i> *„Verkaufsrabatte“* die entsprechende Ansicht. Dort können Sie die gewünschten Preislistenzeilen erfassen und die Verkaufsrabatte für den ausgewählten Artikel pflegen.

<div align="left" data-with-frame="true"><figure><img src="/files/dhOFXhEFfxRVEUYli5KG" alt=""><figcaption><p>Artikelliste</p></figcaption></figure></div>

2. **Oder über die Artikelkarte**

In der Artikelkarte stehen Ihnen zwei Möglichkeiten zur Verfügung, um das Menü *„Preislistenzeilen“* zu öffnen.

Sie können die Preislistenzeilen entweder über den Menüpunkt *„Preise und Rabatte“* aufrufen oder alternativ im Bereich *„Preis und Verkauf“* den Unterpunkt *„Verkaufspreise und Rabatte“* auswählen.

Beide Wege führen zur entsprechenden Ansicht, in der Sie die Preislistenzeilen einsehen, bearbeiten oder neue Verkaufsrabatte erfassen können. Siehe Screenshot.

<div align="left" data-with-frame="true"><figure><img src="/files/TpPsrRRSJiLAMJlhljC5" alt="" width="375"><figcaption></figcaption></figure></div>

<div align="left" data-with-frame="true"><figure><img src="/files/VvNhd3AY9McayIjzULlp" alt="" width="563"><figcaption><p>Menüpunkt: Preislistenzeilen pro Artikel</p></figcaption></figure></div>

### 4.2 Kundenrabatte

**Rabatte für bestimmte Kunden** werden direkt auf der jeweiligen Debitorenkarte hinterlegt. Öffnen Sie dazu die Debitorenkarte des gewünschten Kunden und erfassen Sie dort die entsprechenden Rabattinformationen.

Navigieren Sie hierfür in der Debitorenkarte zum Bereich *„Fakturierung“* und anschließend zum Unterpunkt *„Preise und Rabatte“*. Dort können Sie festlegen, welcher Rabatt für den Kunden gelten soll und in welcher Höhe dieser vergeben wird.

Die hinterlegten Rabatte werden anschließend bei der Belegerfassung für diesen Kunden berücksichtigt.

<div align="left" data-with-frame="true"><figure><img src="/files/z2oyKtX6a3y2us0pv3Sk" alt="" width="563"><figcaption></figcaption></figure></div>

## 5. Kampagnenplanung

**Vorbereitung:**

Vier Wochen vor dem Start werden die Preise in **Business Central** angelegt. Eine Woche vor dem Start wird die Synchronisation getestet, um sicherzustellen, dass die Daten korrekt übertragen werden. Am Starttag erfolgt abschließend die Kontrolle in **Shopware**.

Für das Anlegen einer Kampagne scrollen Sie bitte nach oben zum Abschnitt [4.1 Positionsrabatte](#id-4.1-positionsrabatte). Dort finden Sie die entsprechende Anleitung zum Einstellen einer Kampagne.

<div align="left" data-with-frame="true"><figure><img src="/files/X01Q8DVXh4emJDCz8GAA" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Nach Ablauf der Aktion werden die in Business Central hinterlegten Aktionspreise automatisch ungültig. In Shopware werden anschließend wieder die regulären Normalpreise angezeigt. Eine manuelle Aktion ist hierfür nicht erforderlich.
{% endhint %}

<details>

<summary><strong>Tipps für den täglichen Umgang</strong></summary>

<table data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><p><strong>Aktionsplanung</strong></p><ul><li>Planen Sie Aktionen frühzeitig.</li><li>Testen Sie Preise vor dem Kampagnen-start.</li><li>Dokumentieren Sie alle Aktionen.</li></ul></td></tr><tr><td><p><strong>Preisstrategie</strong></p><ul><li>Halten Sie Rabatte attraktiv aber rentabel.</li><li>Begrenzen Sie Aktionszeiträume.</li><li>Kommunizieren Sie klar.</li></ul></td></tr><tr><td><p><strong>Kontrolle</strong></p><ul><li>Prüfen Sie Preise stichprobenartig.</li><li>Überwachen Sie das Aktivitätsprotokoll.</li><li>Reagieren Sie schnell auf Fehler.</li></ul></td></tr></tbody></table>

</details>


# Lagerbestände

Erfahren Sie, wie Sie Lagerbestände zwischen Business Central und Shopware synchronisieren.

Die Bestandssynchronisation stellt sicher, dass Ihre Verfügbarkeitsinformationen in Shopware aktuell sind.

#### 1. Bestandssynchronisation

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><i class="fa-arrows-rotate">:arrows-rotate:</i></td><td>Bestände werden von <strong>Business Central → Shopware</strong> synchronisiert.</td></tr><tr><td><i class="fa-microsoft">:microsoft:</i></td><td>BC ist das führende System für Bestände.</td></tr><tr><td><i class="fa-angles-up-down">:angles-up-down:</i></td><td>Änderungen in BC werden zu Shopware übertragen.</td></tr><tr><td><i class="fa-cart-circle-check">:cart-circle-check:</i></td><td>Bestandsänderungen durch Bestellungen werden berücksichtigt.</td></tr></tbody></table>

#### 2. Manuelle Bestandssynchronisation

Die manuelle Synchronisation des Bestands erfolgt auf die gleiche Weise wie die manuelle Preissynchronisation. Die entsprechende Beschreibung finden Sie im folgenden Abschnitt:

<a class="button primary">Anleitung Synchronisation</a>

#### 3. Automatische Bestandssynchronisation

Öffnen Sie die Aufgabenwarteschlangen-Erklärung, um dort die Konfiguration der automatischen Bestandssynchronisation anzupassen.

<table data-view="cards"><thead><tr><th data-type="number"></th><th></th></tr></thead><tbody><tr><td>1</td><td>Erstellen eines <strong>Aufgabenwarte-schlangenposten.</strong></td></tr><tr><td>2</td><td>Wählen Sie die Codeunit <strong>Bestandsupload.</strong></td></tr><tr><td>3</td><td>Legen Sie das Intervall fest (z.B. alle 30 Min.).</td></tr></tbody></table>

**Ereignisbasiert:** Bestände können auch bei Änderungen automatisch aktualisiert werden:

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><i class="fa-cart-circle-plus">:cart-circle-plus:</i></td><td>Nach Wareneingang</td></tr><tr><td><i class="fa-cart-circle-arrow-down">:cart-circle-arrow-down:</i></td><td>Nach Warenausgang</td></tr><tr><td><i class="fa-list-ol">:list-ol:</i></td><td>Nach Inventurbuchung</td></tr></tbody></table>

#### 4. Konfiguration

**4.1 Lagerort**

Den Lagerort legen Sie in den Einstellungen fest. Öffnen Sie dazu *"Shopware"* und navigieren Sie zu den *"Einstellungen"*. Wählen Sie anschließend unter *„Lagerstandort-IDs“* den gewünschten Lagerort aus.

<div><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2F1crHpXo128vtvB5gJobQ%2FBildschirmfoto%202026-04-30%20um%2010.21.53.png?alt=media&#x26;token=07ca4e5c-dceb-481e-94e5-1128fd6574a6" alt="" width="563"><figcaption></figcaption></figure> <figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FTaaim6rW2V5pri6Nwedv%2FBildschirmfoto%202026-04-30%20um%2010.24.01.png?alt=media&#x26;token=ca5b4346-e624-4c8c-815b-110ed5693e81" alt="" width="375"><figcaption></figcaption></figure></div>

**4.2 Mehrere Lagerorte**

{% columns %}
{% column width="41.66666666666667%" %}
Wenn mehrere Lagerorte vorhanden sind, können diese je nach Einstellung unterschiedlich berücksichtigt werden. Es besteht die Möglichkeit, die Bestände aller Lagerorte zu summieren oder nur bestimmte Lagerorte für die Bestandsberechnung einzubeziehen.
{% endcolumn %}

{% column width="58.33333333333333%" %}

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FQO0fkP4hB4nsdJrKbftY%2FBildschirmfoto%202026-04-30%20um%2010.23.48.png?alt=media&#x26;token=e968a366-b220-4de0-82d3-590b8e669723" alt="" width="375"><figcaption></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

#### 5. Bestandsanzeige in Shopware

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Numerische Anzeige</strong></td><td><p>Der tatsächliche Bestand wird angezeigt:</p><p>"15 Stück auf Lager"</p></td></tr><tr><td><strong>Ampel-System</strong></td><td><p>Alternativ kann ein Ampel-System verwendet werden:</p><p>🟢 Sofort lieferbar</p><p>🟡 Geringer Bestand</p><p>🔴 Nicht verfügbar</p></td></tr><tr><td><strong>Lieferzeit</strong></td><td><p>Bei Bestand = 0 kann eine Lieferzeit angezeigt werden:</p><p>"Lieferbar in 2-3 Wochen"</p></td></tr></tbody></table>

#### 6. Negativer Bestand

{% columns %}
{% column %}
**Handling**

Falls der Bestand in BC negativ ist:

* Zu Shopware wird 0 übertragen.
* Artikel wird als *"nicht verfügbar"* angezeigt.
* BC-Bestand sollte korrigiert werden.
  {% endcolumn %}

{% column %}
**Benachrichtigung**

Bei negativem Bestand:

* Prüfen Sie offene Wareneingänge.
* Führen Sie Inventur durch.
* Korrigieren Sie den Bestand.
  {% endcolumn %}
  {% endcolumns %}

<details>

<summary><strong>Tipps für den täglichen Umgang</strong></summary>

**Synchronisationsfrequenz**

<table><thead><tr><th width="160.9677734375">Artikel-Typ</th><th width="189.7362060546875">Empfohlene Frequenz</th></tr></thead><tbody><tr><td>Schnelldreher</td><td>Alle 15-30 Minuten</td></tr><tr><td>Standardartikel</td><td>Stündlich</td></tr><tr><td>Langsame Dreher</td><td>Täglich</td></tr></tbody></table>

**Bestandsgenauigkeit**

* Führen Sie regelmäßige Inventuren durch.
* Prüfen Sie Differenzen zwischen den Systemen.
* Klären Sie Abweichungen zeitnah.

**Überverkauf vermeiden**

* Synchronisieren Sie häufig.
* Halten Sie einen Sicherheitsbestand.
* Nutzen Sie den "verfügbaren Bestand".

</details>


# Preislisten-Übersicht & Sync-Status

Die **Preislistenverwaltung** bietet eine zentrale Übersicht mit aktuellem **Synchronisationsstatus** aller Shopware-relevanten Preislisten.

**Was zeigt die Übersicht?**

| Information    | Bedeutung                        |
| -------------- | -------------------------------- |
| Zeilen gesamt  | Anzahl Preiszeilen der Liste     |
| Synchronisiert | Bereits nach Shopware übertragen |
| Offen          | Noch zu übertragen               |
| Rule-ID        | Zugeordnete Shopware-Preisregel  |
| Kundengruppe   | Verknüpfte Shopware-Kundengruppe |

**Aktionen**

* **Ausgewählte hochladen** / **Alle offenen hochladen**
* **Kundengruppe in Shopware anlegen** (inkl. Brutto-/Netto-Einstellung)
* **Sync zurücksetzen** / **Komplett zurücksetzen**

{% hint style="info" %}
Nutzen Sie die Übersicht als tägliches Kontrollinstrument: So erkennen Sie sofort, ob alle Preise erfolgreich im Shop angekommen sind.
{% endhint %}

Grundlagen zu Preisregeln finden Sie unter Kundengruppen-Preise (Rules).


# Kundengruppen-Preise (Rules)

Kundengruppenspezifische Preise werden in Shopware als **Regeln (Rules)** abgebildet. Grundlage ist eine BC-**Preisliste vom Typ Kundenpreisgruppe**.

**Funktionsweise**

```mermaid
flowchart LR
    A[BC-Preisliste Typ Kundenpreisgruppe] --> B[Shopware Rule]
    B --> C[Bedingung: Kundengruppe]
    B --> D[optional: Zeitraum]
    A --> E[Produktpreise productPrices]
    E --> B
```

* Pro Preislisten-Header wird eine **Rule** erzeugt (Bedingung: Kundengruppe, optional Datumsbereich).
* Die Preiszeilen werden als **Produktpreise** an die Rule übertragen.

**Voraussetzungen**

| Feld (Preislisten-Header) | Bedeutung                         |
| ------------------------- | --------------------------------- |
| Web-Preis                 | Preisliste für Shopware markieren |
| Kundengruppe              | Zugeordnete Shopware-Kundengruppe |
| Web-ID                    | Shopware-Rule-ID (nach Upload)    |

{% hint style="warning" %}
Nur Preislisten vom Typ **Kundenpreisgruppe** können als Shopware-Regel hochgeladen werden.
{% endhint %}

**Verwandte Themen**

* Staffelpreise
* Sonderpreise
* Kundengruppen & Preisgruppen


# Preis-Upload ohne Duplikate

Der Preis-Upload wurde so gestaltet, dass beim Wechsel von Preisperioden **keine doppelten Preise** in Shopware entstehen.

**Web-ID-Vererbung (PATCH statt POST)**

* Bereits hochgeladene Preise besitzen eine **Web-ID**.
* Bei einer Preisänderung wird diese Web-ID übernommen und der Preis per **PATCH aktualisiert** – statt einen neuen Datensatz per **POST** anzulegen.
* Dadurch entstehen beim Übergang zwischen Preisperioden **keine Duplikate** mehr.

**Währungssicherheit**

Beim Preis-Upload wird die in der Zuordnung als Standard markierte **Währung** verwendet. So werden Verwechslungen zwischen verschiedenen Währungen vermieden. Siehe Währungen.

**Erzwungener Re-Upload**

Möchten Sie Preise bewusst neu übertragen, markieren Sie die betroffenen Zeilen als **nicht synchronisiert** (z. B. über *Zeilen als unsynchronisiert markieren* oder *Alle Preise als unsynchronisiert markieren*). Beim nächsten Lauf werden sie erneut hochgeladen.

{% hint style="info" %}
Ergänzend stehen Aktionen wie *Neueste Preise hochladen (erzwingen)* und *Alle Shopware-Preise löschen* zur Verfügung.
{% endhint %}

### Häufige Fragen

#### Wie verhindert der Connector doppelte Preise in Shopware?

Preiszeilen werden über ihre „SOUSHW Web ID“ (Shopware product-price-ID) abgeglichen und aktualisiert statt neu angelegt. Zusätzlich erkennt die Prüfung `NewPriceExists()` überlappende Staffeln anhand von Start- und Enddatum. Abgelaufene oder als „Marked Delete“ markierte Zeilen werden über `search/product-price` gefunden und per DELETE entfernt.

#### Was macht „Delete Orphan Prices“?

Diese Aktion entfernt verwaiste Shopware-Preise, zu denen es in Business Central keine passende Preiszeile mehr gibt. Das hält die Preise in Shopware konsistent und beugt Konflikten durch Altlasten vor.

#### Wie viele Preise werden pro API-Aufruf übertragen?

Die Paketgröße steuert das Feld „Price API Limit“ (Default 1). Produktpreise werden in Bulk-Paketen dieser Größe über `Upload_RuleWithBulkPrice` übertragen – bei großen Preismengen kann ein höherer Wert die Anzahl der API-Aufrufe reduzieren.


# Bestandsberechnung & Lagerorte

Der an Shopware übertragene **Bestand** wird auf Basis Ihrer Konfiguration berechnet.

**Optionen**

| Einstellung                         | Wirkung                                                  |
| ----------------------------------- | -------------------------------------------------------- |
| **Lagerort-Codes**                  | Kommagetrennte BC-Lagerorte, deren Bestand summiert wird |
| **Standard-Lagerort verwenden**     | Ignoriert Lagerorte und nutzt einen festen Bestand       |
| **Standard-Bestandsmenge**          | Fester Bestand bei aktiviertem Standard-Lagerort         |
| **Negative Artikelmenge hochladen** | Überträgt negative Bestände; sonst wird 0 gesendet       |
| **Bestand hochladen**               | Master-Schalter für den Bestands-Upload                  |

**Nicht vorrätig**

Über das Artikelfeld **Nicht vorrätig** wird ein Artikel unabhängig vom BC-Bestand in Shopware auf *nicht vorrätig* gesetzt.

{% hint style="info" %}
Der im Artikel angezeigte **Lagerbestand** ergibt sich aus den gewählten Lagereinstellungen. Details zur Konfiguration unter Bestandskonfiguration.
{% endhint %}

**Empfehlung**

{% hint style="success" %}
Laden Sie Bestände regelmäßig (z. B. mehrmals täglich) per Aufgabenwarteschlange hoch, damit die Verfügbarkeit im Shop aktuell bleibt.
{% endhint %}

### Häufige Fragen

#### Wie lege ich fest, welche Lager in den Shop-Bestand einfließen?

Über die Einstellung „Lagerort-Codes“ hinterlegen Sie kommagetrennt die Business-Central-Lagerorte, deren Bestand summiert und nach Shopware übertragen wird. Alternativ nutzen Sie mit „Standard-Lagerort verwenden“ einen festen Bestandswert unabhängig von den Lagerorten.

#### Wie setze ich einen Artikel gezielt auf „nicht vorrätig“?

Über das Artikelfeld „Nicht vorrätig“ wird der Artikel unabhängig vom tatsächlichen Business-Central-Bestand in Shopware als nicht vorrätig gekennzeichnet. Das ist nützlich, um einen Artikel vorübergehend nicht bestellbar zu machen.

#### Werden negative Bestände an Shopware übertragen?

Nur wenn „Negative Artikelmenge hochladen“ aktiviert ist. Andernfalls wird bei negativem Bestand der Wert 0 an Shopware gesendet, damit im Shop keine irreführenden negativen Mengen erscheinen.


# Preise löschen & bereinigen

Damit im Shop keine veralteten Preise verbleiben, bietet der Connector mehrere Bereinigungsfunktionen.

**Automatische Bereinigung**

* **Abgelaufene** Preiszeilen werden entfernt.
* Zeilen mit Lösch‑Markierung (**Marked Delete**) werden gelöscht.
* Zeilen mit **zukünftigem Startdatum** werden bis zu ihrer Gültigkeit nicht übertragen.
* Wird eine Preiszeile in BC gelöscht, wird auch der zugehörige Shopware-Preis entfernt.

**Verwaiste Preise löschen**

Die Aktion **Verwaiste Preise löschen** (*Delete Orphan Prices*) entfernt Shopware-Preise, die keinem Artikel mehr zugeordnet sind.

**Alle Preise zurücksetzen**

Für einen kompletten Neuaufbau steht **Alle Shopware-Preise löschen** zur Verfügung. Anschließend können Sie über *Alle Preise als unsynchronisiert markieren* einen vollständigen Re-Upload auslösen.

{% hint style="warning" %}
Das Löschen von Preisen in Shopware ist nicht umkehrbar. Führen Sie größere Bereinigungen möglichst außerhalb der Geschäftszeiten durch und prüfen Sie danach die Preislisten-Übersicht.
{% endhint %}


# Bestelleingang aus Shopware in BC

Erfahren Sie, wie Bestellungen aus Shopware in Business Central importiert werden.

Der Shopware 6 API Connector ermöglicht den automatischen Import von Bestellungen aus Ihrem Onlineshop in Business Central.

### 1. Bestellimport

{% columns %}
{% column width="41.66666666666667%" %}

#### Manueller Import

1. Klicken Sie auf *"Shopware"* <i class="fa-right">:right:</i> *"Bestellungen Herunterladen"*.
2. Die neuen Bestellungen werden importiert.
   {% endcolumn %}

{% column width="58.33333333333333%" %}

#### Automatischer Import

Für den automatischen Import:

1. Erstellen Sie einen **Aufgabenwarteschlangenposten.**
2. Wählen Sie die entsprechende Codeunit.
3. Legen Sie das Intervall fest (z.B. alle 15 Minuten)
   {% endcolumn %}
   {% endcolumns %}

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Fb7D8bHePpGHOqPyUm8nJ%2FBildschirmfoto%202026-04-30%20um%2011.01.58.png?alt=media&#x26;token=7c6c46e8-800f-4dbb-88c1-48a6e261d7ff" alt=""><figcaption></figcaption></figure></div>

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Fj26dhSC2fPcD1jS3MxoG%2FBildschirmfoto%202026-06-11%20um%2011.09.20.png?alt=media&#x26;token=c8bb0a07-dc59-4b22-82a6-52bac9aa908e" alt=""><figcaption></figcaption></figure></div>

### 2. Importierte Daten

{% columns %}
{% column width="50%" %}

#### Auftragskopf

<table><thead><tr><th width="156.620849609375">Shopware-Feld</th><th width="157.384765625">BC-Feld</th></tr></thead><tbody><tr><td>Bestellnummer</td><td>Externe Belegnr.</td></tr><tr><td>Bestelldatum</td><td>Belegdatum</td></tr><tr><td>Kunde</td><td>Verk. an Deb.-Nr.</td></tr><tr><td>Rechnungs-adresse</td><td>Verk. an Adresse</td></tr><tr><td>Lieferadresse</td><td>Lief. an Adresse</td></tr></tbody></table>
{% endcolumn %}

{% column width="50%" %}

#### Auftragspositionen

<table><thead><tr><th width="145.5789794921875">Shopware-Feld</th><th width="129.7587890625">BC-Feld</th></tr></thead><tbody><tr><td>Artikelnummer</td><td>Nr.</td></tr><tr><td>Artikelname</td><td>Beschreibung</td></tr><tr><td>Menge</td><td>Menge</td></tr><tr><td>Einzelpreis</td><td>VK-Preis</td></tr><tr><td>MwSt.</td><td>MwSt.-%</td></tr></tbody></table>
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column width="83.33333333333334%" %}

#### Zusätzliche Daten

* **Versandkosten:** Werden als separate Position angelegt.
* **Rabatte:** Werden als Positionsrabatte oder Gutscheine verarbeitet.
* **Zahlungsinformationen:** Zahlungsmethode wird zugeordnet.
  {% endcolumn %}

{% column width="16.666666666666657%" %}

{% endcolumn %}
{% endcolumns %}

### 3. Bestellstatus-Filter

Sie können filtern, welche Bestellungen importiert werden:

<table><thead><tr><th width="112.2662353515625">Status</th><th width="149.1549072265625">Beschreibung</th><th width="165.56591796875">Import empfohlen</th></tr></thead><tbody><tr><td>open</td><td>Neue Bestellung</td><td>✅ Ja</td></tr><tr><td>in_progress</td><td>In Bearbeitung</td><td>✅ Ja</td></tr><tr><td>completed</td><td>Abgeschlossen</td><td>⚠️ Optional</td></tr><tr><td>cancelled</td><td>Storniert</td><td>❌ Nein</td></tr></tbody></table>

### Häufige Fragen

#### Als welcher Belegtyp wird eine Shopware-Bestellung in Business Central angelegt?

Das steuert die Konfigurationsoption „Download Order As“: Angebot (Quote), Auftrag (Order) oder Rechnung (Invoice). Der Beleg wird nur automatisch erzeugt, wenn zusätzlich „Generate Sales Order“ aktiv ist. Der verwendete Nummernkreis stammt aus „Sales Ord No.Series“, der Lagerort aus „Ord Download Location“.

#### Woran erkenne ich in Business Central, aus welcher Shopware-Bestellung ein Beleg stammt?

Der Connector hinterlegt am Verkaufsbeleg die Felder „SOUSHW Web Order ID“, „Web Order No“ und „Web Order Auto Increment“. Zusätzlich wird die externe Belegnummer im Format `SW:{Bestellnummer}` gesetzt, sodass sich jede BC-Bestellung eindeutig der Shopware-Bestellung zuordnen lässt.

#### Wie wird der Kunde einer Bestellung zugeordnet?

Der Connector lädt den Shopware-Kunden per `customer/{id}` und sucht den passenden Debitor über die „SOUSHW Web ID“ oder – abhängig von „Cust. Mapping Type“ – über E-Mail, Telefon oder Mobilnummer. Gastbestellungen laufen auf den „Default Guest Cust.“; ist „Create Unknown Cust.“ aktiv, wird bei fehlendem Treffer ein neuer Debitor aus der „Cust. Template“ angelegt.


# Auftragsbearbeitung in BC

Erfahren Sie, wie Sie importierte Bestellungen in Business Central bearbeiten.

Nach dem Import werden Shopware-Bestellungen als **Verkaufsaufträge** in Business Central angelegt und können dort bearbeitet werden.

## 1. Importierte Aufträge

### 1.1 Auftrag finden

{% stepper %}
{% step %}
Über *Verkauf* <i class="fa-right">:right:</i> *Verkaufsaufträge* <i class="fa-right">:right:</i> Filter auf externe Belegnummer

<div align="left" data-with-frame="true"><figure><img src="/files/qogEcu7D3N5VXpktevK1" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Über *Shopware* <i class="fa-right">:right:</i> *Bestell Übersicht* <i class="fa-right">:right:</i> Auftrag öffnen

<div align="left" data-with-frame="true"><figure><img src="/files/JhA61ThRx1pOLU3B4BUx" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Über die Suche nach der Shopware-Bestellnummer suchen.
{% endstep %}
{% endstepper %}

### 1.2 Auftragskarte

Die Auftragskarte enthält:

<table data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><p><strong>Allgemein</strong>:</p><p>Kunden- und Auftragsdaten</p></td></tr><tr><td><p><strong>Positionen</strong>:</p><p>Bestellte Artikel</p></td></tr><tr><td><p><strong>Shopware</strong>:</p><p>Zusätzliche Shopware-Informationen (Bestellnummer, Status)</p></td></tr></tbody></table>

<div align="left" data-with-frame="true"><figure><img src="/files/NVXkxoYNZzfTcV4Qjghq" alt=""><figcaption></figcaption></figure></div>

<div align="left" data-with-frame="true"><figure><img src="/files/7qqpzYBGCZVdRHrooMFX" alt=""><figcaption></figcaption></figure></div>

## 2. Auftragsbearbeitung

<table data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><h3>Positionen prüfen</h3><p>Öffnen Sie den Auftrag.</p><p>Prüfen Sie die <strong>Zeilen</strong>:</p><ul><li>Artikelnummern korrekt?</li><li>Mengen und Preise stimmen?</li><li>Alle Artikel verfügbar?</li></ul></td></tr><tr><td><h3>Verfügbarkeit</h3><p>Bei Nichtverfügbarkeit:</p><ul><li>Teillieferung erstellen.</li><li>Liefertermin mit Kunde abstimmen.</li><li>Ggf. Artikel nachbestellen.</li></ul></td></tr><tr><td><h3>Anpassungen</h3><p>Sie können den Auftrag anpassen:</p><ul><li>Positionen hinzufügen oder entfernen.</li><li>Preise anpassen.</li><li>Rabatte gewähren.</li></ul></td></tr></tbody></table>

{% hint style="warning" %}
Änderungen am Auftrag werden **nicht** automatisch zu Shopware zurückgespielt!
{% endhint %}

<div align="left" data-with-frame="true"><figure><img src="/files/afi5NmrRhlTQdpFagOWj" alt=""><figcaption></figcaption></figure></div>

## 3. Lieferung erstellen und Rechnung erstellen

### 3.1 Warenausgang buchen

{% stepper %}
{% step %}
*Verkaufsauftrag* öffnen.
{% endstep %}

{% step %}
Wählen Sie eine Form des "*Buchen"s aus*.
{% endstep %}

{% step %}
Wählen Sie im neu geöffneten Fenster *eine* der drei Auswahlmöglichkeiten aus. Nur *"Liefern"* oder nur *"Fakturieren"* oder *"Liefern und fakturieren"*. Mit *"OK"* bestätigen.
{% endstep %}
{% endstepper %}

<div align="left"><figure><img src="/files/fPhlfXmVK3Rl4nOePRbn" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="/files/VfN1CVq0yg0t2Gb4Mrit" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="info" %}

### Rechnung erstellen - Rechnung buchen

Für die Buchung einer Rechnung gehen Sie zunächst genauso vor wie unter *"3.1 Warenausgang buchen"* beschrieben.

Wählen Sie im letzten Schritt jedoch die Option *"Fakturieren"* aus und bestätigen Sie den Vorgang anschließend mit *"OK"*.
{% endhint %}

{% hint style="info" %}

### Rechnung erstellen - Kombiniert buchen

Der unter *"3.1 Warenausgang buchen"* beschriebene Schritt bildet die Grundlage für den folgenden Vorgang.

Um die Lieferung und die Rechnung in einem Schritt zu erstellen, wählen Sie die Option *"Liefern und Fakturieren"* aus. Bestätigen Sie den Vorgang anschließend mit *"OK"*.

Die gebuchte Rechnung finden Sie danach unter *"Gebuchte Verkaufsrechnungen"*.
{% endhint %}

### 3.2 Tracking-Informationen

Falls *Tracking-Nummern* vorhanden sind, öffnen Sie zunächst den entsprechenden *Auftrag*. Navigieren Sie anschließend zu *"Zeilen" → "Zeile" → "Artikelverfolgungszeilen"*, um die Tracking-Informationen einzusehen oder zu ergänzen.

Alternativ können Sie die Paketnummer direkt in das dafür vorgesehene Feld eintragen.

<div align="left" data-with-frame="true"><figure><img src="/files/mSU0TxwPPAqhzdxzZ8ka" alt=""><figcaption></figcaption></figure></div>

## 4. Gutschrift erstellen

Bei Retouren oder Reklamationen:

{% stepper %}
{% step %}
Öffnen Sie den *gebuchten Auftrag* oder die *gebuchte Rechnung* (diese dürfen noch nicht geschlossen sein).
{% endstep %}

{% step %}
Klicken Sie auf *"Korrigieren"* und im Dropdown Menü *"Korrekturgutschrift erstellen"*.
{% endstep %}

{% step %}
Passen Sie die Positionen an.
{% endstep %}

{% step %}
Buchen Sie die Gutschrift. Für die Erklärung dieses Schrittes siehe: [3. Lieferung erstellen und Rechnung erstellen](#id-3.-lieferung-erstellen-und-rechnung-erstellen).
{% endstep %}
{% endstepper %}

<div align="left" data-with-frame="true"><figure><img src="/files/Oeh1znxfoIoGqmZ3rXdP" alt="" width="563"><figcaption></figcaption></figure></div>

<details>

<summary><strong>Tipps für den täglichen Umgang</strong></summary>

**Tägliche Routinen**

* **Morgens**: Neue Bestellungen importieren.
* **Vormittags**: Aufträge prüfen und bearbeiten.
* **Mittags**: Lieferungen vorbereiten.
* **Nachmittags**: Rechnungen erstellen.
* **Abends**: Status synchronisieren.

**Dokumentation**

* Notieren Sie Änderungen im Auftrag.
* Dokumentieren Sie Kundenkommunikation.
* Nutzen Sie das Bemerkungsfeld.

**Qualitätskontrolle**

* Prüfen Sie Adressen vor dem Versand.
* Kontrollieren Sie Artikelzuordnungen.
* Überwachen Sie offene Posten.

</details>


# Ersatzartikel-Automatik

Automatisches Ersatzartikel-Handling bei fehlendem Bestand in Verkauf und Umlagerung sowie optionale Shopware-Umschaltung – Einrichtung, Alltag und Fehlerbilder.

Die Ersatzartikel-Automatik verbindet die **Standard-Ersatzartikel** von Business Central mit dem Shopware 6 API Connector. Ziel: Wenn ein bestellter Artikel am Lagerort nicht (ausreichend) verfügbar ist, wird ein hinterlegter Ersatzartikel vorgeschlagen bzw. angewendet – im Verkauf, optional bei Umlagerungen und bei Bedarf auch im Shop.

{% hint style="info" %}
Voraussetzung ist eine **aktive** Shopware-Konfiguration (`Aktivieren`) **und** der Schalter **Ersatzartikel-Automatik aktivieren**. Ohne beide Einstellungen greift die Logik nicht.
{% endhint %}

## Was löst die Automatik?

| Situation                                            | Was passiert                                                           |
| ---------------------------------------------------- | ---------------------------------------------------------------------- |
| Shopware-Bestellung wird als Verkaufsauftrag erzeugt | Verfügbarkeit prüfen, Zeile ersetzen oder splitten (wenn konfiguriert) |
| Verkaufsauftrag wird freigegeben                     | dieselbe Prüfung optional auch für manuell erfasste Aufträge           |
| Mitarbeiter tippt Artikel/Menge ein                  | Warnung mit Ersatzvorschlag **oder** sofortiger Austausch              |
| Umlagerung (z. B. Filial-Bestellportal)              | analog zum Verkauf, wenn die Umlagerungs-Schalter aktiv sind           |
| Bestand unter Schwelle (Shop)                        | Auslaufartikel im Shop anpassen, Ersatzartikel veröffentlichen         |

So vermeiden Sie leere Lieferversprechen im Shop und halten Aufträge ohne manuelles Suchen nach Alternativen beweglich.

## Überblick

```mermaid
flowchart TD
  A[Bestellung / Erfassung / Freigabe] --> B{Bestand Original ausreichend?}
  B -->|Ja| C[Zeile unverändert]
  B -->|Nein| D{Ersatzartikel hinterlegt und verfügbar?}
  D -->|Nein| E[Keine Änderung / Protokoll]
  D -->|Ja| F{Auftragszeilen teilen?}
  F -->|Ja| G[Original behält verfügbare Menge<br/>Fehlmenge als Ersatzzeile]
  F -->|Nein| H[Komplette Zeile auf Ersatzartikel]
  G --> I[Optional Hinweiszeile + Protokoll]
  H --> I
```

### Wie wird der „beste“ Ersatzartikel gewählt?

Bei mehreren Einträgen in der BC-Tabelle **Ersatzartikel** bewertet die Automatik Kandidaten u. a. nach:

1. **Shopware-Priorität** (niedriger Wert = bevorzugt)
2. Kennzeichen **Austauschbar** (Bonus, wenn gewünscht)
3. **Verfügbarkeit** am relevanten Lagerort (volle Deckung der Fehlmenge bevorzugt)
4. optional gleiche **Basiseinheit** / **Artikelkategorie**
5. optional höchster Bestand, wenn **nach Verfügbarkeit sortieren** aktiv ist

Über **Maximale Ersatzartikel-Stufen** kann eine Kette verfolgt werden (A→B→C), falls der direkte Ersatz selbst keinen ausreichenden Bestand hat.

{% hint style="info" %}
Die Auswahl ist **regelbasiert** (Stammdaten + Bestand + Konfiguration), nicht über Copilot/KI. Für Marketingtexte oder Rich Content am Artikel nutzen Sie die separaten KI-/Copilot-Funktionen der Stammdatenverwaltung – die ersetzen keine Ersatzartikel-Pflege.
{% endhint %}

## Einrichtung

### 1. Konfiguration öffnen

{% stepper %}
{% step %}
Öffnen Sie die **Shopware-Konfiguration** (z. B. über die Suche oder das Shopware-Menü).
{% endstep %}

{% step %}
Wechseln Sie in den **Bearbeitungsmodus**.
{% endstep %}

{% step %}
Öffnen Sie den FastTab **Ersatzartikel**.
{% endstep %}

{% step %}
Aktivieren Sie **Ersatzartikel-Automatik aktivieren**.
{% endstep %}
{% endstepper %}

<figure><img src="/files/EqLlBc9W4c9QyQxXGmxT" alt="Einstellungen Ersatzartikel Belegverarbeitung"><figcaption><p>FastTab Ersatzartikel – Belegverarbeitung</p></figcaption></figure>

### 2. Belegverarbeitung

| Einstellung                                         | Wirkung                                                                                                                                                                     |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Bei Auftragsimport anwenden**                     | Beim Erzeugen des Verkaufsauftrags aus Shopware wird die Verfügbarkeit geprüft und ggf. ausgetauscht/gesplittet.                                                            |
| **Bei Freigabe von Verkaufsaufträgen anwenden**     | Dieselbe Prüfung beim Freigeben manuell erfasster Aufträge.                                                                                                                 |
| **Prüfen bei Eingabe der Artikelnr.**               | Bei manueller Artikelerfassung wird geprüft und ggf. gewarnt.                                                                                                               |
| **Prüfen bei Mengenänderung**                       | Gleiche Prüfung bei Mengenänderung.                                                                                                                                         |
| **Bei manueller Erfassung warnen**                  | Zeigt eine Bestandswarnung mit Ersatzartikel-Hinweis; der Anwender entscheidet.                                                                                             |
| **Bei manueller Erfassung automatisch austauschen** | Tauscht bei manueller Erfassung sofort aus (ohne nur zu warnen).                                                                                                            |
| **Auf Umlagerungsaufträge anwenden**                | Aktiviert die Logik auch für Umlagerungen (z. B. Filial-Bestellportal).                                                                                                     |
| **Bei Freigabe von Umlagerungsaufträgen anwenden**  | Prüfung beim Freigeben der Umlagerung.                                                                                                                                      |
| **Auftragszeilen teilen**                           | Bei Teilbestand bleibt die Originalzeile mit verfügbarer Menge; die Fehlmenge wird als eigene Ersatzzeile ergänzt. Ist die Option aus, wird die komplette Zeile umgestellt. |
| **Verfügbarkeitsbasis**                             | `Lagerbestand` / abzüglich Reservierungen / abzüglich offener Verkaufsaufträge.                                                                                             |
| **Lagerort für Verfügbarkeit**                      | Fallback-Lagerort, wenn die Zeile keinen Lagerort hat.                                                                                                                      |
| **Nur austauschbare Ersatzartikel**                 | Nur Einträge mit Kennzeichen **Austauschbar**.                                                                                                                              |
| **Gleiche Basiseinheit bevorzugen**                 | Bevorzugt Ersatzartikel mit gleicher Basiseinheit.                                                                                                                          |
| **Gleiche Artikelkategorie bevorzugen**             | Bevorzugt dieselbe Artikelkategorie.                                                                                                                                        |
| **Ersatzartikel nach Verfügbarkeit sortieren**      | Bei mehreren Kandidaten den mit dem höchsten Bestand.                                                                                                                       |
| **Debitorenfreigabe für Ersatzartikel beachten**    | Respektiert das Debitorenfeld **Ersatzartikel zulassen**.                                                                                                                   |
| **Maximale Ersatzartikel-Stufen**                   | Wie tief eine Ersatzkette verfolgt wird (A→B→C).                                                                                                                            |
| **Preis des Ersatzartikels**                        | Preisfindung über BC-Preislisten oder Preis der Originalzeile beibehalten.                                                                                                  |
| **Mengenstaffel aus Gesamtmenge**                   | Bei Split wird die Staffel aus der ursprünglichen Gesamtmenge berechnet.                                                                                                    |
| **Standard-Austauschgrundcode**                     | Optionaler Grundcode auf der Zeile (z. B. `NO-STOCK`).                                                                                                                      |
| **Hinweiszeile einfügen**                           | Textzeile für Lieferschein/Rechnung. Platzhalter: `%1` Original, `%2` Ersatz.                                                                                               |
| **Ersatzartikel-Protokoll schreiben**               | Schreibt Einträge ins Ersatzartikel-Protokoll.                                                                                                                              |

{% hint style="warning" %}
**Empfohlen für den Alltag:** Automatik aktiv, Import + Freigabe, Zeilen teilen, manuell **warnen** (ohne Auto-Austausch), Protokoll an. So bleibt die Kontrolle bei manueller Erfassung über FactBox und Aktion **Ersatzartikel prüfen**.
{% endhint %}

### 3. Shopware-Umschaltung

Die Shop-Umschaltung ist **getrennt** von der Beleglogik: Sie steuert, was im Shop sichtbar/kaufbar ist, wenn der Auslaufartikel unter die Schwelle fällt.

<figure><img src="/files/2GH2TZJHdl7mAztWGW1V" alt="Einstellungen Shopware-Umschaltung"><figcaption><p>FastTab Ersatzartikel – Shopware-Umschaltung und Protokoll</p></figcaption></figure>

| Einstellung                                     | Wirkung                                                                                     |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------- |
| **Automatische Shop-Umschaltung**               | Steuert, ob bei Unterbestand der Shop umgestellt wird.                                      |
| **Aktion für den Originalartikel**              | z. B. deaktivieren, als nicht vorrätig kennzeichnen oder nicht mehr als Web-Artikel führen. |
| **Ersatzartikel im Shop veröffentlichen**       | Ersatzartikel aktiv/webfähig setzen.                                                        |
| **Shopware-Kategorien übernehmen**              | Kategorien des Originals ergänzen.                                                          |
| **Verkaufskanäle übernehmen**                   | Dieselben Verkaufskanäle zuweisen.                                                          |
| **Web-Einstellungen übernehmen**                | u. a. Bild-Upload-/Bestandsindikatoren (keine SEO-/Beschreibungstexte).                     |
| **Artikel sofort hochladen**                    | Sofortiger Upload statt Warten auf den Zeitplan.                                            |
| **Originalartikel parallel abverkaufen**        | Original bleibt online, solange Restbestand vorhanden ist.                                  |
| **Umschalten bei Bestand kleiner gleich**       | Schwellenwert für die Umschaltung.                                                          |
| **Originalartikel automatisch zurückstellen**   | Bei wieder vorhandenem Bestand Original erneut veröffentlichen.                             |
| **Zurückstellen bei Bestand größer gleich**     | Schwellenwert für die Rückstellung.                                                         |
| **Originalartikel auf Verkauf gesperrt setzen** | Zusätzlich BC-Verkaufssperre.                                                               |
| **Shop nach dem Buchen prüfen**                 | Nach Lieferung/Rechnung Shop-Status prüfen.                                                 |

{% hint style="danger" %}
**Artikel sofort hochladen** wirkt auf den angebundenen Shop. Für Tests und Abnahmen zuerst **ohne** Sofort-Upload arbeiten und die Aktion **Shop-Umschaltung jetzt prüfen** / **Shop-Umschaltung jetzt ausführen** bewusst auslösen.
{% endhint %}

### Empfohlene Konfigurationsprofile

| Profil                     | Typische Schalter                                                                                         | Geeignet für                       |
| -------------------------- | --------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| **Sicher starten**         | Import + Freigabe an, manuell nur warnen, Split an, Protokoll an, Shop-Switch aus oder ohne Sofort-Upload | Go-Live / Pilot                    |
| **Volle Automatik Belege** | wie oben, zusätzlich Auto-Austausch bei manueller Erfassung                                               | hohe Vertrauensbasis in Stammdaten |
| **Omnichannel inkl. Shop** | Belegprofil + Shop-Switch, Parallelverkauf optional, Schwellen bewusst setzen                             | Auslaufsteuerung im Shop           |

## Stammdaten: Ersatzartikel pflegen

Ohne gepflegte BC-Ersatzartikel kann die Automatik nichts anwenden.

{% stepper %}
{% step %}
Öffnen Sie die **Artikelkarte** des Originalartikels (Auslaufartikel).
{% endstep %}

{% step %}
Menü **Artikel** → **Ersatzartikel**.
{% endstep %}

{% step %}
Erfassen Sie den Ersatzartikel (Standard-BC) und die Shopware-Erweiterungsfelder.
{% endstep %}

{% step %}
Prüfen Sie den **Bestand des Ersatzartikels am relevanten Lagerort** (nicht nur den Gesamtbestand).
{% endstep %}
{% endstepper %}

| Feld                                                           | Bedeutung                                                      |
| -------------------------------------------------------------- | -------------------------------------------------------------- |
| **Bestand Ersatzartikel**                                      | Anzeige des Bestands des Ersatzartikels                        |
| **Shopware Automatik-Umschaltung**                             | Dieser Eintrag darf für die Shop-Umschaltung genutzt werden    |
| **Shopware-Daten übernehmen**                                  | Kategorien/Kanäle/Web-Einstellungen beim Umschalten übernehmen |
| **Original parallel abverkaufen**                              | Abweichend zur Konfiguration pro Eintrag steuerbar             |
| **Shopware Priorität**                                         | Reihenfolge (niedriger Wert zuerst)                            |
| **Shopware Umschaltstatus / umgeschaltet am / letzte Meldung** | Status der letzten Umschaltung                                 |

<figure><img src="/files/zdZk0csyIAnCTLIbfnjx" alt="Ersatzartikel mit Shopware-Feldern"><figcaption><p>Ersatzartikel-Eintrag mit Shopware-Spalten und Aktion „Shop-Umschaltung jetzt prüfen“</p></figcaption></figure>

Zusätzlich auf der Artikelkarte:

* Aktion **Ersatzartikel (Shopware)** / **Shop-Umschaltung prüfen** für den Artikel

{% hint style="warning" %}
Ein Ersatz mit Bestand „irgendwo im Unternehmen“, aber **0 am Lagerort der Zeile** (z. B. `HAUPT`), gilt für die Belegautomatik als nicht verfügbar. Immer den Lagerort der Auftragszeile / den Fallback aus der Config mitdenken.
{% endhint %}

## Debitor: Ersatzartikel zulassen

Auf der Debitorenkarte (Shopware-Informationen) gibt es das Feld **Ersatzartikel zulassen**.

* Ist in der Konfiguration **Debitorenfreigabe für Ersatzartikel beachten** aktiv und der Debitor lässt keine Ersatzartikel zu, unterbleibt der automatische Austausch (mit Hinweis).
* Für Tests und Standardkunden das Feld freigeben.
* Für B2B-Kunden mit festen Spezifikationen das Feld bewusst gesperrt lassen.

<figure><img src="/files/9kd4R72cr6MBBgjufurB" alt="Debitor Ersatzartikel zulassen"><figcaption><p>Debitorenkarte – Shopware-Informationen: Ersatzartikel zulassen</p></figcaption></figure>

## Arbeit am Verkaufsauftrag

### Automatisch (Import / Freigabe)

Wenn die jeweiligen Schalter aktiv sind:

1. Verfügbarkeit des Originals am Lagerort prüfen
2. passenden Ersatzartikel ermitteln (Priorität, Verfügbarkeit, optional austauschbar/UoM/Kategorie)
3. Zeile ersetzen oder splitten
4. Felder setzen, u. a. Originalartikelnummer und Kennzeichen „Austausch angewendet“
5. optional Hinweiszeile und Protokolleintrag

Bereits ausgetauschte Zeilen (`Austausch angewendet` = Ja) werden bei erneuter Prüfung übersprungen.

### Manuell (Warnung + FactBox)

1. Artikel mit fehlendem Bestand erfassen
2. Bei aktiver Warnung erscheint ein Hinweis mit Original-, Bestands- und Ersatzdaten
3. Rechts in der FactBox **Ersatzartikel** sehen Sie Vorschlag und Verfügbarkeit
4. Aktion **Ersatzartikel anwenden** (FactBox/Zeile) führt Split/Austausch aus
5. Alternativ am Auftragskopf: **Ersatzartikel prüfen** für alle geeigneten Zeilen

<figure><img src="/files/wUcyE8RY24dXsHEU6Qzw" alt="Meldung Ersatzartikel umgestellt"><figcaption><p>Meldung nach „Ersatzartikel prüfen“</p></figcaption></figure>

<figure><img src="/files/wUcyE8RY24dXsHEU6Qzw" alt="Auftragszeile nach Austausch"><figcaption><p>Zeile nach dem Austausch: Ersatzartikel in der Nr., Originalartikelnr. und Kennzeichen in der FactBox</p></figcaption></figure>

### Sichtbare Zeilenfelder

* **Originalartikelnr.** – vorher bestellter Artikel
* **Austausch angewendet** – Kennzeichen der Automatik
* **Austauschhinweis / Quelle / Grundcode** – je nach Konfiguration und UI

Dieselben Informationen stehen auch auf gebuchten Liefer-/Rechnungszeilen zur Verfügung (TransferFields).

## Umlagerungsaufträge

Analog zum Verkauf, wenn aktiviert:

* Prüfung bei Freigabe
* Aktion **Ersatzartikel prüfen** am Umlagerungsauftrag
* FactBox / Anwenden auf der Zeile
* Felder Originalartikel / Substituiert auf der Umlagerungszeile

{% hint style="info" %}
Nur die Warnung bei Erfassung reicht nicht für den automatischen Austausch: Dafür muss **Auf Umlagerungsaufträge anwenden** (und ggf. Freigabe) in der Shopware-Konfiguration aktiv sein. Maßgeblich ist der Bestand am **Umlag. von**-Lagerort.
{% endhint %}

## Shopware-Umschaltung im Betrieb

Auslöser können sein:

* Aktion **Shop-Umschaltung jetzt prüfen** am Ersatzartikel-Eintrag oder Artikel
* Aktion **Shop-Umschaltung jetzt ausführen** in der Shopware-Konfiguration (Menü Ersatzartikel)
* automatische Prüfung nach Buchung (wenn konfiguriert)
* Unterschreiten / Überschreiten der Schwellenwerte

Typischer Ablauf bei Unterbestand:

1. Originalartikel gemäß **Aktion für den Originalartikel** behandeln
2. Ersatzartikel veröffentlichen und Kanäle/Kategorien übernehmen
3. optional parallel abverkaufen
4. Status/Meldung am Ersatzartikel-Eintrag aktualisieren
5. bei Bestandsrückkehr optional Original zurückstellen

{% hint style="warning" %}
SEO-/Beschreibungstexte werden bewusst **nicht** 1:1 vom Original übernommen. Produkttexte und ggf. KI-generierte Marketingtexte am Ersatzartikel separat pflegen bzw. prüfen.
{% endhint %}

## Protokoll

Seite **Shopware Ersatzartikel-Protokoll** enthält u. a.:

* Zeitpunkt, Quelle (Import, Freigabe, manuell, Shop-Switch, …)
* Original- und Ersatzartikel
* bestellte / ausgetauschte / verfügbare Menge
* Belegbezug (z. B. Verkaufsauftragsnr.)
* Meldung / Protokolltyp (Erfolg, kein Ersatz gefunden, Fehler, …)

Nutzen Sie das Protokoll für Support, Audits und zum Nachvollziehen von Shop-Umschaltungen.

## Empfohlener Testablauf

1. Konfiguration wie oben aktivieren (**ohne** Sofort-Upload).
2. Originalartikel mit **0 Bestand** am Lagerort, Ersatzartikel mit Bestand und Eintrag in **Ersatzartikel**.
3. Debitor mit **Ersatzartikel zulassen**.
4. Verkaufsauftrag mit Originalartikel und Menge > 0 anlegen.
5. Aktion **Ersatzartikel prüfen** bzw. FactBox → anwenden.
6. Zeilen (Split/Ersatz), Hinweiszeile und Protokoll kontrollieren.
7. Optional: **Shop-Umschaltung jetzt prüfen/ausführen** und Statusfelder prüfen.

### Live-Testergebnis (Beispielumgebung)

| Schritt         | Ergebnis                                                                                                 |
| --------------- | -------------------------------------------------------------------------------------------------------- |
| Stammdaten      | Original ohne Bestand → Ersatz mit Bestand am Lagerort HAUPT                                             |
| Debitor         | **Ersatzartikel zulassen** aktiv                                                                         |
| Verkaufsauftrag | Manuelle Warnung; **Ersatzartikel prüfen** → Zeile auf Ersatzartikel, FactBox: Austausch angewendet = Ja |
| Hinweiszeile    | Textzeile mit Original- und Ersatzartikelnummer                                                          |
| Protokoll       | Eintrag „Auftragszeile ausgetauscht“ mit Belegbezug                                                      |
| Umlagerung      | Manuelle Warnung mit Ersatzvorschlag; Automatik nur mit Schalter **Auf Umlagerungsaufträge anwenden**    |

### Beispielmeldungen

Bei fehlendem Bestand erscheint z. B.:

> Artikel 1988-S hat am Lagerort HAUPT nur 0 verfügbar (bestellt: 2). Ersatzartikel 1936-S (BERLIN Gästestuhl, gelb) hat 40 verfügbar. Nutzen Sie „Ersatzartikel anwenden“, um die Zeile zu ersetzen oder zu teilen.

Ist die Debitorenfreigabe aktiv und der Debitor sperrt Ersatzartikel:

> Debitor 10000 lässt keine Ersatzartikel zu.

Nach erfolgreicher Prüfung/Anwendung:

> 1 Auftragszeile(n) wurden auf Ersatzartikel umgestellt.

## Häufige Fragen (FAQ)

<details>

<summary>Wird der Kunde in Shopware über den Austausch informiert?</summary>

Die Belegautomatik arbeitet in Business Central. Ob und wie der Kunde informiert wird (E-Mail, Hinweis auf dem Beleg), hängt von Ihrer Prozessgestaltung und der Hinweiszeile ab. Die Shop-Umschaltung ändert die Shop-Darstellung, ersetzt aber keine Kundenkommunikation zu bereits abgeschlossenen Bestellungen.

</details>

<details>

<summary>Was passiert mit dem Preis?</summary>

Je nach Einstellung bleibt der Preis der Originalzeile erhalten oder es greift die normale BC-Preisfindung für den Ersatzartikel. Mit **Mengenstaffel aus Gesamtmenge** kann bei Split die Staffel aus der ursprünglichen Gesamtmenge berechnet werden.

</details>

<details>

<summary>Kann ich den Austausch rückgängig machen?</summary>

Eine einmal ausgetauschte Zeile wird von der Automatik nicht erneut angefasst. Manuell können Sie die Zeile in BC korrigieren (Artikelnr./Menge). Für den Shop setzen Sie ggf. Umschaltstatus zurück bzw. nutzen die Rückstell-Logik bei wieder vorhandenem Bestand.

</details>

<details>

<summary>Warum greift die Umlagerungsaktion nicht, obwohl die Warnung erscheint?</summary>

Die Warnung kommt aus der manuellen Erfassungsprüfung. Der automatische Austausch über **Ersatzartikel prüfen** benötigt zusätzlich **Auf Umlagerungsaufträge anwenden** in der Konfiguration.

</details>

<details>

<summary>Ist das eine KI-Funktion?</summary>

Nein. Die Ersatzartikel-Automatik ist eine **deterministische Regel-Engine** auf Basis von BC-Ersatzartikeln, Bestand und Konfiguration. Copilot/KI-Funktionen (z. B. Marketingtext) sind davon unabhängig und ersetzen keine Ersatzartikel-Stammdaten.

</details>

## Fehlerbilder

| Symptom                            | Mögliche Ursache                                                                                                                              |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Keine Automatik                    | Konfiguration nicht aktiv oder **Ersatzartikel-Automatik** aus                                                                                |
| FactBox: Automatik nicht aktiviert | Keine passende Config mit `Aktivieren` + Automatik                                                                                            |
| Kein Austausch                     | Kein Ersatzartikel, Bestand Ersatz am Lagerort = 0, Debitor sperrt, nur austauschbar ohne Haken                                               |
| Falscher Ersatz gewählt            | Priorität, Verfügbarkeitssortierung oder Kettenstufe prüfen                                                                                   |
| Shop ändert sich nicht             | Shop-Umschaltung aus, Eintrag ohne **Shopware Automatik-Umschaltung**, Schwelle nicht erreicht, Sofort-Upload aus und Job noch nicht gelaufen |
| Unerwünschte Shop-Änderung         | Sofort-Upload / Auto-Switch in produktiver Config – Schalter prüfen                                                                           |
| Zeile wird nicht erneut geprüft    | Kennzeichen **Austausch angewendet** bereits gesetzt                                                                                          |

## Siehe auch

* [Auftragsbearbeitung in BC](/shopware/bestellabwicklung/auftragsbearbeitung-in-business-central)
* [Bestelleingang aus Shopware in BC](/shopware/bestellabwicklung/bestelleingang-aus-shopware-in-bc)
* [Lagerbestände](/shopware/preis-und-bestandsmanagement/lagerbestande)
* [KI-Unterstützung (Copilot)](/shopware/stammdatenverwaltung/ki-unterstutzung-copilot)


# Statusrückmeldung an Shopware

Erfahren Sie, wie Sie Bestellstatus-Updates an Shopware zurückmelden.

Nach der Bearbeitung in Business Central können Sie den Bestellstatus an Shopware zurückmelden, sodass Ihre Kunden den aktuellen Status ihrer Bestellung sehen können.

**1. Status-Synchronisation**

{% stepper %}
{% step %}
**Unterstützte Status**

<table><thead><tr><th width="142.5753173828125">BC-Status</th><th width="161.9122314453125">Shopware-Status</th><th width="226.3936767578125">Beschreibung</th></tr></thead><tbody><tr><td>In Bearbeitung</td><td>in_progress</td><td>Auftrag wird bearbeitet</td></tr><tr><td>Geliefert</td><td>shipped</td><td>Ware wurde versendet</td></tr><tr><td>Abgeschlossen</td><td>completed</td><td>Vollständig abgeschlossen</td></tr><tr><td>Storniert</td><td>cancelled</td><td>Bestellung storniert</td></tr></tbody></table>
{% endstep %}

{% step %}
**Manuelle Statusmeldung**

1. Öffnen Sie den *Verkaufsauftrag* oder die *Bestellübersicht***.**
2. Klicken Sie auf *"<mark style="background-color:yellow;">Status zu Shopware melden</mark>"*.
3. Der aktuelle Status wird übertragen.
   {% endstep %}

{% step %}
**Automatische Statusmeldung**

Bei bestimmten Aktionen wird der Status automatisch gemeldet:

* **Lieferung gebucht** → Status "shipped"
* **Rechnung gebucht** → Status "completed"
  {% endstep %}
  {% endstepper %}

{% hint style="info" %}
Die automatische Statusmeldung kann in den Einstellungen aktiviert/deaktiviert werden.
{% endhint %}

**2. Tracking-Informationen**

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Paketnummer übermitteln</strong></td><td><ol><li>Öffnen Sie die <em>geb. Verkaufslieferung</em>.</li><li>Tragen Sie die <em>Paketnummer</em> ein.</li><li>Melden Sie den Status zu Shopware <em>"PDF zu Shopware hochladen"</em>.</li></ol></td></tr><tr><td><strong>Mehrere Pakete</strong></td><td><p>Bei Teillieferungen mit mehreren Paketen:</p><ol><li>Erstellen Sie mehrere Lieferungen.</li><li>Jede Lieferung erhält ihre eigene Paketnummer.</li><li>Alle Tracking-Informationen werden übertragen.</li></ol></td></tr></tbody></table>

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FSFSmn9X4bVuD7ReZmuVi%2FBildschirmfoto%202026-07-06%20um%2010.08.26.png?alt=media&#x26;token=4a035991-e70d-454f-bc6c-07407dc3174a" alt="" width="563"><figcaption></figcaption></figure></div>

**3. Shopware-Kundenbenachrichtigung**

Nach der Statusmeldung:

1. Shopware aktualisiert den Bestellstatus.
2. Kunde erhält ggf. eine E-Mail-Benachrichtigung.
3. Status ist im Kundenportal sichtbar.

**4. Stornierungen**

**4.1 Bestellung in BC stornieren**

{% stepper %}
{% step %}
Öffnen Sie den "*Verkaufsaufträge"*.
{% endstep %}

{% step %}
Klicken Sie auf *"Löschen"* oder Archivieren
{% endstep %}

{% step %}
Der Status wird als "cancelled" an Shopware gemeldet.
{% endstep %}
{% endstepper %}

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FoooSZtGK6GC3pI4PBtwD%2FBildschirmfoto%202026-06-11%20um%2010.07.38.png?alt=media&#x26;token=07065c81-065d-451e-9a89-33aef052e03b" alt=""><figcaption></figcaption></figure></div>

**4.2 Stornierung aus Shopware**

Wenn ein Kunde seine Bestellung in Shopware storniert, wird die Stornierung beim *nächsten Bestellimport automatisch erkannt*. Der zugehörige Auftrag in BC kann anschließend entsprechend bearbeitet werden. Je nach Bearbeitungsstand der Bestellung ***kann** zusätzlich die Erstellung einer Gutschrift erforderlich sein*.

**5. Retouren**

**5.1 Retoure bearbeiten**

{% stepper %}
{% step %}
Erstellen Sie eine Verkaufsgutschrift.
{% endstep %}

{% step %}
Buchen Sie die Gutschrift.
{% endstep %}

{% step %}
Melden Sie den [Status](#id-1.-status-synchronisation) zu Shopware.
{% endstep %}
{% endstepper %}

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FldC94E0niaqhpPUZenWC%2FBildschirmfoto%202026-06-11%20um%2010.27.15.png?alt=media&#x26;token=7a1380b8-795d-4e17-9e0c-92ce0fb077c2" alt="" width="563"><figcaption></figcaption></figure></div>

**5.2 Wareneingang Retoure**

Erstellen Sie zunächst einen *Einkaufsrücksendeauftrag* oder *buchen* Sie den *Wareneingang* *direkt*. Prüfen Sie anschließend die retournierte Ware sorgfältig und aktualisieren Sie den Bestand entsprechend.

<details>

<summary><strong>Best Practices</strong></summary>

**Zeitnahe Statusmeldung**

* Melden Sie Status zeitnah nach der Aktion.
* Kunden erwarten aktuelle Informationen.
* Reduziert Kundenanfragen.

**Tracking-Informationen**

* Tragen Sie Paketnummern sofort ein.
* Kunden schätzen Sendungsverfolgung.
* Reduziert "Wo ist mein Paket?"-Anfragen.

**Kommunikation**

Bei Problemen oder Verzögerungen:

* Informieren Sie den Kunden proaktiv.
* Nutzen Sie die Shopware-Kommunikationsfunktionen.
* Dokumentieren Sie alles im Auftrag.

</details>

### Häufige Fragen

#### Welche Shopware-Status werden bei Lieferung und Rechnung gesetzt?

Die gesetzten Status sind frei konfigurierbar: „Ord Status On Shipment“ wird bei gebuchter Lieferung gemeldet, „Ord Status on Invoice“ bei gebuchter Rechnung. Beide werden über die Shopware State Machine ausgewählt. Die Rückmeldung erfolgt über den Endpunkt `_action/order`. Bei der Rechnungsmeldung setzt der Connector zusätzlich das Kennzeichen `isShipped`.

#### Kann der Kunde bei einer Statusänderung automatisch benachrichtigt werden?

Ja. Ist „Send Order Status Email“ aktiv, sendet der Connector im Statusaufruf das Flag `sendMail`, sodass Shopware die zugehörige Kunden-E-Mail auslöst. Ohne diese Option wird der Status still (ohne Mail) aktualisiert.

#### Wo sehe ich, ob eine Statusrückmeldung erfolgreich war?

In der Tabelle „SOUSHW Order“ führen die Felder `isShipped`, `isInvoiced`, `Success` und `Status Description` den Rückmeldestatus mit. Details zur Serverantwort finden Sie bei aktivem Developer Log im API Call Log.


# Order-Dashboard & KPIs

Das **Order-Dashboard** ist die zentrale Anlaufstelle für alle aus Shopware geladenen Bestellungen. Es zeigt Status und Kennzahlen und bietet Direktaktionen.

**Angezeigte Informationen**

| Spalte                             | Bedeutung                              |
| ---------------------------------- | -------------------------------------- |
| Bestelldatum / Shopware-Bestellnr. | Herkunft der Bestellung                |
| Auto-Increment                     | Fortlaufende Shopware-Nummer           |
| BC-Auftragsnr.                     | Verknüpfter BC-Beleg (Drilldown)       |
| BC-Kundennr. / Kundenname / E-Mail | Kundenbezug                            |
| Gesamtbetrag                       | Bestellwert                            |
| isShipped / isInvoiced             | Liefer-/Rechnungsstatus zurückgemeldet |
| Erfolg / Statusmeldung             | Ergebnis der Auftragserstellung        |

**Kennzahlen (Cues)**

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Offene Bestellungen</strong></td><td>Noch ohne BC-Auftrag.</td></tr><tr><td><strong>Heute / Woche / Monat</strong></td><td>Bestellvolumen im Zeitraum.</td></tr><tr><td><strong>Fehlgeschlagene</strong></td><td>Bestellungen mit Fehler bei der Auftragserstellung.</td></tr></tbody></table>

**Direktaktionen**

* **Verkaufsauftrag erzeugen** – legt den BC-Beleg an, falls noch nicht vorhanden.
* **Bestellstatus hochladen** – meldet den Status für diese Bestellung an Shopware.
* **Verkaufsauftrag löschen** – entfernt den BC-Beleg und leert die Verknüpfung.
* **Bestellungen herunterladen** – startet den Download.

{% hint style="info" %}
Die Liste ist absteigend nach Auto-Increment sortiert – die neuesten Bestellungen stehen oben.
{% endhint %}


# Auto-Increment & inkrementeller Download

Shopware vergibt für Bestellungen eine fortlaufende Nummer (**Auto-Increment**). Der Connector nutzt diese, um beim Download **nur neue Bestellungen** zu holen.

**Funktionsweise**

* Der Download filtert auf `autoIncrement >= <letzter Wert + 1>`.
* So werden bereits geladene Bestellungen nicht erneut verarbeitet.
* Über **Seite** und **Limit** steuern Sie die Menge pro Lauf.

**Startwert festlegen**

Beim allerersten Download legen Sie mit **Shopware Start-AutoIncrement** fest, ab welcher Bestellung geladen werden soll. So können Sie ältere Alt-Bestellungen bewusst überspringen.

{% stepper %}
{% step %}
**Startwert setzen**

Hinterlegen Sie in der Konfiguration den gewünschten Start-AutoIncrement.
{% endstep %}

{% step %}
**Erstdownload**

Starten Sie den Report *Bestellungen herunterladen*. Der Startwert wird vorgeschlagen.
{% endstep %}

{% step %}
**Laufender Betrieb**

Danach lädt jeder Lauf automatisch ab der zuletzt geladenen Bestellung + 1.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Der Auto-Increment muss beim Download mindestens dem konfigurierten Startwert entsprechen. So verhindern Sie versehentliche Doppelimporte von Alt-Bestellungen.
{% endhint %}

### Häufige Fragen

#### Mit welchem API-Filter lädt der Connector nur neue Bestellungen?

Der Bestell-Download ruft `search/order` (POST) mit einem Bereichsfilter auf dem Feld `autoIncrement` auf (`type=range`, `gte={letzter Wert + 1}`). So werden ausschließlich Bestellungen mit einer höheren Auto-Increment-Nummer geladen; bereits importierte Bestellungen bleiben außen vor. Über „Page“ und „Limit“ (Default 500) wird die Menge pro Lauf gesteuert.

#### Was bewirkt der Startwert „Shopware Opening AutoIncrement“?

Der Startwert legt fest, ab welcher Auto-Increment-Nummer der allererste Download beginnt – so lassen sich Alt-Bestellungen gezielt überspringen. Der Connector stellt sicher, dass der verwendete Auto-Increment mindestens diesem Startwert entspricht, und verhindert damit versehentliche Doppelimporte.

#### Kann der inkrementelle Download automatisch per Job laufen?

Ja. Die Codeunit „SOUSHW Order Mgnt.“ ist Job-Queue-fähig und lädt bei jedem Lauf ab „letzter Auto-Increment + 1“. So holt ein Aufgabenwarteschlangenposten (z. B. alle 15–30 Minuten) automatisch nur die neuen Bestellungen.


# Gastbestellungen

Bestellungen ohne Kundenkonto (Gastbestellungen) können flexibel verarbeitet werden.

**Optionen**

* **Gastkunde anlegen** – für jede Gastbestellung wird ein Kunde erzeugt.
* **Standard-Gastkunde** – Gastbestellungen werden auf einen festen Sammel-Debitor gebucht.

Die genaue Entscheidungslogik ist unter Gastkunden & Standardkunden beschrieben.

{% hint style="success" %}
Ein fester Standard-Gastkunde hält Ihre Debitorenliste schlank und erleichtert Auswertungen.
{% endhint %}


# Marktplatz-Bestellungen

{% hint style="info" %}
Die Marktplatz-Erkennung ist eine erweiterte Funktion und hängt von Ihrer Shop- und Marktplatz-Anbindung ab. Sprechen Sie uns an, ob sie für Ihre Installation verfügbar ist.
{% endhint %}

Werden über Ihren Shop auch **Marktplätze** bedient (z. B. über eine Channable-Integration für Kaufland, Amazon, eBay oder Otto), kann der Connector solche Bestellungen automatisch erkennen.

**Funktionsweise**

* **Marktplatz-Erkennung:** Bestellungen aus Marktplätzen werden identifiziert.
* **Zuordnung:** über die **Marketplace Order ID** und die **Marketplace Source** werden die Bestellungen dem richtigen Ursprung zugeordnet.
* Zusätzlich können Bestellungen gezielt anhand ihrer Bestellnummer heruntergeladen werden.

**Nutzen**

So behalten Sie auch bei mehreren Verkaufskanälen und Marktplätzen den Überblick, welche Bestellung woher stammt – direkt im Order-Dashboard.


# Widerruf & Retoure-Informationen

{% hint style="info" %}
Erweiterte Funktion – abhängig von Ihrer Anbindung. Sprechen Sie uns bei Bedarf an.
{% endhint %}

Zu Bestellungen können **Widerrufsinformationen** bereitgestellt werden – in deutscher Sprache und mit der zugehörigen **SKU** (Artikelnummer). So ist nachvollziehbar, welche Position eines Auftrags von einem Widerruf betroffen ist.

**Nutzen**

* Klare Zuordnung des Widerrufs zur betroffenen Artikelposition.
* Deutschsprachige Ausgabe für die Sachbearbeitung.

{% hint style="success" %}
Kombinieren Sie Widerrufsinformationen mit dem Order-Dashboard, um betroffene Bestellungen schnell zu finden und zu bearbeiten.
{% endhint %}


# Übersicht

Mit dem PDF-Dokument-Modul können Sie Rechnungen, Gutschriften, Lieferscheine und andere Dokumente direkt aus Business Central zu Shopware hochladen.

Das ***PDF-Dokument-Modul*** erweitert den Shopware 6 API Connector um die Möglichkeit, Verkaufsdokumente als PDF-Dateien zu Ihren Kunden in Shopware hochzuladen. Die Dokumente werden im Kundenportal von Shopware angezeigt und können dort heruntergeladen werden.

## 1. Voraussetzungen

### 1.1 Shopware-Plugin

Für die Nutzung dieser Funktion muss das **s*****olutioo Invoice Documents*** Plugin in Ihrem Shopware-Shop installiert sein. Dieses Plugin stellt die API-Endpunkte sowie die Kundenportal-Ansicht bereit.

<a href="/pages/On0GNAWv9skgivX68c9v" class="button primary" data-icon="envelope">Supportkontakt solutioo</a>

{% hint style="warning" %}
Ohne das Shopware-Plugin funktioniert der PDF-Upload aus Business Central nicht!
{% endhint %}

### 1.2 Aktivierung in Business Central

Damit ***PDF-Dokumente*** verwendet und zu Shopware übertragen werden können, muss das PDF-Dokument-Modul zunächst in der *Konfiguration aktiviert werden*.

Öffnen Sie dazu *"Shopware"* <i class="fa-right">:right:</i> *"Einstellung" / "Konfiguration".* Im geöffneten Fenster wechseln Sie in den *"Editier-Modus"* (Klicken Sie hierfür oben auf das Stift Symbol). Aktivieren Sie anschließend im Bereich *"**Shopware Module**"* die Option *"**PDF-Generierung aktivieren**"*.

<div align="left" data-with-frame="true"><figure><img src="/files/llMVgKHkuWOGUPADYPtt" alt="" width="563"><figcaption></figcaption></figure></div>

<div align="left" data-with-frame="true"><figure><img src="/files/vrIG5PAe0l6RhgKPvyQJ" alt="" width="563"><figcaption></figcaption></figure></div>

## 2. Unterstützte Dokumenttypen

<table><thead><tr><th width="137.5133056640625">Dokumenttyp</th><th width="304.95947265625">Beschreibung</th></tr></thead><tbody><tr><td><strong>Rechnung</strong></td><td>Gebuchte Verkaufsrechnungen</td></tr><tr><td><strong>Gutschrift</strong></td><td>Gebuchte Verkaufsgutschriften</td></tr><tr><td><strong>Lieferschein</strong></td><td>Gebuchte Verkaufslieferungen</td></tr><tr><td><strong>Sonstiges</strong></td><td>Manuelle PDF-Uploads und Anhänge</td></tr></tbody></table>

## 3. Übersicht der Funktionen

{% columns %}
{% column %}

### [Einzelupload](/shopware/pdf-dokumente/einzelupload)

* Direkt von der Dokumenten-Karte (Rechnung, Gutschrift, Lieferschein)
* Manueller PDF-Upload für benutzerdefinierte Dokumente.
* Upload von Dokumentenanhängen.
  {% endcolumn %}

{% column %}

### [Massenupload](/shopware/pdf-dokumente/massenupload)

* Von der Dokumenten-Liste (mehrere Dokumente auswählen)
* Über die Debitorenkarte (alle Dokumente eines Kunden)
* Batch-Upload-Report für große Mengen
  {% endcolumn %}
  {% endcolumns %}

{% hint style="info" %}

## Kundenportal in Shopware

Nach dem Upload sind die Dokumente im Kundenportal von Shopware unter *"Meine Dokumente"* verfügbar.
{% endhint %}


# Einzelupload von Dokumenten

Erfahren Sie, wie Sie einzelne PDF-Dokumente zu Shopware hochladen können.

## 1. Upload von der Dokumenten-Karte

Der einfachste Weg, ein Dokument zu Shopware hochzuladen, ist direkt von der jeweiligen Dokumenten-Karte.

**Gebuchte Verkaufsrechnung /-rechnung /-lieferung**

{% stepper %}
{% step %}
Öffnen Sie die *"gebuchte Verkaufsrechnung /-lieferung /-gutschrift"*.
{% endstep %}

{% step %}
Klicken Sie auf *"**PDF zu Shopware hochladen**".*
{% endstep %}

{% step %}
Das Dokument wird automatisch als PDF generiert und hochgeladen.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Beachte bei&#x20;*****geb. Verkaufsrechnung:***

Der Dokumenttyp wird automatisch auf "Rechnung" gesetzt und die Kundenzuordnung erfolgt über die Kundennummer oder E-Mail-Adresse.
{% endhint %}

<div align="left" data-with-frame="true"><figure><img src="/files/s136EDTlgFzoypquiOpW" alt="" width="563"><figcaption></figcaption></figure></div>

## 2. Manueller PDF-Upload

Neben dem automatischen PDF-Upload haben Sie die Möglichkeit, eigene PDF-Dateien manuell hochzuladen. Öffnen Sie beispielsweise ein Rechnungs-, Gutschrift- oder Lieferscheinmenü.

> Folgen Sie anschließend dem Pfad:
>
> *"Aktionen"* <i class="fa-right">:right:</i> *"Shopware Dokumente"* <i class="fa-right">:right:</i> *"Sonstiges"* <i class="fa-right">:right:</i> *"Manuelle PDF hochladen"*

Laden Sie nun die entsprechende PDF-Datei von Ihrem Computer hoch. Das Dokument wird automatisch der zugehörigen Dokumentnummer zugeordnet und an Shopware übermittelt.

{% hint style="warning" %}
Die manuelle PDF muss eine gültige PDF-Datei sein. Andere Dateitypen werden nicht akzeptiert.
{% endhint %}

<div align="left" data-with-frame="true"><figure><img src="/files/IJJGNh2pZytkppDo8PjZ" alt="" width="563"><figcaption></figcaption></figure></div>

## 3. Upload von Dokumentenanhängen

Zusätzlich können Sie Dokumente zu Shopware hochladen, die bereits als Anhang an einem Datensatz in BC hinterlegt sind. Öffnen Sie dazu die [Dokumentenanhänge](#id-3.-upload-von-dokumentenanhangen) oder öffnen Sie die Anhang-FactBox (rechts) des gewünschten Datensatzes und wählen Sie die entsprechende Datei aus. Klicken Sie anschließend auf den *nach unten zeigenden Pfeil* bei *"Belege"* und wählen Sie *"Zu Shopware hochladen" aus*, um das Dokument an Shopware zu übermitteln. Ggf. müssen Sie noch einen Dokumenttyp auswählen.

<div align="left" data-with-frame="true"><figure><img src="/files/fKYGSayqKC3XUYJGdVPR" alt="" width="563"><figcaption><p>FactBox befindet sich rechts</p></figcaption></figure></div>

## 4. Kundenzuordnung

Die Zuordnung des Dokuments zum Shopware-Kunden erfolgt automatisch über:

<table data-card-size="large" data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><p><strong>Kundennummer</strong></p><p>BC Kundennummer wird mit Shopware-Kundennummer abgeglichen.</p></td></tr><tr><td><p><strong>E-Mail-Adresse</strong></p><p>Falls keine Kundennummer gefunden wird, wird die E-Mail-Adresse verwendet.</p></td></tr></tbody></table>

{% hint style="info" %}
Für eine erfolgreiche Zuordnung muss der Kunde **sowohl** in Business Central **als auch** in Shopware **existieren** und die Kundennummer oder E-Mail-Adresse übereinstimmen.
{% endhint %}


# Massenupload von Dokumenten

Erfahren Sie, wie Sie mehrere PDF-Dokumente gleichzeitig zu Shopware hochladen.

Für den Upload mehrerer Dokumente stehen verschiedene Methoden zur Verfügung.

## 1. Upload von der Dokumentenliste

### Mehrere Rechnungen / Gutschriften / Lieferscheine hochladen

{% stepper %}
{% step %}
Öffnen Sie...\
...*"Gebuchte Verkaufsrechnungen" oder*\
*..."Gebuchte Verkaufsrechnungen" oder*\
*..."Gebuchte Verkaufslieferungen".*
{% endstep %}

{% step %}
Wählen Sie die...\
...gewünschten Rechnungen aus.\
...gewünschten Gutschriften aus.\
...gewünschten Lieferungen aus.

{% hint style="info" %}
***Strg /*****Command*****+Klick*** für Mehrfachauswahl im geöffneten Fenster *"Angehängte Belege*".
{% endhint %}
{% endstep %}

{% step %}
Klicken Sie auf die drei Punkte *"..."* <i class="fa-right">:right:</i> "Start" <i class="fa-right">:right:</i> *"zu Shopware hochladen".* Ggf. müssen Sie noch den Dokumenttyp auswählen.
{% endstep %}

{% step %}
Eine Zusammenfassung zeigt den Upload-Status.
{% endstep %}
{% endstepper %}

<div align="left" data-with-frame="true"><figure><img src="/files/1Thcw2HvbecvlMml1CWo" alt=""><figcaption></figcaption></figure></div>

## 2. Upload über die Debitorenkarte

Von der Debitorenkarte aus können Sie alle Dokumente eines bestimmten Kunden hochladen:

{% stepper %}
{% step %}
Öffnen Sie die "*Debitorenkarte"* des gewünschten Kunden.
{% endstep %}

{% step %}
Navigieren Sie zu *"Aktionen"* <i class="fa-right">:right:</i> *"PDF Dokumente"*
{% endstep %}

{% step %}
Wählen Sie die gewünschte Option:

* *"Rechnungen zu Shopware"*: Alle Rechnungen des Kunden
* *"Gutschriften zu Shopware"*: Alle Gutschriften des Kunden
* *"Lieferscheine zu Shopware"*: Alle Lieferscheine des Kunden
* *"Anhänge zu Shopware"*: Dokumentenanhänge des Kunden
  {% endstep %}

{% step %}
Im neu geöffneten Fenster wählen Sie das gewünschte Dokument oder die gewünschten Dokumente auswählen und bestätigen mit *"OK"*.
{% endstep %}
{% endstepper %}

<div align="left" data-with-frame="true"><figure><img src="/files/hM8UKoBzfnM49eEbSwAp" alt="" width="563"><figcaption></figcaption></figure></div>

<div align="left" data-with-frame="true"><figure><img src="/files/rO7RUPIApKp3jNKxobs4" alt="" width="375"><figcaption><p>Ein Beispiel für den Upload.</p></figcaption></figure></div>

## 3. Batch-Upload-Report

Für die Verarbeitung großer Datenmengen oder für regelmäßige Uploads steht ein spezieller Report zur Verfügung.

Geben Sie in der Suche *„Shopware PDF Dokument Upload“* ein und wählen Sie den entsprechenden Eintrag aus. Im anschließend geöffneten Fenster können verschiedene Filter konfiguriert werden. Beispielsweise lassen sich folgende Einstellungen anpassen:

* Dokumenttyp: Rechnungen, Gutschriften oder Lieferscheine
* *Von Datum / Bis Datum*: Zeitraum eingrenzen (Screenshot: *"Bericht planen -..."*)
* *Kundenfilter*: Bestimmte Kunden auswählen

Klicken Sie auf *"OK"* um den Upload zu starten.

{% hint style="info" %}
Der Batch-Upload-Report eignet sich besonders für die initiale Übertragung von historischen Dokumenten oder regelmäßige automatisierte Uploads.
{% endhint %}

<div align="left"><figure><img src="/files/6Vjc3xF4IvNio33MPFu3" alt=""><figcaption></figcaption></figure> <figure><img src="/files/z6xHuGYP7QoFRI5Ul2kr" alt=""><figcaption><p>Über <em>„Plan…“</em> im vorherigen Screenshot gelangen Sie zu dieser Ansicht.</p></figcaption></figure></div>

## 4. Upload-Zusammenfassung

{% columns %}
{% column %}
Nach jedem Massenupload wird eine Zusammenfassung angezeigt:

```
Upload abgeschlossen:
- Erfolgreich: 15
- Fehlerhaft: 2
```

Bei Fehlern können Sie das Aktivitätsprotokoll prüfen, um die genauen Ursachen zu ermitteln.
{% endcolumn %}

{% column %}

<figure><img src="/files/IyFkCvLRIP3mLECD4poV" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

## 5. Automatisierung

Der PDF-Upload kann auch über die Aufgabenwarteschlange automatisiert werden:

{% stepper %}
{% step %}
Erstellen Sie einen neuen [*Aufgabenwarteschlangenposten.*](/shopware/automatisierungen-und-zeitplane/aufgabenwarteschlangenposten)
{% endstep %}

{% step %}
Wählen Sie den Report "*PDF Dokument Upload"*.
{% endstep %}

{% step %}
Konfigurieren Sie den Zeitplan (z.B. täglich um 20:00 Uhr).
{% endstep %}

{% step %}
Aktivieren Sie den Posten.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Bei automatisierten Uploads werden keine Dialogfenster angezeigt. Stellen Sie sicher, dass alle Filter korrekt konfiguriert sind.
{% endhint %}

<details>

<summary><strong>Tipps für den täglichen Umgang</strong></summary>

**Empfohlene Vorgehensweise**

1. **Testen Sie zuerst:** Laden Sie zunächst einzelne Dokumente hoch, um die Konfiguration zu prüfen.
2. **Kleine Batches:** Beginnen Sie mit kleineren Mengen (10-50 Dokumente).
3. **Prüfen Sie die Zuordnung:** Stellen Sie sicher, dass die Kundenzuordnung funktioniert.
4. **Monitoring:** Überwachen Sie das Aktivitätsprotokoll auf Fehler.

**Performance-Tipps**

* Der Upload erfolgt sequenziell, große Mengen können einige Zeit dauern.
* Vermeiden Sie Uploads während Stoßzeiten.
* Prüfen Sie die Netzwerkverbindung vor größeren Uploads.

</details>


# Shopware Plugin Installation

Installation und Konfiguration des Shopware-Plugins für das PDF-Dokument-Modul.

Das **Solutioo Invoice Documents** Plugin erweitert Shopware um die Fähigkeit, PDF-Dokumente aus Business Central zu empfangen und im Kundenportal anzuzeigen.

## 1. Installation

### 1.1 Via Composer (empfohlen)

```bash
composer require solutioo/invoice-documents
bin/console plugin:refresh
bin/console plugin:install --activate SolutiooInvoiceDocuments
bin/console cache:clear
```

### 1.2 Manuelle Installation

1. Laden Sie das Plugin herunter.
2. Entpacken Sie es nach `custom/plugins/SolutiooInvoiceDocuments`
3. Führen Sie folgende Befehle aus:

```bash
bin/console plugin:refresh
bin/console plugin:install --activate SolutiooInvoiceDocuments
bin/console cache:clear
bin/console theme:compile
```

## 2. Plugin-Funktionen

### 2.1 API-Endpunkte

Das Plugin stellt folgende API-Endpunkte bereit:

<table><thead><tr><th width="383.0965576171875">Endpunkt</th><th width="105.9146728515625">Methode</th><th width="257.5626220703125">Beschreibung</th></tr></thead><tbody><tr><td><code>/api/solutioo-invoice-document/import</code></td><td>POST</td><td>Importiert ein neues Dokument</td></tr><tr><td><code>/api/solutioo-invoice-document/by-reference/{ref}</code></td><td>GET</td><td>Prüft ob Dokument existiert</td></tr><tr><td><code>/api/solutioo-invoice-document/update/{id}</code></td><td>PATCH</td><td>Aktualisiert ein Dokument</td></tr><tr><td><code>/api/solutioo-invoice-document/delete/{id}</code></td><td>DELETE</td><td>Löscht ein Dokument</td></tr><tr><td><code>/api/solutioo-invoice-document/bulk</code></td><td>POST</td><td>Massenimport von Dokumenten</td></tr></tbody></table>

### 2.2 Kundenportal

Nach der Installation erscheint im Kundenbereich ein neuer Menüpunkt *"Dokumente"*:

## 3. Kundenzuordnung

Das Plugin unterstützt verschiedene Methoden zur Kundenzuordnung:

### Priorität der Zuordnung

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Kunden-ID</strong></td><td>Direkte Shopware-Kunden-ID (höchste Priorität)</td></tr><tr><td><strong>E-Mail-Adresse</strong></td><td>Suche nach Kunden-E-Mail</td></tr><tr><td><strong>Kundennummer</strong></td><td>Suche nach Kundennummer</td></tr></tbody></table>

{% hint style="info" %}
Die E-Mail-Zuordnung ist besonders nützlich, wenn die Kundennummern zwischen den Systemen nicht übereinstimmen.
{% endhint %}

## 4. API-Authentifizierung

Die API verwendet die Standard-Shopware Admin-API-Authentifizierung:

{% columns %}
{% column %}

### Integration (empfohlen)

1. Erstellen Sie eine **Integration** in Shopware unter **Einstellungen** <i class="fa-right">:right:</i> **System** <i class="fa-right">:right:</i> **Integrationen**
2. Notieren Sie **Access Key ID** und **Secret Access Key**
3. Tragen Sie diese in Business Central ein
   {% endcolumn %}

{% column %}

### Benutzerauthentifizierung

Alternativ kann ein Admin-Benutzer verwendet werden:

1. Erstellen Sie einen Admin-Benutzer in Shopware
2. Nutzen Sie Benutzername und Passwort in Business Central
   {% endcolumn %}
   {% endcolumns %}

## 5. Dokumenttypen

Das Plugin unterstützt folgende Dokumenttypen:

<table><thead><tr><th width="139.1199951171875">API-Wert</th><th width="203.2235107421875">Deutsche Bezeichnung</th><th width="202.5538330078125">Englische Bezeichnung</th></tr></thead><tbody><tr><td><code>invoice</code></td><td>Rechnung</td><td>Invoice</td></tr><tr><td><code>credit_note</code></td><td>Gutschrift</td><td>Credit Note</td></tr><tr><td><code>delivery_note</code></td><td>Lieferschein</td><td>Delivery Note</td></tr><tr><td><code>cancellation</code></td><td>Storno</td><td>Cancellation</td></tr><tr><td><code>other</code></td><td>Sonstiges</td><td>Other</td></tr></tbody></table>

## 6. Datenbankstruktur

Das Plugin erstellt eine neue Tabelle `solutioo_invoice_document`:

<table><thead><tr><th width="184.8917236328125">Feld</th><th width="127.28955078125">Typ</th><th width="265.6485595703125">Beschreibung</th></tr></thead><tbody><tr><td><code>id</code></td><td>binary(16)</td><td>Primärschlüssel (UUID)</td></tr><tr><td><code>customer_id</code></td><td>binary(16)</td><td>Zugehöriger Kunde</td></tr><tr><td><code>invoice_number</code></td><td>varchar(255)</td><td>Dokumentennummer</td></tr><tr><td><code>invoice_date</code></td><td>date</td><td>Dokumentdatum</td></tr><tr><td><code>document_type</code></td><td>varchar(50)</td><td>Dokumenttyp</td></tr><tr><td><code>external_reference</code></td><td>varchar(255)</td><td>Externe Referenz (BC-Nummer)</td></tr><tr><td><code>media_id</code></td><td>binary(16)</td><td>Verknüpfte Mediendatei</td></tr><tr><td><code>original_filename</code></td><td>varchar(255)</td><td>Originaler Dateiname</td></tr></tbody></table>

## 7. Updates

```bash
# Plugin aktualisieren
composer update solutioo/invoice-documents
bin/console plugin:update SolutiooInvoiceDocuments
bin/console cache:clear
bin/console theme:compile
```

{% hint style="warning" %}
Erstellen Sie vor Updates immer ein Backup Ihrer Datenbank!
{% endhint %}


# Dokumenttypen (Rechnung, Gutschrift, Lieferschein)

{% hint style="info" %}
**Premium-Modul.** Der Dokumenten-Upload erfordert das entsprechende Shopware-Plugin von solutioo und die aktivierten Schalter in der Konfiguration.
{% endhint %}

Der Connector kann gebuchte Belege als **PDF** in das Shopware-Kundenportal übertragen. Unterstützt werden insbesondere:

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Rechnung</strong></td><td>Gebuchte Verkaufsrechnung.</td></tr><tr><td><strong>Gutschrift</strong></td><td>Gebuchte Gutschrift / Korrektur.</td></tr><tr><td><strong>Lieferschein</strong></td><td>Gebuchte Warenlieferung.</td></tr></tbody></table>

**Voraussetzungen**

| Einstellung                      | Bedeutung                             |
| -------------------------------- | ------------------------------------- |
| **Dokumenten-Upload aktivieren** | Aktiviert den Upload ins Kundenportal |
| **PDF-Generierung aktivieren**   | Erzeugt automatisch das PDF zum Beleg |

**Wie geht es weiter?**

* Einzelne Belege hochladen: Einzelupload von Dokumenten
* Viele Belege gesammelt hochladen: Massenupload von Dokumenten
* Voraussetzungen im Shop: Shopware Plugin Installation


# Automatische PDF-Generierung

Ist die **PDF-Generierung** aktiviert, erzeugt der Connector das PDF zu einem gebuchten Beleg automatisch und überträgt es ins Shopware-Kundenportal.

**Ablauf**

```mermaid
flowchart LR
    A[Beleg buchen] --> B[PDF erzeugen]
    B --> C[Base64-Übertragung an Shopware]
    C --> D[Dokument im Kundenportal]
```

**Einstellungen**

* **Dokumenten-Upload aktivieren** – schaltet den Upload frei.
* **PDF-Generierung aktivieren** – erzeugt das PDF automatisch.

{% hint style="info" %}
Alternativ können Sie ein eigenes PDF manuell hochladen (z. B. ein extern erstelltes Dokument). Siehe Einzelupload.
{% endhint %}

{% hint style="success" %}
Kombiniert mit einer Aufgabenwarteschlange lassen sich Dokumente vollautomatisch nach dem Buchen bereitstellen.
{% endhint %}


# SharePoint-Dokumente

{% hint style="info" %}
**Premium-Modul.** Die SharePoint-Anbindung erfordert die entsprechende Freischaltung und eine Microsoft-365-Autorisierung.
{% endhint %}

Mit diesem Modul übertragen Sie **Produktdokumente aus SharePoint** automatisch nach Shopware – etwa Datenblätter oder Handbücher.

**Einstellungen (Auszug)**

| Feld                                       | Bedeutung                                   |
| ------------------------------------------ | ------------------------------------------- |
| SharePoint Dokumente aktivieren            | Master-Schalter                             |
| Site Host / Site Pfad                      | Adressierung der SharePoint-Site            |
| Dokumentenbibliothek                       | Name der Bibliothek                         |
| Ordner-Muster                              | z. B. mit Platzhalter für die Artikelnummer |
| Dateitypen einschließen / Ausschlussmuster | Steuerung der Dateiauswahl                  |

**Autorisierung**

Der Zugriff erfolgt über eine **Microsoft-365-Autorisierung** (Microsoft Graph). Alternativ steht ein Azure-AD-Fallback (Mandanten-ID, Client-ID, Secret) zur Verfügung.

{% hint style="success" %}
So bleiben Produktdokumente zentral in SharePoint gepflegt und gelangen dennoch automatisch in den Shop.
{% endhint %}


# Dokumentstatus prüfen

Sie können prüfen, ob ein Beleg bereits im Shopware-Kundenportal vorliegt – so vermeiden Sie doppelte Uploads und erkennen fehlgeschlagene Übertragungen.

**Vorgehen**

* Auf dem gebuchten Beleg steht eine Aktion zum **Prüfen der Existenz** des Dokuments in Shopware zur Verfügung (Abgleich per Referenz).
* Fehlgeschlagene Uploads lassen sich gezielt wiederholen.

{% hint style="info" %}
Den Verlauf der Dokument-Uploads sehen Sie im Aktivitätsprotokoll (u. a. Rechnungs-, Gutschrift- und Lieferschein-Dokumente).
{% endhint %}


# Aufgabenwarteschlangenposten

Automatisieren Sie Ihre Shopware-Synchronisation mit Aufgabenwarteschlangenposten.

Die Aufgabenwarteschlange in Business Central ermöglicht die automatische Ausführung von Synchronisationsaufgaben nach einem definierten Zeitplan.

## 1. Verfügbare Aufgaben

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Bestelldownload</strong></td><td>Importiert neue Bestellungen aus Shopware</td></tr><tr><td><strong>Artikelupload</strong></td><td>Synchronisiert Artikeldaten zu Shopware</td></tr><tr><td><strong>Preisupload</strong></td><td>Aktualisiert Preise in Shopware</td></tr><tr><td><strong>Bestandsupload</strong></td><td>Synchronisiert Lagerbestände</td></tr><tr><td><strong>Kategorieupload</strong></td><td>Aktualisiert Kategorien</td></tr><tr><td><strong>Bildupload</strong></td><td>Überträgt Artikelbilder</td></tr></tbody></table>

## 2. Aufgabenwarteschlangenposten erstellen

{% stepper %}
{% step %}
Öffnen Sie *Aufgabenwarteschlangenposten* in Business Central.
{% endstep %}

{% step %}
Klicken Sie auf "+Neu".

<div align="left" data-with-frame="true"><figure><img src="/files/xt475VMbrbInmD0oOdB0" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Füllen Sie die Felder aus:
{% endstep %}
{% endstepper %}

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Art des auszuführenden Objekts</strong></td><td>Codeunit</td></tr><tr><td><strong>ID des auszuführenden Objekts</strong></td><td>ID der Shopware-Codeunit</td></tr><tr><td><strong>Beschreibung</strong></td><td>z.B. "Shopware Bestellimport"</td></tr><tr><td><strong>Früheste Startzeit</strong></td><td>Datum/Uhrzeit</td></tr><tr><td><strong>Zeitüberschreitung bei Aufgabe</strong></td><td>Intervall</td></tr><tr><td><strong>Wiederholung</strong></td><td>Wochentage für die Ausführung.</td></tr></tbody></table>

<details>

<summary><strong>Beispiele für die Zeitplanung</strong></summary>

<table><thead><tr><th width="153.347900390625">Aufgabe</th><th width="189.2579345703125">Empfohlenes Intervall</th></tr></thead><tbody><tr><td>Bestelldownload</td><td>15-30 Minuten</td></tr><tr><td>Bestandsupload</td><td>30-60 Minuten</td></tr><tr><td>Preisupload</td><td>1x täglich</td></tr><tr><td>Artikelupload</td><td>1x täglich</td></tr></tbody></table>

</details>

<div align="left" data-with-frame="true"><figure><img src="/files/pI2Az6ey9T7Bu6OqNHha" alt="" width="563"><figcaption></figcaption></figure></div>

## 3. Aufgabenwarteschlangenposten aktivieren

### Status ändern

{% columns %}
{% column %}
{% stepper %}
{% step %}
Wählen Sie den Posten aus.
{% endstep %}

{% step %}
Klicken Sie auf "Status auf 'Bereit' festlegen".
{% endstep %}

{% step %}
Der Posten wird zum nächsten Intervall ausgeführt.
{% endstep %}
{% endstepper %}
{% endcolumn %}

{% column %}

<figure><img src="/files/8lfVuHE4tyEI3bEFHsrK" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

<details>

<summary><strong>Status-Übersicht</strong></summary>

<table><thead><tr><th width="163.5137939453125">Status</th><th width="329.276611328125">Beschreibung</th></tr></thead><tbody><tr><td><strong>In Warteschlange</strong></td><td>Wartet auf nächste Ausführung</td></tr><tr><td><strong>Bereit</strong></td><td>Wird beim nächsten Intervall ausgeführt</td></tr><tr><td><strong>In Bearbeitung</strong></td><td>Wird gerade ausgeführt</td></tr><tr><td><strong>Fehler</strong></td><td>Fehler bei letzter Ausführung</td></tr><tr><td><strong>Angehalten</strong></td><td>Manuell gestoppt</td></tr></tbody></table>

</details>

## 4. Protokollierung

### 4.1 Ausführungsprotokoll

1. Öffnen Sie den **Aufgabenwarteschlangenposten**
2. Klicken Sie auf die drei Punkte *"..."* <i class="fa-right">:right:</i> *"Protokolleinträge"*
3. Sie sehen alle Ausführungen mit Status und Dauer.

<div align="left"><figure><img src="/files/5ckS0Mu7TmdkqqgRx92E" alt=""><figcaption></figcaption></figure> <figure><img src="/files/AmAwpmkYzbNldQOKpEe3" alt=""><figcaption></figcaption></figure></div>

### 4.2 Fehleranalyse

Sie gehen wir bei Punkt [*"4.1 Ausführungsprotokoll"*](#id-4.1-ausfuhrungsprotokoll) vor und klicken dann im Menü auf *"Fehlermeldung anzeigen"* oder direkt im Menü *Aufgabenwarteschlangenposten* klicken Sie auf die drei Punkte *"..."* <i class="fa-right">:right:</i> *"Fehler anzeigen".*

Analysieren Sie die Ursache oder nehmen Sie z.B. die *"Empfohlene Aktion an\[...]"*.

<div align="left" data-with-frame="true"><figure><img src="/files/IVYk2zBRoJg4peTSUshb" alt="" width="563"><figcaption></figcaption></figure></div>

## 5. Beispielkonfiguration

{% tabs %}
{% tab title="Bestelldownload" %}

```
Art des auszuführenden Objekts: Codeunit
Objekt-ID: [Bestelldownload-Codeunit-ID]
Beschreibung: Shopware - Bestellungen herunterladen
Anzahl Minuten zwischen Ausführungen: 15
Ausführen an Wochentagen: Mo-So
```

alle 15 Min.
{% endtab %}

{% tab title="Bestandsupload" %}

<pre><code><strong>Art des auszuführenden Objekts: Codeunit
</strong>Objekt-ID: [Bestandsupload-Codeunit-ID]
Beschreibung: Shopware - Bestände synchronisieren
Anzahl Minuten zwischen Ausführungen: 60
Ausführen an Wochentagen: Mo-So
</code></pre>

stündlich
{% endtab %}

{% tab title="Preisupload" %}

```
Art des auszuführenden Objekts: Codeunit
Objekt-ID: [Preisupload-Codeunit-ID]
Beschreibung: Shopware - Preise synchronisieren
Früheste Startzeit: 06:00:00
Anzahl Minuten zwischen Ausführungen: 1440 (= 24 Stunden)
Ausführen an Wochentagen: Mo-So
```

täglich um 6:00 Uhr
{% endtab %}
{% endtabs %}

<details>

<summary><strong>Tipps für den täglichen Umgang</strong></summary>

#### Zeitplanung

* Verteilen Sie Aufgaben über den Tag.
* Vermeiden Sie Überlappungen.
* Planen Sie ressourcenintensive Aufgaben nachts.

#### Überwachung

* Prüfen Sie regelmäßig die Protokolle.
* Richten Sie Benachrichtigungen bei Fehlern ein.
* Reagieren Sie schnell auf Probleme.

#### Performance

* Begrenzen Sie gleichzeitige Aufgaben.
* Optimieren Sie Datenmengen.
* Nutzen Sie Filter für inkrementelle Updates.

</details>


# Manuelle Synchronisationsoptionen

Erfahren Sie, wie Sie Daten manuell zwischen Business Central und Shopware synchronisieren.

Neben der automatischen Synchronisation können Sie Daten auch manuell übertragen.

**1. Wann manuell synchronisieren?**

<table data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td>Bei Ersteinrichtung und Initial-Upload</td></tr><tr><td>Bei Fehlerkorrekturen</td></tr><tr><td>Bei einzelnen Artikeländerungen</td></tr><tr><td>Bei dringenden Aktualisierungen</td></tr><tr><td>Zum Testen der Konfiguration</td></tr></tbody></table>

**2. Artikelsynchronisation**

{% columns %}
{% column width="41.66666666666667%" %}
**Von der Artikelkarte**

1. Öffnen Sie die *"Artikelkarte"***.**
2. Wählen Sie unter *"Aktionen"* <i class="fa-right">:right:</i>"Shopware" die gewünschte Option aus. (siehe Screenshot der Artikelkarte)
   {% endcolumn %}

{% column width="58.33333333333333%" %}
**Von der Artikelliste**

1. Öffnen Sie die *"Artikelliste"*.
2. Wählen Sie einen oder mehrere Artikel aus.
3. Klicken Sie auf *"Aktionen"* <i class="fa-right">:right:</i> *"Shopware"* und wählen Sie die gewünschte Synchronisation aus.
   {% endcolumn %}
   {% endcolumns %}

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FZaMb7CTKdTj7hHQZMTkg%2FBildschirmfoto%202026-06-29%20um%2011.47.38.png?alt=media&#x26;token=46c6bc20-6ab5-469c-a022-3a238a47e449" alt="" width="563"><figcaption></figcaption></figure></div>

**3. Bestellsynchronisation**

{% columns %}
{% column %}
**Bestellungen herunterladen**

Neue Bestellungen werden importiert, wenn Sie folgenden Pfad folgen:

*"Shopware"* <i class="fa-right">:right:</i> *"Bestellungen herunterladen"*
{% endcolumn %}

{% column %}
**Status melden**

1. Öffnen Sie einen *Verkaufsauftrag.*
2. Klicken Sie auf *"Status zu Shopware melden".*
3. Der aktuelle Status wird übertragen.
   {% endcolumn %}
   {% endcolumns %}

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2F5lV7AriC07xLxGYClHaN%2FBildschirmfoto%202026-06-29%20um%2013.08.15.png?alt=media&#x26;token=b98f25d0-b024-4767-87ab-e386e5c41751" alt="" width="563"><figcaption><p>Herunterladen von Bestellungen</p></figcaption></figure></div>

**4. Kundendaten aktualisieren**

Öffnen Sie in Shopware die *Bestellübersicht*. Beim Herunterladen der Bestellungen werden die Kundendaten automatisch aktualisiert.

**5. Kategoriesynchronisation**

Um Kategorien hochzuladen, öffnen Sie die gewünschte *Artikelkategorie-Karte* und klicken Sie auf *„Zu Shopware hochladen“.* Die Kategorie wird anschließend automatisch in Shopware erstellt.

**6. PDF-Dokumentensynchronisation**

{% columns %}
{% column %}
**Einzelne Dokumente**

Öffnen Sie das gewünschte Dokument (Rechnung, Gutschrift oder Lieferschein) und klicken Sie auf *„PDF zu Shopware hochladen“*, um das Dokument an Shopware zu übertragen.
{% endcolumn %}

{% column %}
**Mehrere Dokumente**

Öffnen Sie die Debitorenkarte und wählen Sie "Aktionen" <i class="fa-right">:right:</i> "**PDF Dokument"** und im Anschluss die gewünschte Option aus.
{% endcolumn %}
{% endcolumns %}

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FNjo7CzhpivXNhGK0BbqB%2FBildschirmfoto%202026-06-29%20um%2013.44.31.png?alt=media&#x26;token=2405bd97-090a-49a5-bd0a-9b58aefd9467" alt="" width="563"><figcaption><p>Menü: Debitorenkarte</p></figcaption></figure></div>

**7. Initial-Synchronisation**

{% stepper %}
{% step %}
Initial-Download (Kategorien, Zahlungsarten, etc.)
{% endstep %}

{% step %}
Mapping-Tabellen prüfen und ergänzen

{% hint style="info" %}
Bei der Ersteinrichtung nach den ersten beiden Schritten einen Test-Upload durchführen.
{% endhint %}
{% endstep %}

{% step %}
Artikel-Stammdaten prüfen
{% endstep %}

{% step %}
Artikel zu Shopware hochladen (manuell oder automatisch)
{% endstep %}

{% step %}
Preise synchronisieren
{% endstep %}

{% step %}
Bestände synchronisieren
{% endstep %}

{% step %}
Bilder hochladen
{% endstep %}
{% endstepper %}

**8. Bulk-Operationen**

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Report verwenden</strong></td><td><p>Für große Datenmengen nutzen Sie Reports:</p><ol><li>Öffnen Sie den entsprechenden <strong>Upload-Report.</strong></li><li>Konfigurieren Sie die Filter.</li><li>Führen Sie den Report aus.</li></ol></td></tr><tr><td><strong>Filter setzen</strong></td><td><p>Nutzen Sie Filter für selektive Uploads:</p><ul><li>Nach Artikelkategorie</li><li>Nach Web-Artikel-Flag</li><li>Nach letztem Änderungsdatum</li></ul></td></tr></tbody></table>

<details>

<summary><strong>Tipps für den täglichen Umgang</strong></summary>

**Vor dem Upload**

* Prüfen Sie die Datenqualität
* Testen Sie mit einzelnen Datensätzen
* Stellen Sie sicher, dass die API-Verbindung funktioniert

**Während des Uploads**

* Überwachen Sie den Fortschritt
* Prüfen Sie auf Fehlermeldungen
* Unterbrechen Sie bei Problemen

**Nach dem Upload**

* Prüfen Sie die Daten in Shopware
* Kontrollieren Sie das Aktivitätsprotokoll
* Dokumentieren Sie durchgeführte Aktionen

</details>


# Fehlerhandling bei automatischen Prozessen

Erfahren Sie, wie Sie Fehler bei automatischen Prozessen erkennen und beheben.

Automatische Prozesse können aus verschiedenen Gründen fehlschlagen. Hier erfahren Sie, wie Sie Fehler erkennen und beheben.

## 1. Fehlertypen

<table data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><i class="fa-wifi">:wifi:</i> <i class="fa-triangle-exclamation">:triangle-exclamation:</i></td><td><h3>Verbindungsfehler</h3></td><td><ul><li>API-Verbindung unterbrochen</li><li>Timeout bei Anfragen</li><li>Authentifizierungs-probleme</li></ul></td></tr><tr><td><i class="fa-database">:database:</i> <i class="fa-triangle-exclamation">:triangle-exclamation:</i></td><td><h3>Datenfehler</h3></td><td><ul><li>Fehlende Pflichtfelder</li><li>Ungültige Datenformate</li><li>Mapping-Probleme</li></ul></td></tr><tr><td><i class="fa-sensor-triangle-exclamation">:sensor-triangle-exclamation:</i></td><td><h3>Systemfehler</h3></td><td><ul><li>Shopware-Server nicht erreichbar</li><li>BC-Dienste nicht verfügbar</li><li>Ressourcenengpässe</li></ul></td></tr></tbody></table>

## 2. Fehlererkennung

### 2.1 Aufgabenwarteschlange

Öffnen Sie die [*Aufgabenwarteschlangenposten*](/shopware/automatisierungen-und-zeitplane/aufgabenwarteschlangenposten). Den aktuellen Status finden Sie in der Spalte *"Status"*. Falls hier *"Fehler"* steht, klicken Sie direkt darauf. Es öffnet sich ein neues Fenster *"Karte für Aufgabenwarteschlagenposten"*.

Gehen Sie anschließend der Ursache des Fehlers nach. Dabei stehen Ihnen verschiedene unterstützende Funktionen zur Verfügung, beispielsweise die Schaltfläche *„Fehler anzeigen“*.

<div align="left" data-with-frame="true"><figure><img src="/files/jOZIRuTyxrVnsQJKscsi" alt=""><figcaption></figcaption></figure></div>

<div align="left" data-with-frame="true"><figure><img src="/files/VH9dVGEuIFwbp0ZozOtv" alt="" width="563"><figcaption></figcaption></figure></div>

### 2.2 Aktivitätsprotokoll

> Folgen Sie dem Pfad: *"Shopware"* <i class="fa-right">:right:</i> *"Aktivitätsprotokoll"*

Filtern Sie nach Fehlern und analysieren Sie diese.

<div align="left" data-with-frame="true"><figure><img src="/files/FJACibz01RyK5kfGDzsE" alt="" width="563"><figcaption></figcaption></figure></div>

### 2.3 API-Call-Log

> Folgen Sie dem Pfad: *"Shopware"* <i class="fa-right">:right:</i> *"API-Aufrufprotokoll"*

Für eine detaillierte Analyse prüfen Sie den Request und die Response. Auf diese Weise können Sie die Fehlerursache gezielt identifizieren.

<div align="left" data-with-frame="true"><figure><img src="/files/mWPYF018BacpnekqwbOB" alt="" width="563"><figcaption></figcaption></figure></div>

## 3. Fehlerbehandlung

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><h3>Allgemeines Vorgehen</h3></td><td><ol><li>Fehler identifizieren</li><li>Ursache analysieren</li><li>Problem beheben</li><li>Aufgabe erneut ausführen</li><li>Erfolg prüfen</li></ol></td></tr><tr><td><h3>Verbindungsfehler beheben</h3></td><td><ol><li>Prüfen Sie die <strong>API-Verbindung</strong> in den Einstellungen.</li><li>Führen Sie einen <strong>Verbindungstest</strong> durch</li><li>Prüfen Sie die <strong>API-Zugangsdaten.</strong></li><li>Prüfen Sie die <strong>Netzwerkverbindung.</strong></li></ol></td></tr><tr><td><h3>Datenfehler beheben</h3></td><td><ol><li>Identifizieren Sie den <strong>fehlerhaften Datensatz.</strong></li><li>Prüfen Sie die <strong>Pflichtfelder.</strong></li><li>Korrigieren Sie die <strong>Daten.</strong></li><li>Prüfen Sie die <strong>Mapping-Tabellen.</strong></li></ol></td></tr></tbody></table>

## 4. Benachrichtigungen

{% tabs %}
{% tab title="E-Mail-Benachrichtigungen" %}
Richten Sie Benachrichtigungen bei Fehlern ein:

1. Öffnen Sie **Aufgabenwarteschlangenposten.**
2. Wählen Sie den Posten.
3. Aktivieren Sie *"Bei Fehler benachrichtigen"***.**
4. Geben Sie E-Mail-Adressen an.
   {% endtab %}

{% tab title="Monitoring-Dashboard" %}
Nutzen Sie die Bestellübersicht für einen schnellen Überblick:

* Anzahl fehlerhafter Imports
* Letzte erfolgreiche Synchronisation
* Offene Fehler
  {% endtab %}
  {% endtabs %}

## 5. Wiederholungsstrategien

{% tabs %}
{% tab title="Automatische Wiederholung" %}
Einige Fehler werden automatisch wiederholt:

* Verbindungsfehler nach kurzer Pause.
* Timeout-Fehler mit erhöhtem Timeout.
  {% endtab %}

{% tab title="Manuelle Wiederholung" %}

1. Beheben Sie die Fehlerursache.
2. Setzen Sie den Status auf *"Bereit"*.
3. Die Aufgabe wird beim nächsten Intervall ausgeführt.
   {% endtab %}
   {% endtabs %}

<details>

<summary><strong>Tipps für den täglichen Umgang</strong></summary>

#### Proaktive Überwachung

* Prüfen Sie täglich die Aufgabenwarteschlange.
* Überwachen Sie das Aktivitätsprotokoll.
* Reagieren Sie schnell auf Fehler.

#### Fehlerprävention

* Pflegen Sie vollständige Stammdaten.
* Halten Sie Mappings aktuell.
* Testen Sie Änderungen zuerst manuell.

#### Dokumentation

* Dokumentieren Sie wiederkehrende Fehler.
* Erstellen Sie eine FAQ für häufige Probleme.
* Schulen Sie Mitarbeiter in der Fehlerbehebung.

</details>


# Massen-Upload-Report (Shopware Upload Data)

Der Sammelreport **Shopware Upload Data** bündelt viele Upload-Vorgänge in einem Lauf. Er eignet sich für die manuelle Ausführung ebenso wie für die geplante Verarbeitung per Aufgabenwarteschlange.

**Wählbare Optionen**

<table><thead><tr><th width="227.116943359375">Option</th><th width="482.4798583984375">Wirkung</th></tr></thead><tbody><tr><td>Nur offene Daten</td><td>Nur nicht synchronisierte Datensätze verarbeiten</td></tr><tr><td>Einheiten</td><td>Maßeinheiten hochladen</td></tr><tr><td>Kategorien</td><td>Offene Kategorien hochladen</td></tr><tr><td>Produkte</td><td>Artikel inkl. Einheiten, Hersteller, Attribute, Varianten, Medien und Bestand</td></tr><tr><td>Kunden</td><td>Web-Kunden hochladen</td></tr><tr><td>Kontakte (B2B-Benutzer)</td><td>B2B-Benutzer hochladen</td></tr><tr><td>Kundenpreisliste</td><td>Preise hochladen (optional gefiltert)</td></tr><tr><td>Verwaiste Preise löschen</td><td>Nicht zugeordnete Shopware-Preise entfernen</td></tr><tr><td>Bestellstatus</td><td>Offene Status an Shopware melden</td></tr></tbody></table>

{% hint style="success" %}
**Tipp:** Mit der Option *Nur offene Daten* halten Sie Läufe kurz – nur geänderte Datensätze werden übertragen.
{% endhint %}

**Ausführung**

* **Manuell:** Report öffnen, Optionen wählen, ausführen.
* **Geplant:** über einen Aufgabenwarteschlangenposten automatisieren.


# Scheduler & AutoSync

Damit Shop und ERP dauerhaft aktuell bleiben, sollten die wichtigsten Übertragungen **automatisch** laufen. Der Connector arbeitet dazu mit der **Aufgabenwarteschlange** von Business Central.

**Was lässt sich automatisieren?**

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Bestellungen laden</strong></td><td>Neue Shopware-Bestellungen inkrementell abrufen.</td></tr><tr><td><strong>Artikel &#x26; Preise hochladen</strong></td><td>Geänderte Artikel, Preise und Bestände übertragen.</td></tr><tr><td><strong>Kunden &#x26; B2B</strong></td><td>Kunden und B2B-Benutzer aktualisieren.</td></tr><tr><td><strong>Bestellstatus</strong></td><td>Liefer-/Rechnungsstatus melden.</td></tr></tbody></table>

**Empfohlene Taktung**

| Prozess            | Vorschlag                |
| ------------------ | ------------------------ |
| Bestellungen laden | alle 15–30 Minuten       |
| Bestand hochladen  | mehrmals täglich         |
| Preise hochladen   | täglich / bei Änderungen |
| Artikel hochladen  | täglich (nur offene)     |

{% hint style="info" %}
Konkrete Einrichtungsbeispiele finden Sie unter Empfohlene Job-Queue-Setups.
{% endhint %}

### Häufige Fragen

#### In welcher Reihenfolge sollten die automatischen Jobs laufen?

Bewährt hat sich: zuerst Stammdaten (Artikel), dann Preise und Bestände, danach Bestellungen laden und zuletzt die Bestellstatus-Rückmeldung. So sind Abhängigkeiten erfüllt und die API-Last bleibt gleichmäßig verteilt.

#### Wie oft sollte der Bestand hochgeladen werden?

Für aktuelle Verfügbarkeiten empfiehlt sich ein mehrmals täglicher Bestands-Upload, Bestellungen werden idealerweise alle 15–30 Minuten inkrementell geladen. Preise und Artikel genügen meist täglich bzw. bei Änderungen. Konkrete Beispiele finden Sie unter „Empfohlene Job-Queue-Setups“.


# Empfohlene Job-Queue-Setups

Die folgenden Beispiele zeigen bewährte Einrichtungen für die Aufgabenwarteschlange. Passen Sie Intervalle an Ihr Bestellaufkommen an.

{% tabs %}
{% tab title="Bestellabruf" %}

* **Zweck:** neue Bestellungen laden und als BC-Auftrag anlegen.
* **Intervall:** alle 15–30 Minuten.
* **Hinweis:** lädt inkrementell ab dem letzten Auto-Increment.
  {% endtab %}

{% tab title="Bestand" %}

* **Zweck:** Lagerbestände aktuell halten.
* **Intervall:** mehrmals täglich (z. B. stündlich).
* **Hinweis:** nur Artikel mit Bestandsänderung.
  {% endtab %}

{% tab title="Preise" %}

* **Zweck:** geänderte Preise übertragen.
* **Intervall:** täglich, idealerweise nachts.
* **Hinweis:** aktualisiert vorhandene Preise per PATCH (keine Duplikate).
  {% endtab %}

{% tab title="Artikel" %}

* **Zweck:** neue/geänderte Artikel hochladen.
* **Intervall:** täglich (nur offene Daten).
* **Hinweis:** große Kataloge außerhalb der Geschäftszeiten.
  {% endtab %}
  {% endtabs %}

{% hint style="warning" %}
Verteilen Sie die Startzeiten, damit nicht mehrere große Läufe gleichzeitig starten. So bleibt die Systemlast gleichmäßig.
{% endhint %}

Grundlagen zur Einrichtung: Aufgabenwarteschlangenposten. Fehlerbehandlung: Fehlerhandling bei automatischen Prozessen.


# FAQ

Lösungen für häufig auftretende Probleme mit dem Shopware 6 API Connector.

**Allgemein**

<details>

<summary><strong>ID-Felder finden</strong></summary>

</details>

<details>

<summary><strong>Bestandssynchronisation</strong></summary>

</details>

<details>

<summary><strong>401 Unauthorized</strong></summary>

**Symptome:**

* API-Aufrufe schlagen mit 401 Fehlermeldung
* Authentifizierungsfehler

**Lösungen:**

1. Prüfen Sie die **API-Zugangsdaten.**
2. Generieren Sie neue **Integration-Credentials** in Shopware.
3. Prüfen Sie, ob die Integration aktiv ist.

</details>

<details>

<summary><strong>Verbindung konnte nicht herstellt werden</strong></summary>

**Symptome:**

* Fehlermeldung "Verbindung konnte nicht hergestellt werden".
* Timeout bei Verbindungstest

**Mögliche Ursachen:**

1. Falsche URL
2. Falsche Zugangsdaten
3. Server nicht erreichbar
4. Firewall blockiert

**Lösungen:**

1. Prüfen Sie die **Webseite-URL** (inkl. https\://).
2. Prüfen Sie **Access Key** und **Secret Key.**
3. Testen Sie die URL im Browser.
4. Prüfen Sie Firewall-Einstellungen.

</details>

<details>

<summary><strong>Kunde konnte nicht angelegt werden</strong></summary>

Mögliche Ursachen:

* Nummernserie erschöpft.
* Pflichtfelder fehlen in Shopware.
* Debitorenvorlage nicht konfiguriert.

**Lösung**

1. Prüfen Sie das **Aktivitätsprotokoll.**
2. Korrigieren Sie die Kundendaten.
3. Importieren Sie die Bestellung erneut.

</details>

<details>

<summary><strong>Kunde nicht gefunden</strong></summary>

Mögliche Ursachen:

* Kundennummer stimmt nicht überein.
* E-Mail-Adresse wurde geändert.
* Mapping-Typ passt nicht.

**Lösung**

1. Prüfen Sie das **Aktivitätsprotokoll.**
2. Korrigieren Sie die Kundendaten.
3. Importieren Sie die Bestellung erneut.

</details>

<details>

<summary><strong>Falscher Kundentyp zugeordnet</strong></summary>

1. Prüfen Sie die **Kundengruppe** in Shopware.
2. Prüfen Sie das **Kundengruppen-Mapping.**
3. Korrigieren Sie den Debitor in BC.

</details>

<details>

<summary><strong>USt-IdNr. fehlt</strong></summary>

* Kunde muss USt-IdNr. in Shopware hinterlegen.
* Bei nächster Bestellung wird diese übernommen.
* Oder manuell in BC nachtragen.

</details>

<details>

<summary><strong>Staffelpreise werden nicht angezeigt</strong></summary>

1. Prüfen Sie, ob Staffelzeilen in BC existieren.
2. Prüfen Sie das **Staffelpreis-Limit** in den Einstellungen.
3. Synchronisieren Sie den Artikel erneut.

</details>

<details>

<summary><strong>Falscher Preis im Warenkorb</strong></summary>

1. Prüfen Sie die Mindestmengen in BC.
2. Prüfen Sie die Kundengruppen-Zuordnung.
3. Leeren Sie den Shopware-Cache.

</details>

<details>

<summary><strong>Sonderpreis wird nicht angezeigt</strong></summary>

* Prüfen Sie das **Gültigkeitsdatum** (Start/Ende).
* Prüfen Sie die **Kundengruppen-Zuordnung.**
* Synchronisieren Sie den Artikel erneut.
* Leeren Sie den Shopware-Cache.

</details>

<details>

<summary><strong>Falscher Preis für Kunde</strong></summary>

* Prüfen Sie die Kundengruppe des Kunden.
* Prüfen Sie die Preisgruppen-Zuordnung in BC.
* Prüfen Sie das Mapping in den Einstellungen.

</details>

**Bestellimport**

<details>

<summary><strong>Bestellungen werden nicht importiert</strong></summary>

**Symptome:**

* Keine neuen Bestellungen in BC.
* Leere Bestellliste trotz Shopware-Bestellungen.

**Mögliche Ursachen:**

1. Statusfilter schließt Bestellungen aus
2. Bestellungen bereits importiert
3. Verbindungsproblem

**Lösungen:**

1. Prüfen Sie den **Statusfilter** in den Einstellungen.
2. Prüfen Sie das **Aktivitätsprotokoll.**
3. Führen Sie einen manuellen Download durch.

</details>

<details>

<summary><strong>Kunde nicht gefunden</strong></summary>

**Symptome:**

* Bestellung kann nicht importiert werden.
* Fehlermeldung: Kunde existiert nicht.

**Lösungen:**

1. Aktivieren Sie **automatische Kundenanlage.**
2. Prüfen Sie das **Kunden-Zuordnung** (E-Mail/Kundennummer). (Mapping fehlt)
3. Legen Sie den Kunden manuell an.

</details>

<details>

<summary><strong>Artikel nicht gefunden</strong></summary>

**Symptome:**

* Bestellposition kann nicht zugeordnet werden.
* Fehlermeldung: Artikelnummer unbekannt

**Lösungen:**

1. Prüfen Sie die **Artikelnummer** in BC.
2. Legen Sie den Artikel in BC an.
3. Prüfen Sie das Artikelnummern-Zuordnung.

</details>

<details>

<summary><strong>Importfehler</strong></summary>

* Prüfen Sie das *"Aktivitätsprotokoll".*
* Häufige Fehler: fehlende Zuordnungs-Einträge, unbekannte Zahlungsmethoden.
* Ergänzen Sie fehlende Zuordnung und starten Sie den Import erneut.

</details>

<details>

<summary><strong>Zahlungsmethode unbekannt</strong></summary>

Mapping fehlt <i class="fa-right">:right:</i> Zahlungsmethoden-Mapping ergänzen

</details>

<details>

<summary><strong>Fehlerhafte Bestellungen</strong></summary>

1. Öffnen Sie das **Aktivitätsprotokoll.**
2. Filtern Sie nach Fehlern.
3. Beheben Sie die Ursache.
4. Importieren Sie erneut.

</details>

<details>

<summary><strong>Status wird nicht aktualisiert</strong></summary>

1. Prüfen Sie die **API-Verbindung.**
2. Prüfen Sie das **Aktivitätsprotokoll.**
3. Stellen Sie sicher, dass die Bestellung in Shopware existiert.

</details>

<details>

<summary><strong>Tracking nicht sichtbar</strong></summary>

1. Prüfen Sie, ob das Tracking-Feld korrekt gefüllt ist.
2. Prüfen Sie das Format der Paketnummer.
3. Melden Sie den Status erneut.

</details>

**Artikel / Stammdatenverwaltung**

<details>

<summary><strong>Kategorie existiert nicht in Shopware</strong></summary>

1. Prüfen Sie die **Shopware ID** in BC.
2. Prüfen Sie, ob die Kategorie in Shopware gelöscht wurde.
3. Aktualisieren Sie das Mapping oder erstellen Sie die Kategorie neu.

</details>

<details>

<summary><strong>Artikel erscheint nicht in der Kategorie</strong></summary>

1. Prüfen Sie die Kategoriezuordnung in BC.
2. Prüfen Sie, ob der Artikel als "Web-Artikel" markiert ist.
3. Synchronisieren Sie den Artikel erneut.

</details>

<details>

<summary><strong>Bild wird nicht hochgeladen</strong></summary>

1. Prüfen Sie die **Bilder Ordner-ID** in den Einstellungen.
2. Prüfen Sie das Bildformat und die Dateigröße.
3. Prüfen Sie das Aktivitätsprotokoll auf Fehler.

</details>

<details>

<summary><strong>Bild erscheint nicht im Shop</strong></summary>

1. Prüfen Sie, ob das Bild in Shopware vorhanden ist.
2. Prüfen Sie, ob das Bild dem Produkt zugeordnet ist.
3. Leeren Sie den Shopware-Cache.

</details>

<details>

<summary><strong>Falsche Bildreihenfolge</strong></summary>

1. Prüfen Sie die Reihenfolge in BC.
2. Synchronisieren Sie den Artikel erneut.
3. Ggf. Reihenfolge in Shopware manuell anpassen.

</details>

<details>

<summary><strong>Shopware Medienordner, Ordner-ID</strong></summary>

<a class="button primary">Shopware Medienordner</a>

</details>

<details>

<summary><strong>Bestand stimmt nicht überein.</strong></summary>

1. Prüfen Sie den **Lagerort** in den Einstellungen.
2. Prüfen Sie, ob Reservierungen berücksichtigt werden.
3. Synchronisieren Sie manuell erneut.

</details>

<details>

<summary><strong>Artikel nicht verfügbar trotz Bestand.</strong></summary>

1. Prüfen Sie, ob der Artikel in Shopware aktiv ist.
2. Prüfen Sie die Verkaufskanal-Zuordnung.
3. Leeren Sie den Shopware-Cache.

</details>

<details>

<summary><strong>Synchronisation läuft nicht.</strong></summary>

* Prüfen Sie den Aufgabenwarteschlangenposten.
* Prüfen Sie die API-Verbindung.
* Prüfen Sie das Aktivitätsprotokoll.

</details>

**Attribute**

<details>

<summary><strong>Attribut wird nicht synchronisiert</strong></summary>

* Prüfen Sie, ob der Artikel als *"Web-Artikel"* gekennzeichnet ist.
* Prüfen Sie die Attribut-Mapping/Zuordnung-Tabelle.
* Prüfen Sie das Aktivitätsprotokoll auf Fehler.

</details>

<details>

<summary><strong>Attributwert fehlt in Shopware</strong></summary>

* Prüfen Sie, ob der Wert in BC korrekt zugewiesen ist.
* Synchronisieren Sie den Artikel erneut.
* Leeren Sie den Shopware-Cache.

</details>

**Artikelsynchronisation**

<details>

<summary><strong>Artikel erscheint nicht im Shop</strong></summary>

**Symptome:**

* Artikel wurde hochgeladen, ist aber nicht sichtbar
* Keine Fehlermeldung

**Mögliche Ursachen:**

1. Artikel nicht aktiviert
2. Keinem Verkaufskanal zugeordnet
3. Keiner Kategorie zugeordnet

**Lösungen:**

1. Aktivieren Sie den Artikel in Shopware.
2. Ordnen Sie den Artikel einem **Verkaufskanal** zu.
3. Ordnen Sie den Artikel einer **Kategorie** zu.

</details>

<details>

<summary><strong>Preis stimmt nicht</strong></summary>

**Symptome:**

* Falscher Preis in Shopware.
* Preis weicht von BC ab.

**Lösungen:**

1. Prüfen Sie das **Preisfeld** in den Einstellungen.
2. Prüfen Sie die **MwSt.-Zuordnung.**
3. Prüfen Sie die **Netto/Brutto-Einstellung.**
4. Synchronisieren Sie den Preis erneut.

</details>

<details>

<summary><strong>Bestand stimmt nicht</strong></summary>

**Symptome:**

* Falscher Bestand in Shopware.
* Bestand ist 0 trotz Lagerbestand.

**Lösungen:**

1. Prüfen Sie den **Lagerort** in den Einstellungen.
2. Prüfen Sie die **Bestandsoption** (verfügbar vs. physisch).
3. Synchronisieren Sie den Bestand erneut.

</details>

<details>

<summary><strong>Bestandssynchronisation</strong></summary>

**Automatische Synchronisation**

Der Bestand kann automatisch synchronisiert werden:

1. Erstellen Sie einen *"Aufgabenwarteschlangenposten"*.
2. Wählen Sie die "*Codeunit*" "*Bestandsupload***".**
3. Legen Sie das Intervall fest (z.B. alle 30 Minuten).

**Manuelle Synchronisation**

1. Öffnen Sie die *"Artikelkarte".*
2. Klicken Sie auf *"Aktionen" → "Bestand zu Shopware"*

Oder für mehrere Artikel:

1. Öffnen Sie die *"Artikelliste".*
2. Wählen Sie die gewünschten Artikel aus.
3. Klicken Sie auf *"Bestand zu Shopware".*

</details>

**PDF-Dokumente**

<details>

<summary><strong>PDF-Upload schlägt fehl</strong></summary>

<table><thead><tr><th width="200.827392578125">Fehler</th><th width="247.597900390625">Mögliche Ursache</th><th>Lösung</th></tr></thead><tbody><tr><td>Kunde nicht gefunden.</td><td>Kundennummer/E-Mail exisiert nicht in Shopware.</td><td>Prüfen Sie die Kundendaten in beiden System.</td></tr><tr><td>PDF konnte nicht generiert werden.</td><td>Berichtslayout fehlt oder ist fehlerhaft.</td><td>Prüfen Sie die Berichtseinstellungen.</td></tr><tr><td>Verbindungsfehler</td><td>API-Verbindung zu Shopware unterbrochen.</td><td>Prüfen Sie die Netzwerkverbindung und API-Einstellungen.</td></tr><tr><td>Modul nicht aktiviert.</td><td>PDF-Modul ist in BC nicht aktiviert.</td><td>Aktivieren Sie das Modul in der Konfiguration.</td></tr></tbody></table>

</details>

<details>

<summary><strong>Dokumenttyp wird nicht übersetzt</strong></summary>

**Symptome:**

* Anzeige: "solutioo-invoice-documents.account.type.xxx"
* Übersetzung fehlt

**Lösungen:**

1. Leeren Sie den **Shopware-Cache.**
2. Kompilieren Sie das **Theme** neu.
3. Prüfen Sie die **Snippet-Dateien.**

</details>

<details>

<summary><i class="fa-screwdriver-wrench">:screwdriver-wrench:</i> <strong>Dokumente werden nicht angezeigt</strong></summary>

* Prüfen Sie, ob das Plugin aktiviert ist.
* Leeren Sie den Cache: `bin/console cache:clear`
* Kompilieren Sie das Theme: `bin/console theme:compile`

</details>

<details>

<summary><strong>API-Fehler 401 (Unauthorized)</strong></summary>

* Prüfen Sie die API-Zugangsdaten in Business Central.
* Stellen Sie sicher, dass die Integration aktiv ist.
* Prüfen Sie die Berechtigungen der Integration.

</details>

<details>

<summary><strong>Kunde nicht gefunden</strong></summary>

* Prüfen Sie, ob der Kunde in Shopware existiert.
* Vergleichen Sie E-Mail-Adresse und Kundennummer.
* Prüfen Sie auf Tippfehler in den Daten.

</details>

**Performance / Automatisierung**

<details>

<summary><strong>Synchronisation dauert sehr lange</strong></summary>

**Symptome:**

* Timeout bei großen Datenmengen
* Langsame Performance

**Lösungen:**

1. Reduzieren Sie die **Datenmenge pro Synchronisation.**
2. Nutzen Sie **Filter** für inkrementelle Updates.
3. Planen Sie Synchronisationen **außerhalb der Stoßzeiten.**

</details>

<details>

<summary><strong>Aufgabenwarteschlangenposten: Aufgabe läuft nicht</strong></summary>

* Prüfen Sie den **Status** (muss "Bereit" oder "In Warteschlange" sein)
* Prüfen Sie die **Früheste Startzeit**
* Prüfen Sie die **Wochentags-Einstellung**
* Starten Sie den Aufgabenwarteschlangenposten-Dienst neu

</details>

<details>

<summary><strong>Aufgabenwarteschlangenposten: Fehler bei Ausführung</strong></summary>

* Öffnen Sie die **Fehlermeldung**
* Prüfen Sie die **API-Verbindung**
* Prüfen Sie das **Aktivitätsprotokoll**
* Beheben Sie das Problem und setzen Sie den Status auf "Bereit"

</details>

<details>

<summary><strong>Upload schlägt fehl</strong></summary>

* Prüfen Sie die **API-Verbindung.**
* Prüfen Sie das **Aktivitätsprotokoll.**
* Beheben Sie die gemeldeten Fehler.
* Versuchen Sie es erneut.

</details>

<details>

<summary><strong>Daten nicht aktualisiert</strong></summary>

1. Prüfen Sie, ob der Artikel als "Web-Artikel" markiert ist.
2. Prüfen Sie die Mapping-Tabellen.
3. Leeren Sie den Shopware-Cache.

</details>

<details>

<summary><strong>Kunde nicht gefunden</strong></summary>

**Ursache:** Kunden-Mapping fehlgeschlagen

**Lösung:**

1. Prüfen Sie die E-Mail/Kundennummer.
2. Aktivieren Sie automatische Kundenanlage.
3. Oder legen Sie den Kunden manuell an.

</details>

<details>

<summary><strong>Artikel nicht gefunden</strong></summary>

**Ursache:** Artikelnummer in BC nicht vorhanden

**Lösung:**

1. Prüfen Sie die Artikelnummer.
2. Legen Sie den Artikel in BC an.
3. Oder korrigieren Sie das Mapping.

</details>

<details>

<summary><strong>Verbindung fehlgeschlagen</strong></summary>

**Ursache:** API nicht erreichbar

**Lösung:**

1. Prüfen Sie die Shopware-URL.
2. Prüfen Sie die API-Zugangsdaten.
3. Prüfen Sie Firewall-Einstellungen.

</details>

<details>

<summary><strong>Timeout bei Anfrage</strong></summary>

**Ursache:** Anfrage dauert zu lange

**Lösung:**

1. Reduzieren Sie die Datenmenge pro Anfrage.
2. Erhöhen Sie ggf. Timeout-Werte.
3. Prüfen Sie die Server-Performance.

</details>

**Allgemeine Tipps**

<details>

<summary><strong>Vor der Kontaktaufnahme mit Support</strong></summary>

1. **Prüfen Sie das Aktivitätsprotokoll** für Fehlermeldungen.
2. **Notieren Sie** die genaue Fehlermeldung.
3. **Dokumentieren Sie** die durchgeführten Schritte.
4. **Prüfen Sie** diese FAQ auf bekannte Lösungen.

</details>

<details>

<summary><strong>Cache leeren</strong></summary>

In Shopware:

```bash
bin/console cache:clear
bin/console theme:compile
```

In Business Central:

* Starten Sie den BC-Client neu.
* Leeren Sie den Browser-Cache.

</details>

<details>

<summary><strong>Entwicklerprotokoll aktivieren</strong></summary>

Für detaillierte Fehleranalyse:

1. Öffnen Sie **Shopware** → **Einstellung**
2. Aktivieren Sie *"Erlaube Entwickler-Protokoll".*
3. Reproduzieren Sie das Problem.
4. Prüfen Sie das *"API-Call-Log".*

</details>

###

#### Weitere Antworten nach Themen

Ergänzend zu den obigen Lösungen finden Sie thematisch sortierte Kurzantworten im FAQ-Bereich:

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Verbindung &#x26; Authentifizierung</strong></td><td>Öffnen</td></tr><tr><td><strong>Artikel &#x26; Katalog</strong></td><td>Öffnen</td></tr><tr><td><strong>Preise &#x26; Bestand</strong></td><td>Öffnen</td></tr><tr><td><strong>Bestellungen</strong></td><td>Öffnen</td></tr><tr><td><strong>Kunden &#x26; B2B</strong></td><td>Öffnen</td></tr><tr><td><strong>Synchronisation &#x26; Fehler</strong></td><td>Öffnen</td></tr></tbody></table>

{% hint style="info" %}
Zur tiefergehenden Fehleranalyse helfen das Aktivitätsprotokoll, der API Call Log und der Leitfaden API-Antworten analysieren.
{% endhint %}


# Logs und Monitoring

Erfahren Sie, wie Sie Logs und Monitoring für den Shopware 6 API Connector nutzen.

Der Shopware 6 API Connector bietet umfangreiche Logging- und Monitoring-Funktionen für Fehleranalyse und Überwachung.

## 1. Aktivitätsprotokoll

### Übersicht

Das Aktivitätsprotokoll zeichnet alle wichtigen Aktionen und Ereignisse auf:

1. Öffnen Sie **Shopware** → **Aktivitätsprotokoll**
2. Sie sehen eine Liste aller Aktivitäten

<div align="left" data-with-frame="true"><figure><img src="/files/6XslS2Xte5Rjb9jd4QoA" alt="" width="563"><figcaption></figcaption></figure></div>

### Protokollierte Ereignisse

<table><thead><tr><th width="155.4857177734375">Ereignis</th><th width="295.5506591796875">Beschreibung</th></tr></thead><tbody><tr><td>Artikelupload</td><td>Artikel zu Shopware synchronisiert</td></tr><tr><td>Bestelldownload</td><td>Bestellung aus Shopware importiert</td></tr><tr><td>Preisupload</td><td>Preis aktualisiert</td></tr><tr><td>Bestandsupload</td><td>Bestand synchronisiert</td></tr><tr><td>Bildupload</td><td>Bild hochgeladen</td></tr><tr><td>PDF-Upload</td><td>Dokument hochgeladen</td></tr><tr><td>Fehler</td><td>Fehler bei einer Aktion</td></tr></tbody></table>

### Filtern und Suchen

Sie können das Protokoll filtern nach:

* **Datum** – Zeitraum eingrenzen
* **Modul** – Nur bestimmte Funktionsbereiche
* **Status** – Erfolg oder Fehler
* **Datensatz** – Bestimmter Artikel, Kunde, etc.

## API-Call-Log

### Detaillierte API-Aufzeichnung

Für technische Analyse:

1. Aktivieren Sie **Erlaube Entwickler-Protokoll** in den Einstellungen
2. Öffnen Sie **Shopware** → **API Calls Log**
3. Sie sehen alle API-Aufrufe im Detail

### Protokollierte Informationen

| Information   | Beschreibung             |
| ------------- | ------------------------ |
| Zeitstempel   | Wann der Aufruf erfolgte |
| Endpunkt      | Aufgerufene API-URL      |
| Methode       | GET, POST, PUT, DELETE   |
| Request-Body  | Gesendete Daten          |
| Response-Code | HTTP-Statuscode          |
| Response-Body | Empfangene Daten         |
| Dauer         | Ausführungszeit          |

### API-Call analysieren

1. Wählen Sie einen Eintrag aus
2. Klicken Sie auf **Details anzeigen**
3. Analysieren Sie Request und Response

## Aufgabenwarteschlangen-Protokoll

### Ausführungshistorie

1. Öffnen Sie **Aufgabenwarteschlangenposten**
2. Wählen Sie einen Posten
3. Klicken Sie auf **Protokollposten**

### Protokollierte Informationen

| Information   | Beschreibung          |
| ------------- | --------------------- |
| Startzeit     | Beginn der Ausführung |
| Endzeit       | Ende der Ausführung   |
| Dauer         | Gesamtdauer           |
| Status        | Erfolg oder Fehler    |
| Fehlermeldung | Bei Fehlern: Details  |

## Monitoring-Dashboard

### Bestellübersicht

Die Bestellübersicht bietet einen schnellen Überblick:

* Anzahl importierter Bestellungen (heute/gesamt)
* Letzte erfolgreiche Synchronisation
* Offene Fehler
* Verbindungsstatus

### Statusanzeigen

| Status  | Bedeutung           |
| ------- | ------------------- |
| 🟢 Grün | Alles OK            |
| 🟡 Gelb | Warnungen vorhanden |
| 🔴 Rot  | Fehler aufgetreten  |

## Fehlerbenachrichtigungen

### E-Mail-Benachrichtigungen

Richten Sie automatische Benachrichtigungen ein:

1. Öffnen Sie **Aufgabenwarteschlangenposten**
2. Aktivieren Sie **Bei Fehler benachrichtigen**
3. Geben Sie E-Mail-Adressen an

### Benachrichtigungsoptionen

| Option                  | Beschreibung               |
| ----------------------- | -------------------------- |
| Bei jedem Fehler        | Sofortige Benachrichtigung |
| Täglich zusammengefasst | Täglicher Fehlerbericht    |
| Bei kritischen Fehlern  | Nur wichtige Fehler        |

## Protokoll-Aufbewahrung

### Automatische Bereinigung

Protokolle werden automatisch nach einem definierten Zeitraum gelöscht:

* Aktivitätsprotokoll: 30 Tage
* API-Call-Log: 7 Tage (bei aktiviertem Entwicklerprotokoll)
* Aufgabenwarteschlangen-Log: 30 Tage

### Manuelle Bereinigung

Bei Bedarf können Sie Protokolle manuell löschen:

1. Öffnen Sie das entsprechende Protokoll
2. Filtern Sie nach Zeitraum
3. Löschen Sie alte Einträge

## Best Practices

### Regelmäßige Überwachung

* Prüfen Sie täglich die Aktivitätsprotokolle
* Reagieren Sie schnell auf Fehler
* Dokumentieren Sie wiederkehrende Probleme

### Entwicklerprotokoll

{% hint style="warning" %}
Das Entwicklerprotokoll erfasst detaillierte Daten und sollte nur bei Bedarf aktiviert werden. Es kann die Performance beeinflussen und speichert sensible Daten.
{% endhint %}

### Protokoll-Export

Für Support-Anfragen:

1. Filtern Sie das relevante Protokoll
2. Exportieren Sie die Daten
3. Senden Sie sie an den Support


# Supportkontakte

Unser Support-Team steht Ihnen bei Fragen und Problemen zur Verfügung.

<h4 align="center">Besuchen Sie unsere Website und erfahren Sie mehr über unsere Lösungen:</h4>

<p align="center"><a href="https://www.solutioo.de/" class="button primary">Solutioo</a></p>

***

<h3 align="center"><i class="fa-comment">:comment:</i> Kontaktformular</h3>

<h4 align="center">Treten Sie mit unseren Experten in Kontakt:</h4>

{% @dynamics-contact-form/dynamics-form url="<https://assets-eur.mkt.dynamics.com/4fdafba7-58a0-439d-ac40-8b9307b6aa29/digitalassets/standaloneforms/26148488-e600-f111-8407-7ced8d493772>" %}

**Wenn Sie zufrieden sind:**

⭐ Bewerten Sie uns auf Microsoft AppSource.

⭐ Empfehlen Sie uns weiter.

⭐ Teilen Sie Ihre Erfolgsgeschichte.


# Onboarding & Best Practices

Dieser Bereich bündelt **praxiserprobte Vorgehensweisen** für die Einführung und den laufenden Betrieb. Statt einzelner Funktionen stehen hier **komplette Abläufe** im Vordergrund – von der Erstübertragung des Katalogs bis zur Go-Live-Checkliste.

Sie erfahren, wie Sie den **Katalog initial übertragen**, wie ein sinnvoller **täglicher Betrieb** aussieht, wie Sie einen **B2B-Shop** aufsetzen, **mehrere Verkaufskanäle** betreiben, **Preisaktionen** planen und bei einem Shopwechsel einen **sauberen Neustart per Reset** durchführen.

{% hint style="success" %}
Für einen entspannten Go-Live: erst in einer **Testumgebung** üben, dann mit wenigen Artikeln live gehen und schrittweise ausrollen.
{% endhint %}

**Inhalte dieses Bereichs**

<table data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Katalog initial übertragen</strong></td><td></td><td>Öffnen</td></tr><tr><td><strong>Täglicher Betrieb</strong></td><td></td><td>Öffnen</td></tr><tr><td><strong>B2B-Shop aufsetzen</strong></td><td></td><td>Öffnen</td></tr><tr><td><strong>Mehrere Verkaufskanäle betreiben</strong></td><td></td><td>Öffnen</td></tr><tr><td><strong>Preisaktionen planen</strong></td><td></td><td>Öffnen</td></tr><tr><td><strong>Sauberer Neustart per Reset</strong></td><td></td><td>Öffnen</td></tr><tr><td><strong>Go-Live-Checkliste</strong></td><td></td><td>Öffnen</td></tr></tbody></table>


# Katalog initial übertragen

Dieser Leitfaden bringt Ihren **kompletten Artikelkatalog** strukturiert und fehlerarm nach Shopware. Die Reihenfolge ist bewusst gewählt, damit Abhängigkeiten (z. B. Kategorien vor Artikeln) stimmen.

{% stepper %}
{% step %}
**Grundlagen sicherstellen**

Verbindung, Erstdaten und Zuordnungen (Steuern, Währung, Kanal, Kundengruppe) müssen stehen.
{% endstep %}

{% step %}
**Kategorien & Attribute**

Legen Sie Artikelkategorien und Artikelattribute an bzw. laden Sie sie hoch.
{% endstep %}

{% step %}
**Artikel als Web-Artikel markieren**

Markieren Sie die zu übertragenden Artikel (Aktion *Alle als Web-Artikel markieren* oder je Artikel **Web Artikel = Ja**).
{% endstep %}

{% step %}
**Bilder & Texte pflegen**

Hinterlegen Sie Artikelbilder, Marketingtexte und ggf. SEO-Metadaten.
{% endstep %}

{% step %}
**Testlauf**

Laden Sie zunächst **wenige Artikel** hoch und prüfen Sie das Ergebnis im Shop und im Aktivitätsprotokoll.
{% endstep %}

{% step %}
**Massen-Upload**

Übertragen Sie den Rest über den Massen-Upload-Report – idealerweise außerhalb der Geschäftszeiten.
{% endstep %}

{% step %}
**Preise & Bestand**

Laden Sie abschließend Preise und Bestände hoch.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Aktivieren Sie danach die Automatisierung, damit Änderungen künftig automatisch übertragen werden.
{% endhint %}


# Täglicher Betrieb

Im eingeschwungenen Betrieb erledigt der Connector das meiste automatisch. Dieser Leitfaden zeigt, worauf Sie im Alltag achten.

**Läuft automatisch**

* Abruf neuer **Bestellungen** und Anlage als BC-Auftrag.
* Upload geänderter **Artikel, Preise und Bestände**.
* Rückmeldung von **Liefer- und Rechnungsstatus** beim Buchen.

**Kurze tägliche Kontrolle**

{% stepper %}
{% step %}
**Order-Dashboard prüfen**

Gibt es **fehlgeschlagene** oder **offene** Bestellungen? Siehe Order-Dashboard.
{% endstep %}

{% step %}
**Aktivitätsprotokoll sichten**

Gab es Fehler bei Uploads? Siehe Aktivitätsprotokoll.
{% endstep %}

{% step %}
**Preisliste prüfen**

Sind alle Preise synchronisiert? Siehe Preislisten-Übersicht.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Eine feste, kurze Morgenroutine (5 Minuten) genügt meist, um den reibungslosen Betrieb sicherzustellen.
{% endhint %}


# B2B-Shop aufsetzen

Für den B2B-Vertrieb spielt der Connector seine Stärken aus: Firmenkunden, individuelle Preise und anmeldbare Ansprechpartner mit Rollen.

{% stepper %}
{% step %}
**Kundengruppen definieren**

Legen Sie B2B-Kundengruppen fest (inkl. Netto-Anzeige).
{% endstep %}

{% step %}
**Kundengruppen-Preise**

Hinterlegen Sie kundengruppenspezifische Preise über BC-Preislisten.
{% endstep %}

{% step %}
**Firmenkunden hochladen**

Übertragen Sie die Debitoren als Web-Kunden.
{% endstep %}

{% step %}
**B2B-Benutzer anlegen**

Übertragen Sie Kontakte als B2B-Benutzer und vergeben Sie Rollen (Anzeige, Besteller, Freigabe).
{% endstep %}
{% endstepper %}

{% hint style="info" %}
So erhalten Ihre Firmenkunden individuelle Preise und ein Rollen-/Freigabekonzept – ohne doppelte Datenpflege.
{% endhint %}


# Mehrere Verkaufskanäle betreiben

Sie können mehrere Shopware-**Verkaufskanäle** über eine einzige Anbindung bespielen – z. B. verschiedene Storefronts oder Marken.

**Vorgehen**

{% stepper %}
{% step %}
**Kanäle zuordnen**

Markieren Sie Standardkanäle in der Zuordnung.
{% endstep %}

{% step %}
**Sortiment je Kanal steuern**

Weisen Sie Artikel gezielt Kanälen zu – siehe Vertriebskanäle am Artikel.
{% endstep %}

{% step %}
**Sichtbarkeit prüfen**

Nach dem Upload setzt der Connector die Sichtbarkeit je Kanal automatisch. Kontrollieren Sie die Darstellung im jeweiligen Storefront.
{% endstep %}
{% endstepper %}

**Empfehlungen**

* Definieren Sie klar, welche Artikel in welchen Kanal gehören.
* Nutzen Sie Tags, um kanalübergreifende Sortimente zu strukturieren.

{% hint style="info" %}
Ein nicht zugewiesener Artikel ist im jeweiligen Kanal **nicht sichtbar** – prüfen Sie bei fehlenden Produkten zuerst die Kanalzuweisung.
{% endhint %}


# Preisaktionen planen

Aktionspreise, Saisonpreise oder Mengenrabatte lassen sich zeitgesteuert ausrollen – dank PATCH-Aktualisierung **ohne Duplikate**.

{% stepper %}
{% step %}
**Preise vorbereiten**

Hinterlegen Sie die Aktionspreise als Sonderpreise oder Staffelpreise mit **Start-** und **Enddatum**.
{% endstep %}

{% step %}
**Zeiträume prüfen**

Zeilen mit zukünftigem Startdatum werden erst bei Gültigkeit übertragen; abgelaufene Zeilen werden automatisch entfernt.
{% endstep %}

{% step %}
**Hochladen & überwachen**

Laden Sie die Preise hoch und kontrollieren Sie den Status in der Preislisten-Übersicht.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Beim Wechsel von Preisperioden wird die vorhandene **Web-ID** übernommen und der Preis per PATCH aktualisiert – so entstehen keine doppelten Einträge. Details: Preis-Upload ohne Duplikate.
{% endhint %}

{% hint style="warning" %}
Testen Sie eine Aktion vorab mit wenigen Artikeln und prüfen Sie die Anzeige im Shop, bevor Sie sie breit ausrollen.
{% endhint %}


# Sauberer Neustart per Reset

Manchmal ist ein kontrollierter Neuaufbau sinnvoll – etwa nach großen Änderungen oder beim Umzug in eine neue Shopware-Instanz. Der Connector bietet dafür gestufte Reset-Funktionen.

**Gestufte Resets**

| Reset                                            | Wirkung                                                    |
| ------------------------------------------------ | ---------------------------------------------------------- |
| MwSt-Zuordnung zurücksetzen                      | Steuerzuordnungen neu aufbauen                             |
| Kunden-Zuordnungen zurücksetzen                  | Kanal-, Gruppen-, Anrede-, Länder-Zuordnungen zurücksetzen |
| Einheiten-/Attribut-/Hersteller-IDs zurücksetzen | Verknüpfungen einzelner Stammdaten lösen                   |
| Artikel / Kategorien / Preislisten zurücksetzen  | Verknüpfung dieser Objekte lösen                           |
| ALLE Shopware-Daten zurücksetzen                 | Vollständiger Reset inkl. anschließendem Erstdaten-Laden   |

{% hint style="danger" %}
Der vollständige Reset löst **alle Verknüpfungen** und kann Shopware-Objekte löschen. Führen Sie ihn nur nach Rücksprache und mit vorherigem Konfigurations-Export durch.
{% endhint %}

**Empfohlener Neuaufbau**

{% stepper %}
{% step %}
**Sichern**

Konfiguration als JSON exportieren.
{% endstep %}

{% step %}
**Zurücksetzen**

Gewünschten Reset ausführen (möglichst gezielt statt vollständig).
{% endstep %}

{% step %}
**Neu aufbauen**

Erstdaten laden, Zuordnungen pflegen, dann Katalog initial übertragen.
{% endstep %}
{% endstepper %}


# Go-Live-Checkliste

Vor dem produktiven Start sollten die folgenden Punkte erledigt sein.

**Verbindung & Grundlagen**

* [ ] Verbindung erfolgreich getestet
* [ ] Passende Authentifizierungsmethode gewählt
* [ ] Erstdaten geladen

**Zuordnungen**

* [ ] Steuern zugeordnet (Steuern & Steuerzuordnung)
* [ ] Zahlungs- und Versandarten zugeordnet
* [ ] Standard-Währung, -Verkaufskanal und -Kundengruppe markiert
* [ ] Anreden & Länder gepflegt

**Daten**

* [ ] Testartikel erfolgreich hochgeladen und im Shop geprüft
* [ ] Preise und Bestände korrekt übertragen
* [ ] Test-Bestellung erfolgreich als BC-Auftrag angelegt

**Betrieb**

* [ ] Automatisierung eingerichtet
* [ ] Monitoring-Routine definiert (Aktivitätsprotokoll)
* [ ] Ansprechpartner & Supportkontakte bekannt

{% hint style="success" %}
Erst wenn alle Punkte erledigt sind, sollten Sie echte Bestellungen verarbeiten und den Shop live schalten.
{% endhint %}




---

[Next Page](/llms-full.txt/1)