📗Distinta base
Guida al modulo aggiuntivo Distinta base in OpenSTAManager
Distinta base è uno dei diversi moduli acquistabili da OpenstaSTAManager. Il modulo permette la gestione della distinta base permettendo il collegamento tra più articoli.
Clicca qui per procedere all'acquisto.
Panoramica delle Funzionalità
Il plugin Distinta Base offre le seguenti funzionalità principali:
Gestione gerarchica delle distinte base: Creazione di strutture ad albero con componenti e sotto-componenti
Produzione automatica: Generazione di articoli finiti consumando i componenti
Scomposizione automatica: Disassemblaggio di articoli finiti ripristinando i componenti
Controllo giacenze in tempo reale: Verifica della disponibilità prima di operazioni di produzione/scomposizione
Integrazione con vendite: Produzione automatica in fase di vendita
Integrazione con acquisti: Scomposizione automatica in fase di acquisto
Sincronizzazione prezzi: Aggiornamento automatico dei prezzi in base ai componenti
Importazione CSV: Caricamento massivo di distinte base da file CSV
Stampa professionale: Generazione di report dettagliati delle distinte base
Gestione multi-sede: Supporto per diverse sedi aziendali
Configurazione Iniziale
Dopo l'installazione, il plugin sarà disponibile nella sezione Magazzino → Articoli. Cliccando su un articolo, apparirà alla destra la sezione dei plugin con l'opzione "Distinta base".
Creazione di una Distinta Base
Navigare in Magazzino → Articoli
Selezionare l'articolo padre (il prodotto finito)
Cliccare sul plugin "Distinta base" nella colonna destra
Utilizzare il pulsante + per aggiungere componenti alla distinta
Configurazione dell'Articolo Padre
Per ogni articolo padre è possibile configurare le seguenti opzioni:
Sincronizza prezzo acquisto: Se abilitato, il prezzo di acquisto dell'articolo padre viene aggiornato automaticamente in base ai prezzi dei componenti
Sincronizza prezzo vendita: Se abilitato, il prezzo di vendita dell'articolo padre viene aggiornato automaticamente in base ai prezzi dei componenti
Gestione della Distinta Base
Aggiunta di Componenti
Per aggiungere un componente alla distinta base:
Cliccare sul pulsante + nella tabella dei componenti
Selezionare l'articolo figlio dal campo di ricerca
Inserire la quantità richiesta
Cliccare su Aggiungi
Il sistema supporta la struttura gerarchica, quindi è possibile aggiungere componenti che a loro volta contengono sotto-componenti, creando distinte base multi-livello.
Modifica di Componenti
Per modificare un componente esistente:
Cliccare sull'icona Modifica (penna) nella riga del componente
Modificare la quantità desiderata
Cliccare su Modifica per salvare
Eliminazione di Componenti
Per rimuovere un componente dalla distinta:
Cliccare sull'icona Elimina (cestino) nella riga del componente
Confermare l'eliminazione
Visualizzazione Distinte Correlate
Se un articolo viene utilizzato come componente in altre distinte base, verrà visualizzata una sezione "Distinte in cui compare questo articolo" che mostra tutte le distinte in cui l'articolo è presente. In questa sezione è possibile modificare le quantità dell'articolo nelle diverse distinte.
Tabella Dettaglio Componenti
La tabella dei componenti mostra le seguenti informazioni per ogni componente:
Riga: Numero progressivo del componente
Articolo: Codice e descrizione dell'articolo (con link alla scheda articolo)
Fornitore: Fornitore principale dell'articolo (se configurato)
Qta: Quantità del componente nella distinta
Prezzo di acquisto: Prezzo unitario di acquisto e totale (quantità × prezzo)
Prezzo di vendita: Prezzo unitario di vendita e totale (quantità × prezzo)
Azioni: Pulsanti per aggiungere, modificare o eliminare componenti
La tabella include filtri per ogni colonna per facilitare la ricerca e l'analisi dei componenti.
Produzione e Scomposizione
Il plugin offre due operazioni principali per la movimentazione del magazzino: Produzione e Scomposizione.
Interfaccia Produzione/Scomposizione
La sezione "Produzione e Scomposizione" permette di:
Selezionare la quantità da produrre/scomporre
Selezionare la sede in cui effettuare l'operazione
Verificare in tempo reale la disponibilità dei componenti
Eseguire l'operazione di produzione o scomposizione
Controllo Giacenze
Il sistema verifica automaticamente la disponibilità quando si seleziona una sede e si inserisce una quantità:
Per la Produzione: Verifica che tutti i componenti siano disponibili in quantità sufficiente
Per la Scomposizione: Verifica che l'articolo padre sia disponibile in quantità sufficiente
Il controllo viene effettuato in tempo reale tramite AJAX e mostra:
Un indicatore visivo (verde/rosso) per lo stato di disponibilità
Il rapporto tra quantità disponibile e quantità richiesta
Una barra di progresso per visualizzare il livello di disponibilità
Dettagli dei componenti con problemi di disponibilità (espandibile)
Operazione di Produzione
La funzione Produci permette di creare articoli finiti consumando i componenti:
Funzionamento:
Il sistema verifica la disponibilità di tutti i componenti nella sede selezionata
Se i componenti sono disponibili, incrementa la quantità dell'articolo padre
Decrementa la quantità di tutti i componenti in base alla distinta base
Registra i movimenti di magazzino con causale "Produzione articolo"
Requisiti:
Tutti i componenti devono essere disponibili in quantità sufficiente
I servizi non vengono considerati nel controllo delle giacenze
Messaggi di errore: Se un componente non è disponibile, il sistema mostra un messaggio dettagliato con:
Codice e descrizione del componente mancante
Quantità disponibile
Quantità necessaria
Unità di misura
Operazione di Scomposizione
La funzione Scomponi permette di disassemblare articoli finiti ripristinando i componenti:
Funzionamento:
Il sistema verifica la disponibilità dell'articolo padre nella sede selezionata
Se l'articolo è disponibile, decrementa la quantità dell'articolo padre
Incrementa la quantità di tutti i componenti in base alla distinta base
Registra i movimenti di magazzino con causale "Scomposizione articolo"
Requisiti:
L'articolo padre deve essere disponibile in quantità sufficiente
Messaggi di errore: Se l'articolo padre non è disponibile, il sistema mostra un messaggio dettagliato con:
Codice e descrizione dell'articolo
Quantità disponibile
Quantità richiesta
Gestione Multi-Sede
Il plugin supporta la gestione delle giacenze in diverse sedi aziendali. È possibile:
Selezionare la sede in cui effettuare l'operazione
Verificare la disponibilità specifica per ogni sede
Effettuare produzioni/scomposizioni in sedi diverse
Integrazione con Documenti di Vendita
Produci articoli della distinta base in fase di vendita
L'impostazione "Produci articoli della distinta base in fase di vendita" permette l'esecuzione automatica dei meccanismi di composizione dell'articolo padre inserito nei documenti di vendita.
Funzionamento:
L'articolo padre mantiene la sua giacenza bloccata
Vengono movimentate le giacenze degli articoli figli (componenti)
Al momento della vendita, vengono scalate le quantità dei componenti dal magazzino
Caso d'uso tipico: Un negozio di informatica che vende computer assemblati con componenti specifici. Al momento della vendita del computer, non viene ridotta la quantità dell'articolo "Computer", ma vengono scalate le quantità relative ai suoi componenti (CPU, RAM, disco, ecc.), mantenendo così allineate le giacenze.
Considerazioni importanti:
Con questa impostazione abilitata è necessario monitorare attentamente le giacenze degli articoli figli
Se le giacenze dei componenti non sono sufficienti, verranno comunque movimentate e assumeranno valori negativi
Per evitare problemi di giacenze negative, si consiglia l'utilizzo del modulo aggiuntivo "Riordino fornitori" che permette di gestire in modo ottimale le quantità di materiale presente a magazzino
Configurazione
L'impostazione può essere abilitata/disabilitata dal menu Strumenti → Impostazioni, sezione Distinta base.
Integrazione con Documenti di Acquisto
Scomponi articolo padre in fase di acquisto
L'impostazione "Scomponi articolo padre in fase di acquisto" permette di scomporre un articolo importato da una fattura di acquisto negli articoli figli che compongono la distinta.
Funzionamento:
Alla registrazione di una fattura di acquisto di un articolo padre
Viene simulata la produzione dell'articolo
Subito dopo viene eseguita la scomposizione nei singoli componenti
I componenti vengono registrati a magazzino
Caso d'uso tipico: Alla registrazione di una fattura di acquisto di una macchina, se l'impostazione è attiva, verrà simulata la produzione della macchina e subito dopo la scomposizione nei singoli componenti (motore, telaio, ruote, ecc.), che verranno registrati a magazzino.
Configurazione
L'impostazione può essere abilitata/disabilitata dal menu Strumenti → Impostazioni, sezione Distinta base.
Stampa della Distinta Base
Il plugin offre una funzione di stampa professionale per generare report dettagliati delle distinte base.
Accesso alla Stampa
Dalla scheda dell'articolo, cliccando sul pulsante Stampa distinta base nella sezione configurazione, sarà possibile stampare il dettaglio della distinta.
Contenuti della Stampa
La stampa include:
Intestazione: Codice e descrizione dell'articolo padre, data di stampa
Tabella dettagliata con:
Riga: Numero progressivo
Livello: Livello di profondità nella distinta (utile per distinte multi-livello)
Codice: Codice dell'articolo
Descrizione: Descrizione dell'articolo
Q.tà: Quantità totale (considerando i livelli superiori)
U.M.: Unità di misura
Prezzo Acq.: Prezzo unitario di acquisto
Totale: Prezzo totale (quantità × prezzo)
Stato: Checkbox di verifica
Riepilogo con:
Totale costo acquisto componenti
Totale prezzo vendita componenti
Margine teorico (differenza tra vendita e acquisto)
Impostazioni del Plugin
Le impostazioni del plugin sono accessibili dal menu Strumenti → Impostazioni, sezione Distinta base.
Elenco delle Impostazioni
Produci articoli della distinta base in fase di vendita
Tipo: Boolean
Valore predefinito: Disabilitato
Descrizione: Se abilitata, esegue automaticamente la composizione dell'articolo padre nei documenti di vendita, movimentando le giacenze degli articoli figli
Scomponi articolo padre in fase di acquisto
Tipo: Boolean
Valore predefinito: Disabilitato
Descrizione: Se abilitata, scompone automaticamente l'articolo padre importato da fatture di acquisto nei componenti della distinta
Movimenta gli articoli figlio tramite i movimenti manuali
Tipo: Boolean
Valore predefinito: Disabilitato
Descrizione: Se abilitata, permette la movimentazione degli articoli figlio tramite i movimenti manuali di magazzino
Impostazioni per Articolo
Oltre alle impostazioni globali, ogni articolo padre può avere configurazioni specifiche:
Sincronizza prezzo acquisto
Tipo: Boolean
Valore predefinito: Abilitato
Descrizione: Se abilitato, aggiorna automaticamente il prezzo di acquisto dell'articolo padre in base ai prezzi dei componenti
Sincronizza prezzo vendita
Tipo: Boolean
Valore predefinito: Abilitato
Descrizione: Se abilitato, aggiorna automaticamente il prezzo di vendita dell'articolo padre in base ai prezzi dei componenti
Changelog
6.0 (2026-03-11)
Aggiunto (Added)
Sistema di controlli di integrità tramite file JSON
Funzionalità di generazione automatica dei file JSON per i controlli di integrità
Sistema di build automatizzato con Gulp per ottimizzare lo sviluppo
5.1 (2025-09-24)
Correzioni (Fixed)
Risolto problema nella funzionalità di stampa della distinta
5.0 (2025-07-23)
Aggiunto (Added)
Gestione multipla delle distinte base per diverse sedi aziendali
Modificato (Changed)
Migliorata l'interfaccia grafica del plugin
Correzioni (Fixed)
Risolto problema nella stampa della distinta base
Risolto problema nella visualizzazione dei dettagli dei componenti
Risolto problema nella visualizzazione dei grafici
4.1 (2025-01-07)
Correzioni (Fixed)
Adattato il codice per compatibilità con versioni aggiornate di PHP
Risolto problema nella visualizzazione della descrizione degli articoli
4.0 (2024-11-14)
Correzioni (Fixed)
Rimossi file personalizzati della classe Articolo per standardizzare il codice
Allineata la classe Articolo con le versioni più recenti di OSM
3.0 (2024-06-14)
Aggiunto (Added)
Aggiunto rector
Allineamento a php8.3
Allineamento con OSM 2.5.2
2.2 (2024-01-17)
Aggiunto (Added)
Aggiunto php-cs-fixer
Aggiunta colonna numero riga in distinta
2.1 (2023-09-05)
Aggiunto (Added)
Aggiunta procedura di disintallazione del plugin
Was this helpful?