Интеграция 1С-Битрикс с Ozon и Wildberries: архитектура и ошибки

Интеграция с маркетплейсами — это не просто выгрузка товаров, а три независимых потока данных с разными лимитами API и ценой ошибки. Разбираю архитектуру мастер-системы, модели FBS/FBO, идемпотентность заказов и типичные ошибки, которые съедают маржу.

Интеграция 1С-Битрикс с Ozon и Wildberries: архитектура и ошибки

Почему ручная выгрузка на маркетплейсы перестала работать

В 2026 году Wildberries и Ozon вместе занимают более 70% онлайн-торговли в России. Для магазина на 1С-Битрикс это означает: вопрос уже не в том, выходить ли на площадки, а в том, как не вести три каталога вручную. Менеджеры тратят 3–5 минут на загрузку одного товара через личный кабинет, остатки обновляются раз в день, а к утру половина позиций уходит в overselling — товар продан на WB, но на сайте всё ещё «в наличии». Штрафы за отмену на Wildberries достигают 1500 ₽ за заказ, на Ozon — падение рейтинга и снижение позиций в поиске.

Типовая интеграция запускается за несколько дней, если использовать готовые модули. Но если нужны свои правила расчёта цен и запасов, закладывайте от одной до двух недель, а для кастомного коннектора на крупном каталоге — 4–8 недель.

Мастер-система: где живёт правда об остатках и ценах

Прежде чем покупать модули, нужно ответить на один вопрос: какая система является источником правды для товаров, цен и остатков. Вариантов три.

1С — мастер. Остатки и цены рождаются в учётной программе. Штатный обмен доставляет их на сайт, а сайт транслирует на маркетплейсы. Одна точка правды: поменяли цену в 1С — она разошлась по всем каналам. Для большинства магазинов с уже работающим обменом это правильный выбор.

Битрикс — мастер. Каталог и остатки живут на сайте, модули отправляют их на площадки. На старте проще, но когда появится 1С, схему придётся перестраивать.

Внешний агрегатор. Сервисы вроде МойСклад, Sellematics или KUB-24 имеют смысл, когда каналов четыре и больше, а ассортимент большой. Минус — ещё одна подписка и ещё одно звено, которое может сломаться.

Классическая рабочая схема: 1С → Битрикс → маркетплейсы. Сайт выступает контент-хабом — фото, описания и SEO-тексты уже лежат в каталоге, — а учёт остаётся в 1С.

FBO, FBS, DBS: от модели зависит, что синхронизировать

Три аббревиатуры — это три ответа на вопрос «чей склад и чья доставка».

МодельЧей складЧто важно в интеграции
FBO (склад маркетплейса)WB / OzonКарточки и поставки. Остатки на сайте и на площадке живут отдельно — синхронизации нужно немного
FBS (свой склад)ВашОстатки почти в реальном времени, приём сборочных заданий, статусы, этикетки. Самый требовательный режим
realFBS / DBS (своя доставка)ВашВсё из FBS плюс передача трек-номеров и статусов вашей доставки

Большинство продавцов с собственным магазином работают по FBS или комбинируют: ходовые позиции отправляют на склад маркетплейса, а «длинный хвост» ассортимента продают со своего. Интеграция должна уметь обе схемы одновременно.

Три потока данных: разная частота, разная цена ошибки

Любая интеграция с маркетплейсами — это не один поток, а три независимых процесса.

Выгрузка товаров (карточки). Передача названия, описания, характеристик, фото, штрихкода и артикула. Делается раз в несколько дней или при изменении товара. На Wildberries — через метод POST /content/v2/cards/upload, на Ozon — через /v3/product/import. Главная сложность — маппинг характеристик: категория «Платье женское» на WB требует 23 обязательных поля, а на Битриксе обычно заполнено 5–10. Остальные либо генерируются по умолчанию, либо требуют ручной доработки.

Синхронизация остатков и цен. Самый частый поток: остатки и цены отправляются на площадки каждые 5–15 минут. API остатков легковесные и выдерживают высокую частоту. На Wildberries используется PUT /api/v3/stocks/{warehouseId} — до 1000 SKU за запрос, лимит 300 запросов в минуту. На Ozon — POST /v2/products/stocks — до 100 SKU за запрос, лимит 80 запросов в минуту. Для каталога в 5000 SKU полная синхронизация остатков занимает около 30 секунд.

