---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
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
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/en/llms.txt

# Stock management

Yandex Market API allows you to receive information about Market promotions and participate in them.

## Add products to the promotion {#add-goods}

{% note tip "You already know the IDs of the list of stocks and products." %}

Skip the steps to get them.

{% endnote %}

<!-- source: en/_includes/mermaid/promo-add-goods.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as Your store
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: Getting the list of promotions
        Merchant ->>+ Market: Cabinet identifier<br>POST v2/businesses/{businessId}/promos
        Market -->> Merchant: OK: current and future Market promotions.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Getting the list of products that can participate in the promotion
        Merchant ->>+ Market: Promotion identifier<br>POST v2/businesses/{businessId}/promos/offers
        Market -->> Merchant: OK: products that can participate in the promotion.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Adding products to the promotion
        Merchant ->>+ Market: Promotion identifier and products to add<br>POST v2/businesses/{businessId}/promos/offers/update
        Market ->> Market: Adds<br>products to the promotion.
        Market -->>- Merchant: OK: result of adding products to the promotion.
    end
```
<!-- endsource: en/_includes/mermaid/promo-add-goods.md -->

1. Get a list of Yandex.Market shares using a request [POST v2/businesses/{businessId}/promos](https://yandex.com/dev/market/partner-api/doc/en/reference/promos/getPromos.md).
2. Pass the stock ID in the request [POST v2/businesses/{businessId}/promos/offers](https://yandex.com/dev/market/partner-api/doc/en/reference/promos/getPromoOffers.md) to find out which products can participate in the promotion.
3. Make a request [POST v2/businesses/{businessId}/promos/offers/update](https://yandex.com/dev/market/partner-api/doc/en/reference/promos/updatePromoOffers.md), where pass the ID of the promotion and the products that need to be added.

## Change the price of products that have already been added to the promotion {#change-price}

{% note tip "You already know the IDs of the list of stocks and products." %}

Skip the steps to get them.

{% endnote %}

<!-- source: en/_includes/mermaid/promo-change-price.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as Your store
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: Getting the list of promotions
        Merchant ->>+ Market: Business ID<br>POST v2/businesses/{businessId}/promos
        Market -->> Merchant: OK: current and future Market promotions.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Getting the list of products added to the promotion
        Merchant ->>+ Market: Promotion ID<br>and statusType parameter with value MANUALLY_ADDED<br>POST v2/businesses/{businessId}/promos/offers
        Market -->> Merchant: OK: products added to the promotion.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Changing prices for products in the promotion
        Merchant ->>+ Market: Product SKUs and their new prices<br>POST v2/businesses/{businessId}/promos/offers/update
        Market ->> Market: Updates prices<br>for products in the promotion.
        Market -->>- Merchant: OK: price update result.
    end
```
<!-- endsource: en/_includes/mermaid/promo-change-price.md -->

1. Get a list of Yandex.Market shares using a request [POST v2/businesses/{businessId}/promos](https://yandex.com/dev/market/partner-api/doc/en/reference/promos/getPromos.md).
2. Pass the promotion ID and the parameter `statusType` with the value `MANUALLY_ADDED` in the request [POST v2/businesses/{businessId}/promos/offers](https://yandex.com/dev/market/partner-api/doc/en/reference/promos/getPromoOffers.md) to find out which products have been added to the promotion.
3. Pass it on SKU products and their new prices — request [POST v2/businesses/{businessId}/promos/offers/update](https://yandex.com/dev/market/partner-api/doc/en/reference/promos/updatePromoOffers.md).

## Remove products from the promotion {#delete-goods}

{% note tip "You already know the IDs of the list of stocks and products." %}

Skip the steps to get them.

{% endnote %}

<!-- source: en/_includes/mermaid/promo-delete-goods.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as Your store
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: Getting the list of promotions
        Merchant ->>+ Market: Cabinet ID<br>POST v2/businesses/{businessId}/promos
        Market -->> Merchant: OK: current and future Market promotions.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Getting the list of products added to the promotion
        Merchant ->>+ Market: Promotion ID<br>and statusType parameter with value MANUALLY_ADDED<br>POST v2/businesses/{businessId}/promos/offers
        Market -->> Merchant: OK: products added to the promotion.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Removing products from the promotion
        Merchant ->>+ Market: deleteAllOffers parameter with value true<br>or product SKUs in offerIds parameter<br>POST v2/businesses/{businessId}/promos/offers/delete
        Market ->> Market: Removes<br>products from the promotion.
        Market -->>- Merchant: OK: result of product removal.
    end
```
<!-- endsource: en/_includes/mermaid/promo-delete-goods.md -->

1. Get a list of Yandex.Market shares using a request [POST v2/businesses/{businessId}/promos](https://yandex.com/dev/market/partner-api/doc/en/reference/promos/getPromos.md).
2. Pass the promotion ID and the parameter `statusType` with the value `MANUALLY_ADDED` in the request [POST v2/businesses/{businessId}/promos/offers](https://yandex.com/dev/market/partner-api/doc/en/reference/promos/getPromoOffers.md) to find out which products have been added to the promotion.
3. Make a request [POST v2/businesses/{businessId}/promos/offers/delete](https://yandex.com/dev/market/partner-api/doc/en/reference/promos/deletePromoOffers.md) to remove from the promotion:

    * all products — parameter `deleteAllOffers` with the value `true`;
    * some products — parameter `offerIds`.

## View the results of participation in the promotion {#promo-results}

You can download a report with all orders that contain products sold under the promotion. For information on how to receive reports, see [step-by-step instructions](https://yandex.com/dev/market/partner-api/doc/en/step-by-step/reports.md).