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

Deprecated

Метод доступен для всех моделей.

Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке

Этот метод устарел

Не используйте его.

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

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

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

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

Полученные SKU можно передать вместе с информацией о ваших товарах с помощью запроса POST businesses/{businessId}/offer-mappings/update.

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

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

Request

POST

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

Path parameters

Name

Description

campaignId*

Type: integer<int64>

Идентификатор магазина в кабинете.

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

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

Min value: 1

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

Description

offers*

Type: MappingsOfferDTO[]

Список товаров.
Информация о товарах в каталоге.
Базовая информация о товарах в каталоге.

Min items: 1

Max items: 500

MappingsOfferDTO

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

Name

Description

availability

Type: OfferAvailabilityStatusType

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

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

Enum: ACTIVE, INACTIVE, DELISTED

barcodes

Type: string[]

Указывайте в виде последовательности цифр. Подойдут коды EAN-13, EAN-8, UPC-A, UPC-E или Code 128.

Для книг указывайте ISBN.

Для товаров определенных категорий и торговых марок штрихкод должен быть действительным кодом GTIN. Обратите внимание: внутренние штрихкоды, начинающиеся на 2 или 02, и коды формата Code 128 не являются GTIN.

Что такое GTIN


Example: 46012300000000

Min items: 1

boxCount

Type: integer<int32>

Сколько мест (если больше одного) занимает товар.

Параметр указывается, только если товар занимает больше одного места (например, кондиционер занимает два места: внешний и внутренний блоки в двух коробках). Если товар занимает одно место, не указывайте этот параметр.

category

⦸

Type: string

Этот параметр устарел

Вместо него используйте marketCategoryId.

Категория товара в вашем магазине.

certificate

Type: string

Номер документа на товар.

Перед указанием номера документ нужно загрузить в кабинете продавца на Маркете. Инструкция

customsCommodityCodes

Type: string[]

Список кодов товара в единой Товарной номенклатуре внешнеэкономической деятельности (ТН ВЭД).

Обязательный параметр, если товар подлежит особому учету (например, в системе «Меркурий» как продукция животного происхождения или в системе «Честный ЗНАК»).

Может содержать только один вложенный код ТН ВЭД.

Min items: 1

deliveryDurationDays

Type: integer<int32>

Срок, за который продавец поставляет товары на склад, в днях.

description

Type: string

Подробное описание товара: например, его преимущества и особенности.

Не давайте в описании инструкций по установке и сборке. Не используйте слова «скидка», «распродажа», «дешевый», «подарок» (кроме подарочных категорий), «бесплатно», «акция», «специальная цена», «новинка», «new», «аналог», «заказ», «хит». Не указывайте никакой контактной информации и не давайте ссылок.

Можно использовать теги:

  • <h>, <h1>, <h2> и так далее — для заголовков;
  • <br> и <p> — для переноса строки;
  • <ol> — для нумерованного списка;
  • <ul> — для маркированного списка;
  • <li> — для создания элементов списка (должен находиться внутри <ol> или <ul>);
  • <div> — поддерживается, но не влияет на отображение текста.

Оптимальная длина — 400–600 символов.

Рекомендации и правила

Max length: 6000

feedId

Type: integer<int64>

Идентификатор фида.

guaranteePeriod

Type: TimePeriodDTO

Информация о гарантийном сроке: в течение какого периода (в годах, месяцах, днях, неделях или часах) возможны обслуживание и ремонт товара или возврат денег, а изготовитель или продавец будет нести ответственность за недостатки товара.

Обязательный параметр, если у товара есть гарантийный срок.

У товара есть гарантийный срок, а вы не укажете его

Товар будет скрыт с Маркета.

guaranteePeriodDays

Type: integer<int32>

Гарантийный срок товара: сколько дней возможно обслуживание и ремонт товара или возврат денег, а изготовитель или продавец будет нести ответственность за недостатки товара.

id

Type: string

Ваш SKU — идентификатор товара в вашей системе.

Правила использования SKU:

  • У каждого товара SKU должен быть свой.

  • Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.

SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов.

Что такое SKU и как его назначать

Min length: 1

Max length: 255

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

lifeTime

