Request
Responses
200 OK
400 Bad Request
- Body
- ApiErrorDTO
401 Unauthorized
- Body
403 Forbidden
- Body
404 Not Found
- Body
420 Method Failure
- Body
500 Internal Server Error
- Body

Рекомендованные карточки для ваших товаров

Info

Console

Deprecated

Этот метод устарел. Пожалуйста, пользуйтесь вместо него POST businesses/{businessId}/offer-mappings/suggestions.

Возвращает идентификаторы карточек товаров на Маркете, рекомендованных для ваших товаров.

Каждому товару, который вы размещаете, должна соответствовать карточка товара на Маркете со своим идентификатором — SKU на Маркете. Он указывается в URL карточки товара, после «...sku=», например:

https://market.yandex.ru/product--yandex-kniga/484830016?sku=484830016…

Чтобы получить для товаров рекомендованные SKU на Маркете, передайте в теле POST-запроса как можно больше информации о них: названия, производителей, штрихкоды, цены и т. д.

Полученные SKU можно передать вместе с информацией о ваших товарах с помощью запроса POST campaigns/{campaignId}/offer-mapping-entries/updates.

В одном запросе можно получить не более 500 рекомендаций.

⚙️ Лимит: 100 000 рекомендаций в час

Request

POST

https://api.partner.market.yandex.ru/campaigns/{campaignId}/offer-mapping-entries/suggestions

Path parameters

Name

Type

Description

campaignId*

integer<int64>

Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете.

Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns.

ℹ️ Что такое кабинет и магазин на Маркете

Body

application/json

{
    "offers": [
        {
            "name": "Ударная дрель Makita HP1630, 710 Вт",
            "shopSku": "string",
            "category": "string",
            "vendor": "LEVENHUK",
            "vendorCode": "VNDR-0005A",
            "description": "string",
            "id": "string",
            "feedId": 0,
            "barcodes": [
                46012300000000
            ],
            "urls": [
                "string"
            ],
            "pictures": [
                "string"
            ],
            "manufacturer": "string",
            "manufacturerCountries": [
                "string"
            ],
            "minShipment": 0,
            "transportUnitSize": 0,
            "quantumOfSupply": 0,
            "deliveryDurationDays": 0,
            "boxCount": 0,
            "customsCommodityCodes": [
                "string"
            ],
            "weightDimensions": {
                "length": 65.55,
                "width": 50.7,
                "height": 20,
                "weight": 1.001
            },
            "supplyScheduleDays": [
                "MONDAY"
            ],
            "shelfLifeDays": 0,
            "lifeTimeDays": 0,
            "guaranteePeriodDays": 0,
            "processingState": {
                "status": "UNKNOWN",
                "notes": [
                    {
                        "type": "ASSORTMENT",
                        "payload": "string"
                    }
                ]
            },
            "availability": "ACTIVE",
            "shelfLife": {
                "timePeriod": 0,
                "timeUnit": "HOUR",
                "comment": "string"
            },
            "lifeTime": {
                "timePeriod": 0,
                "timeUnit": "HOUR",
                "comment": "string"
            },
            "guaranteePeriod": {
                "timePeriod": 0,
                "timeUnit": "HOUR",
                "comment": "string"
            },
            "certificate": "string",
            "price": 0
        }
    ]
}

Name	Type	Description
offers*	MappingsOfferDTO[]	Список товаров. Информация о товарах в каталоге. Информация о товаре из каталога.

MappingsOfferDTO

Информация о товарах в каталоге.

