Управление акциями
API Маркета позволяет получать информацию об акциях Маркета и принимать в них участие.
Добавить товары в акцию
Вы уже знаете идентификаторы списка акций и товаров
Пропустите шаги их получения.
- Получите список акций Маркета с помощью запроса POST businesses/{businessId}/promos.
- Передайте идентификатор акции в запросе POST businesses/{businessId}/promos/offers, чтобы узнать, какие товары могут участвовать в акции.
- Выполните запрос POST businesses/{businessId}/promos/offers/update, где передайте идентификатор акции и товары, которые необходимо добавить.
Изменить цену товаров, которые уже добавлены в акцию
Вы уже знаете идентификаторы списка акций и товаров
Пропустите шаги их получения.
- Получите список акций Маркета с помощью запроса POST businesses/{businessId}/promos.
- Передайте идентификатор акции и параметр
statusType
со значениемMANUALLY_ADDED
в запросе POST businesses/{businessId}/promos/offers, чтобы узнать, какие товары добавлены в акцию. - Передайте SKU товаров и их новые цены — запрос POST businesses/{businessId}/promos/offers/update.
Удалить товары из акции
Вы уже знаете идентификаторы списка акций и товаров
Пропустите шаги их получения.
-
Получите список акций Маркета с помощью запроса POST businesses/{businessId}/promos.
-
Передайте идентификатор акции и параметр
statusType
со значениемMANUALLY_ADDED
в запросе POST businesses/{businessId}/promos/offers, чтобы узнать, какие товары добавлены в акцию. -
Выполните запрос POST businesses/{businessId}/promos/offers/delete, чтобы удалить из акции:
- все товары — параметр
deleteAllOffers
со значениемtrue
; - некоторые товары — параметр
offerIds
.
- все товары — параметр
Посмотреть результаты участия в акции
Вы можете скачать отчет со всеми заказами, в которых есть проданные по акции товары.
Вы уже знаете идентификаторы списка акций и товаров
Пропустите шаги их получения.
-
Получите список ваших акций с помощью запроса POST businesses/{businessId}/promos, где в параметре
participation
передайте значение:-
PARTICIPATING_NOW
— для текущих акций; -
PARTICIPATED
— для завершенных акции.
-
-
Передайте идентификатор акции в запросе POST reports/united-orders/generate, чтобы запустить генерацию отчета по заказам.
Чтобы все товары, которые были проданы по акции, точно попали в отчет
При передаче параметра
dateTo
в запросе POST reports/united-orders/generate укажите не день окончания акции, а следующий. -
Дождитесь завершения генерации отчета и получите ссылку для скачивания — запрос GET reports/info/{reportId}.