Produkt-/Servicekatalog

Produkt-/Dienstleistungskatalog in Mewayz

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

Mewayz-Originalmodul — nein Mewayz stromaufwärts. Dokumentation aus der Paketquelle unter erstellt packages/mewayz/ProductService/.

Demo-URL

Einführung

Das Produkt-/Service-Add-On ist das zentrale Datenquelle für jeden verkaufbaren Artikel auf der Mewayz-Plattform. Anstatt dass jedes Modul (Sales, POS, EcomStore, Bookings) seine eigene Produktliste verwaltet, lesen und schreiben alle aus einem gemeinsamen Katalog. Das bedeutet, dass, wenn ein Bediener ein neues Produkt unter „Produkt/Dienstleistung“ erstellt, dieses Produkt sofort auf jeder Verkaufsfläche verwendet werden kann, mit synchronisierten Bestandszählungen und Steuerregeln.

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.

So aktivieren Sie dieses Modul

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 der Seitenleiste.
• 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 vorläufig gelöscht sodass historische Datensätze ihre Daten unversehrt behalten.

Bestandsverwaltung

• Navigiere zu Produkt & Dienstleistung → Bestand in der Seitenleiste.
• 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.
• Fügen Sie die Steuersätze hinzu, die der Betreiber für sein Unternehmen benötigt (z. B. 15 % Mehrwertsteuer, 7,25 % Umsatzsteuer usw.).
• 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 liefert ein Starterset; Hinzufügen oder Umbenennen entsprechend dem Branchenvokabular des Betreibers.

Modulübergreifendes Verhalten

Andere Mewayz Module 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.