Прибыль под контролем

Оперативная поддержка — быстро отвечаем и помогаем! Предлагайте новые функции и настройки — добавим их по вашим пожеланиям.

Назначение плагина

«Прибыль под контролем» помогает оценивать результат заказов с учётом сохранённой закупки, комиссии оплаты, расходов магазина на доставку, упаковки и ручных уточнений. Это управленческий расчёт по данным Shop-Script, а не бухгалтерская чистая прибыль и не сверка банковских поступлений.

1. Установка

Создайте резервную копию файлов и базы Webasyst. Требуются Shop-Script 12.1 или новее и PHP 7.4 или новее. Работа проверяется в интерфейсе Webasyst 2.0.

Установите плагин через «Инсталлер» Webasyst после приобретения лицензии. Для ручной установки разработчиком содержимое каталога profitcontrol размещается в wa-apps/shop/plugins/profitcontrol; нужно активировать плагин штатным механизмом Webasyst и создать таблицу из lib/config/db.php. Простого копирования архива недостаточно.

Откройте «Магазин → Плагины → Прибыль под контролем». Настройки доступны только администратору приложения «Магазин».

В «Обзоре прибыли» задайте период, лимит и исключённые статусы. Нажмите «Сохранить раздел», затем «Обновить расчёт».

2. Формула и полнота данных

Расчётная прибыль = итог заказа − возвращено покупателю − закупка + себестоимость возвращённых товаров − комиссия оплаты − доставка магазина − упаковка − дополнительные расходы. Итог заказа берётся после скидки: скидка второй раз не вычитается. Оплаченная покупателем доставка уже входит в итог заказа. Налоги, включённые Shop-Script в итог, отдельно не вычитаются.

Пример: итог заказа после скидки 10 000 RUB, закупка 6 000 RUB, комиссия 2% (200 RUB), расход доставки 700 RUB. Прибыль по этим включённым расходам — 3 100 RUB. Если закупочная цена неизвестна, это промежуточный результат. Такой заказ не включается в сводную прибыль полных расчётов.

Каждая валюта считается отдельно. Пересчёт между валютами не выполняется. Все правила и ручные суммы нужно задавать в валюте заказа. Отсутствие правила для валюты или способа доставки/оплаты помечает расчёт неполным. Отключённые статьи расходов не учитываются; их отключение не означает, что реальные расходы отсутствуют.

3. Себестоимость

Используется purchase_price позиции заказа, уже сохранённая Shop-Script в валюте этого заказа, умноженная на количество. Поддерживается дробное количество. Текущая закупка из карточки товара не подставляется, поэтому позднее изменение каталога само по себе не меняет расчёт старого заказа. Изменение самого заказа может изменить расчёт.

По умолчанию нулевая закупка считается неизвестной, в том числе у услуг. Если ноль действительно означает отсутствие затрат, отключите эту проверку либо подтвердите общую закупку заказа в «Расходах и возвратах». Отключение всей себестоимости делает расчёт неполным.

4. Комиссии оплаты

В разделе показаны ID и названия способов оплаты магазина. Введите правила по одному на строку: ID;ВАЛЮТА;процент;фиксированная сумма. Например 3;RUB;2;10 означает 2% от полного итога заказа и дополнительно 10 RUB для метода №3. Правило *;RUB;0;0 явно задаёт нулевую комиссию для остальных методов в RUB. Конкретный ID имеет приоритет перед *. Дробные суммы пишутся через точку. Комиссия применяется к итогу заказа до ручного возврата; фактическую возвращённую комиссию уточняйте вручную.

5. Доставка и упаковка

Правило доставки: ID;ВАЛЮТА;сумма. Пример 2;RUB;350 — расход магазина 350 RUB для метода №2. Это расход перевозчику, а не тариф, который платит покупатель. Для упаковки формат ВАЛЮТА;сумма, например RUB;50. Разделы включаются отдельно. Если расход зависит от веса, региона или счёта перевозчика, задайте ориентировочное правило и затем уточните реальный расход по заказу.

