# WCPOS ATUM-Integration Integriert [ATUM Multi-Inventory](https://www.stockmanagementlabs.com/addons/atum-multi-inventory/) mit [WCPOS Pro](/de/getting-started/pro-license.md) 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](/de/stores/.md), sodass jedes POS-Terminal die korrekten Bestandsmengen, Preise und SKUs für seinen physischen Standort anzeigt. ## Funktionen[​](#features "Direkter Link zu 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[​](#installation "Direkter Link zu Installation") 1 #### ATUM und Multi-Inventory installieren Installieren Sie [ATUM Inventory Management](https://wordpress.org/plugins/atum-stock-manager-for-woocommerce/) und das [ATUM Multi-Inventory Add-on](https://www.stockmanagementlabs.com/addons/atum-multi-inventory/). Konfigurieren Sie anschließend Ihre Lagerstandorte in ATUM. 2 #### WCPOS ATUM-Integration installieren Installation über `WP Admin > POS > Einstellungen > Erweiterungen`, oder laden Sie die neueste Version von der [GitHub-Releases-Seite](https://github.com/wcpos/wcpos-atum/releases) herunter und installieren Sie sie über `Plugins > Neu hinzufügen > Plugin hochladen`. 3 #### 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[​](#store-configuration "Direkter Link zu 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[​](#pos-behavior "Direkter Link zu 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](#product-edit-write-back) weiter unten. ## Bestandsverwaltung[​](#stock-management "Direkter Link zu 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: 1. **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. 2. **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[​](#product-edit-write-back "Direkter Link zu 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[​](#what-syncs "Direkter Link zu 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[​](#what-doesnt-trigger-write-back "Direkter Link zu 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[​](#requirements "Direkter Link zu Voraussetzungen") WordPress : WordPress 5.9+ mit PHP 7.4+ WooCommerce : WooCommerce installiert und aktiviert ATUM : ATUM Inventory Management und ATUM Multi-Inventory Add-on WCPOS : WCPOS Pro — Multi-Filiale ist eine Pro-Funktion ## Verwandte Themen[​](#related "Direkter Link zu Verwandte Themen") * [Multi-Filiale](/de/stores/.md) — Preise, Adressen und Kassiererzuweisung pro Filiale * Quelle: [github.com/wcpos/wcpos-atum](https://github.com/wcpos/wcpos-atum)