Name	Type	Description
name	string	Составляйте название по схеме: тип + бренд или производитель + модель + особенности, если есть (например, цвет, размер или вес) и количество в упаковке. Не включайте в название условия продажи (например, «скидка», «бесплатная доставка» и т. д.), эмоциональные характеристики («хит», «супер» и т. д.). Не пишите слова большими буквами — кроме устоявшихся названий брендов и моделей. Оптимальная длина — 50–60 символов, максимальная — 256. Рекомендации и правила Example: `Ударная дрель Makita HP1630, 710 Вт`
shopSku	string	Ваш SKU. Уникальный код, который вы используете для идентификации товара (если не используете — придумайте). Ваш SKU может состоять из: цифр; латинских букв; русских букв; символов `. , \ / ( ) [ ] - =`. Максимальная длина — 80 символов. Должен быть уникальным для каждого товара.
category	string	Категория, к которой магазин относит свой товар. Она помогает точнее определить для товара категорию в каталоге Маркета. Указывайте конкретные категории — например, набор ножей лучше отнести к категории Столовые приборы, а не просто Посуда. Выбирайте категории, которые описывают товар, а не абстрактный признак — например, Духи, а не Подарки.
vendor	string	Название бренда или производителя. Должно быть записано так, как его пишет сам бренд. Example: `LEVENHUK`
vendorCode	string	Артикул товара от производителя. Example: `VNDR-0005A`
description	string	Подробное описание товара: например, его преимущества и особенности. Не давайте в описании инструкций по установке и сборке. Не используйте слова «скидка», «распродажа», «дешевый», «подарок» (кроме подарочных категорий), «бесплатно», «акция», «специальная цена», «новинка», «new», «аналог», «заказ», «хит». Не указывайте никакой контактной информации и не давайте ссылок. Можно использовать теги: <h>, <h1>, <h2> и так далее — для заголовков; <br> и <p> — для переноса строки; <ol> — для нумерованного списка; <ul> — для маркированного списка; <li> — для создания элементов списка (должен находиться внутри <ol> или <ul>); <div> — поддерживается, но не влияет на отображение текста. Оптимальная длина — 400–600 символов, максимальная — 6000. Рекомендации и правила
id	string	Ваш SKU — идентификатор товара в вашей системе. Разрешена любая последовательность длиной до 80 знаков. В нее могут входить английские и русские буквы, цифры и символы `. , / \ ( ) [ ] - = _` Правила использования SKU: У каждого товара SKU должен быть свой. SKU товара нельзя менять — можно только удалить товар и добавить заново с новым SKU. Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге. Что такое SKU и как его назначать.
feedId	integer<int64>	Идентификатор фида.
barcodes	string[]	Указывайте в виде последовательности цифр. Подойдут коды EAN-13, EAN-8, UPC-A, UPC-E или Code 128. Для книг указывайте ISBN. Для товаров определенных категорий и торговых марок штрихкод должен быть действительным кодом GTIN. Обратите внимание: внутренние штрихкоды, начинающиеся на 2 или 02, и коды формата Code 128 не являются GTIN. Что такое GTIN Example: `46012300000000`
urls	string[]	URL фотографии товара или страницы с описанием на вашем сайте. Переданные данные не будут отображаться на витрине, но они помогут специалистам Маркета найти карточку для вашего товара. Должен содержать один вложенный параметр url.
pictures	string[]	Ссылки (URL) изображений товара в хорошем качестве. Можно указать до 10 ссылок. При этом изображение по первой ссылке будет основным. Оно используется в качестве изображения товара в поиске Маркета и на карточке товара. Другие изображения товара доступны в режиме просмотра увеличенных изображений. Обязательный параметр. Должен содержать хотя бы один вложенный параметр `picture`.
manufacturer	string	Изготовитель товара: компания, которая произвела товар, ее адрес и регистрационный номер (если есть). Необязательный параметр.
manufacturerCountries	string[]	Список стран, в которых произведен товар. Обязательный параметр. Должен содержать хотя бы одну, но не больше 5 стран.
minShipment	integer<int32>	Минимальное количество единиц товара, которое вы поставляете на склад. Например, если вы поставляете детское питание партиями минимум по 10 коробок, а в каждой коробке по 6 баночек, укажите значение 60.
transportUnitSize	integer<int32>	Количество единиц товара в одной упаковке, которую вы поставляете на склад. Например, если вы поставляете детское питание коробками по 6 баночек, укажите значение 6.
quantumOfSupply	integer<int32>	Добавочная партия: по сколько единиц товара можно добавлять к минимальному количеству minShipment. Например, если вы поставляете детское питание партиями минимум по 10 коробок и хотите добавлять к минимальной партии по 2 коробки, а в каждой коробке по 6 баночек, укажите значение 12.
deliveryDurationDays	integer<int32>	Срок, за который продавец поставляет товары на склад, в днях.
boxCount	integer<int32>	Сколько мест (если больше одного) занимает товар. Параметр указывается, только если товар занимает больше одного места (например, кондиционер занимает два места: внешний и внутренний блоки в двух коробках). Если товар занимает одно место, не указывайте этот параметр.
customsCommodityCodes	string[]	Список кодов товара в единой Товарной номенклатуре внешнеэкономической деятельности (ТН ВЭД). Обязательный параметр, если товар подлежит особому учету (например, в системе «Меркурий» как продукция животного происхождения или в системе «Честный ЗНАК»). Может содержать только один вложенный код ТН ВЭД.
weightDimensions	OfferWeightDimensionsDTO	Габариты упаковки и вес товара.
supplyScheduleDays	DayOfWeekType[]	Дни недели, в которые продавец поставляет товары на склад. День недели: `MONDAY` — понедельник. `TUESDAY` — вторник. `WEDNESDAY` — среда. `THURSDAY` — четверг. `FRIDAY` — пятница. `SATURDAY` — суббота. `SUNDAY` — воскресенье. Enum: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`
shelfLifeDays	integer<int32>	Внимание Параметр устарел и не рекомендуется к использованию. Вместо него используйте параметр `shelfLife`. Совместное использование обоих параметров приведет к ошибке. Срок годности: через сколько дней товар станет непригоден для использования.
lifeTimeDays	integer<int32>	Внимание Параметр устарел и не рекомендуется к использованию. Вместо него используйте параметр `lifeTime`. Совместное использование обоих параметров приведет к ошибке. Срок службы: сколько дней товар будет исправно выполнять свою функцию, а изготовитель — нести ответственность за его существенные недостатки.
guaranteePeriodDays	integer<int32>	Гарантийный срок товара: сколько дней возможно обслуживание и ремонт товара или возврат денег, а изготовитель или продавец будет нести ответственность за недостатки товара.
processingState	OfferProcessingStateDTO	Информация о статусе публикации товара на Маркете.
availability	OfferAvailabilityStatusType	Планы по поставкам: `ACTIVE` — поставки будут. `INACTIVE` — поставок не будет: товар есть на складе, но вы больше не планируете его поставлять. Через 60 дней после того, как товар закончится на складе, этот статус изменится на `DELISTED`. `DELISTED` — архив: товар закончился на складе, и его поставок больше не будет. Если товар вернется на склад (например, покупатель вернет заказ), этот статус изменится на `INACTIVE`. Значения по умолчанию: при добавлении товара — `ACTIVE`; при редактировании товара — такое же, как и при последнем обновлении каталога (в том числе другими способами, не через партнерский API). Enum: `ACTIVE`, `INACTIVE`, `DELISTED`
shelfLife	TimePeriodDTO	Информация о сроке годности: через какое время (в годах, месяцах, днях, неделях или часах) товар станет непригоден для использования. Например, срок годности есть у таких категорий, как продукты питания и медицинские препараты. Обязательный параметр, если у товара есть срок годности. Внимание Если у товара есть срок годности, а вы не укажете его, товар будет скрыт с Маркета.
lifeTime	TimePeriodDTO	Информация о сроке службы: в течение какого периода (в годах, месяцах, днях, неделях или часах) товар будет исправно выполнять свою функцию, а изготовитель — нести ответственность за его существенные недостатки. Обязательный параметр, если у товара есть срок службы. Внимание Если у товара есть срок службы, а вы не укажете его, товар будет скрыт с Маркета.
guaranteePeriod	TimePeriodDTO	Информация о гарантийном сроке: в течение какого периода (в годах, месяцах, днях, неделях или часах) возможны обслуживание и ремонт товара или возврат денег, а изготовитель или продавец будет нести ответственность за недостатки товара. Обязательный параметр, если у товара есть гарантийный срок. Внимание Если у товара есть гарантийный срок, а вы не укажете его, товар будет скрыт с Маркета.
certificate	string	Номер документа на товар. Перед указанием номера документ нужно загрузить в личном кабинете магазина. Инструкция
price	number	Цена товара в рублях.

OfferWeightDimensionsDTO

Габариты упаковки и вес товара.

Если товар занимает несколько коробок, перед измерением размеров сложите их компактно.

Схема измерения многоместных грузов

Name	Type	Description
length*	number	Длина упаковки в см. Example: `65.55`
width*	number	Ширина упаковки в см. Example: `50.7`
height*	number	Высота упаковки в см. Example: `20`
weight*	number	Вес товара в кг с учетом упаковки (брутто). Example: `1.001`

DayOfWeekType

День недели:

MONDAY — понедельник.
TUESDAY — вторник.
WEDNESDAY — среда.
THURSDAY — четверг.
FRIDAY — пятница.
SATURDAY — суббота.
SUNDAY — воскресенье.

Type	Description
DayOfWeekType	Enum: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`