6. Расходы и возвраты

Укажите внутренний числовой ID заказа (он может отличаться от отображаемого номера с префиксом), нажмите «Открыть корректировку». Можно заменить общую закупку, комиссию, доставку и упаковку. Пустое поле сохраняет автоматический расчёт; явный ноль означает подтверждённый нулевой расход. Дополнительные расходы, сумма возврата покупателю и возвращённая себестоимость прибавляются к формуле отдельно. Укажите обязательную причину и сохраните.

Для возвращённого заказа со статусом refunded нужна ручная сверка: введите возвращённую сумму, стоимость вернувшихся товаров и отметьте проверку. Частичные возвраты и пользовательские статусы возврата автоматически не распознаются. Их необходимо внести вручную. Эти действия не возвращают деньги, не меняют статус, позиции, закупочные цены или остатки магазина. Изменяется только расчёт плагина. Сохраняется последняя корректировка с причиной, временем и ID администратора; полного журнала версий корректировок нет.

7. Отчёты и выгрузка

Обзор показывает прибыль только по полным расчётам, доход по всем выбранным заказам, число неполных и убыточных расчётов. В «Заказах и товарах» доступны поиск по ID, фильтры, подробный состав расчёта и CSV текущей отфильтрованной выборки. На экран выводится по 50 заказов с кнопкой продолжения.

Товарный отчёт показывает выручку позиций за вычетом записанной скидки позиций и закупку. Вклад товара не включает распределение расходов всего заказа, общие ручные корректировки и возвраты; он не равен окончательной прибыли товара. Отображаются первые 100 товаров по вкладу. Выборка заказов ограничена 100–5000 последними заказами за период; если лимит достигнут, показывается предупреждение. Для анализа большого магазина уменьшайте период.

8. Уведомления администратора

Включите email, введите один адрес, выберите сводку каждые 24 часа или 7 дней, сохраните раздел и отправьте тест. Плагин использует почтовый транспорт Webasyst. Подтверждение отправки означает передачу транспорту; проверьте входящие и спам.

В планировщике хостинга настройте запуск каждые пять минут: php /path/to/webasyst/cli.php shop profitcontrolPluginScan. Замените путь на свой и используйте подходящий PHP. Включите фоновую проверку. В настройках отображается время последнего успешного запуска. Без cron автоматические письма не отправляются. Порог низкой маржи применяется к фильтру в отчёте; отдельное письмо отправляется именно по убыткам при изменении списка убыточных заказов. Одинаковый список не дублируется. Сводка охватывает период, заданный в «Обзоре», и не является списком новых заказов с прошлого письма.

9. Данные, безопасность и ограничения

Плагин читает коммерческие данные магазина и хранит собственные настройки и корректировки в вашей базе Webasyst. Внешние сервисы аналитики не используются. Email содержит агрегированные суммы без имён и контактов покупателей. Изменение настроек и корректировок защищено административными правами и CSRF. Сайт, тема оформления и оформление заказа не изменяются.

Не рассчитываются налог к уплате, зарплата, аренда, списания по партиям, движение денежных средств, комиссии маркетплейсов и автоматическая сверка частичных возвратов. При необходимости вводите известные дополнительные расходы вручную. Неизвестные расходы и ограничения выборки нужно учитывать при принятии решений.

10. Если расчёт или письмо не работает

Нет заказов: расширьте период, проверьте фильтр оплаты и исключённые статусы.

Расчёт неполный: откройте номер заказа и устраните перечисленные неизвестные расходы.

Нет письма: сохраните email, проверьте тест, транспорт Webasyst и запуск cron.

Правило не сохраняется: проверьте число столбцов, валюту из трёх заглавных букв, точку в дробях и отсутствие повторов.

После смены настроек нажмите «Обновить расчёт». Сохранение раздела само по себе не пересчитывает уже открытый отчёт.