Seite 1 von 1

Artikelstammdaten-Änderungen per API synchronisieren ohne Versionskonflikte bei aktiven Kassiervorgängen

Verfasst: Fr 13. Nov 2026, 09:48
von LoefflerLogistik
Wir betreiben fünf Filialen mit eigener Warenwirtschaft und nutzen die REST-Schnittstelle der QuickKasse für nächtliche Stammdatenabgleiche (Preise, Steuersätze, Varianten). Seit dem letzten Update auf Version 4.2 treten sporadisch Sperrvermerke auf, wenn ein Kassiervorgang exakt in dem Zeitfenster läuft, in dem der API-Client per PUT /articles/{id} Änderungen schreibt. Die Kasse zeigt dann 'Datensatz wurde geändert – Vorgang abbrechen?' an, obwohl der Kassierer nur den Barcode scannt. Ein manueller Reload im Client löst das temporär, ist aber keine Lösung im laufenden Betrieb. Wie handhabt ihr die Transaktionsgrenzen zwischen API-Schreibzugriff und Kassen-Frontend? Gibt es einen empfohlenen Mechanismus (ETag, If-Match-Header, Warteschlange), um Dirty Reads oder Lost Updates zu vermeiden, ohne die Kasse in einen reinen Lesemodus zu zwingen? Die lokale USB-TSE läuft stabil, Zertifikate sind bis 2028 gültig.

Re: Artikelstammdaten-Änderungen per API synchronisieren ohne Versionskonflikte bei aktiven Kassiervorgängen

Verfasst: Fr 13. Nov 2026, 10:13
von clairetaylor
Der Konflikt entsteht durch gleichzeitige Schreibzugriffe: Die nächtliche API-Aktualisierung per PUT /articles/{id} und der Kassiervorgang (Scan -> Artikel-Lookup -> Bon-Position) halten beide Datensatz-Sperren in der lokalen Datenbank (MariaDB/MySQL). QuickKasse 4.2 nutzt optimistisches Sperren ohne ETag- oder If-Match-Unterstützung in der REST-Schnittstelle; ein Versionsfeld im Artikelstamm wird nicht über die API ausgegeben. Daher kann das Frontend nicht prüfen, ob der Datensatz seit dem Laden verändert wurde.

Praktisches Vorgehen: 1. Wartungsfenster definieren: API-Sync nur laufen lassen, wenn keine Kasse im Bon-Modus ist (z. B. 02:00–03:00). 2. Falls Überlappung unvermeidbar: Sync in eine Staging-Tabelle schreiben und per internem Job (z. B. Über „Artikel erfassen“ -> „Import“ oder SQL-Job) in einer Transaktion übernehmen, wenn die Kasse im Leerlauf ist (kein offener Bon). 3. Vor jedem Sync „weitere Einstellungen > MySQL Datenbank“ -> „Port testen“ prüfen, ob alle Clients erreichbar sind. 4. Bei sporadischen Meldungen: Kassierer „Vorgang abbrechen“ wählen, Barcode erneut scannen – der zweite Lookup liest den aktuellen Stand. Eine reine Lesesperre für die Kasse gibt es nicht; der Hersteller-Support kann prüfen, ob ein Datenbank-Deadlock-Timeout in der my.ini verkürzt werden kann.