Product-/servicecatalogus

Product-/servicecatalogus in Mewayz

De Product/Service Add-On is de gedeelde inventariscatalogus die wordt gebruikt door boekhouding, CRM, POS, EcomStore en Bookings.

Mewayz-originele module — geen Mewayz stroomopwaarts. Documentatie geschreven vanuit pakketbron op packages/mewayz/ProductService/.

Demo-URL

Introductie

De product-/service-add-on is de enige bron van waarheid voor elk verkoopbaar item op het Mewayz-platform. In plaats van dat elke module (Verkoop, POS, EcomStore, Boekingen) zijn eigen productlijst bijhoudt, lezen ze allemaal uit en schrijven ze naar één gedeelde catalogus. Dit betekent dat wanneer een operator een nieuw product aanmaakt in Product / Service, dat product onmiddellijk bruikbaar is op elk verkoopoppervlak, met gesynchroniseerde voorraadtellingen en belastingregels.

De module omvat fysieke goederen met voorraadtracking, niet-voorraaddiensten met een prijs per uur of per sessie, inventaris in meerdere magazijnen, hiërarchische categorieën, belastingregels per regel en maateenheden.

Hoe deze module in te schakelen

Om de product-/service-add-on in te stellen, kunt u deze link volgen: Add-on instellen.

De Add-On wordt afgesloten door PlanModuleCheck:ProductService. De meeste verkoopgerichte abonnementen bundelen het standaard: POS, Account, EcomStore en Bookings zijn allemaal afhankelijk van de actiefheid ervan.

Artikelen

Blader door artikelen

• Navigeer naar Product & Dienst → Artikelen in de zijbalk.
• De lijstweergave toont alle items die de operator kan beheren, met filters voor Naam, Typ (product of dienst), Categorie, en Actieve status.
• Elke rij toont de SKU, de verkoopprijs, de aankoopprijs, het huidige totaal van de magazijnvoorraad en knoppen voor snelle actie (bekijken, bewerken, verwijderen).

Maak een nieuw artikel aan

• Klik + Nieuw artikel rechtsboven in de lijst met items.
• Het formulier bevat de volgende velden:
• Naam — Weergavenaam weergegeven in vervolgkeuzelijsten op het platform
• Typ — Product (op voorraad) of service (geen voorraad)
• SKU — Optionele voorraadunit (uniek per huurder)
• Categorie — Kies uit bestaande categorieën of maak inline een nieuwe
• Eenheid — Maateenheid (elk, kg, uur, m², etc.)
• Verkoopprijs — Standaardprijs wanneer dit artikel op een factuur of bestelling verschijnt
• Aankoopprijs — Standaardkosten bij ontvangst van voorraad
• Belastingen — Meerdere belastingtarieven selecteren die op dit artikel van toepassing zijn
• Afbeelding — Productafbeelding gebruikt door EcomStore + POS
• Beschrijving — Lange beschrijving; gebruikt door EcomStore-detailpagina's
• Klik Opslaan om het artikel te maken. Een evenement (CreateProductServiceItem) wordt verzonden zodat luisteraars in andere modules kunnen reageren (bijvoorbeeld het opnieuw indexeren van de zoekindex).

Een item bewerken/verwijderen

• Klik in de lijst met items op de knop Bewerken van de rij om hetzelfde formulier te openen waarin de gegevens van het item zijn ingevuld.
• Het verwijderen van een item wordt verzonden DestroyProductServiceItem. Als er naar het artikel wordt verwezen door een bestaande factuur, bestelling of POS-verkoop, is de onderliggende rij dat wel zacht verwijderd zodat historische gegevens hun gegevens intact houden.

Voorraadbeheer

• Navigeer naar Product & Service → Voorraad in de zijbalk.
• In de voorraadweergave worden artikelen gegroepeerd op magazijn zodat een operator met meerdere fysieke locaties de exacte hoeveelheden op elke locatie kan zien.
• Elke rij toont het artikel, het magazijn, de huidige hoeveelheid en de datum van de laatste verplaatsing.

Voorraad toevoegen of aanpassen

• Klik Voorraad toevoegen om een voorraadbeweging te registreren.
• Selecteer de Artikel, de Magazijn, de Hoeveelheid (positief voor inkomend, negatief voor aanpassing uit), en a Let op.
• Elke beweging wordt geregistreerd; de catalogus "werkt nooit zomaar een getal bij" - elke wijziging is controleerbaar.

Categorieën

• Navigeer naar Product en service → Categorieën.
• Categorieën zijn plat of hiërarchisch (bovenliggend → kind). Elke categorie kan een kleur label dat wordt weerspiegeld in de artikellijst en op de EcomStore-lijstpagina's.
• Bewerkingen voor het maken/bewerken/verwijderen volgen het standaard CRUD-patroon.

Belastingen

• Navigeer naar Product & Dienst → Belastingen.
• Voeg de belastingtarieven toe die de ondernemer nodig heeft (bijvoorbeeld BTW 15%, omzetbelasting 7,25%, etc.).
• Elke belasting heeft een naam, tarief (percentage) en een optioneel beschrijving.
• Belastingen worden vervolgens aan artikelen gekoppeld via de meervoudige selectie op het artikelformulier.

Eenheden

• Navigeer naar Product & Dienst → Eenheden.
• Eenheden zijn de labels die worden weergegeven in de winkelwagen-/factuurregel — "elk", "kg", "uur", "sessie", "m²", enz.
• Mewayz verzendt een startset; toevoegen of hernoemen zodat het aansluit bij het branchevocabulaire van de operator.

Gedrag tussen modules

Andere Mewayz-modules consumeren de product-/servicecatalogus:

• Rekening module — Verkoopfacturen en inkoopfacturen verzamelen regelitems uit deze catalogus.
• CRM/Verkoop — Dealregelitems en referentie-items voor voorstellen.
• POS module - POS-verkoop haalt de productlijst rechtstreeks op.
• EcoWinkel module — Storefront-producten worden vanuit deze catalogus weergegeven met op categorieën gebaseerd bladeren.
• Boekingen module — Servicecatalogus voor boekbare services.
• ApiDocsGenerator module — Documenteert de openbare API-eindpunten voor programmatische toegang (/api/productsenz.).

Machtigingen

Het pakket definieert gedetailleerde machtigingen:

• manage-product-service-item — Volledig beheer
• create-product-service-item - Maak nieuwe items
• manage-any-product-service-item — Bewerk elk tenantitem
• manage-own-product-service-item — Bewerk alleen eigen gemaakte items

Wijs deze toe via Instellingen → Rollen en machtigingen.

API-toegang

Het pakket geeft ook bloot GET /api/product-service/items als een intern geverifieerd eindpunt dat door andere modules en de API Docs Generator wordt weergegeven GET /api/products.

Opmerkingen van de operator

• Voorraadbewegingen zijn onveranderlijk — om een ​​beweging "om te keren", logt u een nieuwe beweging in de tegenovergestelde richting in plaats van de oorspronkelijke rij te bewerken.
• Bij het verwijderen van artikelen die op voorraad zijn, waarschuwt het systeem voordat de actie wordt toegestaan.
• Artikelafbeeldingen worden opgeslagen onder storage/app/public/product-service/ en geserveerd via de storage symbolische link. Na het uploaden van een nieuwe afbeelding wordt deze genormaliseerd naar een enkele bestandsnaam in de database; de openbare URL wordt berekend tijdens het renderen.