Katalog produktów/usług w Mewayz
Dodatek do produktów/usług to wspólny katalog zapasów używany przez księgowość, CRM, POS, EcomStore i Bookings.
Mewayz – moduł oryginalny — nie Mewayz w górę rzeki. Dokumentacja utworzona ze źródła pakietu pod adresem
packages/mewayz/ProductService/.
Adres URL wersji demonstracyjnej





Wprowadzenie
Dodatek do produktu/usługi to jedyne źródło prawdy za każdy przedmiot, który można sprzedać na platformie Mewayz. Zamiast, aby każdy moduł (Sales, POS, EcomStore, Bookings) utrzymywał własną listę produktów, wszystkie z nich czytają i zapisują w jednym wspólnym katalogu. Oznacza to, że gdy operator tworzy nowy produkt w Produkcie/Usłudze, produkt ten jest od razu dostępny na każdej powierzchni sprzedażowej, ze zsynchronizowanymi stanami magazynowymi i przepisami podatkowymi.
Moduł obejmuje towary fizyczne ze śledzeniem zapasów, usługi niemagazynowe wyceniane za godzinę lub sesję, zapasy obejmujące wiele magazynów, kategorie hierarchiczne, zasady podatkowe dla poszczególnych wierszy i jednostki miary.
Jak włączyć ten moduł
Aby skonfigurować dodatek do produktu/usługi, kliknij ten link: Skonfiguruj dodatek.
Dodatek jest bramkowany przez PlanModuleCheck:ProductService. Większość planów sprzedażowych domyślnie go obejmuje – POS, konto, EcomStore i rezerwacje zależą od tego, czy są aktywne.
Przedmioty
Przeglądaj przedmioty
- Przejdź do Produkty i usługi → Przedmioty na pasku bocznym.
- Widok listy pokazuje wszystkie elementy, którymi operator może zarządzać, wraz z filtrami Imię, Wpisz (produkt lub usługa), Kategoria, i Stan aktywny.
- Każdy wiersz wyświetla SKU, cenę promocyjną, cenę zakupu, aktualną sumę zapasów magazynowych i przyciski szybkiej akcji (wyświetl, edytuj, usuń).
Utwórz nowy element
- Kliknij + Nowy przedmiot w prawym górnym rogu listy elementów.
- Formularz posiada następujące pola:
- Imię — Nazwa wyświetlana wyświetlana w menu rozwijanym na platformie
- Wpisz — Produkt (śledzony stan magazynowy) lub usługa (brak zapasów)
- SKU — Opcjonalna jednostka magazynowa (unikalna dla każdego najemcy)
- Kategoria — Wybierz jedną z istniejących kategorii lub utwórz nową bezpośrednio
- Jednostka — Jednostka miary (każdy, kg, godzina, m2 itp.)
- Cena sprzedaży — Cena domyślna, gdy pozycja ta pojawia się na fakturze lub zamówieniu
- Cena zakupu — Domyślny koszt przy odbiorze zapasów
- Podatki — Możliwość wyboru wielu stawek podatkowych mających zastosowanie do tego artykułu
- Obraz — Zdjęcie produktu używane przez EcomStore + POS
- Opis — opis w formie długiej; używane przez strony szczegółowe EcomStore
- Kliknij Zapisz aby utworzyć przedmiot. Wydarzenie (
CreateProductServiceItem) jest wywoływany, aby słuchacze w innych modułach mogli zareagować (np. ponowne indeksowanie indeksu wyszukiwania).
Edytuj/Usuń element
- Na liście elementów kliknij przycisk edycji wiersza, aby otworzyć ten sam formularz wypełniony danymi elementu.
- Usuwanie wysyłek pozycji
DestroyProductServiceItem. Jeśli do pozycji odwołuje się istniejąca faktura, zamówienie lub sprzedaż w punkcie sprzedaży, wiersz bazowy tak miękkie usunięte dzięki czemu zapisy historyczne zachowują swoje dane w nienaruszonym stanie.
Zarządzanie zapasami
- Przejdź do Produkty i usługi → Zapasy na pasku bocznym.
- Widok zapasów grupuje pozycje według magazyn dzięki czemu operator posiadający wiele lokalizacji fizycznych może zobaczyć dokładne ilości w każdej lokalizacji.
- Każdy wiersz pokazuje pozycję, magazyn, aktualną ilość i datę ostatniego ruchu.
Dodaj lub dostosuj zapasy
- Kliknij Dodaj zapasy do rejestrowania ruchu zapasów.
- Wybierz Przedmiot, Magazyn, Ilość (dodatni w przypadku wejścia, ujemny w przypadku korekty) oraz a Uwaga.
- Każdy ruch jest rejestrowany; katalog nigdy nie „aktualizuje numeru” — każda zmiana podlega kontroli.
Kategorie
- Przejdź do Produkty i usługi → Kategorie.
- Kategorie są płaskie lub hierarchiczne (rodzic → dziecko). Każda kategoria może mieć znacznik koloru jest to odzwierciedlone na liście artykułów i na stronach z listami EcomStore.
- Operacje tworzenia/edycji/usuwania są zgodne ze standardowym wzorcem CRUD.
Podatki
- Przejdź do Produkty i usługi → Podatki.
- Dodaj stawki podatkowe potrzebne biznesowi operatora (np. VAT 15%, podatek od sprzedaży 7,25% itp.).
- Każdy podatek ma tzw imię, stawka (procentowo) i opcjonalny opis.
- Podatki są następnie dołączane do pozycji za pomocą opcji wielokrotnego wyboru w formularzu pozycji.
Jednostki
- Przejdź do Produkty i usługi → Jednostki.
- Jednostki to etykiety wyświetlane w wierszu koszyka/faktury — „każdy”, „kg”, „godzina”, „sesja”, „m2” itp.
- Mewayz wysyła zestaw startowy; dodaj lub zmień nazwę, aby dopasować ją do słownictwa branżowego operatora.
Zachowanie między modułami
Inne moduły Mewayz konsumować katalog Produktów/Usług:
- Konto moduł — Faktury sprzedaży i faktury zakupu wybierają pozycje z tego katalogu.
- CRM / Sprzedaż — Elementy zamówienia i elementy odniesienia w ofertach pakietowych.
- punkt sprzedaży moduł — sprzedaż POS pobiera bezpośrednio listę produktów.
- EcomStore moduł — produkty sklepowe są renderowane z tego katalogu z przeglądaniem opartym na kategoriach.
- Rezerwacje moduł — Katalog usług dla usług rezerwowalnych.
- Generator ApiDocs moduł — Dokumentuje publiczne punkty końcowe API dla dostępu programistycznego (
/api/productsitp.).
Uprawnienia
Pakiet definiuje szczegółowe uprawnienia:
manage-product-service-item— Pełne zarządzaniecreate-product-service-item— Twórz nowe elementymanage-any-product-service-item— Edytuj dowolny element najemcymanage-own-product-service-item— Edytuj tylko elementy stworzone przez siebie
Przypisz je poprzez Ustawienia → Role i uprawnienia.
Dostęp do API
Pakiet również eksponuje GET /api/product-service/items jako wewnętrzny uwierzytelniony punkt końcowy, na którym działają inne moduły i generator dokumentów API GET /api/products.
Uwagi operatora
- Ruchy zapasów są niezmienne — aby „odwrócić” ruch, zarejestruj nowy ruch w przeciwnym kierunku, zamiast edytować oryginalny wiersz.
- Podczas usuwania artykułów, które są na stanie, system ostrzega przed zezwoleniem na tę czynność.
- Obrazy przedmiotów są przechowywane w obszarze
storage/app/public/product-service/i podawane za pośrednictwemstoragedowiązanie symboliczne. Po przesłaniu nowego obrazu jest on normalizowany do pojedynczej nazwy pliku w bazie danych; publiczny adres URL jest obliczany w czasie renderowania.