> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/shopware/stammdatenverwaltung/artikel.md).

# (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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.solutioo.de/shopware/stammdatenverwaltung/artikel.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.