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

方法适用于模式:FBY, FBS, 快递DBS.

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

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

**⚙️ 限额:**每分钟10,000件

Request

POST

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

Path parameters

Name

Description

campaignId*

Type: integer<int64>

活动ID。

您可以使用查询找到它 :no-translate[GET v2/campaigns] 或者在市场上的卖家办公室找到它-点击您的企业名称并转到页面:

  • 模块和 API→区块 向Yandex发送数据。街市.
  • 查询日志 →块中的下拉列表 显示日志.

,不要发送商店的ID,而不是,这是在卖方的帐户在市场上的商店名称旁边和一些报告。

Min value: 1

Body

application/json
{
    "offers": [
        {
            "offerId": "string",
            "quantum": {
                "minQuantity": 0,
                "stepQuantity": 0
            },
            "available": false,
            "vat": 0
        }
    ]
}

Name

Description

offers*

Type: UpdateCampaignOfferDTO[]

指定商店中的产品放置参数。
商店中的产品放置参数。
有关新产品价格的信息。

Min items: 1

Max items: 500

UpdateCampaignOfferDTO

商店中的产品放置参数。

Name

Description

offerId*

Type: string

你的 SKU -系统中的产品ID。

使用规则 SKU:

  • 对于每个产品 SKU 一定有一个。

  • 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。

SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 在市场对卖家的帮助.

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

available

Type: boolean

相反,使用方法从展柜中隐藏商品。

品是否在售。

quantum

Type: QuantumDTO

Настройка продажи квантами. Что это значит?

vat

Type: integer<int32>

用于产品的增值税标识符:

  • 2 -10%增值税。 例如,它用于销售某些食品和医疗产品。
  • 5 -0%增值税。 例如,在出口海关程序中销售出口货物时,或为国际货物运输提供服务时使用。
  • 6 -不收取增值税,仅用于某些类型的服务。
  • 7 -20%增值税。 基本增值税从2019年开始。
  • 10 -5%增值税。 简化税制(USN)的增值税。
  • 11 -7%增值税。 简化税制(USN)的增值税。

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

卖家须知 Market Yandex Go不提供增值税的转让和收据。

QuantumDTO

建立量子销售。

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

例子:
{
  "offers": [
    {
      "offerId": "08e35dc1-89a2-11e3-8055-0015e9b8c48d",
      "quantum": {}
    }
  ]
}

Name

Description

minQuantity

Type: integer<int32>

订单中产品单位的最小数量。 例如,如果您指定10,客户将能够将至少10个商品添加到购物车。

如果库存商品数量少于指定数量,则限制将不起作用,买方将能够订购。

Min value: 1

stepQuantity

Type: integer<int32>

由多少单位的买方将能够增加货物在篮子里的数量。

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

如果库存货物的数量没有达到数量,限制将不起作用,买方将能够订购数量不是数量的倍数。

Min value: 1

Max value: 100

Responses

200 OK

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

Body

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

Name

Description

status*

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK -没有错误。
  • ERROR -处理请求时发生错误。

Enum: OK, ERROR

ApiResponseStatusType

响应的类型。 可能的值:

  • OK -没有错误。
  • ERROR -处理请求时发生错误。

Type

Description

ApiResponseStatusType

Enum: OK, ERROR

400 Bad Request

请求包含不正确的数据。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK -没有错误。
  • ERROR -处理请求时发生错误。

Enum: OK, ERROR

ApiErrorDTO

一般错误格式。

Name

Description

code*

Type: string

的错误代码。

message

Type: string

错误的描述。

401 Unauthorized

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

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK -没有错误。
  • ERROR -处理请求时发生错误。

Enum: OK, ERROR

403 Forbidden

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

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK -没有错误。
  • ERROR -处理请求时发生错误。

Enum: OK, ERROR

404 Not Found

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

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK -没有错误。
  • ERROR -处理请求时发生错误。

Enum: OK, ERROR

420 Method Failure

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

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK -没有错误。
  • ERROR -处理请求时发生错误。

Enum: OK, ERROR

423 Locked

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

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK -没有错误。
  • ERROR -处理请求时发生错误。

Enum: OK, ERROR

500 Internal Server Error

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

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK -没有错误。
  • ERROR -处理请求时发生错误。

Enum: OK, ERROR

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