Warehouse Revolution: configurazione e aiuto

Esegui il backup del database del negozio e dei dati di stock. Carica e installa mprwarehouserevolution, poi fai clic su Configura per aprire Magazzino > Impostazioni > Configurazione.

Apri Magazzino > Impostazioni > Magazzini e crea o seleziona un magazzino attivo. Scegli consapevolmente il magazzino predefinito. Puoi usare MAIN come riferimento, ma l'installazione non crea un magazzino MAIN per te. ID magazzino predefinito ha inizialmente il valore 0.

Usa un solo materiale e prodotto per il primo test completo. Configura stock, collegamenti ai prodotti, cron e prenotazioni prima di affidarti al modulo per l'evasione degli ordini reali.

Il back office è organizzato così:

Warehouse
- Dashboard

Settings
- Warehouses
- Configuration
- Data Management
- Layout Editor
- Zones
- Code Schemas
- Holidays
- System Check
- License
- Support
- Update

Catalog
- Materials
- Recipes
- Product Links
- Bill of Materials
- Import Data

Inventory
- Stock Levels
- Reservations
- Corrections
- Stock Positions
- Stock Taking
- Internal Docs (PW/RW)

Procurement
- Suppliers
- Purchase Orders
- Suggest Reorder
- Receiving
- Stock Planning

Fulfillment
- Shipments
- Returns (RMA)
- Carriers
- Order Fulfillment
- Returns

Reports

Usa Impostazioni > Editor layout, Zone e Schemi codice quando hai bisogno di ubicazioni fisiche e numerazione dei documenti. Le zone possono descrivere le ubicazioni di ricezione, imballaggio, spedizione, reso e stoccaggio. Una configurazione con un solo magazzino non richiede inizialmente una disposizione dettagliata.

In Catalogo > Materiali, crea ogni articolo di stock interno. Crea le Ricette e i relativi componenti se un prodotto consuma più materiali o sotto-ricette. In Link prodotto, collega il prodotto o la combinazione PrestaShop al materiale o alla ricetta e imposta la quantità consumata. Controlla Distinta base per verificare il fabbisogno di componenti risultante.

Inserisci lo stock iniziale dei materiali in Inventario > Livelli di stock o tramite l'importatore. Controlla unità e riferimenti dei magazzini prima di sincronizzare le quantità native dei prodotti. Il modulo calcola le quantità vendibili dallo stock collegato e dai fabbisogni dei componenti; un collegamento a una ricetta senza stock dei componenti non è una configurazione completa.

Apri Magazzino > Impostazioni > Configurazione. Salva nel contesto del negozio desiderato.

• Attiva più magazzini. Consente di gestire lo stock in più magazzini; valore predefinito: 0.
• ID magazzino predefinito. Seleziona il magazzino usato per impostazione predefinita per spedizioni e calcoli di stock; valore predefinito: 0.
• Sincronizza stock con PrestaShop. Aggiorna le quantità native dei prodotti PrestaShop dallo stock di magazzini/materiali; valore predefinito: 1.
• Attiva avvisi di stock. Attiva la logica degli avvisi di stock basso; valore predefinito: 1.
• Soglia predefinita di stock basso. Imposta la soglia quantitativa di ripiego per lo stock basso; valore predefinito: 10.
• Attiva distinta base. Attiva le ricette dei materiali e lo stock prodotto basato sui componenti; valore predefinito: 1.
• Sottrai automaticamente i componenti alla spedizione. Sottrae i materiali dei componenti al momento della spedizione; valore predefinito: 1.
• Fattore di sicurezza predefinito. Imposta il moltiplicatore di sicurezza della pianificazione dello stock, dove 1 significa nessuna scorta aggiuntiva; valore predefinito: 1.
• Tempo di approvvigionamento predefinito. Imposta il tempo di approvvigionamento di ripiego del fornitore/materiale in giorni per la pianificazione dello stock; valore predefinito: 120.

Mantieni attiva la sincronizzazione dello stock nativo solo quando lo stock di magazzino deve essere la fonte per i prodotti collegati. Controlla anche le opzioni di sincronizzazione dei singoli prodotti in Link prodotto. Scegli soglia di stock basso, tempo di approvvigionamento e fattore di sicurezza in base al tuo effettivo flusso di rifornimento.

