Синхронизация остатков

Приложение поддерживает остатки на Ozon в соответствии с МойСкладом: меняется остаток в МойСкладе — актуальное количество уходит на Ozon. Так вы не продаёте то, чего уже нет на складе, и не теряете продажи из-за заниженных остатков.

Как это работает

1. Вы меняете остаток в МойСкладе (приёмка, продажа, инвентаризация, заказ).
2. МойСклад сразу сообщает приложению об изменении (через подписку на изменения остатков по складам).
3. Приложение пересчитывает количество для нужного склада Ozon и обновляет остаток на Ozon.

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

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

Скриншот

Здесь будет скриншот раздела настроек, отвечающего за остатки.

Какие товары синхронизируются

Остатки уходят по товарам, у которых найден товар в МойСкладе по артикулу (offer_id на Ozon = артикул в МойСкладе) или которые сопоставлены вручную на экране отправления.

Один товар МойСклада — один артикул Ozon

Общий физический остаток нельзя отправлять целиком в несколько карточек Ozon: витрина показала бы удвоенное доступное. Поэтому связать один товар с двумя артикулами приложение не даёт, а если такие связи уже есть (старые данные, дубли карточек), остатки по этому товару не отправляются, и Сводка показывает «Конфликты связей» со ссылкой на экран, где лишний артикул можно отвязать. Для второго артикула заведите в МойСкладе отдельный товар или комплект. Сопоставление строится на экране

«Товары» после «Обновить с Ozon» и при импорте: сколько товаров сопоставлено, видно в подзаголовке экрана «Товары». Товары без пары в МойСкладе остатков не получают — их можно создать импортом или привести артикулы к одному значению.

Отправить остатки сейчас

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

Защита от ошибок (важно)

Случайно «уронить» витрину Ozon приложение не может by design:

• остатки уходят только по сопоставленным складам и только по товарам, которые есть на Ozon (сопоставление по артикулу);
• встроена защита от перегрузки API Ozon (ограничение частоты, повтор при временных ошибках);
• каждое отправление количества фиксируется в журнале — видно, что и когда было отправлено.

Одна витрина — один источник остатков

Если для тех же товаров уже включена встроенная интеграция МойСклада с Ozon или другой коннектор остатков — не включайте вторую синхронизацию на те же склады. Два источника будут перезаписывать друг друга. Оставьте что-то одно.

Несколько складов

Каждая пара «склад Ozon → склад МойСклада» работает независимо: у каждого склада Ozon своё количество, свой журнал отправок и своя сверка. Заказ с Ozon попадает на тот склад МойСклада, который сопоставлен со складом Ozon из отправления, и резерв встаёт там же.

Заказ с несопоставленного склада Ozon

Если привязки заданы, а отправление пришло со склада Ozon, которого среди них нет, заказ в МойСкладе не создаётся и резерв не ставится — иначе он молча встал бы на первый попавшийся склад. Такое отправление видно в списке заказов с пометкой «склад Ozon не сопоставлен». Добавьте пару в Настройки → Склады — заказ создастся следующим опросом.

Один склад МойСклада на несколько складов Ozon

Так можно (например, FBS и realFBS с одного физического склада), но все эти склады Ozon получают одно и то же доступное количество. Продажа на одном из них уменьшит доступное для другого только после того, как заказ попадёт в МойСклад и поставит резерв (обычно в течение минуты). В это окно возможна продажа сверх остатка. Приложение предупреждает об общем запасе при сохранении пары и показывает его в списке складов.

Отключение склада

Убрать пару «склад Ozon → склад МойСклада» просто так нельзя: на Ozon остался бы продаваемый остаток, который больше никто не обновляет. Поэтому при отключении приложение спрашивает, что сделать с остатками:

• Обнулить на Ozon, затем убрать связь — приложение отправит 0 по всем товарам, по которым оно что-то отправляло на этот склад, и уберёт связь только после того, как Ozon принял отправку. Если отправка не подтверждена (режим проверки, ограниченный режим без этих товаров в списке, ошибка Ozon), связь остаётся, и отключение можно повторить.
• Остатками управляет другая система — только убрать связь — на Ozon ничего не отправляется. Выбирайте, только если уверены, что остатки этого склада Ozon обновляет кто-то другой; иначе на витрине останется старое число.

Что именно отправляется на Ozon

На Ozon уходит доступное количество (freeStock), а не физический остаток:

доступно = физический остаток − резервы

Это важно: если часть товара уже зарезервирована (заказ с Ozon, ВБ или опт), на витрину уйдёт только то, что реально можно продать.

Схема с резервом

Ozon заказал 2 шт
    → резерв МойСклада +2
    → доступно −2
    → другие площадки автоматически видят меньше

Почему это правильно

Физический остаток не отражает резервы. Отправляя freeStock, коннектор защищает вас от двойных продаж — сразу на всех подключённых каналах.

Что синхронизируется

Параметр	Сейчас
Доступные остатки (freeStock = остаток − резерв)	✅
Цены (отдельной синхронизацией)	✅ подробнее
Физический остаток (без учёта резервов)	не отправляется