> 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/order-processing/auto-increment-and-incremental-download.md).

# Auto-Increment & Incremental Download

Shopware assigns a consecutive number (**Auto-Increment**) to orders. The connector uses this number to retrieve **only new orders** during the download.

**How it works**

* The download filters on `autoIncrement >= <last value + 1>`.
* This way, orders that have already been loaded are not processed again.
* Use **Page** and **Limit** to control the volume per run.

**Defining the starting value**

For the very first download, you use **Shopware Start AutoIncrement** to define the order from which loading should begin. This lets you deliberately skip older legacy orders.

{% stepper %}
{% step %}
**Set the starting value**

Enter the start AutoIncrement you want in the configuration.
{% endstep %}

{% step %}
**Initial download**

Start the *Download Orders* report. The starting value is suggested.
{% endstep %}

{% step %}
**Ongoing operation**

After that, every run automatically loads from the last order loaded + 1.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
During the download, the Auto-Increment must be at least equal to the configured starting value. This prevents accidental duplicate imports of legacy orders.
{% endhint %}

### Frequently Asked Questions

#### Which API filter does the connector use to load only new orders?

The order download calls `search/order` (POST) with a range filter on the `autoIncrement` field (`type=range`, `gte={last value + 1}`). This means that only orders with a higher auto-increment number are loaded; orders that have already been imported are left out. “Page” and “Limit” (default 500) control the volume per run.

#### What does the “Shopware Opening AutoIncrement” starting value do?

The starting value defines the auto-increment number at which the very first download begins – this lets you skip legacy orders in a targeted way. The connector makes sure that the auto-increment used is at least equal to this starting value, which prevents accidental duplicate imports.

#### Can the incremental download run automatically as a job?

Yes. The “SOUSHW Order Mgnt.” codeunit is Job Queue-capable and loads from “last auto-increment + 1” on every run. This way, a Job Queue Entry (for example, every 15-30 minutes) automatically retrieves only the new orders.


---

# 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/order-processing/auto-increment-and-incremental-download.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.