Документация MBOS
Описание функциональных характеристик MBOS, требования к окружению и порядок начала работы.
Страница публичная, поэтому она сокращена намеренно: состав компонентов, внутреннее устройство, пошаговая установка, эксплуатация и разбор неисправностей в неё не входят. Эта часть документации передаётся вместе с комплектом поставки и предоставляется по запросу — корпоративным заказчикам и проверяющим органам.
История изменений — на странице «Изменения». Вопросы по установке и эксплуатации — через форму обратной связи.
1. Общие сведения
1.1. Назначение
MBOS — система управления бизнесом продавца маркетплейсов. Программное обеспечение собирает данные из личных кабинетов торговых площадок по их официальным программным интерфейсам, приводит разнородные данные к единой модели, рассчитывает финансовый результат по каждой товарной позиции и предоставляет средства управления продажами.
Продукт отвечает на три вопроса владельца бизнеса: что происходит, почему это происходит и что следует сделать.
Отличительная особенность — прослеживаемость: любая рассчитанная величина раскрывается до первичной операции торговой площадки с указанием даты, названия операции в терминах самой площадки и номера документа. При невозможности получить данные ПО сообщает об ошибке и не подставляет нулевые значения вместо отсутствующих.
1.2. Области применения
- розничная торговля через электронные торговые площадки (маркетплейсы);
- операторы фулфилмента — складские компании, обслуживающие продавцов маркетплейсов;
- бухгалтерский и управленческий учёт результатов торговли на площадках.
1.3. Поддерживаемые торговые площадки
Ozon (Seller API и Performance API), Wildberries, Яндекс Маркет, ПСБ Маркет. Архитектура подключения площадок модульная: добавление новой площадки не затрагивает расчётное ядро и интерфейс.
1.4. Типы пользователей
ПО содержит два независимых контура с раздельным доступом:
- Кабинет продавца — владелец товара и его сотрудники;
- Кабинет оператора фулфилмента — складская компания, работающая с товаром продавца по доступу, который продавец выдаёт и в любой момент отзывает.
1.5. Режимы поставки
| Режим | Описание |
|---|---|
| Облачный сервис (SaaS) | Доступ по подписке к экземпляру, размещённому на инфраструктуре правообладателя на территории Российской Федерации |
| Установка в контуре заказчика (on-premise) | Полный комплект контейнеров разворачивается на оборудовании заказчика; данные не покидают его периметр, наружу идут только запросы к API торговых площадок |
3. Функциональные характеристики
MBOS — многопользовательская система с изоляцией данных между организациями. Ниже перечень возможностей; порядок расчётов, состав компонентов и приёмы реализации в публичную версию не входят.
Подключение площадок и сбор данных. Подключение кабинетов Ozon, Wildberries, Яндекс Маркета и ПСБ Маркета по официальным программным интерфейсам ключами, которые продавец создаёт сам. По ПСБ Маркету данные приходят на чтение: магазин, товары, отправления и возвраты. Собираются заказы, продажи, финансовые отчёты, товары, остатки, рекламные кампании, отзывы, начисления и удержания. Синхронизация идёт по расписанию, с журналом прогонов и понятными состояниями; при неудачной загрузке система сообщает об ошибке и её причине.
Финансовый результат. По каждой товарной позиции, магазину, площадке и периоду: выручка, комиссии площадки, логистика, платное хранение, реклама, возвраты и компенсации, себестоимость, налог, прибыль и маржа до и после налога. Любая величина раскрывается до первичной операции площадки — с датой, её собственной формулировкой и номером документа.
Себестоимость и расходы вне площадки. Ручной ввод, импорт из электронных таблиц, загрузка прайс-листа поставщика, перечень товаров без указанной себестоимости. Собственные статьи расходов бизнеса с учётом в прибыли.
Аналитика ассортимента. ABC/XYZ-анализ, вклад товара в прибыль, воронка от показа до заказа, произвольные теги и фильтры, карточка товара с историей показателей.
Склад и поставки. Остатки по схемам торговли раздельно, оценка риска дефицита, расчёт объёма поставки с учётом товара в пути, разбор расхождения остатков, группы складов и перемещение остатков между площадками.
Финансовые отчёты и сверка. Отчёт о прибылях и убытках, отчёты о реализации построчно, детализация начислений, налог по площадкам и сверка показателей системы с показателями кабинета площадки: величина системы, величина площадки, разница и её расшифровка.
Управление продажами. Переоценка по правилам с защитой «не ниже себестоимости», управление ставками рекламных кампаний, автоответы на отзывы, создание и массовое редактирование карточек, смена изображений, участие в акциях. Все действия, изменяющие данные на площадке, выключены по умолчанию, включаются отдельным разрешением по типам действий и по каждому магазину и требуют подтверждения человеком. Предусмотрен общий останов автоматики, не затрагивающий сбор данных и расчёты.
Поисковая оптимизация, отзывы, уведомления. Частотность поисковых запросов, проверка заполненности карточки, работа с отзывами и вопросами, предупреждения о рисках в интерфейсе и в мессенджере.
Советник на основе языковой модели. Ответы на вопросы по данным компании, объяснение отклонений показателей, ежедневная сводка, рекомендации с расчётом. Советник ничего не изменяет самостоятельно. Функция опциональна, поддерживается российская модель GigaChat; без настроенной модели раздел работает на детерминированных правилах.
Контур фулфилмента. Отдельный кабинет оператора склада: доступ, который продавец выдаёт и отзывает; приёмка поставок с фиксацией заявленного и принятого количества; сборочные задания; тарифная сетка на каждого продавца; начисления и счета с печатной формой и выгрузкой в PDF. Оператору не доступны цены продажи, выручка, комиссии площадки и себестоимость товара продавца.
Многопользовательская работа и администрирование. Роли и права, приглашение сотрудников и партнёрских организаций, журнал действий, административная панель, встроенная база знаний, журнал изменений версий.
Безопасность. Аутентификация, хранение паролей в виде хешей, шифрование ключей доступа к внешним системам, разграничение прав, изоляция данных организаций, журнал действий, ежедневное резервное копирование с контрольным восстановлением, версионированные изменения схемы данных. Система не является средством защиты информации.
4. Системные требования
4.1. Серверная часть
| Параметр | Минимально | Рекомендуется |
|---|---|---|
| Архитектура | x86-64 | x86-64 |
| Процессор | 2 ядра | 4 ядра и более |
| Оперативная память | 4 ГБ | 8 ГБ и более |
| Дисковое пространство | 40 ГБ | 100 ГБ и более (данные и резервные копии) |
| Операционная система | 64-разрядная ОС семейства Linux с ядром 5.x и новее | Ubuntu Server 22.04 LTS / 24.04 LTS |
| Docker Engine | 20.10 | 24.0 и новее |
| Docker Compose | v2 | v2 |
| Сеть | исходящий доступ к API торговых площадок; входящие порты 80 и 443 | то же |
Приложение исполняется в контейнерах и не имеет зависимостей от конкретного дистрибутива операционной системы хоста, поэтому переносится на любую ОС семейства Linux с Docker, включая российские операционные системы (Astra Linux Special Edition, РЕД ОС, ALT Server).
4.2. Клиентская часть
Любая операционная система с современным веб-браузером: Windows 10/11, Linux, macOS, Android, iOS. Поддерживаются Яндекс Браузер, Google Chrome, Microsoft Edge, Mozilla Firefox, Safari актуальных версий. Установка программ на рабочее место не требуется. Разрешение экрана — от 1280 × 720; интерфейс адаптируется к мобильным устройствам. Требуется поддержка JavaScript и файлов cookie.
Установка и эксплуатация
MBOS поставляется в двух режимах: доступ по подписке в облаке правообладателя и установка в инфраструктуре заказчика, при которой данные не покидают его контура.
Установка выполняется администратором заказчика по инструкции, входящей в комплект поставки. Программное обеспечение разворачивается набором изолированных компонентов на сервере с 64-разрядной операционной системой семейства Linux; требования к оборудованию приведены выше. Развёртывание, применение обновлений и откат выполняются штатными средствами контейнеризации и занимают, по опыту, 20–30 минут на новом сервере.
Эксплуатация не требует ручного обслуживания: обновление схемы данных, резервное копирование с контрольным восстановлением и проверки работоспособности выполняются автоматически. Состояние сервисов и порядок действий при сбое описаны на странице «Статус системы», сроки поддержки — на странице «Поддержка».
Полная документация — состав компонентов, пошаговая установка, эксплуатация, порядок обновления и разбор типовых неисправностей — передаётся вместе с комплектом поставки, а также предоставляется по запросу: через форму обратной связи.
8. Ограничения
- ПО не изменяет данные на торговых площадках без явного разрешения и подтверждения пользователя;
- состав и сроки предоставления данных определяются самими торговыми площадками; при отсутствии данных ПО показывает отсутствие значения, а не ноль;
- ПО не является средством защиты информации;
- ПО не предназначено для обработки сведений, составляющих государственную тайну.
9. Термины и сокращения
| Термин | Значение |
|---|---|
| Маркетплейс, площадка | Электронная торговая площадка (Ozon, Wildberries, Яндекс Маркет) |
| SKU | Учётная единица товара |
| FBO | Схема торговли со склада площадки |
| FBS | Схема торговли со склада продавца |
| Фулфилмент | Складская услуга: приёмка, хранение, сборка и отгрузка товара продавца |
| СПП | Скидка постоянного покупателя |
| Репрайсер | Средство автоматической переоценки товаров по правилам |
| Биддер | Средство управления ставками рекламных кампаний |
| API | Программный интерфейс приложения |
| RBAC | Разграничение доступа на основе ролей |
Актуальную редакцию документа и ответы на вопросы по установке можно получить через форму обратной связи.