Предварительный просмотр карточек на Маркете, соответствующих вашим товарам
Возвращает идентификаторы карточек на Маркете, которые соответствуют товарам с заданными параметрами.
Пользоваться этим запросом необязательно: он просто помогает заранее убедиться, что Маркет верно определяет карточке по предоставленным вами данным.
Как пользоваться запросом
- Передайте Маркету список товаров, которые нужно проверить.
- В ответ вы получите список SKU на Маркете с расшифровкой: названием, идентификатором модели, категорией.
- Если расшифровки мало, вы можете открыть карточку. Для этого перейдите по ссылке вида
https://market.yandex.ru/product/<marketModelId>?sku=<marketSku>. - Если карточка соответствует товару, значит его можно добавлять в каталог с теми данными, что вы указали. Если карточка определилась неправильно — проверьте данные о товаре. Возможно, их нужно уточнить или дополнить. Кроме того, на этапе добавления товара вы можете указать
marketSKU, который ему подходит по вашему мнению.
𝓠 Как определить marketSku товара, найденного на Маркете?
𝓐 Он есть в адресе страницы товара — расположен после sku=.
Например, https://market.yandex.ru/product--yandex-kniga/484830016?sku=484830016
| ⚙️ Лимит: 100 000 товаров в час, не более 500 товаров в одном запросе |
|---|
Request
POST
https://api.partner.market.yandex.ru/businesses/{businessId}/offer-mappings/suggestions
Path parameters
|
Name |
Type |
Description |
|
businessId* |
integer<int64> |
Идентификатор кабинета. Чтобы узнать идентификатор, воспользуйтесь запросом GET campaigns. |
Body
{
"offers": [
{
"offerId": "string",
"name": "Ударная дрель Makita HP1630, 710 Вт",
"category": "string",
"vendor": "LEVENHUK",
"barcodes": [
46012300000000
],
"description": "string",
"vendorCode": "VNDR-0005A",
"basicPrice": {
"value": 0,
"currencyId": "RUR"
}
}
]
}
|
Name |
Type |
Description |
|
offers |
Список товаров. |
SuggestedOfferDTO
Информация о товаре.
|
Name |
Type |
Description |
|
offerId |
string |
Ваш SKU — идентификатор товара в вашей системе. Разрешена любая последовательность длиной до 80 знаков. В нее могут входить английские и русские буквы, цифры и символы Правила использования SKU:
|
|
name |
string |
Составляйте название по схеме: тип + бренд или производитель + модель + особенности, если есть (например, цвет, размер или вес) и количество в упаковке. Не включайте в название условия продажи (например, «скидка», «бесплатная доставка» и т. д.), эмоциональные характеристики («хит», «супер» и т. д.). Не пишите слова большими буквами — кроме устоявшихся названий брендов и моделей. Оптимальная длина — 50–60 символов, максимальная — 256. Рекомендации и правила
|
|
category |
string |
Категория, к которой магазин относит свой товар. Она помогает точнее определить для товара категорию в каталоге Маркета. Указывайте конкретные категории — например, набор ножей лучше отнести к категории Столовые приборы, а не просто Посуда. Выбирайте категории, которые описывают товар, а не абстрактный признак — например, Духи, а не Подарки. |
|
vendor |
string |
Название бренда или производителя. Должно быть записано так, как его пишет сам бренд. |
|
barcodes |
string[] |
Указывайте в виде последовательности цифр. Подойдут коды EAN-13, EAN-8, UPC-A, UPC-E или Code 128. Для книг указывайте ISBN. Для товаров определенных категорий и торговых марок штрихкод должен быть действительным кодом GTIN. Обратите внимание: внутренние штрихкоды, начинающиеся на 2 или 02, и коды формата Code 128 не являются GTIN. Что такое GTIN
|
|
description |
string |
Подробное описание товара: например, его преимущества и особенности. Не давайте в описании инструкций по установке и сборке. Не используйте слова «скидка», «распродажа», «дешевый», «подарок» (кроме подарочных категорий), «бесплатно», «акция», «специальная цена», «новинка», «new», «аналог», «заказ», «хит». Не указывайте никакой контактной информации и не давайте ссылок. Можно использовать теги:
Оптимальная длина — 400–600 символов, максимальная — 6000. |
|
vendorCode |
string |
Артикул товара от производителя. |
|
basicPrice |
Цена товара |
BasePriceDTO
Цена на товар.
|
Name |
Type |
Description |
|
value* |
number |
Значение. |
|
currencyId* |
string |
Валюта. Если |
Responses
200 OK
Подобранные карточки на Маркете.
Если в ответе на запрос нет идентификатора карточки для одного из товаров, значит Маркету не удалось подобрать для товара подходящую карточку или карточка товара будет специально создана.
Body
{
"status": "OK",
"result": {
"offers": [
{
"offer": {
"offerId": "string",
"name": "Ударная дрель Makita HP1630, 710 Вт",
"category": "string",
"vendor": "LEVENHUK",
"barcodes": [
46012300000000
],
"description": "string",
"vendorCode": "VNDR-0005A",
"basicPrice": {
"value": 0,
"currencyId": "RUR"
}
},
"mapping": {
"marketSku": 0,
"marketSkuName": "string",
"marketModelId": 0,
"marketModelName": "string",
"marketCategoryId": 0,
"marketCategoryName": "string"
}
}
]
}
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
result |
Подобранные карточки на Маркете. |
ApiResponseStatusType
Тип ответа.
|
Type |
Description |
|
Enum: |
GetSuggestedOfferMappingsResultDTO
Подобранные карточки на Маркете.
|
Name |
Type |
Description |
|
offers |
Список товаров. |
SuggestedOfferMappingDTO
Товар с соответствующей карточкой на Маркете.
|
Name |
Type |
Description |
|
offer |
Информация о товаре. |
|
|
mapping |
Информация о карточке на Маркете. Может отсутствовать в ответе, если товар еще не привязан к карточке. |
GetMappingDTO
Информация о товарах в каталоге.
|
Name |
Type |
Description |
|
marketSku |
integer<int64> |
Идентификатор карточки на Маркете. Может отсутствовать в ответе, если товар еще не привязан к карточке. |
|
marketSkuName |
string |
Название карточки товара. Может отсутствовать в ответе, если товар еще не привязан к карточке. |
|
marketModelId |
integer<int64> |
Идентификатор модели на Маркете. Может отсутствовать в ответе, если товар еще не привязан к карточке. |
|
marketModelName |
string |
Название модели на Маркете. Может отсутствовать в ответе, если товар еще не привязан к карточке. |
|
marketCategoryId |
integer<int64> |
Идентификатор категории карточки на Маркете. Может отсутствовать в ответе, если Маркет еще не определил категорию товара. |
|
marketCategoryName |
string |
Название категории карточки на Маркете. Может отсутствовать в ответе, если Маркет еще не определил категорию товара. |
400 Bad Request
Запрос содержит неправильные данные.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
errors |
Список ошибок. |
ApiErrorDTO
Общий формат ошибки.
|
Name |
Type |
Description |
|
code* |
string |
Код ошибки. |
|
message |
string |
Описание ошибки. |
401 Unauthorized
В запросе не указаны данные для авторизации.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
errors |
Список ошибок. |
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
errors |
Список ошибок. |
404 Not Found
Запрашиваемый ресурс не найден.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
errors |
Список ошибок. |
420 Method Failure
Превышено ограничение на доступ к ресурсу.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
errors |
Список ошибок. |
500 Internal Server Error
Внутренняя ошибка сервера.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
errors |
Список ошибок. |
Что такое GTIN
GTIN — это уникальный номер, присвоенный товару в единой международной базе GS1. Из этого номера получается штрихкод формата EAN, UPC или ISBN.
Как убедиться, что товар есть в базе
Проверить код можно на странице проверки на сайте ассоциации GS1. Если товар не находится, запросите код GTIN у вашего поставщика.
Как получить GTIN для своих товаров
Чтобы получить коды GTIN, производителю нужно вступить в ассоциацию GS1 и зарегистрировать товары.