Синхронизация остатков Битрикс ↔ МойСклад

Расхождение остатков — главная причина отменённых заказов и недовольных покупателей. Задача синхронизации — чтобы витрина Битрикс показывала ровно то количество, что реально доступно в МойСклад, с учётом резервов и разных складов.

Модель остатков в обеих системах

МойСклад различает несколько показателей: остаток, резерв, ожидание и доступно (остаток минус резерв). На сайт почти всегда нужно отдавать именно «доступно», иначе зарезервированный под другой заказ товар снова попадёт в продажу.

В Битрикс остаток хранится в двух местах: поле CATALOG_QUANTITY в таблице каталога и построчно по складам в b_catalog_store_product при включённом складском учёте. Решите заранее, работаете вы с суммарным остатком или с раскладкой по складам.

Направление и мастер-система

Для остатков мастером всегда должна быть учётная система — МойСклад. Сайт остатки только принимает и отображает, но никогда не редактирует напрямую. Единственное исключение — списание при оформлении заказа, но и его правильнее делать через создание документа в МойСклад, а не правкой количества на сайте.

Из этого правила следует и практический вывод: витрина Битрикс не должна уводить остаток в минус самостоятельно. Даже при оформлении заказа корректнее не уменьшать число в каталоге напрямую, а фиксировать резерв и ждать, пока учётная система подтвердит движение и вернёт актуальное «доступно».

Несколько складов и что показывать

Когда складов несколько, возможны три стратегии выгрузки на сайт.

• Суммарный остаток — складываем «доступно» по всем складам в одно число. Просто, подходит для магазина с общим пулом товара.
• Выбранные склады — на сайт едут остатки только с розничных складов, а транзитные и брак игнорируются.
• Раскладка по складам — Битрикс показывает наличие в конкретных точках (актуально для сети магазинов с самовывозом).

Для третьего варианта в Битрикс должны быть заведены склады (catalog_store), сопоставленные со складами МойСклад по ID.

Частота обновления и вебхуки

Есть два режима синхронизации, их часто комбинируют.

1. По расписанию (pull). Cron или агент Битрикс раз в 5–15 минут запрашивает у МойСклад отчёт по остаткам /report/stock/all/current и обновляет каталог.
2. По вебхукам (push). МойСклад при изменении остатка шлёт уведомление на ваш обработчик, и обновляется только затронутый товар — почти в реальном времени.

Пример точечного обновления в Битрикс после получения нового остатка:

\Bitrix\Catalog\Model\Product::update($productId, ['QUANTITY' => $available]);

Единицы измерения и кратность

Отдельный источник расхождений — разные единицы измерения. Если в МойСклад товар учитывается в упаковках или коробках, а на сайте продаётся поштучно, остаток надо пересчитывать по коэффициенту кратности.

• Зафиксируйте базовую единицу учёта в МойСклад и единицу продажи в Битрикс.
• Задайте коэффициент пересчёта (например, 1 коробка = 12 штук) и применяйте его при выгрузке.
• Весовой и метражный товар округляйте по согласованному правилу, иначе появятся дробные остатки.

Решите заранее и вопрос дробных остатков: показывать ли 0.5 или округлять вниз до целого доступного количества.

Резервы и защита от оверселлинга

Оверселлинг — продажа товара, которого уже нет, — возникает в окне между заказом и следующей синхронизацией. Минимизировать его помогает несколько приёмов.

• Отдавать на сайт доступный остаток, а не физический.
• При оформлении заказа сразу создавать резерв в МойСклад, а не ждать очередной выгрузки.
• Использовать штатный резерв Битрикс (CATALOG_RESERVATION) как временную блокировку до подтверждения.
• На ходовых позициях сократить интервал синхронизации или перейти на вебхуки.

Полезно предусмотреть и поведение при нулевом остатке: скрывать товар, показывать «под заказ» или оставлять с пометкой о сроке поставки. Это бизнес-решение, но реализуется оно на уровне обмена — обычно через служебное свойство или изменение активности элемента ACTIVE.

Контроль и сверка

Даже отлаженный обмен нужно проверять. Заведите регулярную сверку и алерты.

Логируйте каждый запуск: сколько позиций обновлено, сколько ошибок, длительность. Это первый инструмент при разборе жалоб на «неправильные остатки». Полезно хранить и историю значений по ходовым позициям — так проще доказать, в какой момент и почему остаток изменился, и отличить ошибку обмена от реального движения на складе.

Итог

Синхронизация остатков надёжна, когда мастером выступает МойСклад, на сайт едет доступный (а не физический) остаток, а обмен сочетает вебхуки для скорости и часовую сверку для надёжности. Оверселлинг гасится ранним резервированием и коротким интервалом обновления на ходовых позициях.

Мы в B2Bsite настраиваем такой обмен с учётом ваших складов, резервов и нагрузки, добавляем сверку и мониторинг. Если остатки регулярно расходятся или магазин перерос типовой модуль — соберём устойчивую схему под ваш каталог.