价格表

Deprecated

方法适用于所有模式.

如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一
  • pricing — 价格管理
  • pricing:read-only — 查看价格
  • all-methods — 全面管理账户
  • all-methods:read-only — 查看所有数据

我应该使用哪种方法而不是过时的方法？

POST v2/campaigns/{campaignId}/offer-prices

返回您以任何方式为产品设置的价格列表：例如，通过 API 或有目录的文件中。

项目总数是如何计算的？

根据最近七天（不包括今天）的数据，它不能超过200万。

介绍了设定价格的方法 在市场对卖家的帮助.

**⚙️ 限额：**每分钟150,000件

Request

GET

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/offer-prices

Path parameters

Name

Description

campaignId*

Type: integer<int64>

活动ID。

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

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

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

Min value: 1

Query parameters

Name

Description

archived

Type: boolean

按存档中的位置过滤。

Default: false

limit

Type: integer<int32>

每页的值数。

Min value: 1
Example: 20

page_token

Type: string

结果页面的ID。

如果省略该参数，则返回第一页。

我们建议传输输出参数的值 nextPageToken，在最后一次请求期间接收。

如果设置 page_token 并且请求有参数 page 和 pageSize 它们被忽略了。
Example: eyBuZXh0SWQ6IDIzNDIgfQ==

Responses

200 OK

具有固定价格的所有产品的列表。

Body

application/json
{
    "status": "OK",
    "result": {
        "offers": [
            {
                "id": "string",
                "price": {
                    "value": 0,
                    "discountBase": 0,
                    "currencyId": "RUR",
                    "vat": 0
                },
                "marketSku": 0,
                "updatedAt": "2022-12-29T18:02:01Z"
            }
        ],
        "paging": {
            "nextPageToken": "string"
        },
        "total": 0
    }
}

Name

Description

status*

Type: ApiResponseStatusType

响应的类型。 可能的值:

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

Enum: OK, ERROR

result

Type: OfferPriceListResponseDTO

产品价格列表。

ApiResponseStatusType

响应的类型。 可能的值:

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

Type

Description

ApiResponseStatusType

Enum: OK, ERROR

OfferPriceListResponseDTO

产品价格列表。

Name

Description

offers*

Type: OfferPriceResponseDTO[]

的列表页。
产品的设定价格的信息。

paging

Type: ForwardScrollingPagerDTO

下一页的ID。

total

Type: integer<int32>

所有商店价格的数量通过 API.

OfferPriceResponseDTO

产品的设定价格的信息。

Name

Description

id

Type: string

价目表中的报价ID。

marketSku

Type: integer<int64>

市场上的产品卡的ID。

Min value: 1

price

Type: PriceDTO

价格包括折扣、货币和上次更新的时间.

updatedAt

Type: string<date-time>

产品价格上次更新的日期和时间。

ForwardScrollingPagerDTO

下一页的ID。

Name

Description

nextPageToken

Type: string

下一个结果页面的ID。

PriceDTO

价格包括折扣、货币和上次更新的时间.

Name

Description

currencyId

Type: CurrencyType

Валюта, в которой указана цена товара.

Enum: RUR, USD, EUR, UAH, AUD, GBP, BYR, BYN, DKK, ISK, KZT, CAD, CNY, NOK, XDR, SGD, TRY, SEK, CHF, JPY, AZN, ALL, DZD, AOA, ARS, AMD, AFN, BHD, BGN, BOB, BWP, BND, BRL, BIF, HUF, VEF, KPW, VND, GMD, GHS, GNF, HKD, GEL, AED, EGP, ZMK, ILS, INR, IDR, JOD, IQD, IRR, YER, QAR, KES, KGS, COP, CDF, CRC, KWD, CUP, LAK, LVL, SLL, LBP, LYD, SZL, LTL, MUR, MRO, MKD, MWK, MGA, MYR, MAD, MXN, MZN, MDL, MNT, NPR, NGN, NIO, NZD, OMR, PKR, PYG, PEN, PLN, KHR, SAR, RON, SCR, SYP, SKK, SOS, SDG, SRD, TJS, THB, TWD, BDT, TZS, TND, TMM, UGX, UZS, UYU, PHP, DJF, XAF, XOF, HRK, CZK, CLP, LKR, EEK, ETB, RSD, ZAR, KRW, NAD, TL, UE

discountBase

Type: number

划掉的价格。

数字必须是整数。 您可以指定折扣从5到99％的价格。

如果您提供产品折扣，则在每次更新价格时传递此参数。

Min value (exclusive): 0

value

Type: number

品的价格。

Min value (exclusive): 0

vat

Type: integer<int32>

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

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

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

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

CurrencyType

货币代码:

  • RUR -俄罗斯卢布。
  • UAH -乌克兰格里夫纳。
  • BYR -白俄罗斯卢布。
  • KZT -哈萨克斯坦坚戈。
  • UZS -乌兹别克总和。

Type

Description

CurrencyType

Enum: RUR, USD, EUR, UAH, AUD, GBP, BYR, BYN, DKK, ISK, KZT, CAD, CNY, NOK, XDR, SGD, TRY, SEK, CHF, JPY, AZN, ALL, DZD, AOA, ARS, AMD, AFN, BHD, BGN, BOB, BWP, BND, BRL, BIF, HUF, VEF, KPW, VND, GMD, GHS, GNF, HKD, GEL, AED, EGP, ZMK, ILS, INR, IDR, JOD, IQD, IRR, YER, QAR, KES, KGS, COP, CDF, CRC, KWD, CUP, LAK, LVL, SLL, LBP, LYD, SZL, LTL, MUR, MRO, MKD, MWK, MGA, MYR, MAD, MXN, MZN, MDL, MNT, NPR, NGN, NIO, NZD, OMR, PKR, PYG, PEN, PLN, KHR, SAR, RON, SCR, SYP, SKK, SOS, SDG, SRD, TJS, THB, TWD, BDT, TZS, TND, TMM, UGX, UZS, UYU, PHP, DJF, XAF, XOF, HRK, CZK, CLP, LKR, EEK, ETB, RSD, ZAR, KRW, NAD, TL, UE

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

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.

上一篇
查看匹配的卡片
下一篇
促销价格