Интеграция с Wildberries и Ozon: API без хаоса

Маркетплейсы дают поток заказов, но требуют дисциплины в данных. Если товары, цены и остатки расходятся, продажи превращаются в отмены, штрафы и ручную сверку.

Разбираем, как построить интеграцию с Wildberries и Ozon через API так, чтобы она выдерживала рост и не зависела от одного менеджера.

Зачем нужна интеграция

Ручная загрузка карточек и остатков работает до определённого объёма. Дальше ошибки накапливаются быстрее, чем команда успевает их исправлять.

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

• Единый каталог.
• Актуальные цены.
• Остатки по складам.
• Заказы и статусы.
• Возвраты.
• Комиссии и отчёты.

Что синхронизировать

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

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

• Карточки и контент.
• Цены и скидки.
• Остатки.
• Заказы.
• Возвраты.
• Отчёты и выплаты.

Товары и карточки

Карточка на маркетплейсе имеет свои правила: категории, атрибуты, фото и описание. Автоматическая загрузка должна учитывать эти требования.

Ошибки в карточке могут привести к отклонению или низкому ранжированию. Поэтому валидация должна быть до отправки, а не после.

• Категории.
• Атрибуты.
• Изображения.
• Описание.
• Габариты.
• Сертификаты.

Цены и скидки

Цена на маркетплейсе может отличаться от сайта из-за комиссии и акций. Это нужно учитывать в правилах, а не править вручную.

Если цена обновляется с задержкой, вы можете продать товар ниже себестоимости или потерять Buy Box. Нужен мониторинг и очередь обновлений.

• Базовая цена.
• Комиссия.
• Акции.
• Скидки.
• Округление.
• Мониторинг.

Остатки

Остатки — самая чувствительная часть. Если на сайте и маркетплейсе разные данные, появляются отмены и штрафы.

Синхронизация должна учитывать резервы, склады и заказы в работе. Иначе товар, который уже продан, снова окажется доступным.

• Склады.
• Резервы.
• Заказы в работе.
• Возвраты.
• Лимиты.
• Частота обмена.

Заказы

Заказы должны попадать в учётную систему с номером, составом и статусом. Потерянный заказ — это отмена и штраф.

Нужны повторные попытки и журнал. Если API временно недоступен, заказ не должен исчезнуть.

• Номер.
• Состав.
• Статус.
• Склад.
• Доставка.
• Повторные попытки.

Возвраты

Возвраты влияют на остатки, выручку и документы. Их нужно обрабатывать так же серьёзно, как заказы.

Если возврат не попал в учёт, товар может быть продан дважды или остаться в неверном статусе.

• Причина.
• Статус.
• Склад.
• Остатки.
• Документы.
• Сверка.

Комиссии и выплаты

Маркетплейсы удерживают комиссию, логистику и другие услуги. Эти суммы должны попадать в отчёты и сверку.

Без сверки невозможно понять реальную маржинальность. Выручка может расти, а прибыль — падать.

• Комиссия.
• Логистика.
• Хранение.
• Реклама.
• Штрафы.
• Выплаты.

Очереди и лимиты API

API маркетплейсов имеет лимиты. Если отправлять всё сразу, запросы начнут отклоняться.

Нужна очередь с приоритетами: сначала остатки и заказы, затем карточки и отчёты. Это снижает риск блокировок.

• Лимиты.
• Очередь.
• Приоритеты.
• Повторные попытки.
• Таймауты.
• Логи.

Ошибки и мониторинг

Ошибки API нужно логировать и показывать ответственным. Молчаливое падение обмена — худший сценарий.

Настройте алерты на рост ошибок, задержки и расхождения. Чем раньше вы заметите проблему, тем меньше заказов потеряете.

• Ошибки.
• Задержки.
• Расхождения.
• Очередь.
• Логи.
• Алерты.

Тестовый контур

Проверяйте интеграцию на тестовых данных и реальных сценариях. Не все методы API можно безопасно тестировать на продакшене.

Сверьте товары, цены, остатки и заказы. Затем проведите пилот на ограниченной категории.

Чек-лист

Итог

Интеграция с маркетплейсами — это не разовая загрузка, а постоянный процесс. Если данные и очередь под контролем, маркетплейсы приносят прибыль, а не хаос.

Как выбрать архитектуру

Не стоит делать один монолитный модуль, который знает всё про оба маркетплейса. Лучше выделить общий слой данных и отдельные адаптеры под Wildberries и Ozon, чтобы изменения одного API не ломали второй.

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

Как работать с ошибками API

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

Заведите журнал с телом запроса и ответом, но не храните там лишние персональные данные. По журналу должно быть понятно, что именно не приняла площадка и что с этим делать.

Как считать маржу

Выручка на маркетплейсе не равна прибыли. Нужно учитывать комиссию, логистику, хранение, рекламу, возвраты и штрафы, иначе рост продаж может скрывать убытки.

Сверяйте отчёты площадки с учётной системой и банковскими поступлениями. Расхождения по выплатам — сигнал, что часть расходов не учитывается.

Как запускать пилот

Начните с одной категории и ограниченного склада. Так вы увидите реальные лимиты, ошибки карточек и поведение остатков без риска для всего каталога.

После пилота сравните количество отмен, штрафов и расхождений. Если показатели приемлемы, расширяйте ассортимент постепенно, а не включайте всё сразу.

Что делать при росте

С ростом объёма запросы начинают упираться в лимиты. Очередь должна иметь приоритеты: сначала заказы и остатки, затем цены, карточки и отчёты.

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

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

API маркетплейсов меняются. Нужен регламент проверки после изменений и мониторинг ошибок, иначе интеграция тихо перестанет работать.

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

Как выбрать приоритеты обмена

В первую очередь синхронизируйте заказы и остатки. Ошибка здесь приводит к отменам и штрафам, а задержка карточки — только к потере показов.

Цены и акции обновляйте следом. Карточки и отчёты можно обновлять реже, если API не справляется с нагрузкой.

Как тестировать лимиты

Проверьте, сколько запросов выдерживает интеграция при пиковой нагрузке. Лучше узнать это на тесте, чем в день распродажи.

Смоделируйте задержки и ошибки API. Если интеграция не умеет ждать и повторять, она развалится при первом сбое.

Как документировать интеграцию

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

Добавьте схему очередей и примеры ответов API. Это поможет быстрее разбирать инциденты и не искать информацию в переписках. Документация должна обновляться вместе с кодом. Иначе она быстро станет бесполезной и не поможет при разборе инцидента. Это важно для поддержки. Да, это так. Это важно для бизнеса. Точно. Да. Да. Да.