Пока товаров десять, цены удобно менять руками в личном кабинете. Когда ассортимент вырастает до сотен артикулов, а цены нужно пересматривать регулярно, на помощь приходят официальные API маркетплейсов. Рассказываем, как устроено управление ценами через API на Wildberries и Ozon и что нужно учесть.
Зачем вообще API, если есть Excel-загрузка
Обе площадки позволяют обновлять цены через выгрузку Excel. Но у этого способа есть пределы:
- Это ручная операция. Скачать шаблон, заполнить, загрузить, проверить — каждый раз.
- Нет обратной связи в реальном времени. Узнать, что цена применилась, можно только зайдя в кабинет.
- Сложно встроить в процессы. Автоматический пересчёт цены от курса валют, остатков или цен конкурентов через Excel не сделать.
API решает все три проблемы: ваша система (или сервис вроде recards.ru) сама отправляет новые цены, получает подтверждение и работает по расписанию без участия человека.
Управление ценами через Ozon Seller API
На Ozon цены обновляются через метод обновления цен Seller API (группа методов работы с товарами, актуальные endpoint'ы смотрите в документации Ozon Seller API). Основные моменты:
- Цена передаётся по offer_id (ваш артикул) или product_id.
- Можно передать несколько ценовых полей: базовую цену (price), цену до скидки (old_price) и минимальную цену (min_price) — последняя ограничивает, насколько низко Ozon может опустить цену в своих акциях и механиках софинансирования.
- За один запрос можно обновить пакет товаров — используйте пакетную отправку вместо поштучной, чтобы не упираться в лимиты.
- Аутентификация — по связке Client-Id + Api-Key в заголовках.
Совет: всегда задавайте min_price, если участвуете в акциях Ozon, — это страховка от того, что площадка уведёт цену ниже рентабельности.
Управление ценами через WB API
Wildberries выделил цены и скидки в отдельный контур — Prices & Discounts API (хост и методы периодически обновляются, сверяйтесь с официальной документацией WB). Что важно знать:
- Цена задаётся по nmID (номенклатура WB).
- На WB вы фактически задаёте цену и размер скидки — итоговая цена для покупателя складывается из них, плюс WB может применять собственные скидки постоянного покупателя (СПП).
- Есть строгие лимиты на частоту запросов. При превышении получите HTTP 429. Массовое обновление нужно разбивать на пакеты и разносить по времени.
- Изменение цены применяется не мгновенно — площадке нужно время на обработку.
| Параметр | Ozon Seller API | WB Prices & Discounts API |
|---|---|---|
| Идентификатор товара | offer_id или product_id | nmID |
| Что задаётся | price, old_price, min_price | Цена и размер скидки; итог для покупателя формируется с учётом СПП |
| Пакетное обновление | Да, списком товаров в одном запросе | Да, но со строгими лимитами на частоту запросов |
| Скорость применения | Почти мгновенно | С задержкой на обработку площадкой |
| Аутентификация | Заголовки Client-Id и Api-Key | Токен доступа к API |
Типичные ошибки при работе с ценами через API
- Игнорирование rate limits. Отправка тысяч запросов подряд — прямой путь к ошибкам 429 и временному отказу в обслуживании. Встраивайте паузы и повторные попытки с экспоненциальной задержкой.
- Путаница в идентификаторах. У Ozon — offer_id/product_id, у WB — nmID. Если вы переносили товары между площадками, держите таблицу соответствия артикулов.
- Обновление без проверки. После отправки цены стоит периодически сверять, что на витрине: через методы получения информации о ценах или выборочно глазами.
- Забытые акции. API меняет базовую цену, но акционные механики площадки живут своей жизнью — итоговая цена для покупателя может отличаться.
Важно: ошибка 429 — это сигнал снизить частоту запросов, а не повторять их чаще. Правильная реакция — паузы между пакетами и повторные попытки с экспоненциально растущей задержкой.
Как выстроить процесс
Практичная схема для селлера на двух площадках:
- Храните эталонный прайс в одном месте (учётная система, таблица).
- Раз в N часов скрипт или сервис сравнивает эталон с текущими ценами на площадках.
- Расхождения отправляются пакетами через API каждого маркетплейса с соблюдением лимитов.
- Результаты логируются: какой SKU, какая цена, успех или ошибка.
В recards.ru этот контур уже собран: вы загружаете каталог, задаёте цены, а синхронизация с Ozon и WB происходит автоматически с учётом всех лимитов площадок.
Итог
Управление ценами через API — это переход от «ручного труда» к «настроил и контролируешь». Начните с понимания идентификаторов и лимитов каждой площадки, обязательно добавьте логирование и контроль применения — и ценовая рутина перестанет съедать ваше время.