Catalogo prodotti/servizi

Catalogo prodotti/servizi in Mewayz

L'add-on prodotto/servizio è il catalogo di inventario condiviso utilizzato da contabilità, CRM, POS, EcomStore e prenotazioni.

modulo originale Mewayz — no Mewayz a monte. Documentazione creata dall'origine del pacchetto su packages/mewayz/ProductService/.

URL demo

Introduzione

Il componente aggiuntivo del prodotto/servizio è il unica fonte di verità per ogni articolo vendibile sulla piattaforma Mewayz. Invece di mantenere ciascun modulo (Vendite, POS, EcomStore, Prenotazioni) con il proprio elenco di prodotti, tutti leggono e scrivono su un catalogo condiviso. Ciò significa che quando un operatore crea un nuovo prodotto in Prodotto/Servizio, quel prodotto è immediatamente fruibile su ogni superficie di vendita, con conteggi delle scorte e regole fiscali sincronizzate.

Il modulo copre i beni fisici con monitoraggio delle scorte, servizi non a magazzino con prezzi orari o per sessione, inventario multi-magazzino, categorie gerarchiche, regole fiscali per riga e unità di misura.

Come abilitare questo modulo

Per impostare il componente aggiuntivo del prodotto/servizio, è possibile seguire questo collegamento: Add-On di configurazione.

Il componente aggiuntivo è controllato da PlanModuleCheck:ProductService. La maggior parte dei piani rivolti alle vendite lo integrano per impostazione predefinita: POS, Account, EcomStore e Prenotazioni dipendono tutti dalla sua attivazione.

Articoli

Sfoglia elementi

• Vai a Prodotto e servizio → Articoli nella barra laterale.
• La visualizzazione elenco mostra tutti gli elementi che l'operatore può gestire, con filtri per Nome, Digitare (prodotto o servizio), Categoria, e Stato attivo.
• Ogni riga visualizza lo SKU, il prezzo di vendita, il prezzo di acquisto, il totale delle scorte di magazzino correnti e i pulsanti di azione rapida (visualizza, modifica, elimina).

Crea un nuovo elemento

• Fare clic + Nuovo articolo in alto a destra nell'elenco degli elementi.
• Il modulo ha i seguenti campi:
• Nome — Visualizza il nome mostrato nei menu a discesa sulla piattaforma
• Digitare — Prodotto (con stock monitorato) o servizio (nessun stock)
• SKU — Unità di stoccaggio opzionale (unica per locatario)
• Categoria — Scegli tra le categorie esistenti o creane una nuova in linea
• Unità — Unità di misura (ciascuno, kg, ora, mq, ecc.)
• Prezzo di vendita — Prezzo predefinito quando questo articolo appare su una fattura o su un ordine
• Prezzo d'acquisto — Costo predefinito alla ricezione dello stock
• Tasse — Selezione multipla delle aliquote fiscali applicabili a questo articolo
• Immagine — Immagine del prodotto utilizzata da EcomStore + POS
• Descrizione — descrizione in formato lungo; utilizzato dalle pagine di dettaglio di EcomStore
• Fare clic Salva per creare l'elemento. Un evento (CreateProductServiceItem) viene inviato in modo che gli ascoltatori in altri moduli possano reagire (ad esempio, reindicizzare l'indice di ricerca).

Modifica / Elimina un elemento

• Dall'elenco degli elementi, fai clic sul pulsante di modifica della riga per aprire lo stesso modulo popolato con i dati dell'elemento.
• L'eliminazione di un articolo viene inviata DestroyProductServiceItem. Se l'articolo fa riferimento a una fattura, un ordine o una vendita POS esistente, la riga sottostante lo è eliminazione temporanea così i record storici mantengono i loro dati intatti.

Gestione delle scorte

• Vai a Prodotto e servizio → Stock nella barra laterale.
• La vista delle giacenze raggruppa gli articoli per magazzino in questo modo un operatore con più sedi fisiche può vedere le quantità esatte in ciascuna sede.
• Ogni riga mostra l'articolo, il magazzino, la quantità corrente e la data dell'ultimo movimento.

Aggiungi o modifica le scorte

• Fare clic Aggiungi azione per registrare un movimento di magazzino.
• Seleziona il Articolo, il Magazzino, il Quantità (positivo per le entrate, negativo per le regolazioni in uscita) e a Nota.
• Ogni movimento viene registrato; il catalogo non si limita mai ad "aggiornare un numero" — ogni modifica è verificabile.

Categorie

• Vai a Prodotto e Servizio → Categorie.
• Le categorie sono piatte o gerarchiche (genitore → figlio). Ogni categoria può avere a etichetta di colore ciò si riflette nell'elenco degli articoli e nelle pagine di elenco di EcomStore.
• Le operazioni di creazione/modifica/eliminazione seguono il modello CRUD standard.

Tasse

• Vai a Prodotto e servizio → Tasse.
• Aggiungi le aliquote fiscali di cui ha bisogno l'attività dell'operatore (ad es. IVA 15%, imposta sulle vendite 7,25%, ecc.).
• Ogni imposta ha un nome, tariffa (percentuale) e un facoltativo descrizione.
• Le tasse vengono quindi allegate agli articoli tramite la selezione multipla nel modulo dell'articolo.

Unità

• Vai a Prodotto e servizio → Unità.
• Le unità sono le etichette visualizzate nella riga carrello/fattura: "ciascuno", "kg", "ora", "sessione", "mq", ecc.
• Mewayz spedisce un set iniziale; aggiungere o rinominare per adattarlo al vocabolario del settore dell'operatore.

Comportamento tra moduli

Altri moduli Mewayz consumare il catalogo Prodotti/Servizi:

• Conto modulo — Le fatture di vendita e le fatture di acquisto prelevano voci da questo catalogo.
• CRM/Vendite — Elementi pubblicitari dell'offerta ed elementi di riferimento delle proposte.
• POS modulo: le vendite POS estraggono direttamente l'elenco dei prodotti.
• EcomStore modulo: i prodotti della vetrina vengono visualizzati da questo catalogo con la navigazione basata su categorie.
• Prenotazioni modulo: catalogo dei servizi per i servizi prenotabili.
• ApiDocsGenerator modulo — Documenta gli endpoint API pubblici per l'accesso programmatico (/api/products, ecc.).

Autorizzazioni

Il pacchetto definisce autorizzazioni granulari:

• manage-product-service-item — Gestione completa
• create-product-service-item — Crea nuovi elementi
• manage-any-product-service-item — Modifica qualsiasi elemento del locatario
• manage-own-product-service-item — Modifica solo gli elementi creati dall'utente

Assegnarli tramite Impostazioni → Ruoli e autorizzazioni.

Accesso all'API

Il pacchetto espone anche GET /api/product-service/items come endpoint interno autenticato che altri moduli e il Generatore di Documentazione API espongono come GET /api/products.

Note per l'operatore

• I movimenti azionari sono immutabili — per "invertire" un movimento, registra un nuovo movimento nella direzione opposta invece di modificare la riga originale.
• Quando si eliminano articoli con scorte disponibili, il sistema avvisa prima di consentire l'azione.
• Le immagini degli articoli sono archiviate in storage/app/public/product-service/ e servito tramite il storage collegamento simbolico. Dopo aver caricato una nuova immagine, questa viene normalizzata in un singolo nome file nel DB; l'URL pubblico viene calcolato al momento del rendering.