Integrazione WCPOS ATUM
Integra ATUM Multi-Inventory con WCPOS Pro, abilitando inventario, prezzi e SKU basati sulla sede nel punto vendita.
ATUM Multi-Inventory consente di suddividere lo stock di un prodotto tra più sedi di inventario: magazzini, negozi fisici e così via. Questo plugin collega tali sedi ATUM ai negozi WCPOS Pro, in modo che ogni terminale POS visualizzi livelli di stock, prezzi e SKU corretti per la propria sede fisica.
Funzionalità
Stock per sede
Ogni negozio recupera le quantità di stock dalla sede di inventario ATUM assegnata, anziché dallo stock aggregato di WooCommerce.
Prezzi flessibili
Scegli i prezzi dai valori predefiniti di WooCommerce, dai prezzi per negozio di WCPOS Pro o dai prezzi specifici per sede di ATUM.
SKU per sede
Facoltativamente, sostituisci lo SKU principale del prodotto con uno SKU specifico per la sede ATUM nel POS.
Movimento scorte sicuro per l'audit
Gli ordini scalano e ripristinano le scorte nella sede ATUM corretta, con una traccia di audit completa in atum_inventory_orders.
Riscrittura delle modifiche prodotto
Le modifiche POS a scorte, prezzo e SKU vengono sincronizzate con la riga di inventario ATUM mappata per quella sede.
Installazione
Installa ATUM e Multi-Inventory
Installa ATUM Inventory Management e il componente aggiuntivo ATUM Multi-Inventory. Configura le sedi inventario in ATUM.
Installa l'integrazione WCPOS ATUM
Installa da WP Admin > POS > Impostazioni > Estensioni, oppure scarica l'ultima versione dalla pagina delle release GitHub e caricala tramite Plugin > Aggiungi Nuovo > Carica plugin.
Mappa i negozi alle sedi ATUM
Vai a POS > Negozi, modifica un negozio e configura la sezione della barra laterale Inventario ATUM. Seleziona la sede inventario che il negozio deve usare, scegli una fonte dei prezzi e, facoltativamente, abilita le sostituzioni SKU.
Configurazione del negozio
Il plugin aggiunge una sezione Inventario ATUM alla barra laterale dell'editor dei negozi di WCPOS Pro, con tre impostazioni per ogni negozio:
- Ubicazione inventario — l'ubicazione ATUM da cui questo negozio preleva le scorte.
- Origine prezzi — da dove provengono i prezzi dei prodotti:
- Predefinito — prezzi WooCommerce standard
- WCPOS Pro — prezzi per negozio impostati in WCPOS Pro
- ATUM — prezzi specifici dell'ubicazione dall'inventario ATUM
- Sostituzione SKU — usa facoltativamente gli SKU specifici dell'ubicazione da ATUM invece dello SKU principale del prodotto.
Comportamento del POS
Quando a un negozio è assegnata un'ubicazione ATUM, i dati del prodotto forniti al POS vengono adattati automaticamente:
- Le quantità di magazzino riflettono l'inventario dell'ubicazione specifica, non le scorte aggregate di WooCommerce.
- Lo stato delle scorte viene ricalcolato in base alla quantità dell'ubicazione.
- I prezzi provengono dalla sorgente prezzi configurata.
- Gli SKU vengono sostituiti con lo SKU della posizione ATUM se la sovrascrittura è abilitata.
Tutte le regolazioni avvengono in modo trasparente tramite la REST API di WCPOS — non sono necessarie modifiche lato app POS. Anche le modifiche ai prodotti effettuate dal POS vengono riscritte nella riga di inventario ATUM mappata; vedere Scrittura di ritorno delle modifiche al prodotto più sotto.
Gestione dello stock
Per gli ordini POS effettuati in negozi con una posizione ATUM mappata, il plugin lascia che il flusso nativo di detrazione dello stock di ATUM gestisca la scrittura, ma lo indirizza alla posizione corretta:
- Inserimento nel payload REST. Quando il POS crea o aggiorna un ordine, il plugin inserisce una voce
mi_inventoriesin ogni elemento riga, così ATUM sa da quale posizione prelevare. Senza questo, ATUM ripiegherebbe sull'inventario principale. - Filtro dell'inventario per posizione. Il plugin filtra l'elenco degli inventari candidati di ATUM limitandolo solo a quelli collegati al termine della posizione mappata del negozio, assicurando che venga scelto quello corretto sia in fase di riduzione sia di ripristino.
ATUM esegue direttamente la modifica effettiva dello stock su ordine e rimborso, scrivendo righe in atum_inventory_orders con il vero order_id — preservando la traccia di audit di ATUM.
Scrittura di ritorno delle modifiche al prodotto
Quando un cassiere o un responsabile modifica un prodotto o una variazione dal POS, le modifiche vengono sincronizzate di nuovo con la riga di inventario ATUM mappata per la posizione di quel negozio, non solo con il prodotto WooCommerce principale. In questo modo stock, prezzo e SKU di ogni posizione restano sincronizzati con ATUM senza aggiornamenti manuali in WP Admin.
La scrittura di ritorno viene attivata dagli aggiornamenti REST di prodotti e variazioni WCPOS (POST, PUT, PATCH verso /wcpos/v1/products/...) che includono uno store_id. Il plugin cerca la posizione ATUM mappata del negozio e aggiorna solo la riga di inventario per quella posizione — le altre posizioni restano invariate.
Cosa viene sincronizzato
La scrittura di ritorno rispetta la configurazione di ciascun negozio, quindi i dati ATUM cambiano solo quando il negozio possiede effettivamente quei dati:
| Campo | Quando viene sincronizzato |
|---|---|
| Quantità in magazzino | Sempre — ogni negozio con una sede ATUM mappata mantiene sincronizzata la riga della propria sede. |
| Prezzo di listino / Prezzo scontato / Prezzo | Solo quando l'Origine prezzo del negozio è impostata su ATUM. |
| SKU | Solo quando la Sostituzione SKU è abilitata per il negozio. |
Se il negozio usa il prezzo Predefinito o WCPOS Pro, i campi prezzo di ATUM non vengono modificati, così ATUM continua a fungere da prezzo di riferimento anziché da fonte autorevole. Lo stesso vale per gli SKU quando la sostituzione è disattivata.
Cosa non attiva la scrittura di ritorno
- Creazione di prodotti (vengono riscritti solo gli aggiornamenti — i nuovi prodotti seguono il normale percorso di salvataggio di WooCommerce).
- Richieste senza un
store_id— il POS deve indicare al plugin in quale sede scrivere. - Negozi senza una sede ATUM mappata.
- Prodotti senza una riga di inventario ATUM esistente per la sede del negozio — il plugin non creerà nuove righe di inventario, ma aggiornerà solo quelle esistenti.
Requisiti
Correlati
- Multi-negozio — prezzi per negozio, indirizzi e assegnazione dei cassieri
- Fonte: github.com/wcpos/wcpos-atum