Produkt-/servicekatalog i Mewayz
Produkt-/tjenestetilføjelsen er det delte lagerkatalog, der bruges af regnskab, CRM, POS, EcomStore og Bookinger.
Mewayz-originalt modul — nej Mewayz opstrøms. Dokumentation forfattet fra pakkekilde på
packages/mewayz/ProductService/.





Indledning
Produkt-/tjenestetilføjelsen er enkelt kilde til sandhed for hver salgbar vare på tværs af Mewayz-platformen. 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.
Modulet dækker fysiske varer med lagersporing, ikke-lagertjenester prissat pr. time eller pr. session, multi-lagerbeholdning, hierarkiske kategorier, per-line skatteregler og måleenheder.
Sådan aktiverer du dette modul
For at konfigurere produkt-/tjenestetilføjelsen kan du følge dette link: Opsætning af tilføjelse.
Tilføjelsen er lukket af PlanModuleCheck:ProductService. De fleste salgsrettede planer samler det som standard - POS, Konto, EcomStore og Bookinger afhænger alle af, at det er aktivt.
genstande
Gennemse varer
- Naviger til Produkt & Service → Varer i sidebjælken.
- Listevisningen viser alle elementer, som operatøren kan administrere, med filtre til Navn, Type (produkt eller service), Kategori, og Aktiv status.
- Hver række viser SKU, salgspris, købspris, aktuel lagerbeholdning i alt og hurtige knapper (se, rediger, slet).
Opret et nyt element
- Klik + Ny vare øverst til højre på emnelisten.
- Formularen har følgende felter:
- Navn — Vist navn vist i rullemenuer på tværs af platformen
- Type — Produkt (lagersporet) eller service (ingen lagerbeholdning)
- SKU — Valgfri lagerenhed (unik pr. lejer)
- Kategori — Vælg fra eksisterende kategorier, eller opret en ny inline
- Enhed — Måleenhed (hver, kg, time, kvm osv.)
- Udsalgspris — Standardpris, når denne vare vises på en faktura eller ordre
- Købspris — Standardpris ved modtagelse af lager
- Skatter — Flervalg af skattesatser, der gælder for denne vare
- Billede — Produktbillede brugt af EcomStore + POS
- Beskrivelse — Langformig beskrivelse; brugt af EcomStore-detaljesider
- Klik Gem for at oprette varen. en begivenhed (
CreateProductServiceItem) sendes, så lyttere i andre moduler kan reagere (f.eks. genindeksere søgeindeks).
Rediger / Slet et element
- Fra emnelisten skal du klikke på rækkens redigeringsknap for at åbne den samme formular, der er udfyldt med elementets data.
- Sletning af en vare afsendes
DestroyProductServiceItem. Hvis varen er refereret af en eksisterende faktura, ordre eller POS-salg, er den underliggende række blødt slettet så historiske optegnelser holder deres data intakte.
Lagerstyring
- Naviger til Produkt & Service → Lager i sidebjælken.
- Lagervisningen grupperer varer efter lager så en operatør med flere fysiske lokationer kan se nøjagtige mængder på hver lokation.
- Hver række viser vare, lager, aktuelt antal og sidste flytningsdato.
Tilføj eller juster lager
- Klik Tilføj lager at logge en aktiebevægelse.
- Vælg Vare, den Lager, den Mængde (positiv for indgående, negativ for udligning), og en Bemærk.
- Hver bevægelse registreres; kataloget "opdaterer aldrig bare et tal" - hver ændring kan revideres.
Kategorier
- Naviger til Produkt & Service → Kategorier.
- Kategorier er flade eller hierarkiske (forælder → barn). Hver kategori kan have en farvemærke som afspejles i varelisten og på EcomStore-listesiderne.
- Opret / rediger / slet handlinger følg standard CRUD-mønsteret.
Skatter
- Naviger til Produkt & Service → Afgifter.
- Tilføj de afgiftssatser, som operatørens virksomhed har behov for (f.eks. moms 15 %, omsætningsafgift 7,25 % osv.).
- Hver skat har en navn, sats (procent) og en valgfri beskrivelse.
- Afgifter tilknyttes herefter varer via multi-select på vareformularen.
Enheder
- Naviger til Produkt & Service → Enheder.
- Enheder er etiketterne vist i kurven/fakturalinjen — "hver", "kg", "time", "session", "kvm" osv.
- Mewayz sender et startsæt; tilføje eller omdøbe for at matche operatørens brancheordforråd.
Adfærd på tværs af moduler
Andre Mewayz moduler forbruge produkt-/servicekataloget:
- Konto modul — Salgsfakturaer og købsfakturaer vælger linjeposter fra dette katalog.
- CRM / Salg — Deal linjeposter og forslags referenceposter.
- POS modul — POS-salg trækker produktliste direkte.
- EcomStore modul — Butiksfrontprodukter gengives fra dette katalog med kategoribaseret browse.
- Bestillinger modul — Servicekatalog for tjenester, der kan reserveres.
- ApiDocsGenerator modul — Dokumenterer de offentlige API-endepunkter for programmatisk adgang (
/api/productsosv.).
Tilladelser
Pakken definerer granulære tilladelser:
manage-product-service-item— Fuld ledelsecreate-product-service-item— Opret nye elementermanage-any-product-service-item— Rediger ethvert lejerelementmanage-own-product-service-item— Rediger kun egenskabte elementer
Tildel disse via Indstillinger → Roller og tilladelser.
API-adgang
Pakken afslører også GET /api/product-service/items som et internt autentificeret slutpunkt, som andre moduler og API Docs Generator dukker op som GET /api/products.
Operatør noter
- Aktiebevægelser er uforanderlige — for at "vende" en bevægelse, skal du logge en ny bevægelse i den modsatte retning i stedet for at redigere den oprindelige række.
- Når du sletter varer, der har lager på lager, advarer systemet, før handlingen tillades.
- Varebilleder er gemt under
storage/app/public/product-service/og serveret viastoragesymbollink. Efter upload af et nyt billede, normaliseres det til et enkelt filnavn i DB; den offentlige URL beregnes på gengivelsestidspunktet.