For the complete documentation index, see llms.txt. This page is also available as Markdown.

Item Categories

Manage and synchronize item categories between Business Central and Shopware.

Item categories structure your product catalog and are synchronized between Business Central and Shopware.

1. Categories in Business Central

1.1 Category structure

Business Central uses categories for structuring. The categories are displayed hierarchically. Enter "Categories" in the search field to reach the corresponding menu.

1.2 Creating categories

Enter the term "Item Categories" in the Business Central search field to go directly to the corresponding menu. There, click "+ New" to create a new category. Then fill in the "Code", "Description" and (if required) "Parent Category" fields. Technically, specifying the "Code" is already sufficient; the other fields serve to provide better structure and clarity.

Code: Unique category code

Description: Category name for display

Parent Category: Parent category for the hierarchy

1.3 Assigning a category

  • Open the "Item Card" of the product you want to assign to a category.

  • Under "Item Category Code", select the category you want.

  • How do I create a category? See the previous section: "1.2 Creating categories"

Item Card menu item

2. Category synchronization

Initial download

During the initial download, all categories are imported from Shopware into Business Central:

1

The Shopware categories are retrieved.

2

Corresponding BC item categories are created.

3

The Shopware ID is stored for the mapping / assignment.

Upload to Shopware

New categories from BC can be uploaded to Shopware:

1

Create a new "item category" in BC.

2

In the Item Category Card area, open: "Actions" "Shopware" "Upload category"

3

The category is created under the configured parent category.

The parent category ID in the inventory settings determines where new categories are created in Shopware.

3. Shopware extensions

The Item Category Card has been extended with the following fields:

Shopware ID:

Assigned Shopware category ID

Web Category:

Flags the category for Shopware

4. Category mapping / category assignment

After the initial download, categories are mapped/assigned automatically based on:

  • Shopware ID (highest priority)

  • Category name (if no ID is available)

  • Open the "Item Category Card".

  • Enter the "Shopware ID" manually.

  • Save your changes.

5. Tips for day-to-day use

  • Keep the hierarchy flat (max. 3-4 levels).

  • Use meaningful names.

  • Avoid special characters in codes.

  • Create categories in Shopware first.

  • Use the initial download for the mapping.

  • Check the category assignments regularly.

Frequently asked questions

Can an item be assigned to several Shopware categories?

Yes. The "SOUSHW Shopware Categories" field stores several categories separated by pipes (field length up to 2000 characters). During the upload, all stored categories are assigned to the product; use the drill-down to see the full category paths, and AssistEdit to open the category selection.