Type: TimePeriodDTO

Информация о сроке службы: в течение какого периода (в годах, месяцах, днях, неделях или часах) товар будет исправно выполнять свою функцию, а изготовитель — нести ответственность за его существенные недостатки.

Обязательный параметр, если у товара есть срок службы.

У товара есть срок службы, а вы не укажете его

Товар будет скрыт с Маркета.

lifeTimeDays

⦸

Type: integer<int32>

Этот параметр устарел

Вместо него используйте lifeTime. Совместное использование обоих параметров приведет к ошибке.

Срок службы: сколько дней товар будет исправно выполнять свою функцию, а изготовитель — нести ответственность за его существенные недостатки.

manufacturer

Type: string

Изготовитель товара: компания, которая произвела товар, ее адрес и регистрационный номер (если есть).

Необязательный параметр.

manufacturerCountries

Type: string[]

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

Обязательный параметр.

Должен содержать хотя бы одну, но не больше 5 стран.

Min items: 1

Max items: 5

minShipment

Type: integer<int32>

Минимальное количество единиц товара, которое вы поставляете на склад.

Например, если вы поставляете детское питание партиями минимум по 10 коробок, а в каждой коробке по 6 баночек, укажите значение 60.

name

Type: string

Составляйте название по схеме: тип + бренд или производитель + модель + особенности, если есть (например, цвет, размер или вес) и количество в упаковке.

Не включайте в название условия продажи (например, «скидка», «бесплатная доставка» и т. д.), эмоциональные характеристики («хит», «супер» и т. д.). Не пишите слова большими буквами — кроме устоявшихся названий брендов и моделей.

Оптимальная длина — 50–60 символов.

Рекомендации и правила

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

Max length: 256

pictures

Type: string[]

Ссылки (URL) изображений товара в хорошем качестве.

Можно указать до 30 ссылок. При этом изображение по первой ссылке будет основным. Оно используется в качестве изображения товара в поиске Маркета и на карточке товара. Другие изображения товара доступны в режиме просмотра увеличенных изображений.

Должен содержать хотя бы один вложенный параметр picture.

Min items: 1

price

Type: number

Цена на товар.

processingState

Type: OfferProcessingStateDTO

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

quantumOfSupply

Type: integer<int32>

Добавочная партия: по сколько единиц товара можно добавлять к минимальному количеству minShipment.

Например, если вы поставляете детское питание партиями минимум по 10 коробок и хотите добавлять к минимальной партии по 2 коробки, а в каждой коробке по 6 баночек, укажите значение 12.

shelfLife

Type: TimePeriodDTO

Информация о сроке годности: через какое время (в годах, месяцах, днях, неделях или часах) товар станет непригоден для использования. Например, срок годности есть у таких категорий, как продукты питания и медицинские препараты.

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

У товара есть срок годности, а вы не укажете его

Товар будет скрыт с Маркета.

shelfLifeDays

⦸

Type: integer<int32>

Этот параметр устарел

Вместо него используйте shelfLife. Совместное использование обоих параметров приведет к ошибке.

Срок годности: через сколько дней товар станет непригоден для использования.

shopSku

Type: string

Ваш SKU — идентификатор товара в вашей системе.

Правила использования SKU:

  • У каждого товара SKU должен быть свой.

  • Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.

SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов.

Что такое SKU и как его назначать

Min length: 1

Max length: 255

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

supplyScheduleDays

Type: DayOfWeekType[]

Дни недели, в которые продавец поставляет товары на склад.
День недели:

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

Enum: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY

Min items: 1

transportUnitSize

Type: integer<int32>

Количество единиц товара в одной упаковке, которую вы поставляете на склад.

Например, если вы поставляете детское питание коробками по 6 баночек, укажите значение 6.

urls

Type: string[]

URL фотографии товара или страницы с описанием на вашем сайте.

Переданные данные не будут отображаться на витрине, но они помогут специалистам Маркета найти карточку для вашего товара.

Должен содержать один вложенный параметр url.

Min items: 1

vendor

Type: string

Название бренда или производителя. Должно быть записано так, как его пишет сам бренд.

Example: LEVENHUK

vendorCode

Type: string

