Distinta base — Kit e assemblaggio — Guida completa
Installare, configurare e utilizzare le distinte base (BOM): kit virtuali con stock calcolato, scarico dei componenti alla vendita, ordini di assemblaggio, prezzo calcolato e composizione nel front-office per PrestaShop 8 e 9.
Presentazione e prerequisiti
Il modulo Distinta base aggiunge a PrestaShop una gestione della distinta base (BOM): ogni prodotto può dichiarare l’elenco dei suoi componenti con le quantità, e il negozio ne trae automaticamente le conseguenze su stock e prezzo. Sono disponibili due logiche a seconda della vostra attività: il kit virtuale (stock calcolato, scarico dei componenti alla vendita) e l’assemblaggio fisico (ordini di produzione che generano stock di prodotto finito).
- Compatibile con PrestaShop da 8.0 a 9.x, tema Classic e temi derivati.
- PHP da 7.4 a 8.3.
- Multinegozio e multilingua.
- Componenti con combinazioni, distinte multilivello, protezione dai riferimenti circolari.
- Architettura conforme a PrestaShop (ModuleAdminController, ObjectModel), senza dipendenze Composer.
In modalità kit virtuale, lo stock del prodotto non si inserisce più manualmente: il modulo lo calcola come il minimo consentito dai componenti e lo aggiorna a ogni movimento.
Installazione
Installate il modulo come qualsiasi modulo PrestaShop:
- Scaricate l’archivio
datafireflybom.zipdal vostro account cliente. - Nel back-office, andate su Moduli > Gestore dei moduli.
- Cliccate su Carica un modulo e trascinate l’archivio.
- Una volta installato, cliccate su Configura se desiderate regolare le impostazioni globali.
All’installazione, il modulo crea le sue tabelle (dfbom, dfbom_component, dfbom_assembly_log), registra i suoi hook e aggiunge la scheda Distinte base / BOM sotto Catalogo. Le distinte si gestiscono poi da ogni scheda prodotto.
Impostazioni generali del modulo
La pagina di configurazione (Moduli > DataFirefly BOM > Configura) raccoglie le impostazioni globali e l’elenco delle distinte esistenti:
- Sincronizzazione in tempo reale: ricalcola automaticamente lo stock dei kit virtuali e i prezzi calcolati non appena un componente cambia stock o prezzo. Attiva per impostazione predefinita.
- Consenti stock negativo: permette di assemblare o vendere anche se lo stock dei componenti è insufficiente (flusso teso). Disattivata per impostazione predefinita.
- Risincronizza tutti gli stock / prezzi: un pulsante che ricalcola in una volta stock e prezzo di tutte le distinte attive. Utile dopo un’importazione o una migrazione di dati.
Creare una distinta base
Aprite una scheda prodotto, poi la scheda Moduli: appare il pannello Distinta base / BOM. Attivate la distinta con l’interruttore in alto e seguite i passaggi numerati.
1. Scegliere la modalità di stock
- Kit virtuale: lo stock del prodotto è calcolato automaticamente dai componenti e ogni vendita li scarica. Ideale per cofanetti e pacchetti preparati su ordine.
- Assemblaggio fisico: il prodotto finito ha il proprio stock, alimentato da ordini di assemblaggio. Ideale per la produzione in serie.
2. Scegliere la modalità di prezzo
- Prezzo fisso: il prezzo resta quello definito sulla scheda prodotto. Nessun ricalcolo.
- Prezzo calcolato: il prezzo diventa la somma dei prezzi dei componenti, meno uno sconto percentuale che inserite. Ricalcolato automaticamente quando cambia il prezzo di un componente.
3. Aggiungere i componenti
Usate il campo di ricerca per trovare un prodotto per nome, riferimento o ID. I risultati mostrano miniatura, riferimento, stock e prezzo; cliccate per aggiungere il componente. Ogni riga permette di regolare la quantità richiesta con i pulsanti +/−. Potete aggiungere una combinazione precisa come componente (appare separatamente nella ricerca).
I quattro indicatori in alto nel pannello (componenti, quantità assemblabile, costo dei componenti, prezzo calcolato) si aggiornano in diretta mentre regolate quantità e sconto, ancora prima di salvare.
4. Salvare
Cliccate su Salva la distinta. Il modulo salva la distinta, ricalcola immediatamente lo stock del kit (modalità virtuale) e applica il prezzo calcolato se pertinente.
La modalità kit virtuale
In modalità kit virtuale, lo stock del prodotto è il minimo consentito dai suoi componenti: per un cofanetto che richiede 2 martelli e 1 valigetta, con 120 martelli e 40 valigette a magazzino, il kit mostra 40 unità disponibili.
- Alla convalida di un ordine, lo stock di ogni componente viene scaricato secondo le quantità della distinta, poi lo stock del kit — e di tutti i kit che condividono quei componenti — viene ricalcolato.
- In caso di annullamento o rimborso di una riga, i componenti vengono ripristinati automaticamente.
- Se la sincronizzazione in tempo reale è attiva, ogni variazione di stock di un componente (vendita diretta, riassortimento, altro kit) aggiorna lo stock dei kit interessati.
La modalità kit virtuale presuppone che il kit stesso sia un prodotto senza combinazioni: lo stock calcolato è posto sul prodotto (combinazione 0). I componenti, invece, possono essere combinazioni.
La modalità assemblaggio fisico
In modalità assemblaggio, il prodotto finito mantiene il proprio stock. Lo alimentate con ordini di assemblaggio dal pannello della scheda prodotto:
- Inserite una quantità (il pulsante Max indica quante unità il vostro stock di componenti consente di produrre).
- Cliccate su Assembla: i componenti vengono consumati e lo stock del prodotto finito aumenta.
- Cliccate su Disassembla per l’operazione inversa: il prodotto finito viene scaricato e i componenti ripristinati.
Ogni operazione è tracciata in una cronologia con dipendente, data, operazione e quantità. La cronologia completa è consultabile sotto Catalogo > Distinte base / BOM.
Se lo stock negativo non è consentito, l’assemblaggio è bloccato quando lo stock dei componenti è insufficiente, e il disassemblaggio quando lo stock del prodotto finito è insufficiente. Un messaggio indica il massimo possibile.
Il prezzo calcolato
In modalità prezzo calcolato, il prezzo IVA esclusa del kit è pari alla somma dei prezzi IVA esclusa dei suoi componenti (moltiplicati per le loro quantità), meno lo sconto percentuale definito. Questo prezzo viene scritto sulla scheda prodotto e ricalcolato:
- a ogni salvataggio della distinta;
- quando cambia il prezzo di un componente, se la sincronizzazione in tempo reale è attiva;
- durante una risincronizzazione globale dalla pagina di configurazione.
In modalità prezzo fisso, il modulo non tocca mai il prezzo della vostra scheda prodotto. Il prezzo calcolato resta mostrato a titolo indicativo nel pannello, ma non viene applicato.
Distinte multilivello e combinazioni
Un componente può essere una combinazione precisa di un prodotto (taglia, colore…) o a sua volta un kit con la propria distinta. I sottoinsiemi si annidano allora su più livelli e i calcoli di stock si propagano a cascata. Il modulo rileva e blocca i riferimenti circolari, anche indiretti, al momento del salvataggio: un kit non può contenere sé stesso.
La composizione nel front-office
Una casella «Mostra la scheda Composizione sulla pagina prodotto del negozio» permette, prodotto per prodotto, di presentare il contenuto del kit ai vostri clienti. Una scheda Composizione elenca allora ogni componente con la sua immagine, la sua quantità e un link alla sua pagina. Disattivata, la distinta resta del tutto invisibile nel negozio.
FAQ e risoluzione dei problemi
Lo stock del kit non si aggiorna
Verificate che la distinta sia attiva, in modalità kit virtuale, e che la sincronizzazione in tempo reale sia attivata nelle impostazioni. Un pulsante Risincronizza tutti gli stock / prezzi nella pagina di configurazione forza un ricalcolo completo.
Il prezzo calcolato non viene applicato
Il prezzo viene scritto sulla scheda prodotto solo in modalità prezzo calcolato. In modalità prezzo fisso, il valore mostrato è indicativo. Verificate inoltre che i componenti abbiano un prezzo impostato.
Non riesco ad assemblare
Senza autorizzazione allo stock negativo, l’assemblaggio è limitato dallo stock dei componenti. Il pulsante Max indica la quantità massima possibile. Attivate l’opzione Consenti stock negativo nelle impostazioni se il vostro flusso lo richiede.
Appare un messaggio di riferimento circolare
State tentando di aggiungere come componente un prodotto che contiene già (direttamente o tramite un sotto-kit) il prodotto in modifica. Rimuovete quel componente o riorganizzate il vostro albero di distinte.
Posso vendere i componenti separatamente?
Sì, è lo scenario tipico. Ogni componente resta un prodotto normale, vendibile singolarmente. Il modulo mantiene la coerenza: ogni vendita, del componente singolo o del kit, aggiorna gli stock e le quantità assemblabili di tutti i kit interessati.
Cosa succede alla disinstallazione?
La disinstallazione rimuove la scheda e gli hook del modulo, elimina le sue tabelle (dfbom, dfbom_component, dfbom_assembly_log) e le sue variabili di configurazione. Gli stock e i prezzi già scritti sulle schede prodotto restano invariati.