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

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}.