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

Auto-Increment & inkrementeller Download

Shopware vergibt für Bestellungen eine fortlaufende Nummer (Auto-Increment). Der Connector nutzt diese, um beim Download nur neue Bestellungen zu holen.

Funktionsweise

  • Der Download filtert auf autoIncrement >= <letzter Wert + 1>.

  • So werden bereits geladene Bestellungen nicht erneut verarbeitet.

  • Über Seite und Limit steuern Sie die Menge pro Lauf.

Startwert festlegen

Beim allerersten Download legen Sie mit Shopware Start-AutoIncrement fest, ab welcher Bestellung geladen werden soll. So können Sie ältere Alt-Bestellungen bewusst überspringen.

1

Startwert setzen

Hinterlegen Sie in der Konfiguration den gewünschten Start-AutoIncrement.

2

Erstdownload

Starten Sie den Report Bestellungen herunterladen. Der Startwert wird vorgeschlagen.

3

Laufender Betrieb

Danach lädt jeder Lauf automatisch ab der zuletzt geladenen Bestellung + 1.

Häufige Fragen

Mit welchem API-Filter lädt der Connector nur neue Bestellungen?

Der Bestell-Download ruft search/order (POST) mit einem Bereichsfilter auf dem Feld autoIncrement auf (type=range, gte={letzter Wert + 1}). So werden ausschließlich Bestellungen mit einer höheren Auto-Increment-Nummer geladen; bereits importierte Bestellungen bleiben außen vor. Über „Page“ und „Limit“ (Default 500) wird die Menge pro Lauf gesteuert.

Was bewirkt der Startwert „Shopware Opening AutoIncrement“?

Der Startwert legt fest, ab welcher Auto-Increment-Nummer der allererste Download beginnt – so lassen sich Alt-Bestellungen gezielt überspringen. Der Connector stellt sicher, dass der verwendete Auto-Increment mindestens diesem Startwert entspricht, und verhindert damit versehentliche Doppelimporte.

Kann der inkrementelle Download automatisch per Job laufen?

Ja. Die Codeunit „SOUSHW Order Mgnt.“ ist Job-Queue-fähig und lädt bei jedem Lauf ab „letzter Auto-Increment + 1“. So holt ein Aufgabenwarteschlangenposten (z. B. alle 15–30 Minuten) automatisch nur die neuen Bestellungen.