Массовое участие в акции требует контроля конкретного списка товаров. Решение «выйти из акции» для одного SKU и отключение всего ассортимента — разные операции. В API Яндекс Маркета они задаются отдельными параметрами, поэтому до отправки запроса полезно показать ответственному итоговый перечень изменений.

Сначала определить акцию и её состав

Начните с получения списка акций методом promos. По идентификатору нужной акции запросите promos/offers: он позволяет увидеть товары, которые могут в ней участвовать. Не подменяйте этот список своим старым экспортом каталога. Допустимый ассортимент акции и весь ассортимент магазина решают разные задачи.

Для работы с уже вручную добавленными товарами инструкция предлагает statusType=MANUALLY_ADDED. Такой запрос нужен и перед изменением акционной цены, и перед удалением позиций. Сохраняйте идентификатор акции рядом со списком SKU: одинаковая модель товара может фигурировать в нескольких подготовленных сценариях, а действие должно относиться к выбранной акции.

Изменять цену проверяемым набором

Добавление товаров и изменение цен выполняется методом promos/offers/update. Для изменения передаются SKU и новые цены. Перед массовой операцией сравните исходный и целевой списки: какие позиции добавляются, какие сохраняются и у каких меняется цена. Это редакционная процедура контроля, а не дополнительный метод Маркета.

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

Удалять выбранные SKU без лишнего охвата

Метод promos/offers/delete поддерживает два разных режима: offerIds для отдельных товаров и deleteAllOffers=true для всех. В пользовательском интерфейсе интеграции эти действия стоит разделить по формулировке и показу затронутого списка. Кнопка «убрать выбранное» не должна отправлять удаление всего состава.

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

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