OfferProcessingStateDTO

Информация о статусе публикации товара на Маркете.

Name	Type	Description
status	OfferProcessingStatusType	Статус публикации товара Enum: `UNKNOWN`, `READY`, `IN_WORK`, `NEED_INFO`, `NEED_MAPPING`, `NEED_CONTENT`, `CONTENT_PROCESSING`, `SUSPENDED`, `REJECTED`, `REVIEW`, `CREATE_ERROR`, `UPDATE_ERROR`
notes	OfferProcessingNoteDTO[]	Причины, по которым товар не прошел модерацию. Причины, по которым товар не прошел модерацию.

OfferAvailabilityStatusType

Планы по поставкам:

ACTIVE — поставки будут.
INACTIVE — поставок не будет: товар есть на складе, но вы больше не планируете его поставлять. Через 60 дней после того, как товар закончится на складе, этот статус изменится на DELISTED.
DELISTED — архив: товар закончился на складе, и его поставок больше не будет. Если товар вернется на склад (например, покупатель вернет заказ), этот статус изменится на INACTIVE.

Type	Description
OfferAvailabilityStatusType	Enum: `ACTIVE`, `INACTIVE`, `DELISTED`

TimePeriodDTO

Временной отрезок с комментарием. Требования к содержанию комментария зависят от контекста использования параметра и указаны в описании поля, которое его содержит.

