Интеграция с API Wildberries и Ozon: остатки, цены, отзывы

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

Чем плох ручной режим

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

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

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

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

Каждая из этих проблем решается одним и тем же способом — обменом данными между вашей системой и площадкой без участия человека.

Что умеет API маркетплейсов

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

• Остатки и склады. Передача текущих остатков по складам, чтобы витрина знала реальную доступность товара.
• Цены и скидки. Массовое обновление цен, работа со скидками и акционными механиками.
• Карточки и контент. Создание и обновление товаров, характеристики, описания, медиафайлы.
• Заказы и отгрузки. Получение новых заказов, статусы, сборочные задания, документы на отгрузку.
• Отзывы и вопросы. Выгрузка новых обращений покупателей и отправка ответов.
• Финансы. Отчёты о реализации, комиссии, логистика, штрафы и удержания.
• Аналитика продаж. Показы, воронка, динамика по позициям — база для того, чтобы аналитика Wildberries собиралась автоматически, а не руками.

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

Как связать со своей системой

Есть три рабочих пути.

Архитектурно схема во всех случаях одна: ваша система → прослойка → API площадок. Прослойка знает про ваш справочник товаров, сопоставляет его с идентификаторами площадок, ставит задачи в очередь, отправляет их с учётом лимитов и разбирает ответы.

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

Пределы и подводные камни

Честный раздел, который обычно опускают.

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

API меняется. Методы устаревают, появляются новые версии, меняются форматы. Интеграция — не разовая работа, а система, которую нужно поддерживать. Заложите это в бюджет сразу.

Расхождения данных. То, что показывает кабинет, и то, что отдаёт API, иногда не совпадает — из-за разного времени пересчёта или разной методики. Это нормально, но при сверке цифр вызывает панику.

Задержка на витрине. Между принятым обновлением и изменением на странице товара проходит время. Мгновенного эффекта не ждите.

Не всё доступно через API. Часть функций кабинета наружу не вынесена, и какие-то операции всё равно останутся ручными.

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

Частые вопросы

Нужен ли программист или хватит готового сервиса? Если процессы стандартные, начните с готового решения — это дешевле и быстрее. Программист нужен, когда логика ценообразования или резервирования у вас своя.

Можно ли связать с 1С? Да, это самый частый сценарий: есть типовые модули, есть вариант обмена через промежуточный сервис, если конфигурация сильно доработана.

Как часто обновлять остатки? Достаточно регулярного обмена с небольшим интервалом плюс внеочередная отправка при значимом изменении. Чаще лимиты и не позволят.

Что если торгую на трёх площадках? Тогда собственная прослойка окупается быстрее всего: один справочник товаров и один источник правды об остатках вместо трёх параллельных реальностей.

Коротко о главном

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

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