Catalogue de produits / services

Catalogue de produits / services dans Mewayz

L'add-on Produit / Service est le catalogue d'inventaire partagé utilisé par la comptabilité, le CRM, le point de vente, EcomStore et les Réservations.

module Mewayz-original — aucun Mewayz en amont. Documentation rédigée à partir du code source du package à l'adresse packages/mewayz/ProductService/.

URL de démo

Introduction

L'add-on Produit / Service est le source unique de vérité pour chaque article vendable sur toute la plateforme Mewayz. Plutôt que chaque module (Ventes, PDV, EcomStore, Réservations) maintienne sa propre liste de produits, tous lisent et écrivent dans un catalogue partagé unique. Cela signifie que lorsqu'un opérateur crée un nouveau produit dans Produit / Service, ce produit est immédiatement utilisable sur chaque surface de vente, avec des stocks et des règles de taxe synchronisés.

Le module couvre les biens physiques avec suivi des stocks, les services hors stock facturés à l'heure ou à la séance, l'inventaire multi-entrepôts, les catégories hiérarchiques, les règles de taxe par ligne et les unités de mesure.

Comment activer ce module

Pour configurer le module complémentaire Produit / Service, vous pouvez suivre ce lien : Module complémentaire de configuration.

Le module complémentaire est restreint par PlanModuleCheck:ProductService. La plupart des forfaits orientés vente l'activent par défaut — POS, Account, EcomStore et Bookings dépendent tous de son activation.

Articles

Parcourir les articles

• Accédez à Produit et service → Articles dans la barre latérale.
• La vue liste affiche tous les éléments que l'opérateur peut gérer, avec des filtres pour Nom, Type (produit ou service), Catégorie, et Statut actif.
• Chaque ligne affiche le SKU, le prix de vente, le prix d’achat, le stock total en entrepôt actuel et des boutons d’action rapide (voir, modifier, supprimer).

Créer un nouvel article

• Cliquez + Nouvel élément en haut à droite de la liste des articles.
• Le formulaire comporte les champs suivants :
• Nom — Nom d'affichage affiché dans les menus déroulants à travers la plateforme
• Type — Produit (suivi de stock) ou Service (sans stock)
• UGS — Unité de gestion des stocks facultative (unique par locataire)
• Catégorie — Choisissez parmi les catégories existantes, ou créez-en une nouvelle directement
• Unité — Unité de mesure (à l’unité, kg, heure, m², etc.)
• Prix de vente — Prix par défaut lorsque cet article apparaît sur une facture ou une commande
• Prix d'achat — Coût par défaut à la réception du stock
• Taxes — Sélection multiple des taux de taxe applicables à cet article
• Image — Image produit utilisée par EcomStore + POS
• Description — Description longue ; utilisée par les pages de détail EcomStore
• Cliquez Enregistrer pour créer l'élément. Un événement (CreateProductServiceItem) est déclenché afin que les écouteurs d'autres modules puissent réagir (par ex. réindexation de l'index de recherche).

Modifier / Supprimer un élément

• Dans la liste des articles, cliquez sur le bouton de modification de la ligne pour ouvrir le même formulaire prérempli avec les données de l'article.
• La suppression d'un élément déclenche DestroyProductServiceItem. Si l'article est référencé par une facture, une commande ou une vente POS existante, la ligne sous-jacente est supprimé en douceur afin que les enregistrements historiques conservent leurs données intactes.

Gestion des stocks

• Accédez à Produit et service → Stock dans la barre latérale.
• La vue des stocks regroupe les articles par entrepôt afin qu'un exploitant disposant de plusieurs sites physiques puisse voir les quantités exactes à chaque emplacement.
• Chaque ligne affiche l'article, l'entrepôt, la quantité actuelle et la date du dernier mouvement.

Ajouter ou ajuster le stock

• Cliquez Ajouter du stock pour enregistrer un mouvement de stock.
• Sélectionnez le Article, le Entrepôt, le Quantité (positif pour les entrées, négatif pour les ajustements en sortie), et un Note.
• Chaque mouvement est enregistré ; le catalogue ne se contente jamais de « mettre à jour un nombre » — chaque changement est auditable.

Catégories

• Accédez à Produit et service → Catégories.
• Les catégories sont à plat ou hiérarchiques (parent → enfant). Chaque catégorie peut avoir un étiquette de couleur qui se reflète dans la liste des articles et sur les pages de référencement EcomStore.
• Les opérations de création / modification / suppression suivent le schéma CRUD standard.

Taxes

• Accédez à Produit et service → Taxes.
• Ajoutez les taux de taxe dont l'entreprise de l'opérateur a besoin (par ex. TVA 15 %, taxe de vente 7,25 %, etc.).
• Chaque taxe a un nom, taux (pourcentage), et un optionnel description.
• Les taxes sont ensuite associées aux articles via la sélection multiple sur le formulaire d'article.

Unités

• Accédez à Produit et service → Unités.
• Les unités sont les libellés affichés dans la ligne du panier / de la facture — « pièce », « kg », « heure », « séance », « m² », etc.
• Mewayz fournit un ensemble de départ ; ajoutez ou renommez pour correspondre au vocabulaire sectoriel de l'opérateur.

Comportement inter-modules

Autres modules Mewayz consommer le catalogue Produit / Service :

• Compte module — Les factures de vente et les factures d'achat sélectionnent les lignes dans ce catalogue.
• CRM / Ventes — Les lignes d'articles des affaires et les propositions référencent les articles.
• POS module — les ventes au POS tirent la liste des produits directement.
• EcomStore module — Les produits de la vitrine sont générés à partir de ce catalogue avec une navigation par catégorie.
• Réservations module — Catalogue de services réservables.
• ApiDocsGenerator module — Documente les points de terminaison de l'API publique pour un accès programmatique (/api/products, etc.).

Autorisations

Le forfait définit des autorisations granulaires :

• manage-product-service-item — Gestion complète
• create-product-service-item — Créer de nouveaux éléments
• manage-any-product-service-item — Modifier n'importe quel élément du locataire
• manage-own-product-service-item — Modifier uniquement les éléments créés par soi-même

Attribuez-les via Paramètres → Rôles et autorisations.

Accès API

Le package expose également GET /api/product-service/items comme un point de terminaison interne authentifié que les autres modules et le générateur de documentation API présentent en tant que GET /api/products.

Notes de l’opérateur

• Les mouvements de stock sont immuables — pour « inverser » un mouvement, enregistrez un nouveau mouvement dans la direction opposée plutôt que de modifier la ligne d'origine.
• Lors de la suppression d'articles ayant du stock disponible, le système vous avertit avant d'autoriser l'action.
• Les images des articles sont stockées sous storage/app/public/product-service/ et diffusé via le storage lien symbolique. Après le téléversement d'une nouvelle image, celle-ci est normalisée en un seul nom de fichier dans la base de données ; l'URL publique est calculée au moment du rendu.