> 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/data-from-shopware-download-and-matching/download-categories-from-shopware.md).

# Download Categories from Shopware

If a **category tree** is already maintained in your shop, you should **adopt this structure in Business Central instead of creating it again**. To do so, the connector downloads the complete category list from Shopware, creates or updates the categories in BC, and stores the respective **Shopware ID** so that items can be assigned correctly later on.

**What is downloaded**

The download calls the Shopware search for categories (`search/category`) and retrieves up to **500 categories** in a single run, including all relevant fields:

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Structure</strong></td><td>ID, name, parent category (parentId), level, number of subcategories, sort order.</td></tr><tr><td><strong>Visibility</strong></td><td>Active and visible – controls whether the category appears in the shop.</td></tr><tr><td><strong>SEO &#x26; text</strong></td><td>Description, meta title, meta description, and keywords.</td></tr><tr><td><strong>Media</strong></td><td>Assigned category image (media ID and image URL).</td></tr></tbody></table>

**How the download works**

The connector works in several passes so that the tree is consistent at the end:

{% stepper %}
{% step %}
**Create/update categories**

Each category is created in BC or – if it already exists based on the Shopware ID – updated.
{% endstep %}

{% step %}
**Set parent-child relationships**

In the second pass, the **parent categories** are linked so that the tree is mapped correctly.
{% endstep %}

{% step %}
**Renumber the sort order**

The sort order is reassigned per level in clean increments (10, 20, 30 …).
{% endstep %}

{% step %}
**Load image URLs**

For categories with an assigned image, the media URL is loaded afterwards.
{% endstep %}
{% endstepper %}

At the end, the connector reports **how many categories** were processed successfully and how many errors occurred.

{% hint style="info" %}
Run the category download **before** the large item upload. The categories are then available with their Web-IDs and items can be assigned to them directly.
{% endhint %}

**Troubleshooting**

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Incomplete tree</strong></td><td>More than 500 categories? The download is designed for 500 per run – check the structure.</td></tr><tr><td><strong>Incorrect sort order</strong></td><td>The sort order is reassigned during the download; synchronize subsequent changes again.</td></tr><tr><td><strong>No image</strong></td><td>Category without a media ID – assign an image in the shop and load it again.</td></tr></tbody></table>

**Related topics**

* [Download Tags from Shopware](/shopware/shopware6_en_us/data-from-shopware-download-and-matching/download-tags-from-shopware.md)
* [Download Group Items from Shopware](/shopware/shopware6_en_us/data-from-shopware-download-and-matching/download-group-items-from-shopware.md)
* [Data from Shopware (Download & Matching)](/shopware/shopware6_en_us/data-from-shopware-download-and-matching.md)

### Frequently Asked Questions

#### How do I download all categories from Shopware to Business Central?

The "Download All" action calls `search/category` (POST, limit 500) and writes the categories to the "SOUSHW Category" table. "Fix Parent Links" repairs the parent-child links, and "Sync Sort Order" applies the sort order.


---

# 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/data-from-shopware-download-and-matching/download-categories-from-shopware.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.