Получение заказов. Обратный поток: заказы из WB и Ozon приходят в Битрикс как обычные заказы — с покупателем, товарами, статусом и способом доставки. На Wildberries — GET /api/v3/orders/new для FBS-заказов, опрос каждые 1–2 минуты. На Ozon — POST /v3/posting/fbs/list с фильтром по статусу awaiting_packaging. На стороне Битрикса заказы создаются через D7 API (\Bitrix\Sale\Order::create) с дополнительным полем-меткой источника (UF_SOURCE = wildberries | ozon), чтобы была корректная сегментация в CRM и отчётность по каналам.

Идемпотентность: один заказ — одна запись

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

Идемпотентность бывает двух типов: запросная (один и тот же запрос выполняется только один раз) и результирующая (даже при повторном выполнении бизнес-результат не меняется). Для заказов маркетплейсов критична именно запросная идемпотентность — через уникальный номер заказа или ключ, переданный в заголовке.

Лимиты API и очередь: почему «в лоб» не работает

У каждой площадки есть ограничения на число вызовов в секунду или минуту. В 2025 году Wildberries ужесточил лимиты: было 1000 запросов в минуту, стало 300 для большинства методов. Если интеграция написана «в лоб», без батчинга и очереди, на каталоге в 10 000 SKU вы упрётесь в лимит за минуты.

Надёжная схема строится вокруг промежуточного слоя:

  • Очередь задач. Запросы к API ставятся в очередь и выполняются с учётом лимитов. Неудачные — повторяются с паузой (экспоненциальная задержка при ошибке 429).
  • Единая модель данных. Заказы и товары всех площадок приводятся к одному формату: артикул, штрихкод, склад, статус.
  • Сопоставление товаров. Таблица соответствия артикулов площадок и номенклатуры склада, включая размеры и комплекты.

Без этого слоя интеграция работает до первой смены версии API или до второго клиента на складе.

Безопасность ключей API

Ключ API даёт доступ к заказам, ценам и финансам продавца. Хранить его нужно в защищённом хранилище, выдавать минимально необходимые права и не пересылать в мессенджерах. При уходе сотрудника или подрядчика ключ перевыпускают.

Для входящих вебхуков от маркетплейсов (если они используются) нужно проверять подпись и отвечать 200 OK до тяжёлой обработки, чтобы площадка не считала доставку неуспешной и не повторяла запрос. Сравнение токена должно быть в постоянном времени (constant-time comparison), чтобы исключить timing-атаки.

Пять ошибок, которые стоят денег

Остатки без буфера. Последний экземпляр продался одновременно на сайте и на WB — кто-то из покупателей получит отмену, а вы штраф и просевший рейтинг. На маркетплейс нужно отправлять «остаток минус N штук» и чаще обновлять остатки по ходовым позициям.

Цена без экономики канала. Розничная цена сайта — не то же самое, что цена для маркетплейса. Комиссия категории, логистика, хранение и эквайринг вместе съедают 25–40%. Для WB и Ozon нужны отдельные типы цен и правила пересчёта, а не «выгрузим как есть».

Дубли карточек. Повторная выгрузка без привязки по артикулу или штрихкоду плодит карточки-близнецы. Надёжнее проверить связку на десятке товаров, и только потом выгружать весь каталог.

Один товар — разные штрихкоды. Когда в 1С, на сайте и на маркетплейсе у товара три разных штрихкода, сборка заказов FBS превращается в квест «найди меня». Порядок в штрихкодах нужно навести до интеграции.

Резервы не учитываются. Остаток для маркетплейса должен учитывать уже собранные, но не отгруженные заказы, иначе один товар продадут дважды. Если интеграция передаёт физическое наличие без вычета резервов, overselling гарантирован.

Что в итоге

Интеграция 1С-Битрикс с Ozon и Wildberries — это не «поставить модуль». Это архитектурное решение: выбор мастер-системы, три независимых потока данных с разной частотой, очередь с учётом лимитов, идемпотентность заказов и защита от overselling через буферы остатков. Готовые модули закрывают 80% задачи, но оставшиеся 20% — маппинг категорий, ценовые правила и контроль резервов — определяют, будет интеграция приносить прибыль или генерировать штрафы.

АН
Автор

Алексей Нестеров

Веб-разработчик. Пишу о PHP, 1С-Битрикс, интеграциях и инструментах разработки.

Обо мне

Комментариев пока нет. Будьте первым.

Оставить комментарий

Комментарий появится после проверки модератором.