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

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.

1

Set the starting value

Enter the start AutoIncrement you want in the configuration.

2

Initial download

Start the Download Orders report. The starting value is suggested.

3

Ongoing operation

After that, every run automatically loads from the last order loaded + 1.

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.