查看市场上与您的产品相匹配的卡片

Deprecated

Info

Console

方法适用于所有模式.

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

offers-and-cards-management — 商品和卡片管理
offers-and-cards-management:read-only — 查看商品和卡片
all-methods — 全面管理账户
all-methods:read-only — 查看所有数据

返回市场上与具有指定参数的产品相对应的卡的Id。

您不需要使用此查询：它只是有助于提前确保市场根据您提供的数据正确识别卡片。

如何使用请求

将需要检查的产品列表发送到Yandex。市场。
作为回应，您将收到一份清单 SKU 在市场上有一个描述：名称，型号ID，类别。
如果没有足够的解密，您可以打开卡。要做到这一点，请按照表单中的链接 ：没有-翻译[https://market.yandex.ru/product/<市场模型>?sku=<市场模型>].
如果卡与产品匹配，则可以将其添加到目录中，并使用您指定的数据。如果卡识别错误 — 检查产品信息。它们可能需要澄清或补充。此外，在添加产品的阶段，您可以指定 marketSKU 你认为哪一个适合他。

如何确定 marketSku 市场上发现的产品？

它在产品页面的地址中。 — 位于后 sku=.

例如, ：没有-翻译[https://market.yandex.ru/product--yandex-kniga/484830016?sku=484830016]

⚙️ 限制: 每小时100,000种产品

Request

POST

https://api.partner.market.yandex.ru/v2/businesses/{businessId}/offer-mappings/suggestions

Path parameters

Name

Description

businessId

Type: integer

内阁ID。要找到答案，请使用请求 GET v2/campaigns.

ℹ️ 什么是市场上的橱柜和商店？

Min value: 1

Body

application/json

{
  "offers": [
    {
      "offerId": "example",
      "name": "Ударная дрель Makita HP1630, 710 Вт",
      "category": "example",
      "vendor": "LEVENHUK",
      "barcodes": [
        "46012300000000"
      ],
      "description": "example",
      "vendorCode": "VNDR-0005A",
      "basicPrice": {
        "value": 0,
        "currencyId": "RUR"
      }
    }
  ]
}

Name

Description

offers

Type: object[]

barcodes

Type: string[] | null

条形码。

将其指定为数字序列。密码可以 EAN-13, EAN-8, UPC-A, UPC-E 或 Code 128. 对于书籍 — ISBN.

对于产品某些类别和品牌条形码必须是有效的代码。 GTIN. 请注意：内部条码以2或02开头，以及格式代码 Code 128 他们不是 GTIN.

【是什么 GTIN](*gtin)

Min items: 1

Unique items: true

Example

[
  "46012300000000"
]

basicPrice

Type: object

currencyId

Type: string

货币代码:

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

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

value

Type: number

品的价格。

Min value: 0

Exclusive min: true

品的价格。

Example

{
  "value": 0,
  "currencyId": "RUR"
}

category

Type: string

相反，使用 marketCategoryId.

您商店中的产品类别。

Example: example

description

Type: string

详细的产品说明：例如，它的优点和特点。

说明中不提供安装和装配说明。不要使用"折扣"，"销售"，"便宜"，"礼品"（礼品类别除外），"免费"，"特价"，"特价"，"新奇"，"新"，"模拟"，"订单"，"点击"等字样。不要提供任何联系信息或链接。

您可以使用HTML标记来格式化文本:

<h>，<h1>，<h2>等等 — 新闻标题;
<br>和<p> — 对于换行符;
<ol> — 对于编号列表;
<ul> — 对于项目符号列表。
<李> — 创建列表项（必须在<ol>或<ul>内）;
<div> — 支持，但不影响文本显示。

最佳长度 — 400-600个字符。

建议和规则

Max length: 6000

Example: example

name

Type: string

根据方案组成名称：类型+品牌或制造商+型号+功能，如果有（例如，颜色，尺寸或重量）和数量在包装中。

不包括情感特征（"命中"，"超级"等。）以销售条款的名义（例如，"折扣"，"免费送货"等。). 不要用大写字母写单词 — 除了成熟的品牌名称和型号。

最佳长度 — 50-60个字符。

建议和规则

Max length: 256

Example: Ударная дрель Makita HP1630, 710 Вт

offerId

Type: string

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

使用规则 SKU:

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

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

重要

值开头和结尾的空格会自动删除。例如, " SKU123 " 和 "SKU123" 它们将被视为相同的值。

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

Example: example

vendor

Type: string

品牌或制造商的名称。它应该按照品牌本身的方式来写。

Example: LEVENHUK

vendorCode

Type: string

从制造商的产品的文章。

Example: VNDR-0005A

的产品清单。

Min items: 1

Max items: 500

Example

[
  {
    "offerId": "example",
    "name": "Ударная дрель Makita HP1630, 710 Вт",
    "category": "example",
    "vendor": "LEVENHUK",
    "barcodes": [
      "46012300000000"
    ],
    "description": "example",
    "vendorCode": "VNDR-0005A",
    "basicPrice": {
      "value": 0,
      "currencyId": "RUR"
    }
  }
]

Responses

200 OK

市场上精选的卡片。

根据产品验证的结果，通过此请求接收的卡可以用另一个替换。

Body

application/json

{
  "status": "OK",
  "result": {
    "offers": [
      {
        "offer": {},
        "mapping": {}
      }
    ]
  }
}

Type: object

All of 2 types

Type: object
status

Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

result

Type: object

offers

Type: object[]

mapping

Type: object

All of 2 types

Type: object

marketSku

Type: integer

市场上的产品卡的ID。

Min value: 1

从您的角度来看，市场上适合产品的卡片。要确定相应卡的ID，请使用机柜中的搜索（产品中心 → 目录 → 上传产品).

