更改商店内商品的销售条款

方法适用于模式:FBY, FBS, ExpressDBS.

如果您使用API-Key令牌,调用该方法时需要具备列表中可用权限之一

更改特定商店中产品放置的参数:产品可用性,量子销售和适用的增值税。

⚙️ 限制: 每分钟10,000件物品

Request

POST

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/offers/update

Path parameters

Name

Description

campaignId

Type: integer

广告系列(商店)的ID — 通过API工作时,代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接,但仅用于自动交互。

您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:

  • 运动ID;
  • 标签 查询日志 →块中的下拉列表 显示日志.

⚠️ 不要把它与:

  • 商店的标识符,显示在商家的个人帐户中。
  • 广告活动。

Min value: 1

Body

application/json
{
  "offers": [
    {
      "offerId": "example",
      "quantum": {
        "minQuantity": 1,
        "stepQuantity": 1
      },
      "available": true
    }
  ]
}

Name

Description

offers

Type: object[]

指定商店中的产品放置参数。

Min items: 1

Max items: 500

Example
[
  {
    "offerId": "example",
    "quantum": {
      "minQuantity": 1,
      "stepQuantity": 1
    },
    "available": true
  }
]

Responses

200 OK

回答 200 表示新参数已被Yandex接收。市场,并将很快生效。

Body

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

Type: object

400 Bad Request

请求包含不正确的数据。 详细了解处理价格时的错误

Body

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

Type: object

401 Unauthorized

请求中未指定授权数据。 有关错误的更多信息

Body

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

Type: object

403 Forbidden

授权数据不正确或禁止访问资源。 有关错误的更多信息

Body

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

Type: object

404 Not Found

找不到请求的资源。 有关错误的更多信息

Body

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

Type: object

420 Method Failure

已超出资源访问限制。 有关错误的更多信息

Body

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

Type: object

423 Locked

指定的方法不能应用于资源。 有关错误的更多信息

Body

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

Type: object

500 Internal Server Error

Yandex的内部错误。 市场。 有关错误的更多信息

Body

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

Type: object

pathParams:
  - description: "广告系列(商店)的ID — 通过API工作时,代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接,但仅用于自动交互。\n\n您可以使用查询找到它 [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md) 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ **设置** 在左边的菜单中,选择 **Api和模块**:\n\n* 座 **运动ID**;\n* 标签 **查询日志** →块中的下拉列表 **显示日志**.\n\n⚠️ 不要把它与:\n- 商店的标识符,显示在商家的个人帐户中。\n- 广告活动。\n"
    name: campaignId
    in: path
    required: true
    schema:
      type: integer
      format: int64
      minimum: 1
searchParams: []
headers: []
body: |-
  {
    "offers": [
      {
        "offerId": "example",
        "quantum": {
          "minQuantity": 1,
          "stepQuantity": 1
        },
        "available": true
      }
    ]
  }
schema:
  description: 请求更新商店的产品优惠.
  type: object
  required:
    - offers
  properties:
    offers:
      description: 指定商店中的产品放置参数。
      type: array
      minItems: 1
      maxItems: 500
      items:
        description: 商店中的产品放置参数。
        type: object
        allOf:
          - description: 有关新产品价格的信息。
            type: object
            required:
              - offerId
            properties:
              offerId:
                description: "你的 SKU —\_系统中的产品ID。\n\n使用规则 SKU:\n\n* 对于每个产品 SKU 一定有一个。\n\n* 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。\n\nSKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 [在市场对卖家的帮助](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku).\n\n{% note warning %}\n\n值开头和结尾的空格会自动删除。 例如, `\"  SKU123  \"` 和 `\"SKU123\"` 它们将被视为相同的值。\n\n{% endnote %}\n\n[什么是 SKU 以及如何分配它](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
              quantum:
                deprecated: true
                description: |
                  建立量子销售。

                  要重置先前设置的值,请传递一个空参数 `quantum`.

                  {% cut "例子:" %}

                  ```json translate=no
                  {
                    "offers": [
                      {
                        "offerId": "08e35dc1-89a2-11e3-8055-0015e9b8c48d",
                        "quantum": {}
                      }
                    ]
                  }
                  ```

                  {% endcut %}
                type: object
                properties:
                  minQuantity:
                    description: |
                      订单中产品单位的最小数量。 例如,如果您指定10,客户将能够将至少10个商品添加到购物车。

                      ⚠️ 如果仓库中的货物数量少于指定的数量,则限制将不起作用,买方将能够订购。
                    type: integer
                    format: int32
                    minimum: 1
                  stepQuantity:
                    description: >
                      由多少单位的买方将能够增加货物在篮子里的数量。


                      例如,如果您设置5,买方将能够添加只有5,10,15,。.. 订单的项目。


                      ⚠️
                      如果库存货物的数量没有达到数量,限制将不起作用,买方将能够订购数量不是数量的倍数。
                    type: integer
                    format: int32
                    minimum: 1
                    maximum: 100
              available:
                description: "{% note warning \"相反,使用方法从展柜中隐藏商品。\" %}\n\n* [GET\_v2/campaigns/{campaignId}/hidden-offers](../../reference/assortment/getHiddenOffers.md) — 查看隐藏商品;\n* [POST\_v2/campaigns/{campaignId}/hidden-offers](../../reference/assortment/addHiddenOffers.md) — 隐藏货物;\n* [POST\_v2/campaigns/{campaignId}/hidden-offers/delete](../../reference/assortment/deleteHiddenOffers.md) — 恢复演出。\n\n{% endnote %}\n\n品是否在售。\n"
                deprecated: true
                type: boolean
          - properties:
              vat:
                description: >
                  用于产品的增值税标识符:


                  * `2` — 10%增值税。
                  例如,它用于销售某些食品和医疗产品。

                  * `5` — 增值税为0%。
                  例如,它用于销售在出口海关程序中出口的货物,或为国际货物运输提供服务。

                  * `6` — 增值税不收取,它仅用于某些类型的服务。

                  * `7` — 增值税20%。
                  基本增值税从2019年到2026年1月1日。

                  * `10` — 增值税是5%。 简化税制(USN)的增值税。

                  * `11` — 增值税是7%。 简化税制(USN)的增值税。

                  * `14` — 增值税是22%。
                  基本增值税从2026年1月1日开始。


                  如果省略该参数,则使用机柜中设置的增值税。


                  **卖家须知 Market Yandex Go**不提供增值税的转让和收据。
                type: integer
                format: int32
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/campaigns/{campaignId}/offers/update
host: https://api.partner.market.yandex.ru

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