> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/shopware/shopware6_en_us/master-data-management/simple-items.md). # (Simple) Items #### 1. Upload to Shopware To enable items to be uploaded to Shopware, the Item Card has been extended with additional functions. Default mapping of fields between BC and Shopware:

BC field	Shopware field
No.	Product number (productNumber)
Description	Name
Marketing Text	Description (HTML)
Unit Cost	Purchase price
Unit Price	Price
GTIN	EAN
Base Unit of Measure	Unit

To open the overview of all items in Business Central, navigate along the following path: "*Sales"* "*Items"*.

To make the following settings, select an **existing item** or create a **new item** in Business Central. {% hint style="info" %} **How do I create an item correctly?** Microsoft provides comprehensive instructions and notes on creating items in Business Central. Follow this link: Register new items {% endhint %} The item attributes are displayed. The following two screenshots show a standard view of an item with all editable properties. These can be adjusted individually depending on your settings. This explanation assumes the standard view. The individual fields are explained below.

An item can be uploaded to Shopware if the following fields are filled in on the Item Card: * **No.**: The content of this field becomes the product number in Shopware. * **Description**: The content of this field becomes the product name in Shopware. * **Blocked**: This field determines whether the item is displayed in the online shop or remains deactivated. * **Base Unit of Measure**: The content of this field becomes the unit of measure in Shopware (found under "Specification"). * **GTIN** *(visible when you select "Show more")*: Defines the GTIN in Shopware. * **Item Category Code**: The category stored here is the BC-native one. As a rule, it is only used to sort the item within Business Central. However, it is also possible to store a category that has been uploaded to Shopware as a web category. * **Shopware Categories**: Here you can store item categories for Shopware. It is also possible to assign an item to several categories, which is otherwise not possible in standard BC.\ You can find out more under [Item Categories](/shopware/shopware6_en_us/master-data-management/item-categories.md).

#### 2. Item Card description {% hint style="info" %} In the standard view, *Picture*, *Marketing Text* and *Item Attributes* are located on the right-hand side of the BC window. {% endhint %}

		Cover image
Picture	Editing is described in the section Item Pictures. For more information, please go to that section.	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&token=7dd730f8-8cbf-4622-b988-fb7bdd1a3667
Marketing Text	The marketing text becomes the product description in Shopware. It is transferred as HTML code, so formatting such as bold or italic is also possible.	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&token=5bf59def-5c2e-49f4-b4de-9dfccabe9c0a
Item Attributes	Editing is described in the section Item Attributes. For more information, please go to that section.	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&token=61996cfa-975e-45b8-9ef5-5d0d18f6445e

{% hint style="info" %} For extended product descriptions, for example using attribute-based text modules, please contact our support team: [Support Contacts](/shopware/shopware6_en_us/troubleshooting-and-support/support-contacts.md) {% endhint %} **Inventory** The Inventory field takes the stock available for the shop from the inventory settings stored in the configuration. * **Inventory:**\ The "*Inventory*" field fills the inventory in the shop based on the inventory settings configured in the setup.

**Unit costs and posting** * **Unit Cost**\ Not relevant for the display in the online shop, as this is the purchase price. It is not transferred and therefore cannot be found in the shop either. * **VAT Prod. Posting Group** (visible when you select *"Show more"*):\ Responsible for assigning the tax rate in Shopware. {% hint style="warning" %} The VAT mapping is described in [Order Configuration](/shopware/shopware6_en_us/configuration/basic-settings/order-configuration.md). This mapping must be carried out once!

{% endhint %}

**Shopware information** * **Web Item**\ **YES:** Only if Web Item is set to *YES* can the item be uploaded to the shop. {% hint style="warning" %} Please note: This does not upload the item to Shopware automatically. You trigger the upload under ***Actions*** ***Shopware*** ***Upload product***. {% endhint %} * **Parent No.**\ If this item is set up as a *variant*, you will find the parent item here. * **Shopware Active**\ YES: The item is not only uploaded to Shopware but also activated there. * **Out of Stock**\ YES: Regardless of the inventory in BC, the item is set to "*out of stock*" in Shopware. * **Web-ID**\ The Web-ID is filled in automatically after a successful upload to Shopware. * **Imported**\ YES: the item has been imported, otherwise *NO*. * **Synchronized On**\ Date of the last synchronization with Shopware. * **Inventory Quantity Synchronized** * **Inventory Quantity Synchronized On**\ Date of the last synchronization with Shopware. * **Price Synchronized** * **Price Synchronized On**\ Date of the last synchronization with Shopware. * **Synchronization Message**\ Indicates whether the last synchronization with Shopware was successful. If it failed, the error that occurred is shown.

**Sales Channel** On the Sales Channel tab, you can define which Shopware sales channel the product is intended for. Assigning an item to several sales channels is also possible here.

**Price & Sales, Replenishment, Planning, Item Tracking and Warehouse** The following screenshot illustrates the standard display of the remaining sections. These fields are:

*** #### 3. Additional options To define the **units of measure of an item** in more detail, follow this path: *Related* *Item* *Units of Measure* For example, the *weight* or the *quantity per unit* (for instance for "sets of 3") can be defined.

On the *Actions* *Shopware* tab you will find not only the *"Upload product"* button for uploading the product to Shopware, but also further functions: * **Import default pictures** ~~COMING SOON~~ * **Price list line** ~~COMING SOON~~ * **Reset synchronization status** ~~COMING SOON~~ {% updates format="full" %} {% update date="2026-06-01" tags="update" %} ## Shopware upload on the Item Card

{% endupdate %} {% endupdates %} #### 4. Summary

Flag an item as a web item

For an item to be synchronized to Shopware, it must be flagged as a **web item**: 1. Open the **Item Card.** 2. Scroll to the **Shopware Information** section. 3. Set **Web Item** to **Yes.**

Upload a single item

1. Open the **Item Card.** 2. Click **Actions** **Item to Shopware**

Upload multiple items

1. Open the **item list.** 2. Select the items you want. 3. Click **Item to Shopware.**

Automatic synchronization

1. Create a **Job Queue Entry.** 2. Select the **Item Upload** codeunit. 3. Define the interval.

#### 5. Tips for day-to-day use {% tabs %} {% tab title="Data quality" %} * Maintain complete item data (name, description, pictures). * Use meaningful item numbers. * Check the VAT mapping before uploading. {% endtab %} {% tab title="Performance" %} * Upload large catalogs outside business hours. * Use filters for selective updates. * Monitor the Activity Log. {% endtab %} {% endtabs %} {% hint style="info" %} New items may still need to be assigned to a sales channel in Shopware before they are visible in the shop. {% 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/shopware6_en_us/master-data-management/simple-items.md?ask=&goal= ``` `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.