Остатки расходятся: где ломается интеграция ERP с маркетплейсом
Когда в ERP числится одна единица товара, а на маркетплейсе покупателю доступны две, проблема редко сводится к одной кнопке «синхронизировать». Остаток проходит через модель складского учёта, резервы, правила распределения запасов и очередь обмена.

Если хотя бы один участок использует другие данные или другой момент фиксации заказа, появляется ошибка синхронизации остатков маркетплейс ERP.
Это заметно не только по отменённым заказам. Команда начинает вручную сверять кабинеты, временно выключать карточки, искать пропавшие единицы и выяснять, какая система показывает правду. Чтобы вернуть процессу предсказуемость, нужно сначала определить, что именно считается остатком в каждом канале, затем проследить путь изменения от ERP до площадки и проверить, где оно задержалось или было отвергнуто.
Откуда берётся остаток: склад, схема продаж и резервы
В учётной системе число «в наличии» может означать физический товар на складе. В кабинете маркетплейса остаток зависит от другой модели: для какого склада он указан, по какой схеме продаётся товар и какие количества уже зарезервированы или распределены. Поэтому сравнение двух цифр имеет смысл только после проверки, что сравниваются одинаковые товары, склады и состояния заказа.
Например, компания хранит товар на своём складе и продаёт его через несколько площадок по схеме, при которой заказ собирает продавец. ERP может показывать доступное количество по конкретному складу, а маркетплейс принимает остаток, привязанный к складу продавца. Если интеграция отправляет суммарное количество без нужного складского соответствия, данные разойдутся даже при исправной передаче API.
У Wildberries в модели FBS остатки сгруппированы по складам продавца. Заказы поступают на каждый склад в соответствии с указанными для него остатками. Это означает, что общий итог по компании не заменяет остаток в разрезе склада: товар на складе А не обязательно должен автоматически появляться в доступности склада Б.
В ERP тоже может быть несколько значений, которые интерфейс называет остатком. Физическое наличие, свободный запас, доступное для заказа количество и количество после резервов — разные показатели. Интеграции обычно нужен тот показатель, который отражает товар, действительно доступный для нового заказа. Если в обмен попадает физическое наличие, а открытые заказы ещё не вычтены, площадка может продолжать продавать уже зарезервированные единицы.
Перед поиском технического сбоя полезно зафиксировать, какое значение передаётся и откуда оно берётся. В рабочем описании процесса стоит указать:
- какой склад ERP соответствует каждому складу в кабинете площадки;
- считается ли остаток физическим, свободным или доступным после резервирования;
- когда заказ уменьшает доступность: при создании, подтверждении или другом событии в вашей учётной модели;
- возвращается ли товар в доступный запас после отмены или снятия резерва;
- кто управляет остатком, если товар лежит на нескольких складах или продаётся по разным схемам.
Без этих ответов техническая диагностика превращается в разбор симптомов. Интеграция может успешно передавать количество, которое бизнес сам определил неверно.
Как заказ на одной площадке влияет на другие каналы
Расхождение остатков ERP и маркетплейса часто начинается не с отказа передачи, а с общего запаса. Последняя единица одновременно доступна на нескольких площадках. Покупатель оформляет заказ на одной, информация доходит до ERP, затем запускается обновление на другой. Пока изменение не обработано и не принято, второй канал тоже может показать товар доступным.
Ozon прямо описывает такой сценарий оверселла для общего запаса: разные покупатели могут заказать последние единицы на разных площадках, пока обновление задерживается или ограничено лимитами API. Это не доказывает, что каждый случай двойной продажи вызван задержкой. Но сам сценарий показывает, почему единого общего остатка недостаточно, если несколько витрин продают одни и те же единицы.
Для снижения риска используют два подхода. Первый — страховой буфер: часть запаса не публикуют на площадках, оставляя запас на время обмена и обработки заказов. Второй — квотирование: общий остаток заранее делят между каналами, и каждый получает собственный лимит. Ozon приводит примеры обоих подходов, но конкретные значения в таких примерах иллюстративны. Универсального размера буфера для всех товаров и компаний нет.
| Подход | Как устроен | Что потребуется от команды |
|---|---|---|
| Общий остаток без квот | Каналы получают данные об одном запасе, изменения распространяются по мере поступления заказов | Контроль задержек обмена и риска одновременной продажи последних единиц |
| Страховой буфер | На площадки передаётся меньше товара, чем доступно физически | Настройка буфера с учётом скорости продаж и допустимого риска отмен |
| Квоты по каналам | Запас распределяется между площадками заранее | Пересмотр долей при изменении спроса и понятное правило перераспределения |
Выбор зависит от сценария продаж. Если товар продаётся медленно и остаток велик, простой обмен общего количества может быть приемлем. Для быстро продаваемых позиций с небольшим запасом цена задержки выше: здесь буфер или квоты могут оказаться полезнее, хотя они снижают количество товара, доступного на отдельных площадках.
Отдельный источник рассогласования — заказы, которые обрабатываются вне привычного потока ERP. Например, часть продаж или резервов учитывается в другой системе либо сотрудник меняет количество вручную в кабинете. Тогда ERP продолжает считать единицу свободной, хотя в канале она уже недоступна. Для устойчивого процесса важно определить, какие изменения разрешено делать вручную и как они возвращаются в основную учётную систему.
Общий запас становится управляемым только тогда, когда команда понимает, кто и в какой момент уменьшает доступность товара для каждого канала.
Задержки, очереди и лимиты API
Обмен данными состоит из нескольких событий. Сначала изменение фиксируется в учётной системе, затем интеграция формирует запрос, отправляет его, получает ответ и, наконец, проверяет, что площадка приняла новое значение. Успешное выполнение одного шага не гарантирует, что остальные уже завершились.
Ozon рекомендует сначала зафиксировать изменение количества в базе продавца и после этого передать актуальный остаток на площадку. В обратном направлении площадка сообщает продавцу о заказах, поступивших на ней. Такая двунаправленная схема важна для общей картины: ERP должна получать события продаж, а маркетплейс — актуальное количество после изменений вне платформы.
Если система отправляет остатки только по расписанию, между изменением и следующей выгрузкой возникает окно, когда разные каналы располагают разными данными. При ночной пакетной загрузке эффект может быть особенно заметным: витрина способна показывать товар доступным после того, как запас фактически исчерпан. Это типичный риск пакетного обмена, а не доказательство неисправности конкретного коннектора.
У API есть и технические ограничения. Для метода Ozon /v2/products/stocks указаны максимум 100 пар «товар–склад» в одном запросе, до 80 запросов в минуту с аккаунта продавца и интервал не чаще одного обновления одной пары «товар–склад» за 30 секунд. Эти условия относятся к конкретному методу Ozon. Их нельзя переносить на Wildberries, другие методы или сторонний сервис интеграции.
Если несколько процессов пытаются обновить одну и ту же пару чаще допустимого, часть запросов может не пройти. Похожий эффект возникает, когда интеграция отправляет большой поток изменений без очереди и не учитывает ответы площадки. Поэтому для обмена полезна очередь, которая:
- объединяет несколько изменений одного товара и склада, если они произошли до отправки;
- соблюдает лимиты конкретного метода;
- повторяет запросы после временных ошибок по контролируемому правилу;
- сохраняет ответ площадки и причину отказа;
- позволяет отличить поставленное в очередь обновление от принятого.
Важна именно фиксация результата. Статус «задача запущена» не равен статусу «остаток обновлён». Если интерфейс интеграции показывает только время последней выгрузки, сотрудник может принять сам факт запуска за подтверждение успешной передачи. Журнал запросов должен показывать, что отправлялось, для какого товара и склада, когда пришёл ответ и потребовалась ли повторная попытка.
Ozon не рекомендует массово обновлять все товары по расписанию, если изменений не было, сначала отправлять нулевой остаток, а затем актуальный, а также одновременно использовать несколько интеграций. Такие действия создают лишний поток запросов и затрудняют понимание, какой процесс записал значение последним. Если в компании действительно работают несколько систем обмена, стоит назначить владельца данных и явно определить, какая система имеет право менять остатки.
Идентификаторы товаров и складов: где возникает подмена
Иногда обмен выглядит исправным: запросы уходят, соединение работает, а цифры всё равно не совпадают. Тогда нужно проверить сопоставления. ERP отправляет не просто количество, а количество для определённой пары «товар–склад». Ошибка в идентификаторе товара, кабинете или складе приводит к тому, что корректная цифра относится не к той сущности либо запрос отклоняется.
Проверка должна проходить по цепочке: внутренний артикул в ERP, идентификатор товара на площадке, кабинет продавца и склад, к которому относится остаток. Название товара для такой сверки недостаточно: похожие наименования могут скрывать разные карточки, комплектации или варианты. Если площадка сообщает о несуществующем идентификаторе или товаре из другого кабинета, нужно исправить соответствие, а не повторять тот же запрос без изменений.
Есть и менее очевидный сценарий: карточка товара верная, но склад сопоставлен неправильно. В ERP запас хранится на одном складе, а интеграция отправляет его в другой склад маркетплейса. Сумма по компании при этом может выглядеть правдоподобно, однако доступность для конкретной схемы продаж останется неверной. Поэтому сверять стоит не только общий итог, но и каждую пару «товар–склад».
Для диагностики удобно выбрать несколько расхождений и проследить их от начала до конца. В выборку стоит включить товар с остатком больше нуля, позицию, которую недавно заказали, и случай с отменой или изменением заказа, если он есть. Для каждой позиции фиксируют значение ERP до отправки, склад и идентификатор, время изменения, ответ интеграции и количество в кабинете. Такая проверка помогает отделить сбой сопоставления от задержки или неправильной логики резервирования.
Не стоит считать любое расхождение доказательством того, что виноват API. Причиной могут быть неверная настройка склада, другой показатель остатка, параллельная запись из кабинета или устаревшая конфигурация обмена. Универсальной допустимой задержки для всех ERP, коннекторов и площадок нет: рабочий интервал зависит от реализации интеграции и требований конкретного процесса.
Для Ozon есть ещё один практический нюанс: площадка объявила о переходе методов получения информации о складах и остатках FBS/rFBS на новые версии с 7 апреля 2026 года. Этот срок уже прошёл, поэтому при диагностике существующей интеграции нужно смотреть, какие методы она использует сейчас и что видно в её журнале запросов. Сам факт объявленной миграции не говорит, что конкретная система перешла на новые методы или что все ошибки связаны с этим изменением.
Как выстроить обмен, чтобы расхождение было заметно раньше отмены
Надёжная настройка синхронизации товаров с маркетплейсом начинается с единого правила учёта, а не с увеличения частоты выгрузки. Сначала команда определяет, какая система владеет остатком, что считается доступным количеством и как резерв заказа влияет на этот показатель. Затем настраиваются сопоставления складов и товаров, а уже после этого выбираются расписание, очередь и правила повторной отправки.
В рабочем процессе полезно разделить три состояния: изменение ещё не отправлено, запрос передан площадке, обновление подтверждено. Между ними могут быть задержки и ошибки. Когда сотрудники видят только итоговый остаток, они не понимают, на каком этапе возникло расхождение. Когда видны статусы и история, можно быстро установить, требуется ли исправить данные, дождаться очереди или восстановить соответствие идентификаторов.
Для Ozon в рекомендациях описана такая логика: хранить актуальный остаток на стороне продавца, отправлять обновление после фиксации изменения, использовать очередь и вести журнал отправок и отказов. Очередь помогает соблюдать лимиты, объединять изменения и повторять запросы после ошибок. Это полезный проектный ориентир, но конкретная реализация должна учитывать документацию используемого метода и возможности интегратора.
Перед запуском процесса стоит пройти последовательность:
1. Уточнить источник доступного остатка. Зафиксировать, какие резервы уже вычтены и когда именно меняется доступность при заказе, отмене или возврате.
2. Проверить соответствия. Сверить идентификаторы товаров и складов между ERP, кабинетом продавца и интеграцией, уделив внимание товарам с вариантами и несколькими местами хранения.
3. Определить правила для общего запаса. Решить, будет ли остаток публиковаться целиком, распределяться квотами или уменьшаться на страховой буфер.
4. Настроить обработку обмена. Добавить очередь, контроль лимитов конкретной площадки, журнал ответов и повторную отправку там, где она уместна.
5. Проверить изменения на ограниченном наборе позиций. Проследить не только обычное уменьшение остатка, но и заказ, отмену, ручное изменение и ситуацию с нулевым количеством.
6. Назначить ответственного за мониторинг. Команде нужно понимать, кто разбирает отказы и кто утверждает изменения в правилах складского учёта.
Практический результат измеряется не количеством запросов, а тем, насколько быстро команда замечает и локализует проблему. Для внутреннего контроля можно отслеживать число неподтверждённых обновлений, повторяющиеся отказы, позиции с несоответствием склада и время от фиксации изменения в ERP до подтверждения на площадке. Это внутренние показатели процесса, а не универсальные отраслевые нормативы: полезные пороги компания определяет под свои продажи и допустимый риск.
Не стоит лечить расхождение простым учащением выгрузки, пока не проверены данные и правила. Если ERP каждый раз отправляет не тот склад или не вычитает резервы, более частый обмен будет быстрее распространять неверный остаток. Если запросы упираются в лимиты, увеличение потока способно усложнить очередь. А если две интеграции записывают одно поле, частота только затруднит поиск источника последнего изменения.
Устойчивый обмен строится вокруг понятного владельца остатка, корректной модели доступности и наблюдаемого пути каждого обновления. Начните с нескольких конкретных расхождений, разберите их по товарам и складам, затем исправьте повторяющуюся причину и расширяйте настройку постепенно. Так команда сохранит управляемость процесса, а интеграция станет частью операционной работы, а не поводом для ежедневной ручной сверки.