Артикул товара от производителя.

Example: VNDR-0005A

weightDimensions

Type: OfferWeightDimensionsDTO

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

OfferAvailabilityStatusType

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

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

Type

Description

OfferAvailabilityStatusType

Enum: ACTIVE, INACTIVE, DELISTED

TimePeriodDTO

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

Name

Description

timePeriod*

Type: integer

Продолжительность в указанных единицах.

timeUnit*

Type: TimeUnitType

Единица измерения.

Enum: HOUR, DAY, WEEK, MONTH, YEAR

comment

Type: string

Комментарий.

OfferProcessingStateDTO

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

Name

Description

notes

Type: OfferProcessingNoteDTO[]

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

Min items: 1

status

Type: OfferProcessingStatusType

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

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

Enum: UNKNOWN, READY, IN_WORK, NEED_INFO, NEED_MAPPING, NEED_CONTENT, CONTENT_PROCESSING, SUSPENDED, REJECTED, REVIEW, CREATE_ERROR, UPDATE_ERROR

DayOfWeekType

День недели:

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

Type

Description

DayOfWeekType

Enum: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY

OfferWeightDimensionsDTO

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

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

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

Name

Description

height*

Type: number

Высота упаковки в см.

Example: 20

length*

Type: number

Длина упаковки в см.

Example: 65.55

weight*

Type: number

Вес товара в кг с учетом упаковки (брутто).

Example: 1.001

width*

Type: number

Ширина упаковки в см.

Example: 50.7

TimeUnitType

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

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

Type

Description

TimeUnitType

Enum: HOUR, DAY, WEEK, MONTH, YEAR

OfferProcessingNoteDTO

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

Name

Description

payload

Type: string

Дополнительная информация о причине отклонения товара.

type

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

OfferProcessingStatusType

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

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

Type

Description

OfferProcessingStatusType

Enum: UNKNOWN, READY, IN_WORK, NEED_INFO, NEED_MAPPING, NEED_CONTENT, CONTENT_PROCESSING, SUSPENDED, REJECTED, REVIEW, CREATE_ERROR, UPDATE_ERROR

OfferProcessingNoteType

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

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

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

Responses

200 OK

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

Body

