将产品添加到目录并更改有关它们的信息

Info

Console

方法适用于模式：FBY, FBS, Express 和 DBS.

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

offers-and-cards-management — 商品和卡片管理
all-methods — 全面管理账户

将产品添加到目录并传输:

他们的叶子类别 关于市场和分类特征;
主要特点;
商品在橱柜的价格。

它还结合卡上的产品，编辑和删除有关已添加产品的信息，包括机柜和产品类别中的价格。

您可以使用请求获取市场类别列表。 POST v2/categories/tree，以及按类别使用的产品特性 POST v2/category/{categoryId}/parameters.

添加新产品

使用以前从未在文件夹中使用过的新ID传输它。

请务必指定参数: offerId, name, marketCategoryId, pictures, vendor, description.

尝试一次传达尽可能多的信息 — 市场将需要它来选择合适的卡或创建一个新的。

如果您知道市场上的哪张卡对应的产品，您可以立即指定此卡的ID（SKU 在市场上）在现场 marketSKU.

对于Yandex Go市场的卖家:

将产品添加到目录时，请指定参数值 name 和 description 用俄语。要在展柜上以不同的语言显示它们，请再次提出请求。 POST v2/businesses/{businessId}/offer-mappings/update 在哪里指定:

参数中的语言 language;
参数值 name 和 description 在指定的语言。

不需要重新传输剩余的产品特性。

更改产品信息

通过指定in发送新数据 offerId SKU 产品在您的系统中。

可以省略任何更改的字段。

删除以前传输的产品参数

在 deleteParameters 指定要删除的参数值。您可以一次传递多个值。

对于具有类型的参数 string 您也可以传递空值。

参数 offerId (SKU 系统中的产品）必须是 独特的 对于您转移的所有产品。

使用规则 SKU

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

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

目录中的数据不会立即更新

最多需要几分钟。

⚙️ 限制: 每分钟10,000个产品，每个请求不超过100个产品

Request

POST

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

Path parameters

Name

Description

businessId*

Type: integer<int64>

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

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

Min value: 1

Query parameters

Name

Description

language

Type: string

接受和返回参数中的值的语言 name 和 description.

默认值: RU.
语言:

RU — 俄语。
UZ — 乌兹别克。

Enum: RU, UZ

Body

application/json

{
    "offerMappings": [
        {
            "offer": {
                "offerId": "string",
                "name": "Ударная дрель Makita HP1630, 710 Вт",
                "marketCategoryId": 0,
                "category": "string",
                "pictures": [
                    "string"
                ],
                "videos": [
                    "string"
                ],
                "manuals": [
                    {
                        "url": "string",
                        "title": "string"
                    }
                ],
                "vendor": "LEVENHUK",
                "barcodes": [
                    "46012300000000"
                ],
                "description": "string",
                "manufacturerCountries": [
                    "Россия"
                ],
                "weightDimensions": {
                    "length": 65.55,
                    "width": 50.7,
                    "height": 20,
                    "weight": 1.001
                },
                "vendorCode": "VNDR-0005A",
                "tags": [
                    "до 500 рублей"
                ],
                "shelfLife": {
                    "timePeriod": 0,
                    "timeUnit": "HOUR",
                    "comment": "string"
                },
                "lifeTime": {
                    "timePeriod": 0,
                    "timeUnit": "HOUR",
                    "comment": "string"
                },
                "guaranteePeriod": {
                    "timePeriod": 0,
                    "timeUnit": "HOUR",
                    "comment": "string"
                },
                "customsCommodityCode": "8517610008",
                "commodityCodes": [
                    {
                        "code": "string",
                        "type": "CUSTOMS_COMMODITY_CODE"
                    }
                ],
                "certificates": [
                    "string"
                ],
                "boxCount": 0,
                "condition": {
                    "type": "PREOWNED",
                    "quality": "PERFECT",
                    "reason": "string"
                },
                "type": "DEFAULT",
                "downloadable": false,
                "adult": false,
                "age": {
                    "value": 0,
                    "ageUnit": "YEAR"
                },
                "params": [
                    {
                        "name": "Wi-Fi",
                        "value": "есть"
                    }
                ],
                "parameterValues": [
                    {
                        "parameterId": 0,
                        "unitId": 0,
                        "valueId": 0,
                        "value": "string"
                    }
                ],
                "basicPrice": {
                    "value": 0,
                    "currencyId": "RUR",
                    "discountBase": 0
                },
                "purchasePrice": {
                    "value": 0,
                    "currencyId": "RUR"
                },
                "additionalExpenses": {
                    "value": 0,
                    "currencyId": "RUR"
                },
                "firstVideoAsCover": false,
                "deleteParameters": [
                    "ADDITIONAL_EXPENSES"
                ]
            },
            "mapping": {
                "marketSku": 0
            }
        }
    ],
    "onlyPartnerMediaContent": false
}

Name

Description

offerMappings*

Type: object[]

需要添加或更新的产品列表。

我们将很快减少每个请求的最大产品数量.

现在不要发送超过100。

产品信息。

Min items: 1

Max items: 500

onlyPartnerMediaContent

Type: boolean

是否只会使用您提供的产品数据。

默认值: false. 要删除市场添加的数据，请传递值 true.

Responses

200 OK

请求已正确执行，并且数据已被处理。

回答 200 就其本身而言，它并不意味着传递的值是正确的。

请务必查看响应的详细信息。: status，以及错误列表（results.errors）和评论（results.warnings），如果有的话。

如果至少有一个产品返回错误（results.errors），场 status = ERROR. 不会应用对所有转移项目的更改。
如果没有错误，但至少有一个产品返回了注释（results.warnings），场 status = OK，并将应用更改。

Body

application/json

{
    "status": "OK",
    "results": [
        {
            "offerId": "string",
            "errors": [
                {
                    "type": "UNKNOWN_CATEGORY",
                    "parameterId": 0,
                    "message": "string"
                }
            ],
            "warnings": [
                {
                    "type": "UNKNOWN_CATEGORY",
                    "parameterId": 0,
                    "message": "string"
                }
            ]
        }
    ]
}

Name

Description

status*

Type: string

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

results

Type: object[]

处理特征列表时出现的错误和警告。列表中的每个项目对应一个产品。

如果没有错误或警告，则不传递该字段。
传输的特性而出现的错误和警告。

Min items: 1

400 Bad Request

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

Body

application/json

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

Name

Description

errors

Type: object[]

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

Min items: 1

status

Type: string

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

401 Unauthorized

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

Body

application/json

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

Name

Description

errors

Type: object[]

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

Min items: 1

status

Type: string

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

403 Forbidden

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

Body

application/json

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

Name

Description

errors

Type: object[]

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

Min items: 1

status

Type: string

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

404 Not Found

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

Body

application/json

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

Name

Description

errors

Type: object[]

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

Min items: 1

status

Type: string

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

420 Method Failure

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

Body

application/json

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

Name

Description

errors

Type: object[]

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

Min items: 1

status

Type: string

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

423 Locked

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

Body

application/json

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

Name

Description

errors

Type: object[]

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

Min items: 1

status

Type: string

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

500 Internal Server Error

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

Body

application/json

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

Name

Description

errors

Type: object[]

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

Min items: 1

status

Type: string

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

这篇文章是否有用？

按类别列出的产品特性

更改销售条款