Adding products to a promotion or changing their prices

The method is available for all models.

Not yet available for Market Yandex Go sellers.

If you are using an API Key token, one of the accesses in the list is required to call the method

Adds products to the promotion or changes the prices of the products that participate in the promotion.

The changes begin to take effect within 4-6 hours. To find out if they have been applied, use the parameter processing in the method's response POST v2/businesses/{businessId}/promos.

⚙️ Limit: 10,000 requests per hour

Request

POST

https://api.partner.market.yandex.ru/v2/businesses/{businessId}/promos/offers/update

Path parameters

Name

Description

businessId

Type: integer

Cabinet ID. To find out, use the request GET v2/campaigns.

ℹ️ What is a cabinet and a store on the Market?

Min value: 1

Body

application/json
{
  "promoId": "example",
  "offers": [
    {
      "offerId": "example",
      "params": {
        "discountParams": {
          "price": 1,
          "promoPrice": 1
        }
      }
    }
  ]
}

Name

Description

offers

Type: object[]

offerId

Type: string

Your SKU — the product ID in your system.

Usage rules SKU:

  • For each product SKU there must be one.

  • Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before.

SKU The product can be changed in the seller's account on the Market. Read about how to do this. in the Help of the Market for sellers.

Warning

Spaces at the beginning and end of the value are automatically deleted. For example, " SKU123 " and "SKU123" they will be treated as identical values.

What is SKU and how to assign it

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

Example: example

params

Type: object

discountParams

Type: object

price

Type: integer

Crossed out price — the price at which the product was sold before the promotion.

Indicated in rubles.

The number must be an integer.

Min value: 1

promoPrice

Type: integer

Share price — the one you want to sell the product at.

Indicated in rubles.

The number must be an integer.

Min value: 1

Product parameters in the promotion with the type DIRECT_DISCOUNT or BLUE_FLASH.

A required parameter for stocks with these types.

Example
{
  "price": 1,
  "promoPrice": 1
}

The parameters of the product that participates in the promotion.

Example
{
  "discountParams": {
    "price": 1,
    "promoPrice": 1
  }
}

Products that need to be added to the promotion or whose prices need to be changed.

Min items: 1

Max items: 500

Example
[
  {
    "offerId": "example",
    "params": {
      "discountParams": {
        "price": 1,
        "promoPrice": 1
      }
    }
  }
]

promoId

Type: string

The ID of the promotion.

Example: example

Responses

200 OK

The result of adding products to the promotion or updating their prices.

Body

application/json
{
  "status": "OK"
}

Type: object

400 Bad Request

The request contains incorrect data. Learn more about errors when working with stocks

Body

application/json
{
  "status": "OK"
}

Type: object

401 Unauthorized

The authorization data is not specified in the request. More information about the error

Body

application/json
{
  "status": "OK"
}

Type: object

403 Forbidden

The authorization data is incorrect or access to the resource is prohibited. More information about the error

Body

application/json
{
  "status": "OK"
}

Type: object

404 Not Found

The requested resource was not found. More information about the error

Body

application/json
{
  "status": "OK"
}

Type: object

420 Method Failure

The resource access limit has been exceeded. More information about the error

Body

application/json
{
  "status": "OK"
}

Type: object

500 Internal Server Error

Internal error of the Market. More information about the error

Body

application/json
{
  "status": "OK"
}

Type: object

pathParams:
  - description: "Cabinet ID. To find out, use the request [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md).\n\nℹ️ [What is a cabinet and a store on the Market?](https://yandex.ru/support/marketplace/account/introduction.html)\n"
    name: businessId
    in: path
    required: true
    schema:
      type: integer
      format: int64
      minimum: 1
searchParams: []
headers: []
body: |-
  {
    "promoId": "example",
    "offers": [
      {
        "offerId": "example",
        "params": {
          "discountParams": {
            "price": 1,
            "promoPrice": 1
          }
        }
      }
    ]
  }
schema:
  description: >
    Adding products to a promotion or updating their parameters.


    To add products to a promotion or update the parameters of some products,
    pass them in the parameter `offers`.
  type: object
  required:
    - promoId
    - offers
  properties:
    promoId:
      description: The ID of the promotion.
      type: string
    offers:
      description: >-
        Products that need to be added to the promotion or whose prices need to
        be changed.
      type: array
      minItems: 1
      maxItems: 500
      items:
        description: Description of the products that participate in the promotion.
        type: object
        required:
          - offerId
        properties:
          offerId:
            description: "Your SKU —\_the product ID in your system.\n\nUsage rules SKU:\n\n* For each product SKU there must be one.\n\n* Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before.\n\nSKU The product can be changed in the seller's account on the Market. Read about how to do this. [in the Help of the Market for sellers](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku).\n\n{% note warning %}\n\nSpaces at the beginning and end of the value are automatically deleted. For example, `\"  SKU123  \"` and `\"SKU123\"` they will be treated as identical values.\n\n{% endnote %}\n\n[What is SKU and how to assign it](https://yandex.ru/support/marketplace/assortment/add/index.html#fields)\n"
            type: string
            pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$
            x-transform: trim
            minLength: 1
            maxLength: 255
          params:
            description: The parameters of the product that participates in the promotion.
            type: object
            properties:
              discountParams:
                description: >
                  Product parameters in the promotion with the type
                  `DIRECT_DISCOUNT` or
                  `BLUE_FLASH`.


                  A required parameter for stocks with these types.
                type: object
                properties:
                  price:
                    description: >
                      Crossed out price — the price at which the
                      product was sold before the promotion.


                      Indicated in rubles.


                      The number must be an integer.
                    type: integer
                    format: int64
                    minimum: 1
                  promoPrice:
                    description: >
                      Share price — the one you want to sell the
                      product at.


                      Indicated in rubles.


                      The number must be an integer.
                    type: integer
                    format: int64
                    minimum: 1
bodyType: application/json
method: post
security:
  - type: apiKey
    name: 'Api-Key'
    in: header
  - type: oauth2
    x-inline: true
    flows:
      implicit:
        authorizationUrl: https://oauth.yandex.ru/authorize
        scopes:
          market:partner-api: API Яндекс.Маркета / Поиска по товарам для партнеров
path: v2/businesses/{businessId}/promos/offers/update
host: https://api.partner.market.yandex.ru

No longer supported, please use an alternative and newer version.

Цена, которая действует во всех магазинах.