application/json
{
    "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

Description

result

Type: OfferMappingSuggestionsListDTO

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

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR

OfferMappingSuggestionsListDTO

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

Name

Description

offers*

Type: EnrichedMappingsOfferDTO[]

Список товаров.
Информация о рекомендованных карточках товаров.
Информация о товарах в каталоге.

ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Type

Description

ApiResponseStatusType

Enum: OK, ERROR

EnrichedMappingsOfferDTO

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

Name

Description

availability

Type: OfferAvailabilityStatusType

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

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

Enum: ACTIVE, INACTIVE, DELISTED

barcodes

Type: string[]

Указывайте в виде последовательности цифр. Подойдут коды EAN-13, EAN-8, UPC-A, UPC-E или Code 128.

Для книг указывайте ISBN.

Для товаров определенных категорий и торговых марок штрихкод должен быть действительным кодом GTIN. Обратите внимание: внутренние штрихкоды, начинающиеся на 2 или 02, и коды формата Code 128 не являются GTIN.

Что такое GTIN


Example: 46012300000000

Min items: 1

boxCount

Type: integer<int32>

Сколько мест (если больше одного) занимает товар.

Параметр указывается, только если товар занимает больше одного места (например, кондиционер занимает два места: внешний и внутренний блоки в двух коробках). Если товар занимает одно место, не указывайте этот параметр.

category

⦸

Type: string

Этот параметр устарел

Вместо него используйте marketCategoryId.

Категория товара в вашем магазине.

certificate

Type: string

Номер документа на товар.

Перед указанием номера документ нужно загрузить в кабинете продавца на Маркете. Инструкция

customsCommodityCodes

Type: string[]

Список кодов товара в единой Товарной номенклатуре внешнеэкономической деятельности (ТН ВЭД).

Обязательный параметр, если товар подлежит особому учету (например, в системе «Меркурий» как продукция животного происхождения или в системе «Честный ЗНАК»).

Может содержать только один вложенный код ТН ВЭД.

Min items: 1

deliveryDurationDays

Type: integer<int32>

Срок, за который продавец поставляет товары на склад, в днях.

description

Type: string

Подробное описание товара: например, его преимущества и особенности.

Не давайте в описании инструкций по установке и сборке. Не используйте слова «скидка», «распродажа», «дешевый», «подарок» (кроме подарочных категорий), «бесплатно», «акция», «специальная цена», «новинка», «new», «аналог», «заказ», «хит». Не указывайте никакой контактной информации и не давайте ссылок.

Можно использовать теги:

  • <h>, <h1>, <h2> и так далее — для заголовков;
  • <br> и <p> — для переноса строки;
  • <ol> — для нумерованного списка;
  • <ul> — для маркированного списка;
  • <li> — для создания элементов списка (должен находиться внутри <ol> или <ul>);
  • <div> — поддерживается, но не влияет на отображение текста.

Оптимальная длина — 400–600 символов.

Рекомендации и правила

Max length: 6000

feedId

Type: integer<int64>

Идентификатор фида.

guaranteePeriod

Type: TimePeriodDTO

Информация о гарантийном сроке: в течение какого периода (в годах, месяцах, днях, неделях или часах) возможны обслуживание и ремонт товара или возврат денег, а изготовитель или продавец будет нести ответственность за недостатки товара.

Обязательный параметр, если у товара есть гарантийный срок.

У товара есть гарантийный срок, а вы не укажете его

Товар будет скрыт с Маркета.

guaranteePeriodDays

Type: integer<int32>

Гарантийный срок товара: сколько дней возможно обслуживание и ремонт товара или возврат денег, а изготовитель или продавец будет нести ответственность за недостатки товара.

id

Type: string

Ваш SKU — идентификатор товара в вашей системе.

Правила использования SKU:

  • У каждого товара SKU должен быть свой.

  • Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.

SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов.

Что такое SKU и как его назначать

Min length: 1

Max length: 255

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

lifeTime

Type: TimePeriodDTO

Информация о сроке службы: в течение какого периода (в годах, месяцах, днях, неделях или часах) товар будет исправно выполнять свою функцию, а изготовитель — нести ответственность за его существенные недостатки.

Обязательный параметр, если у товара есть срок службы.

У товара есть срок службы, а вы не укажете его

Товар будет скрыт с Маркета.

lifeTimeDays

⦸

Type: integer<int32>

Этот параметр устарел

Вместо него используйте lifeTime. Совместное использование обоих параметров приведет к ошибке.

Срок службы: сколько дней товар будет исправно выполнять свою функцию, а изготовитель — нести ответственность за его существенные недостатки.

manufacturer

Type: string

Изготовитель товара: компания, которая произвела товар, ее адрес и регистрационный номер (если есть).

Необязательный параметр.

manufacturerCountries

Type: string[]

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

Обязательный параметр.

Должен содержать хотя бы одну, но не больше 5 стран.

Min items: 1

Max items: 5

marketCategoryId

Type: integer<int64>

Идентификатор категории для рекомендованной карточки товара на Маркете.

Возвращается только вместе с параметром marketSku.

marketCategoryName

Type: string

Название категории для рекомендованной карточки товара на Маркете.

Может отсутствовать в ответе.

marketModelId

⦸

Type: integer<int64>

Этот параметр устарел

Не используйте его.

Идентификатор модели для рекомендованной карточки товара на Маркете.

Может отсутствовать в ответе.

marketModelName

⦸

Type: string

Этот параметр устарел

Не используйте его.

Название модели для рекомендованной карточки товара на Маркете.

Возвращается только вместе с параметром marketSku.

marketSku

Type: integer<int64>

SKU на Маркете — идентификатор рекомендованной карточки товара на Маркете.

Параметр возвращается, если для товара нашлась карточка. Если параметра нет в ответе, возможно, товар еще не продается на Маркете или вы передали неполные (некорректные) данные в запросе.

Min value: 1

marketSkuName

Type: string

Название товара с рекомендованной карточки на Маркете.

Может отсутствовать в ответе.

minShipment

Type: integer<int32>

Минимальное количество единиц товара, которое вы поставляете на склад.

Например, если вы поставляете детское питание партиями минимум по 10 коробок, а в каждой коробке по 6 баночек, укажите значение 60.

name

Type: string

Составляйте название по схеме: тип + бренд или производитель + модель + особенности, если есть (например, цвет, размер или вес) и количество в упаковке.

Не включайте в название условия продажи (например, «скидка», «бесплатная доставка» и т. д.), эмоциональные характеристики («хит», «супер» и т. д.). Не пишите слова большими буквами — кроме устоявшихся названий брендов и моделей.

Оптимальная длина — 50–60 символов.

Рекомендации и правила

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

Max length: 256

pictures

Type: string[]

Ссылки (URL) изображений товара в хорошем качестве.

Можно указать до 30 ссылок. При этом изображение по первой ссылке будет основным. Оно используется в качестве изображения товара в поиске Маркета и на карточке товара. Другие изображения товара доступны в режиме просмотра увеличенных изображений.

Должен содержать хотя бы один вложенный параметр picture.

Min items: 1

price

Type: number

Цена на товар.

processingState

Type: OfferProcessingStateDTO

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

quantumOfSupply

Type: integer<int32>

Добавочная партия: по сколько единиц товара можно добавлять к минимальному количеству minShipment.

Например, если вы поставляете детское питание партиями минимум по 10 коробок и хотите добавлять к минимальной партии по 2 коробки, а в каждой коробке по 6 баночек, укажите значение 12.

shelfLife

Type: TimePeriodDTO

Информация о сроке годности: через какое время (в годах, месяцах, днях, неделях или часах) товар станет непригоден для использования. Например, срок годности есть у таких категорий, как продукты питания и медицинские препараты.

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

У товара есть срок годности, а вы не укажете его

Товар будет скрыт с Маркета.

shelfLifeDays

⦸

Type: integer<int32>

Этот параметр устарел

Вместо него используйте shelfLife. Совместное использование обоих параметров приведет к ошибке.

Срок годности: через сколько дней товар станет непригоден для использования.

shopSku

Type: string

Ваш SKU — идентификатор товара в вашей системе.

Правила использования SKU:

  • У каждого товара SKU должен быть свой.

  • Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.

SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов.

Что такое SKU и как его назначать

Min length: 1

Max length: 255

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

supplyScheduleDays

Type: DayOfWeekType[]

Дни недели, в которые продавец поставляет товары на склад.
День недели:

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

Enum: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY

Min items: 1

transportUnitSize

Type: integer<int32>

Количество единиц товара в одной упаковке, которую вы поставляете на склад.

Например, если вы поставляете детское питание коробками по 6 баночек, укажите значение 6.

urls

Type: string[]

URL фотографии товара или страницы с описанием на вашем сайте.

Переданные данные не будут отображаться на витрине, но они помогут специалистам Маркета найти карточку для вашего товара.

Должен содержать один вложенный параметр url.

Min items: 1

vendor

Type: string

Название бренда или производителя. Должно быть записано так, как его пишет сам бренд.

Example: LEVENHUK

vendorCode

Type: string

Артикул товара от производителя.

Example: VNDR-0005A

weightDimensions

Type: OfferWeightDimensionsDTO

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

400 Bad Request

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

Body

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

Name

Description

errors

Type: ApiErrorDTO[]

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

Min items: 1

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR

ApiErrorDTO

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

Name

Description

code*

Type: string

Код ошибки.

message

Type: string

Описание ошибки.

401 Unauthorized

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

Body

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

Name

Description

errors

Type: ApiErrorDTO[]

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

Min items: 1

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR

403 Forbidden

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

Body

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

Name

Description

errors

Type: ApiErrorDTO[]

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

Min items: 1

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR

404 Not Found

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

Body

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

Name

Description

errors

Type: ApiErrorDTO[]

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

Min items: 1

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR

420 Method Failure

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

Body

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

Name

Description

errors

Type: ApiErrorDTO[]

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

Min items: 1

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR

500 Internal Server Error

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

Body

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

Name

Description

errors

Type: ApiErrorDTO[]

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

Min items: 1

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR
Предыдущая
Список товаров
Следующая
Просмотр подходящих карточек