Sotto il modulo standard, Magazzino principale per paese ti consente di scegliere il magazzino principale per i paesi di consegna. I paesi non associati usano il magazzino predefinito. Controlla Si risolve in e fai clic su Salva magazzini principali per salvare questo pannello di instradamento separato. È una mappatura configurata dei paesi, non un calcolo del magazzino più vicino.

• Crea automaticamente spedizioni all’ordine. Crea automaticamente record di spedizione con i valori none, dropship_only o all; valore predefinito: none.
• Selezione magazzino per spedizioni automatiche. Sceglie il magazzino per la creazione automatica delle spedizioni usando default, first_available o most_stock; valore predefinito: default.
• Imposta automaticamente lo stato ordine alla spedizione. Mostra e preseleziona uno stato dell'ordine durante la creazione delle spedizioni; valore predefinito: 1.
• Stato ordine - spedito completamente. Imposta lo stato dell'ordine suggerito quando tutti gli articoli dell'ordine sono spediti; valore predefinito: 4.
• Stato ordine - spedito parzialmente. Imposta lo stato dell'ordine suggerito quando alcuni articoli non sono ancora spediti, con 0 che significa nessuna modifica; valore predefinito: 0.
• Notifica cliente - spedizione completa. Imposta la selezione predefinita della notifica al cliente per spedizioni complete; valore predefinito: 1.
• Notifica cliente - spedizione parziale. Imposta la selezione predefinita della notifica al cliente per spedizioni parziali; valore predefinito: 0.
• Blocca e-mail di esaurimento stock. Blocca l'e-mail nativa di esaurimento scorte di PrestaShop quando il modulo gestisce il flusso delle spedizioni; valore predefinito: 1.
• Periodo di tolleranza dopo la spedizione. Imposta quanti minuti attendere prima di confermare la deduzione dello stock dopo la spedizione; valore predefinito: 5.
• Ora limite di spedizione. Imposta l'ora limite in formato 24 ore usata per le stime predefinite della spedizione in giornata; valore predefinito: 15.
• Giorni di transito predefiniti. Imposta il tempo di transito di ripiego in giorni lavorativi quando il corriere non ha un valore di transito; valore predefinito: 3.
• Valute dei costi. Imposta le valute dei costi separate da virgole, con la prima usata come predefinita; valore predefinito: GBP,EUR,PLN.
• Motivi di correzione. Imposta un motivo di correzione per riga nella finestra modale di correzione della spedizione; valore predefinito: Shipped wrong item; Damaged in transit; Customer return; Quantity error; Quality issue; Missing from package; Other.
• Attiva tracciamento spedizioni. Mostra il tracciamento delle spedizioni nell'account cliente e nelle pagine dei dettagli dell'ordine; valore predefinito: 1.
• Attiva notifiche e-mail delle spedizioni. Invia le e-mail di spedizione del modulo quando il tracciamento è attivo; valore predefinito: 1.
• Attiva immagini delle spedizioni. Consente al personale di caricare foto dei pacchi e documenti nelle spedizioni; valore predefinito: 1.
• Dimensione massima immagine. Imposta la dimensione massima di caricamento delle immagini di spedizione in MB; valore predefinito: 5.
• Immagini visibili ai clienti per impostazione predefinita. Rende le immagini di spedizione caricate visibili ai clienti per impostazione predefinita, invece che solo agli amministratori; valore predefinito: 0.

Usa Crea automaticamente spedizioni all’ordine = none per un primo test manuale. Se attivi la creazione automatica, scegli dropship_only o all e verifica la strategia di selezione del magazzino su ordini rappresentativi. Le strategie disponibili sono magazzino predefinito, primo stock disponibile e stock maggiore.

Controlla che gli ID degli stati ordine configurati corrispondano agli stati del tuo negozio. Gli interruttori di notifica per spedizioni complete/parziali impostano la scelta iniziale della notifica. Controlla la scelta effettiva quando elabori una spedizione. Blocca e-mail di esaurimento stock è attivo per impostazione predefinita per evitare l'e-mail nativa di esaurimento scorte nel flusso del modulo.