根据验证结果，市场可以将产品链接到更合适的卡。
Example
```
{
  "marketSku": 1
}
```

Type: object

marketCategoryId	Type: integer 品所属的市场上的类别的ID。如果市场尚未确定产品类别，则可能会在响应中缺失。
marketCategoryName	Type: string 卡在市场上的类别的名称。如果市场尚未确定产品类别，则可能会在响应中缺失。 Example: `example`
marketModelName	Type: string 市场上模型的名称。如果产品尚未链接到卡，则可能不会包含在响应中。 Example: `example`
marketSkuName	Type: string 产品卡的名称。如果产品尚未链接到卡，则可能不会包含在响应中。 Example: `example`

Example

{
  "marketSkuName": "example",
  "marketModelName": "example",
  "marketCategoryId": 0,
  "marketCategoryName": "example"
}

目录中有关产品的信息。

Example

{
  "marketSku": 1,
  "marketSkuName": "example",
  "marketModelName": "example",
  "marketCategoryId": 0,
  "marketCategoryName": "example"
}

offer

Type: object

barcodes

Type: string[] | null

条形码。

将其指定为数字序列。密码可以 EAN-13, EAN-8, UPC-A, UPC-E 或 Code 128. 对于书籍 — ISBN.

对于产品某些类别和品牌条形码必须是有效的代码。 GTIN. 请注意：内部条码以2或02开头，以及格式代码 Code 128 他们不是 GTIN.

【是什么 GTIN](*gtin)

Min items: 1

Unique items: true

Example

[
  "46012300000000"
]

basicPrice

Type: object

currencyId

Type: string

货币代码:

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

value

Type: number

品的价格。

Min value: 0

Exclusive min: true

品的价格。

Example

{
  "value": 0,
  "currencyId": "RUR"
}

category

Type: string

相反，使用 marketCategoryId.

您商店中的产品类别。

Example: example

description

Type: string

详细的产品说明：例如，它的优点和特点。

您可以使用HTML标记来格式化文本:

<h>，<h1>，<h2>等等 — 新闻标题;
<br>和<p> — 对于换行符;
<ol> — 对于编号列表;
<ul> — 对于项目符号列表。
<李> — 创建列表项（必须在<ol>或<ul>内）;
<div> — 支持，但不影响文本显示。

最佳长度 — 400-600个字符。

建议和规则

Max length: 6000

Example: example

name

Type: string

根据方案组成名称：类型+品牌或制造商+型号+功能，如果有（例如，颜色，尺寸或重量）和数量在包装中。

不包括情感特征（"命中"，"超级"等。）以销售条款的名义（例如，"折扣"，"免费送货"等。). 不要用大写字母写单词 — 除了成熟的品牌名称和型号。

最佳长度 — 50-60个字符。

建议和规则

Max length: 256

Example: Ударная дрель Makita HP1630, 710 Вт

offerId

Type: string

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

使用规则 SKU:

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

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

重要

值开头和结尾的空格会自动删除。例如, " SKU123 " 和 "SKU123" 它们将被视为相同的值。

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

Example: example

vendor

Type: string

品牌或制造商的名称。它应该按照品牌本身的方式来写。

Example: LEVENHUK

vendorCode

Type: string

从制造商的产品的文章。

Example: VNDR-0005A

产品信息。

Example

{
  "offerId": "example",
  "name": "Ударная дрель Makita HP1630, 710 Вт",
  "category": "example",
  "vendor": "LEVENHUK",
  "barcodes": [
    "46012300000000"
  ],
  "description": "example",
  "vendorCode": "VNDR-0005A",
  "basicPrice": {
    "value": 0,
    "currencyId": "RUR"
  }
}

的产品清单。

Example

[
  {
    "offer": {
      "offerId": "example",
      "name": "Ударная дрель Makita HP1630, 710 Вт",
      "category": "example",
      "vendor": "LEVENHUK",
      "barcodes": [
        "46012300000000"
      ],
      "description": "example",
      "vendorCode": "VNDR-0005A",
      "basicPrice": {
        "value": 0,
        "currencyId": "RUR"
      }
    },
    "mapping": {
      "marketSku": 1,
      "marketSkuName": "example",
      "marketModelName": "example",
      "marketCategoryId": 0,
      "marketCategoryName": "example"
    }
  }
]

市场上精选的卡片。

Example

{
  "offers": [
    {
      "offer": {
        "offerId": "example",
        "name": "Ударная дрель Makita HP1630, 710 Вт",
        "category": "example",
        "vendor": "LEVENHUK",
        "barcodes": [
          "46012300000000"
        ],
        "description": "example",
        "vendorCode": "VNDR-0005A",
        "basicPrice": {
          "value": 0,
          "currencyId": "RUR"
        }
      },
      "mapping": {
        "marketSku": 1,
        "marketSkuName": "example",
        "marketModelName": "example",
        "marketCategoryId": 0,
        "marketCategoryName": "example"
      }
    }
  ]
}

Example

{
  "result": {
    "offers": [
      {
        "offer": {
          "offerId": "example",
          "name": "Ударная дрель Makita HP1630, 710 Вт",
          "category": "example",
          "vendor": "LEVENHUK",
          "barcodes": [
            null
          ],
          "description": "example",
          "vendorCode": "VNDR-0005A",
          "basicPrice": {}
        },
        "mapping": {}
      }
    ]
  }
}

400 Bad Request

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

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

401 Unauthorized

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

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

403 Forbidden

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

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

404 Not Found

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

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

420 Method Failure

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

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

500 Internal Server Error

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

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

这篇文章是否有用？

推荐卡片

价格表