Name	Type	Description
timePeriod*	integer	Продолжительность в указанных единицах.
timeUnit*	TimeUnitType	Единица измерения. Enum: `HOUR`, `DAY`, `WEEK`, `MONTH`, `YEAR`
comment	string	Комментарий.

OfferProcessingStatusType

Статус публикации товара:

READY — товар прошел модерацию. Чтобы разместить его на Маркете, установите для него цену.
IN_WORK — товар проходит модерацию. Это занимает несколько дней.
NEED_CONTENT — для товара без SKU на Маркете marketSku нужно найти карточку самостоятельно (через API или личный кабинет магазина) или создать ее, если товар еще не продается на Маркете.
NEED_INFO — товар не прошел модерацию из-за ошибок или недостающих сведений в описании товара. Информация о причинах отклонения возвращается в параметре notes.
REJECTED — товар не прошел модерацию, так как Маркет не планирует размещать подобные товары.
SUSPENDED — товар не прошел модерацию, так как Маркет пока не размещает подобные товары.

Type	Description
OfferProcessingStatusType	Enum: `UNKNOWN`, `READY`, `IN_WORK`, `NEED_INFO`, `NEED_MAPPING`, `NEED_CONTENT`, `CONTENT_PROCESSING`, `SUSPENDED`, `REJECTED`, `REVIEW`, `CREATE_ERROR`, `UPDATE_ERROR`

OfferProcessingNoteDTO

Причины, по которым товар не прошел модерацию.

Name	Type	Description
type	OfferProcessingNoteType	Тип причины, по которой товар не прошел модерацию. Enum: `ASSORTMENT`, `CANCELLED`, `CONFLICTING_INFORMATION`, `OTHER`, `DEPARTMENT_FROZEN`, `INCORRECT_INFORMATION`, `LEGAL_CONFLICT`, `NEED_CLASSIFICATION_INFORMATION`, `NEED_INFORMATION`, `NEED_PICTURES`, `NEED_VENDOR`, `NO_CATEGORY`, `NO_KNOWLEDGE`, `NO_PARAMETERS_IN_SHOP_TITLE`, `NO_SIZE_MEASURE`, `SAMPLE_LINE`
payload	string	Дополнительная информация о причине отклонения товара.

TimeUnitType

Единица измерения времени:

HOUR — час;
DAY — сутки;
WEEK — неделя;
MONTH — месяц;
YEAR — год.

Type	Description
TimeUnitType	Enum: `HOUR`, `DAY`, `WEEK`, `MONTH`, `YEAR`

OfferProcessingNoteType

Тип причины, по которой товар не прошел модерацию:

