---
metadata:
- name: generator
content: Diplodoc Platform v5.52.0
alternate:
- https://yandex.com/dev/market/partner-api/doc/en/step-by-step/promos.md
- https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/promos.md
- https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/promos.md
- href: zh/step-by-step/promos.md
type: text/markdown
title: Markdown version
- href: ../llms.txt
type: text/markdown
title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/zh/llms.txt
# 存货管理
Yandex Market API 允许您接收有关市场促销活动的信息并参与其中。
## 将产品添加到促销中 {#add-goods}
{% note tip "您已经知道股票和产品列表的Id。" %}
跳过步骤来获得它们。
{% endnote %}
```mermaid
%%{
init: {
'theme': 'base',
'themeVariables': {
'primaryColor': '#FDF3E8',
'primaryTextColor': '#000000',
'primaryBorderColor': '#BA9C80',
'lineColor': '#BA9C80',
'secondaryColor': '#94E1C4',
'tertiaryColor': '#F84E57',
'noteBkgColor': '#FED58D'
}
}
}%%
sequenceDiagram
participant Merchant as 您的店铺
participant Market as Yandex Market
rect rgb(251, 243, 232)
note right of Merchant: 获取促销活动列表
Merchant ->>+ Market: 商家ID
POST v2/businesses/{businessId}/promos
Market -->> Merchant: OK: 当前和未来的Market促销活动。
end
rect rgb(251, 243, 232)
note right of Merchant: 获取可参与促销活动的商品列表
Merchant ->>+ Market: 促销活动ID
POST v2/businesses/{businessId}/promos/offers
Market -->> Merchant: OK: 可参与促销活动的商品。
end
rect rgb(251, 243, 232)
note right of Merchant: 将商品添加到促销活动
Merchant ->>+ Market: 促销活动ID和需要添加的商品
POST v2/businesses/{businessId}/promos/offers/update
Market ->> Market: 将商品
添加到促销活动。
Market -->>- Merchant: OK: 商品添加至促销活动的结果。
end
```
1. 获取Yandex的列表。使用请求的市场份额 [POST v2/businesses/{businessId}/promos](https://yandex.com/dev/market/partner-api/doc/zh/reference/promos/getPromos.md).
2. 在请求中传递股票ID [POST v2/businesses/{businessId}/promos/offers](https://yandex.com/dev/market/partner-api/doc/zh/reference/promos/getPromoOffers.md) 了解哪些产品可以参加促销活动。
3. 提出要求 [POST v2/businesses/{businessId}/promos/offers/update](https://yandex.com/dev/market/partner-api/doc/zh/reference/promos/updatePromoOffers.md)，凡传递促销的ID和需要添加的产品。
## 更改已添加到促销中的产品的价格 {#change-price}
{% note tip "您已经知道股票和产品列表的Id。" %}
跳过步骤来获得它们。
{% endnote %}
```mermaid
%%{
init: {
'theme': 'base',
'themeVariables': {
'primaryColor': '#FDF3E8',
'primaryTextColor': '#000000',
'primaryBorderColor': '#BA9C80',
'lineColor': '#BA9C80',
'secondaryColor': '#94E1C4',
'tertiaryColor': '#F84E57',
'noteBkgColor': '#FED58D'
}
}
}%%
sequenceDiagram
participant Merchant as 您的店铺
participant Market as Yandex Market
rect rgb(251, 243, 232)
note right of Merchant: 获取促销活动列表
Merchant ->>+ Market: 商家ID
POST v2/businesses/{businessId}/promos
Market -->> Merchant: OK: 当前和未来的Market促销活动。
end
rect rgb(251, 243, 232)
note right of Merchant: 获取已加入促销活动的商品列表
Merchant ->>+ Market: 促销活动ID
和参数statusType值为MANUALLY_ADDED
POST v2/businesses/{businessId}/promos/offers
Market -->> Merchant: OK: 已加入促销活动的商品。
end
rect rgb(251, 243, 232)
note right of Merchant: 修改促销活动中商品的价格
Merchant ->>+ Market: 商品SKU及其新价格
POST v2/businesses/{businessId}/promos/offers/update
Market ->> Market: 更新促销活动中
商品的价格。
Market -->>- Merchant: OK: 价格更新结果。
end
```
1. 获取Yandex的列表。使用请求的市场份额 [POST v2/businesses/{businessId}/promos](https://yandex.com/dev/market/partner-api/doc/zh/reference/promos/getPromos.md).
2. 传递促销ID和参数 `statusType` 与值 `MANUALLY_ADDED` 在请求 [POST v2/businesses/{businessId}/promos/offers](https://yandex.com/dev/market/partner-api/doc/zh/reference/promos/getPromoOffers.md) 了解哪些产品已被添加到促销中。
3. 传下去 SKU 产品及其新价格 — 请求 [POST v2/businesses/{businessId}/promos/offers/update](https://yandex.com/dev/market/partner-api/doc/zh/reference/promos/updatePromoOffers.md).
## 从促销中删除产品 {#delete-goods}
{% note tip "您已经知道股票和产品列表的Id。" %}
跳过步骤来获得它们。
{% endnote %}
```mermaid
%%{
init: {
'theme': 'base',
'themeVariables': {
'primaryColor': '#FDF3E8',
'primaryTextColor': '#000000',
'primaryBorderColor': '#BA9C80',
'lineColor': '#BA9C80',
'secondaryColor': '#94E1C4',
'tertiaryColor': '#F84E57',
'noteBkgColor': '#FED58D'
}
}
}%%
sequenceDiagram
participant Merchant as 您的店铺
participant Market as Yandex Market
rect rgb(251, 243, 232)
note right of Merchant: 获取促销活动列表
Merchant ->>+ Market: 商家ID
POST v2/businesses/{businessId}/promos
Market -->> Merchant: OK: 当前和未来的Market促销活动。
end
rect rgb(251, 243, 232)
note right of Merchant: 获取已添加到促销活动的商品列表
Merchant ->>+ Market: 促销活动ID
和参数statusType值为MANUALLY_ADDED
POST v2/businesses/{businessId}/promos/offers
Market -->> Merchant: OK: 已添加到促销活动的商品。
end
rect rgb(251, 243, 232)
note right of Merchant: 从促销活动中删除商品
Merchant ->>+ Market: 参数deleteAllOffers值为true
或商品SKU在参数offerIds中
POST v2/businesses/{businessId}/promos/offers/delete
Market ->> Market: 删除
促销活动中的商品。
Market -->>- Merchant: OK: 商品删除结果。
end
```
1. 获取Yandex的列表。使用请求的市场份额 [POST v2/businesses/{businessId}/promos](https://yandex.com/dev/market/partner-api/doc/zh/reference/promos/getPromos.md).
2. 传递促销ID和参数 `statusType` 与值 `MANUALLY_ADDED` 在请求 [POST v2/businesses/{businessId}/promos/offers](https://yandex.com/dev/market/partner-api/doc/zh/reference/promos/getPromoOffers.md) 了解哪些产品已被添加到促销中。
3. 提出要求 [POST v2/businesses/{businessId}/promos/offers/delete](https://yandex.com/dev/market/partner-api/doc/zh/reference/promos/deletePromoOffers.md) 从促销活动中删除:
* 所有产品 — 参数 `deleteAllOffers` 与值 `true`;
* 一些产品 — 参数 `offerIds`.
## 查看参与推广活动的结果 {#promo-results}
您可以下载包含在促销活动下销售的产品的所有订单的报告。 有关如何接收报告的信息，请参阅 [分步说明](https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/reports.md).