Usa Periodo di tolleranza dopo la spedizione per definire il ritardo prima della registrazione definitiva dello stock di una spedizione inviata. Il valore predefinito è 5 minuti. Uno scheduler deve elaborare le spedizioni in attesa dopo questo ritardo. Prova il flusso di annullamento/correzione prima di usarlo per spedizioni reali.

Motivi di sostituzione degli articoli aggiunge i motivi usati per le sostituzioni. I valori predefiniti sono Non disponibile, Danneggiato in magazzino, Fuori produzione, Richiesta del cliente, Più adatto all’ordine, Problema di qualità e Altro. Mantieni ogni motivo su una riga separata, come per Motivi di correzione.

Lo stato di preparazione memorizzato ha come valore predefinito 3 e il minuto dell'ora limite di spedizione 0. Non sono campi visibili separati chiamati Stato ordine - preparazione o Minuto dell’ora limite di spedizione nell'attuale modulo Configurazione.

Nel gruppo Scorte:

• Attiva prenotazioni dei materiali. Attiva le prenotazioni temporanee dei materiali dalla fase selezionata in Inizio delle prenotazioni di stock. Valore predefinito: 1. Una nuova configurazione inizia all'accesso alla pagina del carrello o al checkout, non a ogni aggiunta al carrello.

• Durata della prenotazione. Imposta la durata della prenotazione dopo una modifica accettata del carrello. Valore predefinito: 30 minuti. È limitata da Periodo massimo di protezione; aggiornamenti e salvataggi duplicati non la rinnovano.

• Inizio delle prenotazioni di stock. Valore predefinito: cart_page. Prenota all'accesso alla pagina del carrello o al checkout. Puoi invece scegliere l'aggiunta al carrello o l'ingresso al checkout. L'accesso a carrello/checkout richiede JavaScript e una sessione cliente valida. Una successiva modifica accettata del carrello può prenotare stock; la semplice visualizzazione o l'aggiornamento non riavviano una prenotazione.

• Integrazione stock del carrello. Fai clic su Prepara integrazione stock del carrello per controllare la versione installata di PrestaShop e preparare i suoi adattatori nativi. Risolvi i conflitti segnalati e ricarica la pagina.

• Riduci lo stock prodotto disponibile per le prenotazioni del carrello. Valore predefinito: disattivato. Attiva questa opzione solo quando l'integrazione nativa e il worker rapido dello stock sono pronti. La prenotazione di un componente riduce la disponibilità di ogni prodotto collegato che lo usa; lo stock fisico del componente resta invariato.

• Periodo massimo di protezione. Valore predefinito: 120 minuti. Limita la protezione continua di un proprietario.

• Pausa tra i periodi di protezione. Valore predefinito: 30 minuti. Richiede una pausa prima che quel proprietario ottenga una nuova protezione.

• Carrelli protetti per proprietario. Valore predefinito: 3.

• Unità di vendita protette per proprietario. Valore predefinito: 100.

• Modifiche per periodo di protezione. Valore predefinito: 60 modifiche accettate di quantità/ricetta.

• Carrelli protetti per pool di stock. Valore predefinito: 1000 carrelli temporanei concorrenti.

• Numero massimo di righe distinte del carrello. Valore predefinito: 256. Aumenta il valore solo dopo aver misurato carrelli più grandi.

• Numero massimo di pool di stock per carrello. Valore predefinito: 128. Un pool rappresenta un materiale o una ricetta assemblata in un magazzino.

Valuta questi limiti insieme. I carrelli senza prenotazione temporanea possono comunque essere sottoposti ai controlli di stock al checkout. Aggiornare la pagina non prolunga la protezione. Controlla Inventario > Prenotazioni usando carrelli di prova e una quantità di stock controllata.

reservation_use_session_tracking = 1 e reservation_cron_enabled = 0 restano valori predefiniti memorizzati per compatibilità. Non sono campi Usa tracciamento sessione o Attiva pulizia cron separati nel modulo attuale. L'attività di pulizia attualmente registrata viene eseguita tramite lo scheduler condiviso. Non affidarti al traffico dei visitatori per eseguire le attività di stock in background.

