Editing product category characteristics

Info

Console

The method is available for models: FBY, FBS, Express and DBS.

If you are using an API Key token, one of the accesses in the list is required to call the method

offers-and-cards-management — Manage products and cards
all-methods — Full account management

Edits the product characteristics that are specific to the category it belongs to.

Here is only what belongs to a specific category.

If you need to change the main parameters of the product (name, description, images, video, manufacturer, barcode), use the request POST v2/businesses/{businessId}/offer-mappings/update.

To remove the characteristics that are set in the parameters with the type string, pass an empty value.

The data in the catalog is not updated instantly

It takes up to a few minutes.

⚙️ Limit: 10,000 items per minute

Request

POST

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

Path parameters

Name

Description

businessId*

Type: integer<int64>

Cabinet ID. To find out, use the request GET v2/campaigns.

ℹ️ What is a cabinet and a store on the Market?

Min value: 1

Body

application/json

{
    "offersContent": [
        {
            "offerId": "string",
            "categoryId": 0,
            "parameterValues": [
                {
                    "parameterId": 0,
                    "unitId": 0,
                    "valueId": 0,
                    "value": "string"
                }
            ]
        }
    ]
}

Name

Description

offersContent*

Type: OfferContentDTO[]

A list of products with the specified characteristics.
An item with the specified characteristics.

Min items: 1

Max items: 100

OfferContentDTO

An item with the specified characteristics.

Name	Description
categoryId*	Type: integer<int32> The ID of the category on the Market. When changing the category, make sure that the product characteristics and their values in the parameter `parameterValues` you are submitting for a new category. You can get a list of Market categories using a request. POST v2/categories/tree. Min value (exclusive): `0`
offerId*	Type: string Your SKU — the product ID in your system. Usage rules SKU: For each product SKU there must be one. Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before. SKU The product can be changed in the seller's account on the Market. Read about how to do this. in the Help of the Market for sellers. What is SKU and how to assign it Min length: `1` Max length: `255` Pattern: `^(?=.\S.)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
parameterValues*	Type: ParameterValueDTO[] A list of characteristics with their values. When changing characteristics, transmit only those whose value needs to be updated. If in `categoryId` you are changing the category, the values of the common characteristics for the old and new categories will remain, and you do not need to transfer them. To delete the value of a given characteristic, pass it `parameterId` with an empty `value`. The value of the characteristic. You can specify multiple values of the same characteristic, provided that: Type of feature — `ENUM`. In response to the request POST v2/category/{categoryId}/parameters this characteristic has a field `multivalue` it matters `true`. To do this, in `parameterValues` pass each value separately — multiple objects with parameters `parameterId`, `valueId` and `value`. Parameter `parameterId` it must be the same. Min items: `1` Max items: `300`

ParameterValueDTO

The value of the characteristic.

You can specify multiple values of the same characteristic, provided that:

Type of feature — ENUM.
In response to the request POST v2/category/{categoryId}/parameters this characteristic has a field multivalue it matters true.

To do this, in parameterValues pass each value separately — multiple objects with parameters parameterId, valueId and value. Parameter parameterId it must be the same.

Name	Description
parameterId*	Type: integer<int64> The identifier of the characteristic. Min value: `1`
unitId	Type: integer<int64> ID of the unit of measurement. If you did not pass the parameter `unitId`, the default unit of measurement is used.
value	Type: string Meaning. For type characteristics `ENUM` transmit along with `valueId`.
valueId	Type: integer<int64> ID of the value. Be sure to specify the identifier if you are transmitting a value from the list of acceptable values received from the Market. Transmit along with `value`. Only for type characteristics `ENUM`.

Responses

200 OK

The request was executed correctly, and the data has been processed.

Answer 200 by itself, it does not mean that the values passed are correct.

Be sure to look at the details of the response.: status, as well as a list of errors (results.errors) and comments (results.warnings), if there are any.

If an error is returned for at least one product (results.errors), field status = ERROR. Changes to all transferred items will not be applied.
If there are no errors, but at least one product has a comment returned (results.warnings), field status = OK, and the changes will be applied.

If in status It's back ERROR, make sure that:

All required specifications are filled in.
the characteristics actually exist in the specified categories;
the values correspond to the characteristics;
your own values have the desired data type.

Fields will help you find problems. errors and warnings.

Body

application/json

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

Name

Description

status*

Type: ApiResponseStatusType

The type of response. Possible values:

OK — There are no errors.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

results

Type: UpdateOfferContentResultDTO[]

Errors and warnings that appeared when processing the transmitted values. Each item in the list corresponds to one product.

If there are no errors or warnings, the field is not passed.
Errors and warnings that appeared due to the transmitted characteristics.

Min items: 1

ApiResponseStatusType