ASSORTMENT — товар производится в разных вариантах. Каждый из них нужно описать как отдельный товар (входной параметр offer-mapping-entry запроса POST campaigns/{campaignId}/offer-mapping-entries/updates или строка в каталоге, если вы загружаете товары через личный кабинет магазина).
CANCELLED — товар отозван с модерации по вашей инициативе.
CONFLICTING_INFORMATION (ранее ошибочно CONFLICTING) — вы предоставили противоречивую информацию о товаре. Параметры, которые нужно исправить, указаны в параметре payload.
DEPARTMENT_FROZEN — правила размещения товаров в данной категории перерабатываются, поэтому товар пока не может пройти модерацию.
INCORRECT_INFORMATION — информация о товаре, которую вы предоставили, противоречит описанию от производителя. Параметры, которые нужно исправить, указаны в параметре payload.
LEGAL_CONFLICT — товар не прошел модерацию по юридическим причинам. Например, он официально не продается в России или у вас нет разрешения на его продажу.
NEED_CLASSIFICATION_INFORMATION — информации о товаре, которую вы предоставили, не хватает, чтобы отнести его к категории. Проверьте, что правильно указали название, категорию, производителя и страны производства товара, а также URL изображений или страниц с описанием, по которым можно идентифицировать товар.
NEED_INFORMATION — товар раньше не продавался в России и пока не размещается на Маркете. Для него можно создать карточку. Подробнее см. в разделе Работа с карточкой товара Справки Маркета для продавцов.
NEED_PICTURES — для идентификации товара нужны его изображения. Отправьте URL изображений товара в запросе POST campaigns/{campaignId}/offer-mapping-entries/updates или загрузите обновленный каталог через личный кабинет магазина.
NEED_VENDOR — неверно указан производитель товара.
NO_CATEGORY, NO_KNOWLEDGE — товары из указанной категории пока не размещаются на Маркете. Если категория появится, товар будет снова отправлен на модерацию.
NO_PARAMETERS_IN_SHOP_TITLE — товар производится в разных вариантах, и из указанного названия непонятно, о каком идет речь. Параметры, которые нужно добавить в название товара, указаны в параметре payload.
NO_SIZE_MEASURE — для этого товара нужна размерная сетка. Отправьте ее в службу поддержки или вашему менеджеру. Требования к размерной сетке указаны в параметре payload.
UNKNOWN — товар не прошел модерацию по другой причине. Обратитесь в службу поддержки или к вашему менеджеру.

Type	Description
OfferProcessingNoteType	Enum: `ASSORTMENT`, `CANCELLED`, `CONFLICTING_INFORMATION`, `OTHER`, `DEPARTMENT_FROZEN`, `INCORRECT_INFORMATION`, `LEGAL_CONFLICT`, `NEED_CLASSIFICATION_INFORMATION`, `NEED_INFORMATION`, `NEED_PICTURES`, `NEED_VENDOR`, `NO_CATEGORY`, `NO_KNOWLEDGE`, `NO_PARAMETERS_IN_SHOP_TITLE`, `NO_SIZE_MEASURE`, `SAMPLE_LINE`

{
    "status": "OK",
    "result": {
        "offers": [
            {
                "name": "Ударная дрель Makita HP1630, 710 Вт",
                "shopSku": "string",
                "category": "string",
                "vendor": "LEVENHUK",
                "vendorCode": "VNDR-0005A",
                "description": "string",
                "id": "string",
                "feedId": 0,
                "barcodes": [
                    46012300000000
                ],
                "urls": [
                    "string"
                ],
                "pictures": [
                    "string"
                ],
                "manufacturer": "string",
                "manufacturerCountries": [
                    "string"
                ],
                "minShipment": 0,
                "transportUnitSize": 0,
                "quantumOfSupply": 0,
                "deliveryDurationDays": 0,
                "boxCount": 0,
                "customsCommodityCodes": [
                    "string"
                ],
                "weightDimensions": {
                    "length": 65.55,
                    "width": 50.7,
                    "height": 20,
                    "weight": 1.001
                },
                "supplyScheduleDays": [
                    "MONDAY"
                ],
                "shelfLifeDays": 0,
                "lifeTimeDays": 0,
                "guaranteePeriodDays": 0,
                "processingState": {
                    "status": "UNKNOWN",
                    "notes": [
                        {
                            "type": "ASSORTMENT",
                            "payload": "string"
                        }
                    ]
                },
                "availability": "ACTIVE",
                "shelfLife": {
                    "timePeriod": 0,
                    "timeUnit": "HOUR",
                    "comment": "string"
                },
                "lifeTime": {
                    "timePeriod": 0,
                    "timeUnit": "HOUR",
                    "comment": "string"
                },
                "guaranteePeriod": {
                    "timePeriod": 0,
                    "timeUnit": "HOUR",
                    "comment": "string"
                },
                "certificate": "string",
                "price": 0,
                "marketCategoryId": 0,
                "marketCategoryName": "string",
                "marketModelId": 0,
                "marketModelName": "string",
                "marketSku": 0,
                "marketSkuName": "string"
            }
        ]
    }
}

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
result	OfferMappingSuggestionsListDTO	Список рекомендованных карточек товара.