Visualizzazione

• Mostra disponibilità di stock. Mostra la disponibilità dello stock di magazzino nelle pagine prodotto; valore predefinito: 1.
• Mostra dettagli dello stock. Mostra informazioni dettagliate sullo stock quando la disponibilità dello stock prodotto è attiva; valore predefinito: 1.
• Nascondi barra dello stock. Nasconde la barra dello stock del modulo mantenendo utilizzabile la finestra modale di verifica tramite gli elementi .stock_checker del tema; valore predefinito: 0.
• Testo di consegna per prodotti disponibili. Imposta il testo del badge di consegna quando è disponibile stock locale; valore predefinito: Next day delivery.
• Testo di consegna senza stock locale. Imposta il testo del badge di consegna quando è disponibile solo stock del magazzino secondario; valore predefinito: Secondary warehouse · 3-5 business days.

Usa i testi di consegna come messaggi configurati da te. Questi messaggi vengono inseriti manualmente anziché calcolati dai dati del corriere. Se il tuo tema ha un proprio pulsante di stock, attiva Nascondi barra dello stock e mantieni un elemento .stock_checker con gli ID di prodotto e combinazione in modo che possa aprire la finestra modale di verifica.

Il modulo registra stock-availability, my-shipments e my-returns. La pagina stock-availability richiede anche la preferenza memorizzata stock_checker_page, con valore predefinito 0. Non è un normale campo Configurazione. Usa la verifica dello stock prodotto come primo test pubblico.

Resi (RMA)

• Attiva resi (RMA). Consente ai clienti di richiedere resi dal proprio account; valore predefinito: 1.
• RMA richiede approvazione. Richiede l'approvazione del personale prima che un cliente rispedisca un reso; valore predefinito: 1.
• Rimborsa automaticamente i resi di grado A. Questa impostazione non avvia rimborsi automatici. Esegui i rimborsi tramite il tuo flusso PrestaShop/di pagamento; valore predefinito: 0.

I clienti possono richiedere resi e visualizzare il tracciamento delle spedizioni tramite le aree account/ordine registrate, quando attive. Verifica quei collegamenti accedendo come cliente con un vero ordine di prova. Il personale approva, riceve, ispeziona e risolve il reso in Evasione > Resi (RMA). I campi di rimborso registrano decisioni; verifica ogni rimborso effettivo attraverso il tuo flusso PrestaShop/di pagamento. Non considerare Rimborsa automaticamente i resi di grado A una prova dell'avvenuto trasferimento di denaro.

Esegui il runner cron MPR condiviso dallo scheduler del server. Usa il token cron MPR condiviso esistente fornito dall'API getCronToken() del modulo o dalla tua amministrazione cron MPR. Non è un campo Token cron modificabile in Magazzino > Configurazione. Il punto di ingresso CLI supporta:

* * * * * php /var/www/html/modules/mprwarehouserevolution/cron.php --token=YOUR_SHARED_TOKEN --max-tasks=20 --max-seconds=55 --context=cron

Sostituisci il percorso del negozio e il token. Le attività pianificate rilasciano le prenotazioni scadute e gli impegni di stock degli ordini conclusi ogni 300 secondi, registrano definitivamente le spedizioni in attesa ogni 60 secondi, elaborano lo stock prodotto in coda tramite CLI ogni minuto, recuperano le pubblicazioni in attesa ogni minuto e richiedono una riconciliazione completa ogni giorno.

L'endpoint cron HTTP non può eseguire attività di stock riservate alla CLI. Mantieni una pianificazione CLI per elaborare lo stock. Il punto di ingresso principale accetta anche --stock-only per eseguire il sottoinsieme di attività CLI legate allo stock. Controlla i risultati delle attività prima di creare ulteriori pianificazioni sovrapposte.

Se attivi Riduci lo stock prodotto disponibile per le prenotazioni del carrello, supervisiona anche questo breve processo CLI in modo che venga rieseguito a intervalli di circa un secondo:

php /var/www/html/modules/mprwarehouserevolution/bin/cart-stock-worker.php --seconds=3 --max-products=20

