Каталог товаров/услуг в Mewayz
Надстройка продукта/услуги — это общий каталог инвентаря, используемый бухгалтерией, CRM, POS, EcomStore и Bookings.
Mewayz-исходный модуль — нет Mewayz вверх по течению. Документация создана из исходного кода пакета по адресу
packages/mewayz/ProductService/.





Введение
Дополнительный продукт/услуга – это единственный источник истины за каждый продаваемый предмет на платформе Mewayz. Вместо того, чтобы каждый модуль (Продажи, POS, EcomStore, Бронирование) поддерживал свой собственный список продуктов, все они читают и записывают данные в один общий каталог. Это означает, что когда оператор создает новый продукт в разделе «Продукт/Услуга», этот продукт сразу же можно использовать на всех торговых площадках с синхронизированным подсчетом запасов и налоговыми правилами.
Модуль охватывает физические товары с отслеживанием запасов, нескладские услуги с оплатой за час или за сеанс, инвентарь на нескольких складах, иерархические категории, построчные налоговые правила и единицы измерения.
Как включить этот модуль
Чтобы настроить надстройку продукта/услуги, вы можете перейти по этой ссылке: Настройка дополнения.
Дополнение закрыто PlanModuleCheck:ProductService. В большинстве планов продаж он включен по умолчанию — POS, Account, EcomStore и Bookings зависят от его активности.
Предметы
Просмотр элементов
- Перейдите к Товар и услуга → Предметы в боковой панели.
- В виде списка отображаются все элементы, которыми может управлять оператор, с фильтрами для Имя, Тип (товар или услуга), Категорияи Активный статус.
- В каждой строке отображается артикул, цена продажи, цена покупки, текущий объем складских запасов и кнопки быстрого действия (просмотреть, изменить, удалить).
Создать новый элемент
- Нажмите + Новый предмет в правом верхнем углу списка элементов.
- Форма имеет следующие поля:
- Имя — Отображаемое имя отображается в раскрывающихся списках на платформе.
- Тип — Продукт (отслеживается наличие на складе) или Услуга (нет на складе)
- Артикул — Дополнительный складской блок (уникальный для каждого арендатора)
- Категория — Выбирайте из существующих категорий или создайте новую в режиме онлайн.
- Единица — Единица измерения (каждый, кг, час, кв.м и т.д.)
- Цена продажи — Цена по умолчанию, когда этот товар отображается в счете или заказе.
- Цена покупки — Стоимость по умолчанию при получении товара
- Налоги — Множественный выбор налоговых ставок, применимых к этому товару.
- Изображение — Изображение продукта, используемое EcomStore + POS
- Описание — Подробное описание; используется на страницах сведений EcomStore
- Нажмите Сохранить для создания предмета. Событие (
CreateProductServiceItem) отправляется, чтобы прослушиватели в других модулях могли отреагировать (например, переиндексация поискового индекса).
Редактировать/удалить элемент
- В списке элементов нажмите кнопку редактирования строки, чтобы открыть ту же форму, заполненную данными элемента.
- Удаление отправки товара
DestroyProductServiceItem. Если на товар ссылается существующий счет, заказ или продажа в точках продаж, базовая строка имеет вид мягко удаленный поэтому исторические записи сохраняют свои данные нетронутыми.
Управление запасами
- Перейдите к Товар и услуга → Сток в боковой панели.
- В представлении запасов товары группируются по склад поэтому оператор, имеющий несколько физических местоположений, может видеть точные количества в каждом месте.
- В каждой строке отображается товар, склад, текущее количество и дата последнего перемещения.
Добавить или изменить запас
- Нажмите Добавить акции для регистрации движения акций.
- Выберите Товар, Склад, Количество (положительный для поступления, отрицательный для корректировки) и Примечание.
- Каждое движение записывается; каталог никогда не просто «обновляет номер» — каждое изменение можно проверить.
Категории
- Перейдите к Товары и услуги → Категории.
- Категории бывают плоскими или иерархическими (родительский → дочерний). Каждая категория может иметь цветная бирка это отражено в списке товаров и на страницах списков EcomStore.
- Операции создания/редактирования/удаления следуют стандартному шаблону CRUD.
Налоги
- Перейдите к Товары и услуги → Налоги.
- Добавьте налоговые ставки, необходимые оператору для бизнеса (например, НДС 15 %, налог с продаж 7,25 % и т. д.).
- Каждый налог имеет имя, ставка (в процентах) и необязательный описание.
- Затем налоги прикрепляются к товарам с помощью множественного выбора в форме товара.
Единицы
- Перейдите к Товар и услуга → Единицы измерения.
- Единицы измерения — это метки, отображаемые в корзине/строке счета — «каждый», «кг», «час», «сеанс», «кв.м» и т. д.
- Mewayz отправляет стартовый набор; добавьте или переименуйте в соответствии с отраслевым словарем оператора.
Межмодульное поведение
Другие модули Mewayz потреблять Каталог товаров/услуг:
- Аккаунт модуль — Счета-фактуры продажи и счета-фактуры покупки выбирают позиции из этого каталога.
- CRM / Продажи — Позиции сделок и справочные элементы предложений.
- POS-терминал модуль — продажи через POS напрямую извлекают список продуктов.
- ЭкомСтор модуль — продукты витрины отображаются из этого каталога с просмотром по категориям.
- Бронирование модуль — Каталог услуг для заказываемых услуг.
- Генератор APIDocs модуль — документирует конечные точки общедоступного API для программного доступа (
/api/products, и т. д.).
Разрешения
Пакет определяет детальные разрешения:
manage-product-service-item— Полное управлениеcreate-product-service-item— Создавайте новые предметыmanage-any-product-service-item— Редактировать любой элемент арендатораmanage-own-product-service-item— Редактировать только собственные элементы
Назначьте их через Настройки → Роли и разрешения.
API-доступ
Пакет также предоставляет GET /api/product-service/items в качестве внутренней аутентифицированной конечной точки, которую другие модули и генератор документов API отображают как GET /api/products.
Примечания оператора
- Движение запасов неизменно — чтобы «обратить» движение, запишите новое движение в противоположном направлении, а не редактируйте исходную строку.
- При удалении товаров, которые есть в наличии, система предупреждает, прежде чем разрешить действие.
- Изображения предметов хранятся в папке
storage/app/public/product-service/и обслуживается черезstorageсимволическая ссылка. После загрузки нового изображения оно нормализуется до одного имени файла в базе данных; общедоступный URL-адрес вычисляется во время рендеринга.