Интеграция с Ozon и Wildberries: как автоматизировать остатки, цены и заказы

Как связать учётную систему продавца с Ozon и Wildberries через API: синхронизация остатков и цен, загрузка заказов, FBO и FBS, отчёты и финансы, интеграция с 1С и МойСклад, ограничения API и контроль ошибок.

Пока продавец работает на одной площадке с сотней товаров, остатки и цены можно править в личном кабинете. Когда появляются Ozon и Wildberries одновременно, свой склад, несколько схем доставки и тысячи позиций, ручное управление ломается: товар продаётся на одной площадке, а на другой всё ещё висит в наличии, цена после изменения закупки обновилась не везде, заказы FBS собирают по распечаткам, а выручку по отчётам сверяют в таблицах неделями. Ниже — как устроена интеграция учётной системы с Ozon и Wildberries через API: что синхронизировать, как учитывать схемы FBO и FBS, где интеграции ломаются и когда хватает готового коннектора. Что автоматизирует интеграция с маркетплейсами Интеграция связывает учётную систему продавца — 1С, МойСклад, собственную ERP или WMS — с кабинетами площадок и берёт на себя пять потоков данных: Каталог. Соответствие артикулов учётной системы карточкам товаров на площадках, а для продавцов с большим ассортиментом — создание и обновление карточек. Остатки. Передача доступного количества со своих складов, чтобы не продавать то, чего нет. Цены. Выгрузка цен из единого прайса с учётом правил каждой площадки и участия в акциях. Заказы. Загрузка новых отправлений в учётную систему, резерв, сборка, этикетки, статусы, отмены и возвраты. Финансы и отчёты. Отчёты о реализации, начисления, удержания, выплаты — для бухгалтерии и управленческой аналитики. Эта статья — о подключении к существующим площадкам как продавец. Если вы думаете о запуске собственной торговой площадки, это совсем другой проект — см. как создать маркетплейс . Схемы работы: от чего зависит объём интеграции Главный вопрос до начала проекта — по каким схемам вы продаёте. От схемы зависит, кто хранит товар, чьи остатки передаются и нужно ли вообще загружать заказы в сборку. Схема Где хранится товар Кто доставляет Что делает интеграция FBO (Ozon), FBW (Wildberries) На складе площадки Площадка Остатки площадка ведёт сама; интеграция получает продажи, остатки на складах площадки, поставки и отчёты FBS (Ozon и Wildberries) На складе продавца Продавец собирает и сдаёт заказ площадке, дальше доставляет площадка Передаёт остатки своего склада, загружает заказы, печатает этикетки, формирует отгрузки realFBS (Ozon), DBS (Wildberries) На складе продавца Продавец своими силами или через службу доставки Всё, что для FBS, плюс статусы доставки и трек-номера Схемы можно совмещать: часть ассортимента лежит на складах площадки, часть отгружается со своего склада. У Wildberries есть и другие варианты — актуальный список и методы для каждого описаны в документации площадки. Для интеграции это значит, что один и тот же артикул может жить в нескольких контурах одновременно, и учётная система должна их различать. Как устроен доступ к API Ozon Seller API Для собственной интеграции продавец создаёт API-ключ в личном кабинете. Запросы отправляются с заголовками Client-Id и Api-Key. У ключей есть роли, ограничивающие доступ, — например, роль только на чтение подходит для аналитики и не позволяет менять цены и остатки. Сторонние сервисы из каталога решений Ozon могут подключаться через OAuth: продавец выдаёт приложению доступ, не передавая ему свой ключ. Wildberries API Токены создаются в кабинете продавца и привязаны к категориям API: «Контент», «Цены и скидки», «Маркетплейс» (заказы со своего склада), «Статистика», «Финансы» и другие. Wildberries выделяет несколько типов токенов: Персональный — для собственных программ продавца и коробочных систем, установленных у него. Сервисный — для облачного сервиса из каталога решений. Базовый — когда другие типы не подходят или нужно проверить интеграцию на реальных данных. Тестовый — для разработки в песочнице, без доступа к реальным данным. У токенов ограниченный срок действия, и часть методов доступна только для определённых типов токенов. Практический вывод: в регламенте нужна процедура перевыпуска токена и напоминание до истечения срока, иначе интеграция однажды утром просто перестанет работать. Правила безопасности для обеих площадок Отдельный ключ или токен на каждую систему и минимально нужные права. Ключи хранятся в защищённом хранилище секретов, а не в коде и не в общих таблицах. При уходе сотрудника или смене подрядчика ключи перевыпускаются. Лимиты запросов: проектировать под них с первого дня Обе площадки ограничивают частоту обращений к API, и ограничения различаются по методам и категориям. Wildberries описывает лимиты для каждой категории, сообщает остаток запросов в заголовках ответа и при превышении возвращает ошибку 429. Ozon при превышении тоже отвечает ошибкой 429 и отдельно ограничивает массовые операции с товарами. Конкретные цифры мы сознательно не приводим: площадки их регулярно меняют, и актуальные значения нужно брать из документации — dev.wildberries.ru и docs.ozon.ru — на момент разработки. Архитектурно это означает: Очередь вместо прямых вызовов. Изменения складываются в очередь и отправляются пакетами с контролируемой скоростью. Пакетные методы. Остатки и цены передаются списками, а не по одному товару. Повтор с задержкой. На ошибку 429 и временные сбои — повтор с нарастающей паузой, а не немедленный повтор в цикле. Только изменения. Отправлять остатки, которые поменялись, а полную сверку делать реже и в спокойное время. Разные контуры для разных задач. Загрузка заказов не должна стоять в очереди за массовым обновлением цен. Остатки: как не продать то, чего нет Прямой ответ: передавать на площадки не физический остаток, а доступный к продаже — за вычетом резервов и страхового запаса, — и обновлять его по событию, а не по расписанию раз в сутки. Из чего считать доступный остаток Физический остаток на складе, с которого идёт отгрузка FBS или realFBS/DBS. Минус резерв под уже принятые заказы со всех каналов — площадок, сайта, оптовых клиентов. Минус страховой запас на время задержки синхронизации. С учётом комплектов: остаток набора считается по наименьшему остатку его комплектующих. Один склад на несколько площадок Если товар со своего склада продаётся и на Ozon, и на Wildberries, продажа на одной площадке должна уменьшить остаток на другой. Здесь решает скорость: новый заказ приходит — резерв в учётной системе — пересчёт доступного количества — отправка на все площадки. Чем дольше цепочка, тем больше страховой запас. Склады площадки По FBO и FBW остатками управляет площадка. Интеграция их не отправляет, а получает: сколько товара на каких складах, сколько в пути, когда планировать поставку. Цены: единый прайс и правила площадок Цены лучше считать в одном месте — в учётной системе или отдельном модуле ценообразования, — а на площадки передавать результат. Ручные правки в кабинетах при работающей интеграции быстро превращаются в конфликт: следующая синхронизация перезапишет изменение, и никто не поймёт, какая цена правильная. Разные цены для разных площадок. Комиссии и логистика отличаются, поэтому одна розничная цена для всех каналов часто означает разную маржу. Скидки и акции. У площадок есть собственные механизмы скидок и акций, и итоговая цена для покупателя может отличаться от переданной. Интеграция должна знать, участвует ли товар в акции, прежде чем менять цену. Защита от ошибок. Проверка перед отправкой: цена не ниже минимальной, изменение не больше заданного порога. Опечатка в прайсе без такой проверки уходит на все площадки за минуты. Журнал. Кто и когда изменил цену, какое правило сработало, что ответила площадка. Заказы: от нового отправления до отгрузки Как узнавать о новых заказах Есть два способа. Первый — периодически запрашивать список новых отправлений. Второй — получать уведомления. Ozon поддерживает push-уведомления: в кабинете указывается адрес вашего сервера и выбираются типы событий — новое отправление, смена статуса, отмена, изменение остатков и другие. У Wildberries механизм вебхуков доступен сервисам из каталога бизнес-решений. Надёжная схема сочетает оба подхода: уведомление даёт скорость, периодическая сверка страхует от потерянных событий. Сквозной сценарий FBS Заказ появился на площадке. Интеграция получает отправление и создаёт заказ в учётной системе, запоминая идентификатор площадки. Резерв. Товар резервируется, доступный остаток пересчитывается и уходит на все площадки. Сборка. Склад получает задание, собирает заказ, для маркированных товаров фиксирует коды маркировки — площадки требуют передавать их по заказу. Этикетки и отгрузка. Интеграция получает этикетки, формирует отгрузку или поставку и переводит заказы в нужный статус до крайнего срока. Отмена. Если покупатель отменил заказ до отгрузки, резерв снимается, а товар возвращается в доступный остаток. Доставка и возврат. Статусы доставки и возвраты попадают в учётную систему, возвращённый товар проходит приёмку. Что обязательно предусмотреть Идемпотентность. Одно и то же отправление может прийти дважды — через уведомление и через сверку. Заказ создаётся один раз по идентификатору площадки. Сроки. У площадок есть крайние сроки сборки и отгрузки, за нарушение которых следуют санкции. Интеграция должна показывать заказы, близкие к сроку. Статусы в обе стороны. Изменение в учётной системе, которое не дошло до площадки, опаснее, чем отсутствие интеграции: склад уверен, что всё сделано. Финансы и отчёты о реализации Площадка продаёт товар по договору комиссии или агентскому договору, поэтому бухгалтерии нужны отчёты о реализации и детализация удержаний: комиссии, логистика, хранение, штрафы, компенсации. Wildberries формирует отчёты о реализации еженедельно, Ozon — ежемесячный отчёт о реализации и детализацию начислений. В 1С на их основании оформляется отчёт комиссионера (агента). Для интеграции здесь две задачи: Бухгалтерская. Загрузить отчёт и превратить его в документы учёта без ручного переноса строк. Управленческая. Разложить начисления и удержания по товарам и заказам, чтобы увидеть реальную маржу каждого артикула на каждой площадке. Финансовые методы API меняются заметнее других. В 2026 году обе площадки заменили часть методов финансовой отчётности: Ozon вывел из работы общий метод списка транзакций в пользу отдельных методов начислений, а Wildberries перенёс детализацию отчёта о реализации в новую категорию «Финансы» с изменёнными названиями и типами полей. Если интеграция писалась давно, её стоит проверить на устаревшие методы. Подписка на новости разработчиков обеих площадок — обязательная часть сопровождения. Когда данные площадок нужно свести с продажами на сайте, в рознице и в опте в одной картине, это уже задача аналитики — как её строить, мы разбирали в статье о BI-системе и управленческой отчётности . Закрывающие документы с площадками и документы по маркированным товарам проходят в электронном виде — подготовка к этому описана в материале об электронном документообороте с контрагентами . Готовое решение или своя интеграция Прямой ответ: начинать стоит с готового решения, если оно закрывает ваши схемы работы и учётную систему. Собственная разработка оправдана, когда готовые решения упираются в особенности процессов. Готовые варианты Встроенные возможности 1С. В ряде типовых конфигураций, например «1С:Управление нашей фирмой» и «1С:Розница», есть интеграция с Ozon и Wildberries. Модули для 1С от партнёров. Для «Управления торговлей», «Комплексной автоматизации» и ERP существуют отраслевые модули обмена с площадками. МойСклад. Поддерживает интеграцию с Ozon, Wildberries и Яндекс Маркетом: товары, остатки, цены, заказы. Облачные сервисы из каталогов решений площадок — для аналитики, цен, заказов и отчётов. Тарифы не приводим — они меняются и зависят от числа магазинов и заказов. Когда нужна разработка Учётная система нетиповая или сильно доработанная, и готовый модуль ломает её логику. Несколько юрлиц, складов и площадок, а остатки нужно распределять по сложным правилам. Своя WMS со сборкой, маркировкой и отгрузками, которую нужно связать с заказами площадок. Ценообразование зависит от закупки, конкурентов и маржи по каждой площадке. Нужна управленческая маржинальность по SKU с детализацией всех удержаний. Архитектурно своя интеграция обычно строится