Il worker accetta --seconds=1..20, --max-products=1..100 e --quiet. Eseguilo con il normale utente dei processi del negozio. Controlla il rapporto di stato JSON e il codice di uscita prima di silenziare l'output. La sola preparazione dell'integrazione non esegue il worker.

Apri Magazzino > Catalogo > Importa dati. Usa CSV UTF-8 e i modelli per il tipo di entità selezionato. L'importatore accetta separatori punto e virgola o virgola e offre anteprima/preparazione, selezione delle righe ed elaborazione in batch. Il limite del controller è 500 MB, subordinato a eventuali limiti PHP/server inferiori.

Importa in ordine di dipendenza: magazzini e zone; fornitori e materiali; ricette e componenti delle ricette; collegamenti ai prodotti e prodotti dei fornitori; stock; ordini di acquisto e relative righe. I riferimenti devono corrispondere esattamente ai record esistenti.

Aggiungi un URL di tracciamento personalizzato del corriere in Magazzino -> Evasione -> Corrieri. Il modulo sostituisce {tracking} o {tracking_number} con il numero di tracciamento della spedizione e gli URL in stile DHL possono anche usare {locale}.

Code: custom_local
Name: Local Courier
Tracking URL Pattern: https://carrier.example/track?id={tracking}
Transit Time: 2
Active: yes

DHL pattern:
https://www.dhl.com/{locale}/home/tracking.html?tracking-id={tracking}&submit=1

Importa i collegamenti ai prodotti con file CSV UTF-8 separati da punto e virgola in Magazzino -> Catalogo -> Importa dati.

product_reference;product_attribute_id;item_type;item_reference;quantity;sync_stock
TRAY-1200;0;recipe;SHOWER-TRAY-KIT;1;1
DRAIN-90;0;material;DRAIN-90;1;1

Importa lo stock iniziale dei materiali per riferimento del magazzino.

material_reference;warehouse_reference;quantity
PANEL-1200;MAIN;25
DRAIN-90;MAIN;40

Crea una ricetta e i suoi componenti.

reference;name_en;description_en;assembly_time;assembly_cost;auto_deduct
SHOWER-TRAY-KIT;Shower tray kit;Panel and drain kit;30;5.00;1

recipe_reference;component_type;component_reference;quantity;is_optional
SHOWER-TRAY-KIT;material;PANEL-1200;1;0
SHOWER-TRAY-KIT;material;DRAIN-90;1;0

Usa il pulsante di stock del tuo tema lasciando che il modulo apra la finestra modale di verifica dello stock. Funziona con Nascondi barra dello stock attivo.

<button type="button"
        class="btn btn-secondary stock_checker"
        data-id-product="{$product.id_product|intval}"
        data-id-product-attribute="{$product.id_product_attribute|default:0|intval}">
    Check live stock
</button>

Definisci lo stile degli elementi di stock del front office tramite le classi del modulo.

.mprw-stock-bar {
  border: 1px solid #d9e2ec;
  padding: 12px;
}

.mprw-bar-in-stock {
  color: #127a3a;
}

.mprw-bar-secondary-stock {
  color: #8a5a00;
}

.stock_checker.mprw-price-stock-summary {
  white-space: nowrap;
}

I modelli e-mail di spedizione e RMA supportano questi segnaposto.

Shipment email:
{firstname}
{lastname}
{email_heading}
{order_reference}
{shipments_text}
{pending_items_text}
{history_url}
{shop_name}
{shop_url}

RMA customer update:
{firstname}
{lastname}
{rma_reference}
{order_reference}
{return_type}
{status_label}
{date_updated}
{message}
{rma_url}
{shop_name}

Usa gli esempi CSS ed e-mail solo per i modelli/classi corrispondenti della versione installata. Controlla un messaggio di spedizione e uno RMA in uscita dopo le modifiche ai modelli.

Crea un ordine di prova con un prodotto collegato. Controlla il pannello del magazzino nella pagina ordine del back office, inclusi componenti, articoli delle spedizioni, materiali personalizzati, problemi, correzioni, resi, registro e-mail e cronologia di evasione.

