Product / Service Catalog

Product / Service Catalog in Mewayz

Das Produkt-/Service-Add-on ist der gemeinsame Inventarkatalog, der von Buchhaltung, CRM, POS, EcomStore und Bookings genutzt wird.

Mewayz-original module — no Mewayz upstream. Documentation authored from package source at packages/mewayz/ProductService/.

Demo-URL

Einführung

Das Produkt-/Service-Add-On ist das zentrale Datenquelle for every sellable item across the Mewayz platform. Rather than each module (Sales, POS, EcomStore, Bookings) maintaining its own product list, all of them read from and write to one shared catalog. This means that when an operator creates a new product in Product / Service, that product is immediately usable on every sales surface, with synchronized stock counts and tax rules.

Das Modul deckt physische Waren mit Bestandsverfolgung, lagerlose Dienstleistungen mit Abrechnung pro Stunde oder pro Termin, lagerübergreifende Bestände, hierarchische Kategorien, Steuerregeln pro Position und Maßeinheiten ab.

How to enable this module

Um das Add-On Produkt / Dienstleistung einzurichten, folgen Sie diesem Link: Einrichtungs-Add-on.

Das Add-on ist freigeschaltet durch PlanModuleCheck:ProductService. Die meisten vertriebsorientierten Pläne aktivieren es standardmäßig — POS, Account, EcomStore und Buchungen hängen alle davon ab, dass es aktiv ist.

Artikel

Artikel durchsuchen

• Navigiere zu Produkt & Dienstleistung → Artikel in the sidebar.
• Die Listenansicht zeigt alle Elemente, die der Operator verwalten kann, mit Filtern für Name, Typ (Produkt oder Dienstleistung), Kategorie, und Aktiver Status.
• Jede Zeile zeigt SKU, Verkaufspreis, Einkaufspreis, den aktuellen Lagerbestand und Schnellaktions-Schaltflächen (Ansehen, Bearbeiten, Löschen).

Einen neuen Artikel erstellen

• Klicken Sie auf + Neuer Eintrag oben rechts in der Artikelliste.
• Das Formular enthält die folgenden Felder:
• Name — Anzeigename, der in Dropdowns auf der gesamten Plattform erscheint
• Typ — Produkt (bestandsverfolgt) oder Dienstleistung (kein Bestand)
• SKU – Optionale Artikelnummer (SKU, eindeutig pro Mandant)
• Kategorie — Wählen Sie aus bestehenden Kategorien oder erstellen Sie inline eine neue
• Einheit — Maßeinheit (Stück, kg, Stunde, m², usw.)
• Verkaufspreis — Standardpreis, wenn dieser Artikel auf einer Rechnung oder Bestellung erscheint
• Einkaufspreis — Standardkosten beim Wareneingang
• Steuern — Mehrfachauswahl der für diesen Artikel geltenden Steuersätze
• Bild — Produktbild, verwendet von EcomStore + POS
• Beschreibung — Langform-Beschreibung; wird von den EcomStore-Detailseiten verwendet
• Klicken Sie auf Speichern um den Artikel zu erstellen. Ein Ereignis (CreateProductServiceItem) wird ausgelöst, sodass Listener in anderen Modulen reagieren können (z. B. Neuindexierung des Suchindex).

Element bearbeiten / löschen

• Klicken Sie in der Artikelliste auf die Bearbeiten-Schaltfläche der Zeile, um dasselbe Formular gefüllt mit den Artikeldaten zu öffnen.
• Das Löschen eines Artikels löst aus DestroyProductServiceItem. Wenn der Artikel von einer bestehenden Rechnung, Bestellung oder einem POS-Verkauf referenziert wird, wird die zugrunde liegende Zeile soft-deleted sodass historische Datensätze ihre Daten unversehrt behalten.

Bestandsverwaltung

