Интеграция с маркетплейсами: каталог, заказы, возвраты и выплаты

Интеграция с маркетплейсами (Ozon, Wildberries и др.) — это не один «выгрузить товары», а набор потоков: каталог, цены, остатки, заказы, статусы, возвраты и финансы.

Какие потоки важно настроить

• Каталог: карточки товаров, вариации, характеристики, фото, маркировка.
• Цены: базовая цена, акции, минимальная цена, НДС, правила округления.
• Остатки: единый источник, резервирование, «минусовые» остатки.
• Заказы: импорт заказов, печать этикеток, сборка, трек‑номер.
• Возвраты: причины, состояние товара, повторная продажа или списание.
• Финансы: комиссии, штрафы, удержания, сверка выплат.

Частые ошибки

• Склад и маркетплейс «живут отдельно» — появляются отмены из‑за отсутствия товара.
• Нет идемпотентности — один и тот же заказ создаётся дважды при повторной доставке события.
• Непрозрачная цена — скидки на витрине не сходятся с отчётами маркетплейса.

Как сделать надёжно

Разделите интеграцию на независимые модули (каталог/заказы/остатки), ведите журнал событий, ставьте ретраи и алерты. Начинайте с самого дорогого по ошибкам потока — обычно это остатки и заказы.