Crea la spedizione, verifica magazzino e quantità, poi falla avanzare nelle fasi applicabili di prelievo, imballaggio e spedizione. Dopo il periodo di tolleranza, verifica il movimento e lo stock disponibile. Usa una correzione esplicita quando è stato registrato un articolo o una quantità errata. Non modificare manualmente le tabelle dello stock.

Per il rifornimento, crea un fornitore e un ordine di acquisto, poi usa Ricezione quando arriva la merce. Controlla separatamente le quantità in arrivo e quelle ricevute. Usa Suggerisci riordino, Pianificazione stock e Report solo quando collegamenti dei materiali, tempi di approvvigionamento e stock sono corretti.

Per i resi, verifica la ricezione e assegna un grado a ogni articolo prima di rimetterlo a stock o risolvere la RMA. I modelli degli URL di tracciamento sostituiscono {tracking} o {tracking_number} e quelli applicabili supportano anche {locale}. Questi collegamenti non prenotano etichette del corriere.

Gli stati delle spedizioni sono:

1 = Pending
2 = Picking
3 = Picked
4 = Packed
5 = Shipped
6 = Delivered
7 = Cancelled

Gli stati RMA sono:

1 = Requested
2 = Approved
3 = Awaiting return
4 = In transit back
5 = Received
6 = Inspected
7 = Resolved
8 = Rejected
9 = Cancelled

I gradi di qualità dei resi sono:

A = Like new - full stock credit
B = Slight damage - refurbished stock
C = Damaged - heavy discount
F = Unsellable - write-off

Gli stati degli ordini di acquisto sono:

1 = Draft
2 = Sent
3 = Confirmed
4 = Partial
5 = Received
6 = Cancelled

Le etichette dei gradi A/B/C/F corrispondono alle costanti numeriche interne 1/2/3/4. Usa le opzioni di grado nel back office anziché scrivere questi codici nel database.

Esegui Magazzino > Impostazioni > Controllo sistema. Controlla magazzino predefinito, tabelle, hook e stato dell'integrazione installata. Con un prodotto di prova, verifica stock iniziale, prenotazione del carrello, impegno di stock dell'ordine, spedizione parziale/completa, completamento del periodo di tolleranza, annullamento/correzione, ricezione e reintegro a stock tramite RMA. Confronta la quantità nativa del prodotto con i record di stock e movimenti del modulo.

Se le quantità sono in ritardo, controlla cron CLI, salute del worker, interruttori di sincronizzazione e collegamenti ai prodotti prima di inserire correzioni manuali. Se un carrello non prenota subito, controlla Inizio delle prenotazioni di stock e i limiti di protezione. Se la barra pubblica dello stock è assente, controlla le impostazioni Visualizzazione e gli hook del tema. Per collegamenti mancanti nell'account, controlla impostazioni di tracciamento/RMA, accesso e proprietario dell'ordine. Per errori di importazione, controlla colonne obbligatorie, record referenziati, codifica e limiti di caricamento del server.

Usa i permessi dei dipendenti del back office per le relative azioni di visualizzazione/aggiunta/modifica/eliminazione. Le scritture dell'instradamento per paese richiedono accesso in modifica. Non concedere al personale di magazzino un ampio accesso al database come sostituto dei permessi del modulo.

Esegui prima il backup di tutti i dati di magazzini, materiali, ricette, collegamenti ai prodotti, stock, approvvigionamento, spedizioni, resi e movimenti. Disattiva Riduci lo stock prodotto disponibile per le prenotazioni del carrello e lascia il worker dello stock in esecuzione finché non ha ripristinato la disponibilità. Il modulo blocca disattivazione/disinstallazione mentre restano attive prenotazioni pubbliche, un ripristino o un ticket di transizione.

Dopo il completamento del ripristino, disattiva o disinstalla dal back office. La disinstallazione rimuove attività registrate, menu, preferenze delle colonne e dati SQL del modulo. Rimuovi le tue voci del supervisore del worker e dello scheduler quando non servono più. Ricontrolla le quantità native di stock e il flusso sostitutivo di gestione dello stock prima di accettare ordini.

Richiede PrestaShop 1.6.1 o successivo e PHP 7.1 o successivo.