﻿---
title: "Синхронизация с маркетплейсами: каналы и способы обмена"
description: "Как связать учётную систему с Ozon, Wildberries, Яндекс Маркет и Авито: официальные API, сервисы-посредники и модули учётных систем, приоритет данных и типовые сбои."
---

TL;DR: маркетплейс — это внешний канал сбыта со своим каталогом, своими правилами и своим API. Связка с ним почти всегда состоит из трёх потоков: карточки и цены наружу, заказы внутрь, статусы отгрузки обратно. Ломается она не на «настройке интеграции», а на остатках, которые одновременно живут на сайте, на двух площадках и на складе.

## Назначение и границы

Страница описывает обмен с чужими торговыми площадками: что синхронизируется, какими способами и где возникают расхождения. Она не описывает собственную мультивендорную площадку (это [модель маркетплейса и агрегатора](https://wpcraft.ru/kb/practices/ecommerce/models/marketplace-aggregator.md)) и не выбирает платформу витрины (это [платформы интернет-магазина](https://wpcraft.ru/kb/practices/ecommerce/storefront/platforms.md)). Владение сущностями — в [обзоре контура](https://wpcraft.ru/kb/practices/ecommerce/integrations.md), доступность к продаже — в [заказах и остатках](https://wpcraft.ru/kb/practices/ecommerce/integrations/orders-and-inventory.md).

## Каналы и что для них критично

Перечень площадок нужен не для рейтинга, а чтобы зафиксировать, какие данные канал потребляет. Обмен проектируется под состав данных, а не под бренд.

| Канал | Роль в системе продаж | Что критично в данных |
| --- | --- | --- |
| Ozon | Универсальная площадка под широкий ассортимент | Карточки, остатки, цены, заказы, логистика, маржинальность по SKU |
| Wildberries | Массовая площадка с высокой конкуренцией | Карточки, фото и характеристики, размеры, остатки, скидки, оборачиваемость |
| Яндекс Маркет | Площадка внутри экосистемы Яндекса | Карточки и цены; полезна, если бизнес уже работает с Директом, Метрикой и Яндекс Pay |
| Авито | Локальный спрос, объявления, сложные товары и B2B | Объявления и лиды; часто нужна связка с CRM, а не со складом |

Практический вывод: Ozon и Wildberries требуют почти мгновенных остатков, Авито — обработки обращений, а не остатков. Смешивать их в один «обмен с маркетплейсами» не стоит: у каналов разная критичность задержки.

## Три способа обмена

| Способ | Что даёт | Ограничения |
| --- | --- | --- |
| Официальное API площадки | Загрузка и обновление карточек, передача остатков и цен, приём заказов и статусов доставки | Свой контракт и лимиты у каждой площадки; нужна разработка и поддержка под изменения API |
| Сервис-посредник | Готовый обмен с несколькими площадками из одного окна, шаблоны, автоматизация | Абонентская плата, зависимость от третьей стороны, задержка и состав данных ограничены сервисом |
| Модуль учётной системы | Интеграция уже внутри «МойСклад», RetailCRM и подобных решений | Работает в границах модуля; нестандартные сценарии упираются в его настройки |

### Про сервисы-посредники

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

Для маленького проекта порядок обычно такой: модуль учётной системы, пока сценарий типовой; посредник, когда площадок стало больше двух-трёх; собственный обмен через API, когда появляются нестандартные правила или расходы на посредника перестают быть оправданными.

## Что синхронизировать и в каком порядке

1. **Карточки** — названия, описания, фото, характеристики, категории. Без приведённой в порядок номенклатуры автоматизация только быстрее размножает ошибки (см. [товарные данные](https://wpcraft.ru/kb/practices/ecommerce/integrations/product-data.md)).
2. **Остатки и резервы** — по складам, с учётом буфера на задержку обмена.
3. **Цены, скидки и акции** — с правилами приоритета: акция площадки и акция сайта не должны перезаписывать друг друга.
4. **Заказы** — приём в учётную систему с идемпотентным ключом, иначе повторная выгрузка даёт дубли.
5. **Статусы и трек-номера** — сборка, отгрузка, передача перевозчику; без обратного потока площадка считает заказ неотгруженным.
6. **Оплаты, чеки и возвраты** — статусы расчётов и документы площадки.

Остатки и заказы требуют почти моментального обмена; описания, фото и SEO-поля можно обновлять реже. Разделение по критичности снижает и нагрузку, и число конфликтов.

## Схема потока

```
учётная система ──► площадки : карточки, остатки, цены, статусы отгрузки
площадки ──► учётная система : заказы, оплаты, возвраты
учётная система ──► свой сайт : то же, что и на площадки, из одного источника
```

Ключевое свойство схемы: сайт и площадки — равноправные потребители одних и тех же данных из учёта. Если витрина получает остатки из одного места, а маркетплейсы из другого, «двойная продажа» возникает не из-за площадки, а из-за двух источников.

## Где ломается

- **Остаток продан дважды.** Товар ушёл на сайте, а на площадку обновление не доехало. Лечится резервом и буфером, а не «ускорить синхронизацию».
- **Дубль заказа.** Повторная отправка без идемпотентного ключа создаёт второй заказ в учёте.
- **Цена откатилась.** Акция площадки перезаписала цену сайта, или наоборот: нужны правила приоритета на уровне владельца данных.
- **Заказ висит «в сборке».** Отгрузка прошла физически, но статус не ушёл обратно.
- **Сбой молчит.** API площадки недоступен, обмен встал, а узнали об этом из штрафа за просрочку.

Последний пункт — причина, по которой журнал обменов и ручная очередь ошибок делаются до первого боевого обмена, а не после первого инцидента (техника — в [системах и потоках данных](https://wpcraft.ru/kb/practices/ecommerce/integrations/systems-and-data-flows.md)).

## Мониторинг и сверка

- Невыгруженные заказы за период и заказы без статуса отгрузки.
- Отрицательные остатки и остатки, ушедшие в минус именно после обмена.
- Расхождения цен: площадка против учёта, по акционным позициям отдельно.
- Недоступность API и частота ретраев — как отдельная метрика, а не как запись в логе.
- Ежедневная сверка: заказы площадки против заказов в учёте, суммы — по отчётам площадки.

## Критерии проверки

- Для каждого канала выписано, что он потребляет и с какой допустимой задержкой.
- Остатки для сайта и площадок идут из одного владельца данных.
- У приёма заказов есть идемпотентный ключ и журнал обмена.
- Обратный поток статусов и трек-номеров реализован, а не подразумевается.
- Есть владелец разбора ошибок обмена и ежедневная сверка заказов.

## Связанные страницы

- [Обзор контура «Данные и интеграции»](https://wpcraft.ru/kb/practices/ecommerce/integrations.md) — матрица source of truth и допустимые задержки.
- [Учётная система и склад: три класса решений](https://wpcraft.ru/kb/practices/ecommerce/integrations/accounting-and-warehouse.md) — откуда берутся остатки и цены.
- [Системы и потоки данных: обмен с 1С, ERP и CRM](https://wpcraft.ru/kb/practices/ecommerce/integrations/systems-and-data-flows.md) — очередь, идемпотентность, журнал обмена.
- [Заказы и остатки: состояния, резерв и склад](https://wpcraft.ru/kb/practices/ecommerce/integrations/orders-and-inventory.md) — доступность к продаже и буфер.
- [Маркетплейс и агрегатор](https://wpcraft.ru/kb/practices/ecommerce/models/marketplace-aggregator.md) — собственная площадка, а не внешний канал.
- [Модели торговли](https://wpcraft.ru/kb/practices/ecommerce/models.md) — место канала в коммерческой схеме.
- [Маркетинг и лояльность магазина](https://wpcraft.ru/kb/practices/ecommerce/growth/marketing-and-loyalty.md) — фиды, промо и работа с каналами.

## Материалы и источники

- [Современная система управления торговлей: склад, маркетплейсы и собственный интернет-магазин](https://wpcraft.ru/blog/sistema-upravleniya-torgovlej-sklad-marketplejsy-i-sobstvennyj-internet-magazin) — типовые каналы, способы интеграции, состав синхронизации и риски.
- [Ozon: Seller API](https://docs.ozon.ru/api/seller/) — официальный API площадки для карточек, цен, остатков и заказов.
- [Wildberries: API для продавцов](https://dev.wildberries.ru/) — официальная документация по обмену данными с площадкой.
- [Яндекс Маркет: Partner API](https://yandex.ru/dev/market/partner-api/) — API площадки для каталога, цен, остатков и заказов.
- [Авито: API](https://developers.avito.ru/) — программный доступ к объявлениям и сообщениям.
- [«МойСклад»: JSON API](https://dev.moysklad.ru/doc/api/remap/1.2/) — пример учётной системы, которая сама выступает интегратором площадок.