• Navigiere zu Produkt & Dienstleistung → Bestand in the sidebar.
• Die Bestandsansicht gruppiert Artikel nach Lager sodass ein Betreiber mit mehreren physischen Standorten die exakten Mengen an jedem Standort sehen kann.
• Jede Zeile zeigt Artikel, Lager, aktuelle Menge und das Datum der letzten Bewegung.

Bestand hinzufügen oder anpassen

• Klicken Sie auf Bestand hinzufügen um eine Bestandsbewegung zu erfassen.
• Wählen Sie die Artikel, die Lager, die Menge (positiv für Zugang, negativ für Abgangsanpassung), und ein Notiz.
• Jede Bewegung wird aufgezeichnet; der Katalog „aktualisiert nie einfach eine Zahl“ – jede Änderung ist prüfbar.

Kategorien

• Navigiere zu Produkt & Service → Kategorien.
• Kategorien sind flach oder hierarchisch (übergeordnet → untergeordnet). Jede Kategorie kann eine Farbkennzeichnung das sich in der Artikelliste und auf den EcomStore-Angebotsseiten widerspiegelt.
• Erstellen / Bearbeiten / Löschen folgen dem Standard-CRUD-Muster.

Steuern

• Navigiere zu Produkt & Dienstleistung → Steuern.
• Add the tax rates the operator's business needs (e.g. VAT 15%, Sales Tax 7.25%, etc.).
• Jede Steuer hat einen Name, Rate (Prozentsatz) und ein optionales Beschreibung.
• Steuern werden dann über die Mehrfachauswahl im Artikelformular an Artikel angehängt.

Einheiten

• Navigiere zu Produkt & Service → Einheiten.
• Einheiten sind die Bezeichnungen, die in der Warenkorb-/Rechnungszeile angezeigt werden – „Stück“, „kg“, „Stunde“, „Sitzung“, „qm“ usw.
• Mewayz ships a starter set; add or rename to match the operator's industry vocabulary.

Modulübergreifendes Verhalten

Other Mewayz modules verbrauchen den Produkt-/Dienstleistungskatalog:

• Konto Modul — Verkaufsrechnungen und Einkaufsrechnungen wählen Positionen aus diesem Katalog.
• CRM / Sales — Deal-Positionen und Angebote referenzieren Artikel.
• POS Modul – POS-Verkäufe rufen die Produktliste direkt ab.
• EcomStore Modul – Storefront-Produkte werden aus diesem Katalog gerendert, mit kategoriebasiertem Stöbern.
• Buchungen Modul — Servicekatalog für buchbare Dienstleistungen.
• ApiDocsGenerator Modul — Dokumentiert die öffentlichen API-Endpunkte für den programmatischen Zugriff (/api/products, usw.).

Berechtigungen

Das Paket definiert granulare Berechtigungen:

• manage-product-service-item — Vollständige Verwaltung
• create-product-service-item — Neue Elemente erstellen
• manage-any-product-service-item — Jeden Mandanten-Eintrag bearbeiten
• manage-own-product-service-item — Nur selbst erstellte Elemente bearbeiten

Weisen Sie diese zu über Einstellungen → Rollen & Berechtigungen.

API-Zugriff

Das Paket stellt außerdem bereit GET /api/product-service/items als interner authentifizierter Endpunkt, den andere Module und der API-Docs-Generator darstellen als GET /api/products.

Betreibernotizen

• Bestandsbewegungen sind unveränderlich – um eine Bewegung zu „stornieren“, erfassen Sie eine neue Bewegung in die entgegengesetzte Richtung, statt die ursprüngliche Zeile zu bearbeiten.
• Beim Löschen von Artikeln mit vorhandenem Lagerbestand warnt das System, bevor die Aktion zugelassen wird.
• Artikelbilder werden gespeichert unter storage/app/public/product-service/ und bereitgestellt über das storage Symlink. Nach dem Hochladen eines neuen Bildes wird es in der Datenbank auf einen einzigen Dateinamen normalisiert; die öffentliche URL wird zur Renderzeit berechnet.