The type of response. Possible values:

OK — There are no errors.
ERROR — an error occurred while processing the request.

Type	Description
ApiResponseStatusType	Enum: `OK`, `ERROR`

UpdateOfferContentResultDTO

Errors and warnings that appeared due to the transmitted characteristics.

Name	Description
offerId*	Type: string Your SKU — the product ID in your system. Usage rules SKU: For each product SKU there must be one. Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before. SKU The product can be changed in the seller's account on the Market. Read about how to do this. in the Help of the Market for sellers. What is SKU and how to assign it Min length: `1` Max length: `255` Pattern: `^(?=.\S.)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
errors	Type: OfferContentErrorDTO[] Mistakes. If there is an error for at least one product, the information in the catalog will not be updated for all transferred products. The text of the error or warning. Min items: `1`
warnings	Type: OfferContentErrorDTO[] Warnings. The information in the catalog will be updated. The text of the error or warning. Min items: `1`

OfferContentErrorDTO

The text of the error or warning.

Name	Description
message*	Type: string The text of the error or warning.
type*	Type: OfferContentErrorType Types of errors and warnings: `OFFER_NOT_FOUND` — there is no such product in the catalog. `UNKNOWN_CATEGORY` — an unknown category is specified. `INVALID_CATEGORY` — a non-leaf category is specified. Specify the one that has no child categories. `UNKNOWN_PARAMETER` — A characteristic has been transmitted that is not among the characteristics of the category. `UNEXPECTED_BOOLEAN_VALUE` — something else is passed instead of the boolean value. `NUMBER_FORMAT` — a string is passed that does not represent a number, instead of a number. `INVALID_UNIT_ID` — the unit of measurement that is unacceptable for the characteristic has been passed. `INVALID_GROUP_ID_LENGTH` — the allowed character value is exceeded in the name — 255. `INVALID_GROUP_ID_CHARACTERS` — passed invalid characters. You can check which category characteristics are available for a given category and get their settings using a request. POST v2/category/{categoryId}/parameters. Enum: `OFFER_NOT_FOUND`, `UNKNOWN_CATEGORY`, `INVALID_CATEGORY`, `UNKNOWN_PARAMETER`, `UNEXPECTED_BOOLEAN_VALUE`, `NUMBER_FORMAT`, `INVALID_UNIT_ID`, `INVALID_GROUP_ID_LENGTH`, `INVALID_GROUP_ID_CHARACTERS`
parameterId	Type: integer<int64> ID of the feature that the error or warning is associated with.

OfferContentErrorType

Types of errors and warnings:

OFFER_NOT_FOUND — there is no such product in the catalog.
UNKNOWN_CATEGORY — an unknown category is specified.
INVALID_CATEGORY — a non-leaf category is specified. Specify the one that has no child categories.
UNKNOWN_PARAMETER — A characteristic has been transmitted that is not among the characteristics of the category.
UNEXPECTED_BOOLEAN_VALUE — something else is passed instead of the boolean value.
NUMBER_FORMAT — a string is passed that does not represent a number, instead of a number.
INVALID_UNIT_ID — the unit of measurement that is unacceptable for the characteristic has been passed.
INVALID_GROUP_ID_LENGTH — the allowed character value is exceeded in the name — 255.
INVALID_GROUP_ID_CHARACTERS — passed invalid characters.

You can check which category characteristics are available for a given category and get their settings using a request. POST v2/category/{categoryId}/parameters.

Type	Description
OfferContentErrorType	Enum: `OFFER_NOT_FOUND`, `UNKNOWN_CATEGORY`, `INVALID_CATEGORY`, `UNKNOWN_PARAMETER`, `UNEXPECTED_BOOLEAN_VALUE`, `NUMBER_FORMAT`, `INVALID_UNIT_ID`, `INVALID_GROUP_ID_LENGTH`, `INVALID_GROUP_ID_CHARACTERS`

400 Bad Request

The request contains incorrect data. More information about the error

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — There are no errors.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

ApiErrorDTO

The general error format.

Name

Description

code*

Type: string

The error code.

message

Type: string

Description of the error.

401 Unauthorized

The authorization data is not specified in the request. More information about the error

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — There are no errors.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

403 Forbidden

The authorization data is incorrect or access to the resource is prohibited. More information about the error

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — There are no errors.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

404 Not Found

The requested resource was not found. More information about the error

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — There are no errors.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

420 Method Failure

The resource access limit has been exceeded. More information about the error

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — There are no errors.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

423 Locked

The specified method cannot be applied to the resource. More information about the error

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — There are no errors.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

500 Internal Server Error

Internal error in Yandex. Market. More information about the error

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — There are no errors.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

Was the article helpful?

Information about card occupancy

In the office