ApiResponseStatusType

Тип ответа.

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

OfferMappingSuggestionsListDTO

Список рекомендованных карточек товара.

Name	Type	Description
offers	EnrichedMappingsOfferDTO[]	Список товаров. Информация о рекомендованных карточках товаров. Информация о товарах в каталоге.

EnrichedMappingsOfferDTO

Информация о рекомендованных карточках товаров.

Name	Type	Description
name	string	Составляйте название по схеме: тип + бренд или производитель + модель + особенности, если есть (например, цвет, размер или вес) и количество в упаковке. Не включайте в название условия продажи (например, «скидка», «бесплатная доставка» и т. д.), эмоциональные характеристики («хит», «супер» и т. д.). Не пишите слова большими буквами — кроме устоявшихся названий брендов и моделей. Оптимальная длина — 50–60 символов, максимальная — 256. Рекомендации и правила Example: `Ударная дрель Makita HP1630, 710 Вт`
shopSku	string	Ваш SKU. Уникальный код, который вы используете для идентификации товара (если не используете — придумайте). Ваш SKU может состоять из: цифр; латинских букв; русских букв; символов `. , \ / ( ) [ ] - =`. Максимальная длина — 80 символов. Должен быть уникальным для каждого товара.
category	string	Категория, к которой магазин относит свой товар. Она помогает точнее определить для товара категорию в каталоге Маркета. Указывайте конкретные категории — например, набор ножей лучше отнести к категории Столовые приборы, а не просто Посуда. Выбирайте категории, которые описывают товар, а не абстрактный признак — например, Духи, а не Подарки.
vendor	string	Название бренда или производителя. Должно быть записано так, как его пишет сам бренд. Example: `LEVENHUK`
vendorCode	string	Артикул товара от производителя. Example: `VNDR-0005A`
description	string	Подробное описание товара: например, его преимущества и особенности. Не давайте в описании инструкций по установке и сборке. Не используйте слова «скидка», «распродажа», «дешевый», «подарок» (кроме подарочных категорий), «бесплатно», «акция», «специальная цена», «новинка», «new», «аналог», «заказ», «хит». Не указывайте никакой контактной информации и не давайте ссылок. Можно использовать теги: <h>, <h1>, <h2> и так далее — для заголовков; <br> и <p> — для переноса строки; <ol> — для нумерованного списка; <ul> — для маркированного списка; <li> — для создания элементов списка (должен находиться внутри <ol> или <ul>); <div> — поддерживается, но не влияет на отображение текста. Оптимальная длина — 400–600 символов, максимальная — 6000. Рекомендации и правила
id	string	Ваш SKU — идентификатор товара в вашей системе. Разрешена любая последовательность длиной до 80 знаков. В нее могут входить английские и русские буквы, цифры и символы `. , / \ ( ) [ ] - = _` Правила использования SKU: У каждого товара SKU должен быть свой. SKU товара нельзя менять — можно только удалить товар и добавить заново с новым SKU. Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге. Что такое SKU и как его назначать.
feedId	integer<int64>	Идентификатор фида.
barcodes	string[]	Указывайте в виде последовательности цифр. Подойдут коды EAN-13, EAN-8, UPC-A, UPC-E или Code 128. Для книг указывайте ISBN. Для товаров определенных категорий и торговых марок штрихкод должен быть действительным кодом GTIN. Обратите внимание: внутренние штрихкоды, начинающиеся на 2 или 02, и коды формата Code 128 не являются GTIN. Что такое GTIN Example: `46012300000000`
urls	string[]	URL фотографии товара или страницы с описанием на вашем сайте. Переданные данные не будут отображаться на витрине, но они помогут специалистам Маркета найти карточку для вашего товара. Должен содержать один вложенный параметр url.
pictures	string[]	Ссылки (URL) изображений товара в хорошем качестве. Можно указать до 10 ссылок. При этом изображение по первой ссылке будет основным. Оно используется в качестве изображения товара в поиске Маркета и на карточке товара. Другие изображения товара доступны в режиме просмотра увеличенных изображений. Обязательный параметр. Должен содержать хотя бы один вложенный параметр `picture`.
manufacturer	string	Изготовитель товара: компания, которая произвела товар, ее адрес и регистрационный номер (если есть). Необязательный параметр.
manufacturerCountries	string[]	Список стран, в которых произведен товар. Обязательный параметр. Должен содержать хотя бы одну, но не больше 5 стран.
minShipment	integer<int32>	Минимальное количество единиц товара, которое вы поставляете на склад. Например, если вы поставляете детское питание партиями минимум по 10 коробок, а в каждой коробке по 6 баночек, укажите значение 60.
transportUnitSize	integer<int32>	Количество единиц товара в одной упаковке, которую вы поставляете на склад. Например, если вы поставляете детское питание коробками по 6 баночек, укажите значение 6.
quantumOfSupply	integer<int32>	Добавочная партия: по сколько единиц товара можно добавлять к минимальному количеству minShipment. Например, если вы поставляете детское питание партиями минимум по 10 коробок и хотите добавлять к минимальной партии по 2 коробки, а в каждой коробке по 6 баночек, укажите значение 12.
deliveryDurationDays	integer<int32>	Срок, за который продавец поставляет товары на склад, в днях.
boxCount	integer<int32>	Сколько мест (если больше одного) занимает товар. Параметр указывается, только если товар занимает больше одного места (например, кондиционер занимает два места: внешний и внутренний блоки в двух коробках). Если товар занимает одно место, не указывайте этот параметр.
customsCommodityCodes	string[]	Список кодов товара в единой Товарной номенклатуре внешнеэкономической деятельности (ТН ВЭД). Обязательный параметр, если товар подлежит особому учету (например, в системе «Меркурий» как продукция животного происхождения или в системе «Честный ЗНАК»). Может содержать только один вложенный код ТН ВЭД.
weightDimensions	OfferWeightDimensionsDTO	Габариты упаковки и вес товара.
supplyScheduleDays	DayOfWeekType[]	Дни недели, в которые продавец поставляет товары на склад. День недели: `MONDAY` — понедельник. `TUESDAY` — вторник. `WEDNESDAY` — среда. `THURSDAY` — четверг. `FRIDAY` — пятница. `SATURDAY` — суббота. `SUNDAY` — воскресенье. Enum: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`
shelfLifeDays	integer<int32>	Внимание Параметр устарел и не рекомендуется к использованию. Вместо него используйте параметр `shelfLife`. Совместное использование обоих параметров приведет к ошибке. Срок годности: через сколько дней товар станет непригоден для использования.
lifeTimeDays	integer<int32>	Внимание Параметр устарел и не рекомендуется к использованию. Вместо него используйте параметр `lifeTime`. Совместное использование обоих параметров приведет к ошибке. Срок службы: сколько дней товар будет исправно выполнять свою функцию, а изготовитель — нести ответственность за его существенные недостатки.
guaranteePeriodDays	integer<int32>	Гарантийный срок товара: сколько дней возможно обслуживание и ремонт товара или возврат денег, а изготовитель или продавец будет нести ответственность за недостатки товара.
processingState	OfferProcessingStateDTO	Информация о статусе публикации товара на Маркете.
availability	OfferAvailabilityStatusType	Планы по поставкам: `ACTIVE` — поставки будут. `INACTIVE` — поставок не будет: товар есть на складе, но вы больше не планируете его поставлять. Через 60 дней после того, как товар закончится на складе, этот статус изменится на `DELISTED`. `DELISTED` — архив: товар закончился на складе, и его поставок больше не будет. Если товар вернется на склад (например, покупатель вернет заказ), этот статус изменится на `INACTIVE`. Значения по умолчанию: при добавлении товара — `ACTIVE`; при редактировании товара — такое же, как и при последнем обновлении каталога (в том числе другими способами, не через партнерский API). Enum: `ACTIVE`, `INACTIVE`, `DELISTED`
shelfLife	TimePeriodDTO	Информация о сроке годности: через какое время (в годах, месяцах, днях, неделях или часах) товар станет непригоден для использования. Например, срок годности есть у таких категорий, как продукты питания и медицинские препараты. Обязательный параметр, если у товара есть срок годности. Внимание Если у товара есть срок годности, а вы не укажете его, товар будет скрыт с Маркета.
lifeTime	TimePeriodDTO	Информация о сроке службы: в течение какого периода (в годах, месяцах, днях, неделях или часах) товар будет исправно выполнять свою функцию, а изготовитель — нести ответственность за его существенные недостатки. Обязательный параметр, если у товара есть срок службы. Внимание Если у товара есть срок службы, а вы не укажете его, товар будет скрыт с Маркета.
guaranteePeriod	TimePeriodDTO	Информация о гарантийном сроке: в течение какого периода (в годах, месяцах, днях, неделях или часах) возможны обслуживание и ремонт товара или возврат денег, а изготовитель или продавец будет нести ответственность за недостатки товара. Обязательный параметр, если у товара есть гарантийный срок. Внимание Если у товара есть гарантийный срок, а вы не укажете его, товар будет скрыт с Маркета.
certificate	string	Номер документа на товар. Перед указанием номера документ нужно загрузить в личном кабинете магазина. Инструкция
price	number	Цена товара в рублях.
marketCategoryId	integer<int64>	Идентификатор категории для рекомендованной карточки товара на Маркете. Возвращается только вместе с параметром `marketSku`.
marketCategoryName	string	Название категории для рекомендованной карточки товара на Маркете. Может отсутствовать в ответе.
marketModelId	integer<int64>	Идентификатор модели для рекомендованной карточки товара на Маркете. Может отсутствовать в ответе.
marketModelName	string	Название модели для рекомендованной карточки товара на Маркете. Возвращается только вместе с параметром `marketSku`.
marketSku	integer<int64>	SKU на Маркете — идентификатор рекомендованной карточки товара на Маркете. Параметр возвращается, если для товара нашлась карточка. Если параметра нет в ответе, возможно, товар еще не продается на Маркете или вы передали неполные (некорректные) данные в запросе.
marketSkuName	string	Название товара с рекомендованной карточки на Маркете. Может отсутствовать в ответе.

400 Bad Request

Запрос содержит неправильные данные.

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

ApiErrorDTO

Общий формат ошибки.

Name	Type	Description
code*	string	Код ошибки.
message	string	Описание ошибки.

401 Unauthorized

В запросе не указаны данные для авторизации.

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

403 Forbidden

Данные для авторизации неверны или доступ к ресурсу запрещен.

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

404 Not Found

Запрашиваемый ресурс не найден.

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

420 Method Failure

Превышено ограничение на доступ к ресурсу.

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

500 Internal Server Error

Внутренняя ошибка сервера.

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

Рекомендованные карточки для ваших товаров

RequestRequest

Path parametersPath parameters

BodyBody

MappingsOfferDTOMappingsOfferDTO

OfferWeightDimensionsDTOOfferWeightDimensionsDTO

DayOfWeekTypeDayOfWeekType

OfferProcessingStateDTOOfferProcessingStateDTO

OfferAvailabilityStatusTypeOfferAvailabilityStatusType

TimePeriodDTOTimePeriodDTO

OfferProcessingStatusTypeOfferProcessingStatusType

OfferProcessingNoteDTOOfferProcessingNoteDTO

TimeUnitTypeTimeUnitType

OfferProcessingNoteTypeOfferProcessingNoteType

ResponsesResponses

200 OK200 OK

BodyBody

ApiResponseStatusTypeApiResponseStatusType

OfferMappingSuggestionsListDTOOfferMappingSuggestionsListDTO

EnrichedMappingsOfferDTOEnrichedMappingsOfferDTO

400 Bad Request400 Bad Request

BodyBody

ApiErrorDTOApiErrorDTO

401 Unauthorized401 Unauthorized

BodyBody

403 Forbidden403 Forbidden

BodyBody

404 Not Found404 Not Found

BodyBody

420 Method Failure420 Method Failure

BodyBody

500 Internal Server Error500 Internal Server Error

BodyBody

Была ли статья полезна?

Request

Path parameters

Body

MappingsOfferDTO

OfferWeightDimensionsDTO

DayOfWeekType

OfferProcessingStateDTO

OfferAvailabilityStatusType

TimePeriodDTO

OfferProcessingStatusType

OfferProcessingNoteDTO

TimeUnitType

OfferProcessingNoteType

Responses

200 OK

Body

ApiResponseStatusType

OfferMappingSuggestionsListDTO

EnrichedMappingsOfferDTO

400 Bad Request

Body

ApiErrorDTO

401 Unauthorized

Body

403 Forbidden

Body

404 Not Found

Body

420 Method Failure

Body

500 Internal Server Error

Body