WCPOS ATUM-Integration
Integriert ATUM Multi-Inventory mit WCPOS Pro und ermöglicht standortbezogenen Bestand, Preise und SKUs am Point of Sale.
ATUM Multi-Inventory ermöglicht es, den Bestand eines Produkts auf mehrere Lagerstandorte aufzuteilen – Lagerhäuser, Einzelhandelsgeschäfte und so weiter. Dieses Plugin verknüpft diese ATUM-Standorte mit WCPOS Pro-Filialen, sodass jedes POS-Terminal die korrekten Bestandsmengen, Preise und SKUs für seinen physischen Standort anzeigt.
Funktionen
Standortbezogener Bestand
Jede Filiale bezieht Bestandsmengen vom zugewiesenen ATUM-Lagerstandort anstelle des aggregierten WooCommerce-Bestands.
Flexible Preisgestaltung
Preise können aus den WooCommerce-Standardwerten, den WCPOS Pro-Filialpreisen oder den ATUM-standortspezifischen Preisen bezogen werden.
Standort-SKUs
Optional kann die Haupt-SKU eines Produkts im POS durch eine ATUM-standortspezifische SKU ersetzt werden.
Revisionssichere Bestandsbewegung
Bestellungen buchen Bestand am korrekten ATUM-Standort ab und wieder ein, mit vollständigem Audit-Trail in atum_inventory_orders.
Produktbearbeitung mit Rückschreibung
Änderungen an Bestand, Preis und SKU im POS werden in die zugeordnete ATUM-Inventarzeile für den jeweiligen Standort zurückgeschrieben.
Installation
ATUM und Multi-Inventory installieren
Installieren Sie ATUM Inventory Management und das ATUM Multi-Inventory Add-on. Konfigurieren Sie anschließend Ihre Lagerstandorte in ATUM.
WCPOS ATUM-Integration installieren
Installation über WP Admin > POS > Einstellungen > Erweiterungen, oder laden Sie die neueste Version von der GitHub-Releases-Seite herunter und installieren Sie sie über Plugins > Neu hinzufügen > Plugin hochladen.
Filialen ATUM-Standorten zuordnen
Navigieren Sie zu POS > Geschäfte, bearbeiten Sie eine Filiale und konfigurieren Sie den Seitenleistenabschnitt ATUM-Bestandsverwaltung. Wählen Sie den Lagerstandort aus, den die Filiale verwenden soll, legen Sie eine Preisquelle fest und aktivieren Sie optional die SKU-Überschreibung.
Filialenkonfiguration
Das Plugin fügt einen Bereich ATUM-Bestandsverwaltung in der Seitenleiste des WCPOS Pro Filialeditors mit drei Einstellungen pro Filiale hinzu:
- Lagerstandort — von welchem ATUM-Standort diese Filiale den Bestand bezieht.
- Preisquelle — woher die Produktpreise stammen:
- Standard — reguläre WooCommerce-Preise
- WCPOS Pro — filialspezifische Preise, festgelegt in WCPOS Pro
- ATUM — standortspezifische Preise aus dem ATUM-Inventar
- SKU-Überschreibung — optional können standortspezifische SKUs aus ATUM anstelle der Haupt-SKU des Produkts verwendet werden.
POS-Verhalten
Wenn einer Filiale ein ATUM-Standort zugewiesen ist, werden die an das POS übermittelten Produktdaten automatisch angepasst:
- Lagerbestände spiegeln den Bestand des jeweiligen Standorts wider, nicht den aggregierten WooCommerce-Bestand.
- Lagerstatus wird anhand der Menge am jeweiligen Standort neu berechnet.
- Preise stammen aus der konfigurierten Preisquelle.
- SKUs werden durch die ATUM-Standort-SKU ersetzt, wenn die Überschreibung aktiviert ist.
Alle Anpassungen erfolgen transparent über die WCPOS REST API — auf der POS-App-Seite sind keine Änderungen erforderlich. Produktänderungen, die über das POS vorgenommen werden, werden ebenfalls in die zugeordnete ATUM-Bestandszeile zurückgeschrieben; siehe Produktbearbeitungs-Rückschreibung weiter unten.
Bestandsverwaltung
Bei POS-Bestellungen, die in Filialen mit einem zugeordneten ATUM-Standort aufgegeben werden, überlässt das Plugin den nativen Bestandsabzug von ATUM — lenkt ihn jedoch zum korrekten Standort:
- REST-Payload-Injektion. Wenn das POS eine Bestellung erstellt oder aktualisiert, fügt das Plugin einen
mi_inventories-Eintrag zu jeder Auftragsposition hinzu, damit ATUM weiß, von welchem Standort der Bestand entnommen werden soll. Ohne dies würde ATUM auf den Hauptbestand zurückfallen. - Standortbezogener Bestandsfilter. Das Plugin filtert die Bestandskandidatenliste von ATUM auf diejenigen, die mit dem zugeordneten Standortbegriff der Filiale verknüpft sind, sodass sowohl bei Reduktion als auch bei Wiederherstellung der richtige Bestand ausgewählt wird.
ATUM selbst führt die eigentliche Bestandsänderung bei Bestellung und Rückerstattung durch und schreibt Zeilen in atum_inventory_orders mit der tatsächlichen order_id — wodurch der Audit-Trail von ATUM erhalten bleibt.
Produktbearbeitungs-Rückschreibung
Wenn ein Kassierer oder Manager ein Produkt oder eine Variante über das POS bearbeitet, werden die Änderungen in die zugeordnete ATUM-Bestandszeile für den Standort dieser Filiale zurücksynchronisiert — nicht nur in das WooCommerce-Hauptprodukt. Dadurch bleiben Bestand, Preis und SKU jedes Standorts ohne manuelle Aktualisierungen im WP Admin mit ATUM synchron.
Die Rückschreibung wird bei WCPOS-Produkt- und Varianten-REST-Aktualisierungen (POST, PUT, PATCH an /wcpos/v1/products/...) ausgelöst, die eine store_id enthalten. Das Plugin ermittelt den zugeordneten ATUM-Standort der Filiale und aktualisiert nur die Bestandszeile für diesen Standort — andere Standorte bleiben unberührt.
Was synchronisiert wird
Das Zurückschreiben berücksichtigt die Konfiguration jeder Filiale, sodass ATUM-Daten nur geändert werden, wenn die Filiale diese Daten tatsächlich verwaltet:
| Feld | Wann synchronisiert wird |
|---|---|
| Lagerbestand | Immer — jede Filiale mit einem zugeordneten ATUM-Lagerort hält ihre Lagerortzeile synchron. |
| Regulärer Preis / Aktionspreis / Preis | Nur wenn die Preisquelle der Filiale auf ATUM gesetzt ist. |
| SKU | Nur wenn SKU-Überschreibung für die Filiale aktiviert ist. |
Wenn die Filiale die Preisquelle Standard oder WCPOS Pro verwendet, bleiben die ATUM-Preisfelder unverändert, sodass ATUM weiterhin als Referenzpreis und nicht als maßgebliche Quelle dient. Dasselbe gilt für SKUs, wenn die Überschreibung deaktiviert ist.
Was kein Zurückschreiben auslöst
- Produkterstellung (nur Aktualisierungen werden zurückgeschrieben — neue Produkte durchlaufen den normalen Speicherprozess von WooCommerce).
- Anfragen ohne eine
store_id— das POS muss dem Plugin mitteilen, in welchen Lagerort geschrieben werden soll. - Filialen ohne einen zugeordneten ATUM-Lagerort.
- Produkte ohne eine vorhandene ATUM-Bestandszeile für den Lagerort der Filiale — das Plugin erstellt keine neuen Bestandszeilen, sondern aktualisiert nur bestehende.
Voraussetzungen
Verwandte Themen
- Multi-Filiale — Preise, Adressen und Kassiererzuweisung pro Filiale
- Quelle: github.com/wcpos/wcpos-atum