Каталог, цены и остатки едут из кабинета продавца в вашу систему по расписанию, а не руками. Интерфейс читает свою базу, а не чужой API, поэтому пауза на стороне площадки не роняет страницы. Основной объём работы прошёл через интеграцию с Wildberries API и обмен с Ozon API: товары, цены, статистика продаж.
Где ломается обмен с API маркетплейса
Документация описывает методы, но не описывает поведение площадки под нагрузкой. Ниже четыре места, на которых интеграция с API маркетплейса спотыкается чаще всего.
Лимит считается на кабинет
Бюджет запросов висит на кабинете продавца, а не на приложении. Его расходуют все сервисы, которые владелец уже подключил, поэтому новый обмен надо вписывать в общий бюджет.
Паузу надо читать, а не гадать
Площадка называет срок паузы своим заголовком, а привычного стандартного заголовка в ответе может не быть. Если его не читать, повторы уходят раньше времени и лимит выгорает по кругу.
Тяжёлые отчёты обрезаются
Большая выгрузка отдаёт не всё, а первые строки до предела. Поэтому статистику забирают по одному дню и складывают историю у себя, иначе длинный период теряется молча.
Отбор идёт не по той дате
Фильтр по дате изменения вместо даты заказа тихо ломает порядок каталога и границы отчёта. Ошибка не падает, просто цифры перестают сходиться.
Что входит в работу
Набор собирается под задачу, но каркас автоматизации селлера маркетплейса одинаковый: своя база как источник правды и обмен с площадкой по расписанию.
Синхронизация каталога
Товары, характеристики, фотографии и остатки приезжают из кабинета продавца по расписанию. Витрина и отчёты берут данные из своей базы, чужой API остаётся источником обновлений.
Склейка расцветок в модель
Карточка приходит на каждый цвет отдельно. В модель они собираются по отдельному полю, иначе каталог рассыпается на сотни почти одинаковых позиций.
Выгрузка товаров и цен
Цена сайта считается правилом от цены продавца. Витринная цена площадки ниже на скидку постоянного покупателя, которой в API нет, поэтому у правила есть база и её видно в админке.
Замки полей
Ручные правки сотрудника закрываются замком на конкретном поле. Ночной прогон обходит закрытые поля стороной и не затирает то, что человек поправил осознанно.
Статистика продаж
Заказы, продажи и реклама забираются по одному дню и складываются в свою историю. Дальше отчёты строятся по своей базе, без похода в чужой API на каждый экран.
Расписание и наблюдение
Обмен идёт задачами по расписанию, с очередью, повторами и журналом. Видно, когда прошёл последний успешный обмен и что именно не доехало.
Как идёт работа
- Разбор кабинета и данных. Смотрю, какие методы уже подключены, кто ещё ест лимит, какие поля нужны на выходе. Этап заканчивается описанием объёма работ и ценой.
- Своя схема и первая загрузка. Сначала схема под товар, цену и остаток, потом первый полный импорт каталога. Данные проверяются на живом кабинете, а не на примерах из документации.
- Расписание и правила. Настраиваются частота, приоритеты и правила цены. Здесь же появляются замки полей, чтобы ручная работа не пропадала после ночного прогона.
- Передача. Сервер, доступы и код на вас. README по каждому обмену: какие методы дёргаются, как считается пауза, что делать, когда площадка меняет формат ответа.
Как это выглядит в работе
По каждой системе есть подробный разбор и кликабельное демо на вымышленных данных. Имена заказчиков закрыты, цифры настоящие.
Частые вопросы
Сколько стоит интеграция с API маркетплейса
Цена зависит от того, сколько методов нужно дёргать и что система делает с данными дальше. Разбор кабинета продавца идёт отдельным коротким этапом и заканчивается описанием объёма работ с ценой. После него можно спокойно отказаться и уйти с этим документом к любому подрядчику.
Что будет с сайтом, если API площадки недоступен
Страницы останутся на месте. Интерфейс читает свою базу, а обмен с площадкой идёт фоновой задачей по расписанию. Если площадка молчит, посетитель видит последние успешно полученные данные, а задача повторится в следующий заход.
Почему цена на сайте отличается от цены на витрине площадки
Витринная цена площадки обычно ниже цены продавца на скидку постоянного покупателя, а этой скидки в API нет. Поэтому цена сайта считается правилом от цены продавца, и у правила есть база, которую можно менять. Так витрина остаётся предсказуемой и не пляшет вслед за чужими акциями.
У нас уже подключены другие сервисы, хватит ли лимита запросов
Лимит считается на весь кабинет продавца, а не на отдельное приложение. Все подключённые сервисы владельца тратят один и тот же бюджет запросов. Поэтому обмен идёт по расписанию, тяжёлые выгрузки разносятся по времени, а срок паузы берётся из заголовка ответа площадки, а не угадывается.
Сохранятся ли правки, которые сотрудник сделал руками
Да, для этого есть замки полей. Поле под замком ночной прогон не трогает, остальные обновляются из кабинета продавца. Без замков любая ручная правка живёт до ближайшего обмена.
Работаете только с Wildberries и Ozon
Чаще всего с ними, потому что через них прошёл основной объём задач. Механика у площадок похожая: авторизация, общий лимит на кабинет, отчёты по дням, своя логика карточек и цен. Своя схема данных и расписание обмена переносятся на другой API без переписывания системы.
Если у вас похожая история с обменом, напишите пару строк о том, что сейчас переносится руками: LinkedIn или Telegram. В ответ придут вопросы по делу, а не презентация.