Управление акциями

API Маркета позволяет получать информацию об акциях Маркета и принимать в них участие.

Добавить товары в акцию

1. Получите список акций Маркета с помощью запроса POST businesses/{businessId}/promos.
2. Передайте идентификатор акции в запросе POST businesses/{businessId}/promos/offers, чтобы узнать, какие товары могут участвовать в акции.
3. Выполните запрос POST businesses/{businessId}/promos/offers/update, где передайте идентификатор акции и товары, которые необходимо добавить.

Изменить цену товаров, которые уже добавлены в акцию

1. Получите список акций Маркета с помощью запроса POST businesses/{businessId}/promos.
2. Передайте идентификатор акции и параметр statusType со значением MANUALLY_ADDED в запросе POST businesses/{businessId}/promos/offers, чтобы узнать, какие товары добавлены в акцию.
3. Передайте SKU товаров и их новые цены — запрос POST businesses/{businessId}/promos/offers/update.

Удалить товары из акции

1. Получите список акций Маркета с помощью запроса POST businesses/{businessId}/promos.

2. Передайте идентификатор акции и параметр statusType со значением MANUALLY_ADDED в запросе POST businesses/{businessId}/promos/offers, чтобы узнать, какие товары добавлены в акцию.

3. Выполните запрос POST businesses/{businessId}/promos/offers/delete, чтобы удалить из акции:

   • все товары — параметр deleteAllOffers со значением true;
   • некоторые товары — параметр offerIds.

Посмотреть результаты участия в акции

Вы можете скачать отчет со всеми заказами, в которых есть проданные по акции товары.

1. Получите список ваших акций с помощью запроса POST businesses/{businessId}/promos, где в параметре participation передайте значение:

   • PARTICIPATING_NOW — для текущих акций;

   • PARTICIPATED — для завершенных акции.

2. Передайте идентификатор акции в запросе POST reports/united-orders/generate, чтобы запустить генерацию отчета по заказам.

   Совет

   При передаче параметра dateTo в запросе POST reports/united-orders/generate укажите не день окончания акции, а следующий. Так все товары, которые были проданы по акции, точно попадут в отчет.

3. Дождитесь завершения генерации отчета и получите ссылку для скачивания — запрос GET reports/info/{reportId}.