Синхронизация с маркетплейсами: каналы и способы обмена
TL;DR: маркетплейс — это внешний канал сбыта со своим каталогом, своими правилами и своим API. Связка с ним почти всегда состоит из трёх потоков: карточки и цены наружу, заказы внутрь, статусы отгрузки обратно. Ломается она не на «настройке интеграции», а на остатках, которые одновременно живут на сайте, на двух площадках и на складе.
Назначение и границы
Заголовок раздела «Назначение и границы»Страница описывает обмен с чужими торговыми площадками: что синхронизируется, какими способами и где возникают расхождения. Она не описывает собственную мультивендорную площадку (это модель маркетплейса и агрегатора) и не выбирает платформу витрины (это платформы интернет-магазина). Владение сущностями — в обзоре контура, доступность к продаже — в заказах и остатках.
Каналы и что для них критично
Заголовок раздела «Каналы и что для них критично»Перечень площадок нужен не для рейтинга, а чтобы зафиксировать, какие данные канал потребляет. Обмен проектируется под состав данных, а не под бренд.
| Канал | Роль в системе продаж | Что критично в данных |
|---|---|---|
| Ozon | Универсальная площадка под широкий ассортимент | Карточки, остатки, цены, заказы, логистика, маржинальность по SKU |
| Wildberries | Массовая площадка с высокой конкуренцией | Карточки, фото и характеристики, размеры, остатки, скидки, оборачиваемость |
| Яндекс Маркет | Площадка внутри экосистемы Яндекса | Карточки и цены; полезна, если бизнес уже работает с Директом, Метрикой и Яндекс Pay |
| Авито | Локальный спрос, объявления, сложные товары и B2B | Объявления и лиды; часто нужна связка с CRM, а не со складом |
Практический вывод: Ozon и Wildberries требуют почти мгновенных остатков, Авито — обработки обращений, а не остатков. Смешивать их в один «обмен с маркетплейсами» не стоит: у каналов разная критичность задержки.
Три способа обмена
Заголовок раздела «Три способа обмена»| Способ | Что даёт | Ограничения |
|---|---|---|
| Официальное API площадки | Загрузка и обновление карточек, передача остатков и цен, приём заказов и статусов доставки | Свой контракт и лимиты у каждой площадки; нужна разработка и поддержка под изменения API |
| Сервис-посредник | Готовый обмен с несколькими площадками из одного окна, шаблоны, автоматизация | Абонентская плата, зависимость от третьей стороны, задержка и состав данных ограничены сервисом |
| Модуль учётной системы | Интеграция уже внутри «МойСклад», RetailCRM и подобных решений | Работает в границах модуля; нестандартные сценарии упираются в его настройки |
Про сервисы-посредники
Заголовок раздела «Про сервисы-посредники»Посредник экономит месяцы разработки, но добавляет точку отказа между учётом и площадкой. При выборе проверяется не список площадок на лендинге, а: передаёт ли сервис заказы обратно в учёт, обновляет ли остатки по событию или по расписанию, что делает при сбое площадки и есть ли журнал обменов. В подборках такие сервисы часто смешаны с аналитикой и службами доставки — это разные продукты, и аналитический сервис заказы в учёт не вернёт.
Для маленького проекта порядок обычно такой: модуль учётной системы, пока сценарий типовой; посредник, когда площадок стало больше двух-трёх; собственный обмен через API, когда появляются нестандартные правила или расходы на посредника перестают быть оправданными.
Что синхронизировать и в каком порядке
Заголовок раздела «Что синхронизировать и в каком порядке»- Карточки — названия, описания, фото, характеристики, категории. Без приведённой в порядок номенклатуры автоматизация только быстрее размножает ошибки (см. товарные данные).
- Остатки и резервы — по складам, с учётом буфера на задержку обмена.
- Цены, скидки и акции — с правилами приоритета: акция площадки и акция сайта не должны перезаписывать друг друга.
- Заказы — приём в учётную систему с идемпотентным ключом, иначе повторная выгрузка даёт дубли.
- Статусы и трек-номера — сборка, отгрузка, передача перевозчику; без обратного потока площадка считает заказ неотгруженным.
- Оплаты, чеки и возвраты — статусы расчётов и документы площадки.
Остатки и заказы требуют почти моментального обмена; описания, фото и SEO-поля можно обновлять реже. Разделение по критичности снижает и нагрузку, и число конфликтов.
Схема потока
Заголовок раздела «Схема потока»учётная система ──► площадки : карточки, остатки, цены, статусы отгрузкиплощадки ──► учётная система : заказы, оплаты, возвратыучётная система ──► свой сайт : то же, что и на площадки, из одного источникаКлючевое свойство схемы: сайт и площадки — равноправные потребители одних и тех же данных из учёта. Если витрина получает остатки из одного места, а маркетплейсы из другого, «двойная продажа» возникает не из-за площадки, а из-за двух источников.
Где ломается
Заголовок раздела «Где ломается»- Остаток продан дважды. Товар ушёл на сайте, а на площадку обновление не доехало. Лечится резервом и буфером, а не «ускорить синхронизацию».
- Дубль заказа. Повторная отправка без идемпотентного ключа создаёт второй заказ в учёте.
- Цена откатилась. Акция площадки перезаписала цену сайта, или наоборот: нужны правила приоритета на уровне владельца данных.
- Заказ висит «в сборке». Отгрузка прошла физически, но статус не ушёл обратно.
- Сбой молчит. API площадки недоступен, обмен встал, а узнали об этом из штрафа за просрочку.
Последний пункт — причина, по которой журнал обменов и ручная очередь ошибок делаются до первого боевого обмена, а не после первого инцидента (техника — в системах и потоках данных).
Мониторинг и сверка
Заголовок раздела «Мониторинг и сверка»- Невыгруженные заказы за период и заказы без статуса отгрузки.
- Отрицательные остатки и остатки, ушедшие в минус именно после обмена.
- Расхождения цен: площадка против учёта, по акционным позициям отдельно.
- Недоступность API и частота ретраев — как отдельная метрика, а не как запись в логе.
- Ежедневная сверка: заказы площадки против заказов в учёте, суммы — по отчётам площадки.
Критерии проверки
Заголовок раздела «Критерии проверки»- Для каждого канала выписано, что он потребляет и с какой допустимой задержкой.
- Остатки для сайта и площадок идут из одного владельца данных.
- У приёма заказов есть идемпотентный ключ и журнал обмена.
- Обратный поток статусов и трек-номеров реализован, а не подразумевается.
- Есть владелец разбора ошибок обмена и ежедневная сверка заказов.
Связанные страницы
Заголовок раздела «Связанные страницы»- Обзор контура «Данные и интеграции» — матрица source of truth и допустимые задержки.
- Учётная система и склад: три класса решений — откуда берутся остатки и цены.
- Системы и потоки данных: обмен с 1С, ERP и CRM — очередь, идемпотентность, журнал обмена.
- Заказы и остатки: состояния, резерв и склад — доступность к продаже и буфер.
- Маркетплейс и агрегатор — собственная площадка, а не внешний канал.
- Модели торговли — место канала в коммерческой схеме.
- Маркетинг и лояльность магазина — фиды, промо и работа с каналами.
Материалы и источники
Заголовок раздела «Материалы и источники»- Современная система управления торговлей: склад, маркетплейсы и собственный интернет-магазин — типовые каналы, способы интеграции, состав синхронизации и риски.
- Ozon: Seller API — официальный API площадки для карточек, цен, остатков и заказов.
- Wildberries: API для продавцов — официальная документация по обмену данными с площадкой.
- Яндекс Маркет: Partner API — API площадки для каталога, цен, остатков и заказов.
- Авито: API — программный доступ к объявлениям и сообщениям.
- «МойСклад»: JSON API — пример учётной системы, которая сама выступает интегратором площадок.