Добавление и редактирование товаров в каталоге

Deprecated

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

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

Какой метод использовать вместо устаревшего

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

Информацию о товарах нужно передать в теле POST-запроса.

У каждого товара должен быть ваш SKU — уникальный код, который вы используете для идентификации товара:

  • Чтобы добавить в каталог новый товар, укажите в параметре shopSku ваш SKU, которого еще нет в каталоге.
  • Чтобы отредактировать товар из каталога, укажите в параметре shopSku ваш SKU этого товара в каталоге.

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

Если вы знаете, какой карточке товара на Маркете соответствует ваш товар, укажите ее идентификатор (SKU на Маркете) во входном параметре mapping. Получить SKU на Маркете рекомендованной карточки товара можно через кабинет. Если SKU на Маркете не указан, сотрудники Маркета сами подберут или создадут подходящую карточку товара, либо у него появится статус NEED_CONTENT (нужно найти карточку или создать ее самостоятельно) в выходных данных запроса POST v2/businesses/{businessId}/offer-mappings.

Перед публикацией товары проходят модерацию. Если в одном из отправленных товаров найдена ошибка, ответ на запрос будет иметь HTTP-код 400 Bad Request, и ни один из товаров не отправится на модерацию. При этом если вы не передадите все обязательные параметры для какого‑либо товара, после модерации у него появится статус NEED_INFO (в описании товара не хватает информации) в выходных данных запроса POST v2/businesses/{businessId}/offer-mappings.

В одном запросе можно добавить не более 500 товаров.

Данные в каталоге обновляются не мгновенно

Это занимает до нескольких минут.

⚙️ Лимит: 5 000 товаров в минуту

Request

POST

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

Path parameters

Name

Description

campaignId

Type: integer

Идентификатор кампании (магазина) — технический идентификатор, который представляет ваш магазин в системе Яндекс Маркета при работе через API. Он однозначно связывается с вашим магазином, но предназначен только для автоматизированного взаимодействия.

Его можно узнать с помощью запроса GET v2/campaigns или найти в кабинете продавца на Маркете. Нажмите на иконку вашего аккаунта → Настройки и в меню слева выберите API и модули:

  • блок Идентификатор кампании;
  • вкладка Лог запросов → выпадающий список в блоке Показывать логи.

⚠️ Не путайте его с:

  • идентификатором магазина, который отображается в личном кабинете продавца;
  • рекламными кампаниями.

Min value: 1

Body

application/json
{
  "offerMappingEntries": [
    {
      "offer": {}
    }
  ]
}

Name

Description

offerMappingEntries

Type: UpdateOfferMappingEntryDTO[]

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

Min items: 1

Max items: 500

Example
[
  {
    "offer": {
      "name": "Ударная дрель Makita HP1630, 710 Вт",
      "shopSku": "example",
      "category": "example",
      "vendor": "LEVENHUK",
      "vendorCode": "VNDR-0005A",
      "description": "example",
      "id": null,
      "feedId": 0,
      "barcodes": [
        null
      ],
      "urls": [
        null
      ],
      "pictures": [
        null
      ],
      "manufacturer": "example",
      "manufacturerCountries": [
        null
      ],
      "minShipment": 0,
      "transportUnitSize": 0,
      "quantumOfSupply": 0,
      "deliveryDurationDays": 0,
      "boxCount": 0,
      "customsCommodityCodes": [
        null
      ],
      "weightDimensions": {},
      "supplyScheduleDays": [
        null
      ],
      "shelfLifeDays": 0,
      "lifeTimeDays": 0,
      "guaranteePeriodDays": 0,
      "processingState": {},
      "availability": "ACTIVE",
      "shelfLife": {},
      "lifeTime": null,
      "guaranteePeriod": null,
      "certificate": "example"
    }
  }
]

OfferName

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

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

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

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

Type: string

Max length: 256

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

ShopSku

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

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

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

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

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

Важно

Пробельные символы в начале и конце значения автоматически удаляются. Например, " SKU123 " и "SKU123" будут обработаны как одинаковые значения.

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

Type: string

Min length: 1

Max length: 255

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

Example: example

OfferCategory

Deprecated

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

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

Type: string

Example: example

OfferVendor

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

Type: string

Example: LEVENHUK

OfferVendorCode

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

Type: string

Example: VNDR-0005A

OfferDescription

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

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

Для форматирования текста можно использовать теги HTML:

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

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

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

Type: string

Max length: 6000

Example: example

OfferBarcodes

Штрихкод.

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

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

Что такое GTIN

Type: string[] | null

Min items: 1

Unique items: true

Example
[
  "46012300000000"
]

Url

Type: string

Min length: 1

Max length: 2000

Example: example

OfferWeightDimensionsDTO

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

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

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

Name

Description

height

Type: number

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

Min value: 0

length

Type: number

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

Min value: 0

weight

Type: number

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

Min value: 0

width

Type: number

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

Min value: 0

Example
{
  "length": 65.55,
  "width": 50.7,
  "height": 20,
  "weight": 1.001
}

DayOfWeekType

День недели:

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

Type: string

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

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: string

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

OfferProcessingNoteType

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

  • ASSORTMENT — товар производится в разных вариантах. Каждый из них нужно описать как отдельный товар (параметр offerMappings в запросе POST v2/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 v2/businesses/{businessId}/offer-mappings/update или загрузите обновленный каталог через кабинет продавца на Маркете.
  • NEED_VENDOR — неверно указан производитель товара.
  • NO_CATEGORY, NO_KNOWLEDGE — товары из указанной категории пока не размещаются на Маркете. Если категория появится, товар будет снова отправлен на модерацию.
  • NO_PARAMETERS_IN_SHOP_TITLE — товар производится в разных вариантах, и из указанного названия непонятно, о каком идет речь. Параметры, которые нужно добавить в название товара, указаны в параметре payload.
  • NO_SIZE_MEASURE — для этого товара нужна размерная сетка. Отправьте ее в службу поддержки или вашему менеджеру. Требования к размерной сетке указаны в параметре payload.
  • SAMPLE_LINE — товар не прошел модерацию из-за лишней строки.

Type: string

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

OfferProcessingNoteDTO

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

Name

Description

payload

Type: string

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

Example: example

type

Type: OfferProcessingNoteType

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

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

  • ASSORTMENT — товар производится в разных вариантах. Каждый из них нужно описать как отдельный товар (параметр offerMappings в запросе POST v2/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 v2/businesses/{businessId}/offer-mappings/update или загрузите обновленный каталог через кабинет продавца на Маркете.
  • NEED_VENDOR — неверно указан производитель товара.
  • NO_CATEGORY, NO_KNOWLEDGE — товары из указанной категории пока не размещаются на Маркете. Если категория появится, товар будет снова отправлен на модерацию.
  • NO_PARAMETERS_IN_SHOP_TITLE — товар производится в разных вариантах, и из указанного названия непонятно, о каком идет речь. Параметры, которые нужно добавить в название товара, указаны в параметре payload.
  • NO_SIZE_MEASURE — для этого товара нужна размерная сетка. Отправьте ее в службу поддержки или вашему менеджеру. Требования к размерной сетке указаны в параметре payload.
  • SAMPLE_LINE — товар не прошел модерацию из-за лишней строки.

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

Example
{
  "type": "ASSORTMENT",
  "payload": "example"
}

OfferProcessingStateDTO

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

Name

Description

notes

Type: OfferProcessingNoteDTO[] | null

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

Min items: 1

Example
[
  {
    "type": "ASSORTMENT",
    "payload": "example"
  }
]

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

Example
{
  "status": "UNKNOWN",
  "notes": [
    {
      "type": "ASSORTMENT",
      "payload": "example"
    }
  ]
}

OfferAvailabilityStatusType

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

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

Type: string

Enum: ACTIVE, INACTIVE, DELISTED

TimeUnitType

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

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

Type: string

Enum: HOUR, DAY, WEEK, MONTH, YEAR

TimePeriodDTO

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

Name

Description

timePeriod

Type: integer

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

timeUnit

Type: TimeUnitType

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

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

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

Enum: HOUR, DAY, WEEK, MONTH, YEAR

comment

Type: string

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

Max length: 500

Example: example

Example
{
  "timePeriod": 0,
  "timeUnit": "HOUR",
  "comment": "example"
}

MappingsOfferInfoDTO

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

Name

Description

availability

Type: OfferAvailabilityStatusType

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

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

Значения по умолчанию:

  • при добавлении товара — ACTIVE;
  • при редактировании товара — такое же, как и при последнем обновлении каталога (в том числе другими способами, не через API).

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

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

Enum: ACTIVE, INACTIVE, DELISTED

barcodes

Type: OfferBarcodes

Штрихкод.

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

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

Что такое GTIN

Min items: 1

Unique items: true

Example
[
  "46012300000000"
]

boxCount

Type: integer

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

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

category

Type: OfferCategory

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

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

Example: example

certificate

Type: string

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

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

Example: example

customsCommodityCodes

Type: string[] | null

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

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

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

Min items: 1

Unique items: true

Example
[
  "example"
]

deliveryDurationDays

Type: integer

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

description

Type: OfferDescription

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

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

Для форматирования текста можно использовать теги HTML:

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

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

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

Max length: 6000

Example: example

feedId

Type: integer

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

guaranteePeriod

Type: TimePeriodDTO

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

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

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

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

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

Example
{
  "timePeriod": 0,
  "timeUnit": "HOUR",
  "comment": "example"
}

guaranteePeriodDays

Type: integer

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

id

Type: ShopSku

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

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

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

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

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

Важно

Пробельные символы в начале и конце значения автоматически удаляются. Например, " SKU123 " и "SKU123" будут обработаны как одинаковые значения.

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

Min length: 1

Max length: 255

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

Example: example

lifeTime

Type: TimePeriodDTO

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

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

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

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

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

Example
{
  "timePeriod": 0,
  "timeUnit": "HOUR",
  "comment": "example"
}

lifeTimeDays

Type: integer

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

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

manufacturer

Type: string

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

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

Example: example

manufacturerCountries

Type: string[] | null

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

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

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

Min items: 1

Max items: 5

Unique items: true

Example
[
  "example"
]

minShipment

Type: integer

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

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

name

Type: OfferName

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

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

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

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

Max length: 256

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

pictures

Type: Url[] | null

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

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

Min items: 1

Max items: 30

Example
[
  "example"
]

processingState

Type: OfferProcessingStateDTO

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

Example
{
  "status": "UNKNOWN",
  "notes": [
    {
      "type": "ASSORTMENT",
      "payload": "example"
    }
  ]
}

quantumOfSupply

Type: integer

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

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

shelfLife

Type: TimePeriodDTO

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

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

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

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

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

Example
{
  "timePeriod": 0,
  "timeUnit": "HOUR",
  "comment": "example"
}

shelfLifeDays

Type: integer

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

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

shopSku

Type: ShopSku

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

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

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

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

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

Важно

Пробельные символы в начале и конце значения автоматически удаляются. Например, " SKU123 " и "SKU123" будут обработаны как одинаковые значения.

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

Min length: 1

Max length: 255

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

Example: example

supplyScheduleDays

Type: DayOfWeekType[] | null

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

Min items: 1

Unique items: true

Example
[
  "MONDAY"
]

transportUnitSize

Type: integer

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

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

urls

Type: Url[] | null

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

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

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

Min items: 1

Unique items: true

Example
[
  "example"
]

vendor

Type: OfferVendor

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

Example: LEVENHUK

vendorCode

Type: OfferVendorCode

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

Example: VNDR-0005A

weightDimensions

Type: OfferWeightDimensionsDTO

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

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

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

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

Example
{
  "length": 65.55,
  "width": 50.7,
  "height": 20,
  "weight": 1.001
}
Example
{
  "name": "Ударная дрель Makita HP1630, 710 Вт",
  "shopSku": "example",
  "category": "example",
  "vendor": "LEVENHUK",
  "vendorCode": "VNDR-0005A",
  "description": "example",
  "id": null,
  "feedId": 0,
  "barcodes": [
    "46012300000000"
  ],
  "urls": [
    "example"
  ],
  "pictures": [
    null
  ],
  "manufacturer": "example",
  "manufacturerCountries": [
    "example"
  ],
  "minShipment": 0,
  "transportUnitSize": 0,
  "quantumOfSupply": 0,
  "deliveryDurationDays": 0,
  "boxCount": 0,
  "customsCommodityCodes": [
    "example"
  ],
  "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": "example"
      }
    ]
  },
  "availability": "ACTIVE",
  "shelfLife": {
    "timePeriod": 0,
    "timeUnit": "HOUR",
    "comment": "example"
  },
  "lifeTime": null,
  "guaranteePeriod": null,
  "certificate": "example"
}

UpdateMappingsOfferDTO

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

Type: object

All of 1 type
  • Type: MappingsOfferInfoDTO

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

    Example
    {
      "name": "Ударная дрель Makita HP1630, 710 Вт",
      "shopSku": "example",
      "category": "example",
      "vendor": "LEVENHUK",
      "vendorCode": "VNDR-0005A",
      "description": "example",
      "id": null,
      "feedId": 0,
      "barcodes": [
        "46012300000000"
      ],
      "urls": [
        "example"
      ],
      "pictures": [
        null
      ],
      "manufacturer": "example",
      "manufacturerCountries": [
        "example"
      ],
      "minShipment": 0,
      "transportUnitSize": 0,
      "quantumOfSupply": 0,
      "deliveryDurationDays": 0,
      "boxCount": 0,
      "customsCommodityCodes": [
        "example"
      ],
      "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": "example"
          }
        ]
      },
      "availability": "ACTIVE",
      "shelfLife": {
        "timePeriod": 0,
        "timeUnit": "HOUR",
        "comment": "example"
      },
      "lifeTime": null,
      "guaranteePeriod": null,
      "certificate": "example"
    }
    
Example
{
  "name": "Ударная дрель Makita HP1630, 710 Вт",
  "shopSku": "example",
  "category": "example",
  "vendor": "LEVENHUK",
  "vendorCode": "VNDR-0005A",
  "description": "example",
  "id": null,
  "feedId": 0,
  "barcodes": [
    "46012300000000"
  ],
  "urls": [
    "example"
  ],
  "pictures": [
    null
  ],
  "manufacturer": "example",
  "manufacturerCountries": [
    "example"
  ],
  "minShipment": 0,
  "transportUnitSize": 0,
  "quantumOfSupply": 0,
  "deliveryDurationDays": 0,
  "boxCount": 0,
  "customsCommodityCodes": [
    "example"
  ],
  "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": "example"
      }
    ]
  },
  "availability": "ACTIVE",
  "shelfLife": {
    "timePeriod": 0,
    "timeUnit": "HOUR",
    "comment": "example"
  },
  "lifeTime": null,
  "guaranteePeriod": null,
  "certificate": "example"
}

MarketSku

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

Type: integer

Min value: 1

OfferMappingDTO

Информация о текущей карточке товара на Маркете.

Name

Description

categoryId

Type: integer

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

marketSku

Type: MarketSku

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

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

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

Min value: 1

Example: 1

modelId

Type: integer

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

Например, две лопатки разных цветов имеют разные SKU на Маркете (параметр marketSku), но одинаковый идентификатор модели товара.

Example
{
  "marketSku": 1,
  "modelId": 0,
  "categoryId": 0
}

OfferMappingInfoDTO

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

Name

Description

awaitingModerationMapping

Type: OfferMappingDTO

Информация о карточке товара на Маркете, проходящей модерацию для данного товара

Информация о текущей карточке товара на Маркете.

Example
{
  "marketSku": 1,
  "modelId": 0,
  "categoryId": 0
}

mapping

Type: OfferMappingDTO

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

Если параметр не указан, сотрудники Маркета сами подберут или создадут подходящую карточку товара, либо у него появится статус NEED_CONTENT (нужно найти карточку или создать ее самостоятельно) в выходных данных запроса POST v2/businesses/{businessId}/offer-mappings.

Информация о текущей карточке товара на Маркете.

Example
{
  "marketSku": 1,
  "modelId": 0,
  "categoryId": 0
}

rejectedMapping

Type: OfferMappingDTO

Информация о последней карточке товара на Маркете, отклоненной на модерации для данного товара

Информация о текущей карточке товара на Маркете.

Example
{
  "marketSku": 1,
  "modelId": 0,
  "categoryId": 0
}
Example
{
  "mapping": {
    "marketSku": 1,
    "modelId": 0,
    "categoryId": 0
  },
  "awaitingModerationMapping": null,
  "rejectedMapping": null
}

UpdateOfferMappingEntryDTO

Список товаров.

Type: object

All of 2 types
  • Type: object

    offer

    Type: UpdateMappingsOfferDTO

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

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

    Example
    {
      "name": "Ударная дрель Makita HP1630, 710 Вт",
      "shopSku": "example",
      "category": "example",
      "vendor": "LEVENHUK",
      "vendorCode": "VNDR-0005A",
      "description": "example",
      "id": null,
      "feedId": 0,
      "barcodes": [
        "46012300000000"
      ],
      "urls": [
        "example"
      ],
      "pictures": [
        null
      ],
      "manufacturer": "example",
      "manufacturerCountries": [
        "example"
      ],
      "minShipment": 0,
      "transportUnitSize": 0,
      "quantumOfSupply": 0,
      "deliveryDurationDays": 0,
      "boxCount": 0,
      "customsCommodityCodes": [
        "example"
      ],
      "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": "example"
          }
        ]
      },
      "availability": "ACTIVE",
      "shelfLife": {
        "timePeriod": 0,
        "timeUnit": "HOUR",
        "comment": "example"
      },
      "lifeTime": null,
      "guaranteePeriod": null,
      "certificate": "example"
    }
    
    Example
    {
      "offer": {
        "name": "Ударная дрель Makita HP1630, 710 Вт",
        "shopSku": "example",
        "category": "example",
        "vendor": "LEVENHUK",
        "vendorCode": "VNDR-0005A",
        "description": "example",
        "id": null,
        "feedId": 0,
        "barcodes": [
          "46012300000000"
        ],
        "urls": [
          "example"
        ],
        "pictures": [
          null
        ],
        "manufacturer": "example",
        "manufacturerCountries": [
          "example"
        ],
        "minShipment": 0,
        "transportUnitSize": 0,
        "quantumOfSupply": 0,
        "deliveryDurationDays": 0,
        "boxCount": 0,
        "customsCommodityCodes": [
          "example"
        ],
        "weightDimensions": {
          "length": 65.55,
          "width": 50.7,
          "height": 20,
          "weight": 1.001
        },
        "supplyScheduleDays": [
          "MONDAY"
        ],
        "shelfLifeDays": 0,
        "lifeTimeDays": 0,
        "guaranteePeriodDays": 0,
        "processingState": {
          "status": "UNKNOWN",
          "notes": [
            {}
          ]
        },
        "availability": "ACTIVE",
        "shelfLife": {
          "timePeriod": 0,
          "timeUnit": "HOUR",
          "comment": "example"
        },
        "lifeTime": null,
        "guaranteePeriod": null,
        "certificate": "example"
      }
    }
    
  • Type: OfferMappingInfoDTO

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

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

Responses

200 OK

Статус выполнения операции.

Body

application/json
{
  "status": "OK"
}

Type: object

ApiResponseStatusType

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

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

Type: string

Enum: OK, ERROR

ApiResponse

Стандартная обертка для ответов сервера.

Name

Description

status

Type: ApiResponseStatusType

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

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

Enum: OK, ERROR

Example
{
  "status": "OK"
}

400 Bad Request

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

Body

application/json
{
  "status": "OK"
}

Type: object

ApiErrorDTO

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

Name

Description

code

Type: string

Код ошибки.

Example: example

message

Type: string

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

Example: example

Example
{
  "code": "example",
  "message": "example"
}

ApiErrorResponse

Стандартная обертка для ошибок сервера.

Type: object

All of 2 types
  • Type: ApiResponse

    Стандартная обертка для ответов сервера.

    Example
    {
      "status": "OK"
    }
    
  • Type: object

    errors

    Type: ApiErrorDTO[] | null

    Список ошибок.

    Min items: 1

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

401 Unauthorized

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

Body

application/json
{
  "status": "OK"
}

Type: object

403 Forbidden

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

Body

application/json
{
  "status": "OK"
}

Type: object

404 Not Found

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

Body

application/json
{
  "status": "OK"
}

Type: object

420 Method Failure

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

Body

application/json
{
  "status": "OK"
}

Type: object

423 Locked

К ресурсу нельзя применить указанный метод. Подробнее об ошибке

Body

application/json
{
  "status": "OK"
}

Type: object

500 Internal Server Error

Внутренняя ошибка Маркета. Подробнее об ошибке

Body

application/json
{
  "status": "OK"
}

Type: object

pathParams:
  - description: "Идентификатор кампании (магазина) — технический идентификатор, который представляет ваш магазин в системе Яндекс Маркета при работе через API. Он однозначно связывается с вашим магазином, но предназначен только для автоматизированного взаимодействия.\n\nЕго можно узнать с помощью запроса [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md) или найти в кабинете продавца на Маркете. Нажмите на иконку вашего аккаунта → **Настройки** и в меню слева выберите **API и модули**:\n\n* блок **Идентификатор кампании**;\n* вкладка **Лог запросов** → выпадающий список в блоке **Показывать логи**.\n\n⚠️ Не путайте его с:\n- идентификатором магазина, который отображается в личном кабинете продавца;\n- рекламными кампаниями.\n"
    name: campaignId
    in: path
    required: true
    schema:
      type: integer
      format: int64
      minimum: 1
searchParams: []
headers: []
body: |-
  {
    "offerMappingEntries": [
      {
        "offer": {}
      }
    ]
  }
schema:
  description: Запрос на обновление товаров.
  type: object
  required:
    - offerMappingEntries
  properties:
    offerMappingEntries:
      description: Информация о товарах в каталоге.
      type: array
      minItems: 1
      maxItems: 500
      items:
        description: |
          Список товаров.
        type: object
        allOf:
          - properties:
              offer:
                description: Информация о товаре из каталога.
                $ref: '#/$defs/UpdateMappingsOfferDTO'
          - description: Информация о карточке товара.
            type: object
            properties:
              mapping:
                description: "Информация о карточке товара на Маркете.\n\nЕсли параметр не указан, сотрудники Маркета сами подберут или создадут подходящую карточку товара, либо у него появится статус `NEED_CONTENT` (нужно найти карточку или создать ее самостоятельно) в выходных данных запроса [POST\_v2/businesses/{businessId}/offer-mappings](../../reference/business-assortment/getOfferMappings.md).\n"
                $ref: '#/$defs/OfferMappingDTO'
              awaitingModerationMapping:
                description: >-
                  Информация о карточке товара на Маркете, проходящей модерацию
                  для данного товара
                $ref: '#/$defs/OfferMappingDTO'
              rejectedMapping:
                description: >-
                  Информация о последней карточке товара на Маркете, отклоненной
                  на модерации для данного товара
                $ref: '#/$defs/OfferMappingDTO'
  $defs:
    /home/sandbox/.ya/build/build_root/4217/00000b/market/mbi/docs/partner-api/docfiles/__docsbuild/.tmp_input/ru/openapi/partner-api-spec/offer-mappings/schemas.yaml#/OfferWeightDimensionsDTO:
      description: >
        Габариты упаковки и вес товара.


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


        ![Схема измерения многоместных
        грузов](../../_images/reference/boxes-measure.png)
      type: object
      required:
        - length
        - width
        - height
        - weight
      properties:
        length:
          description: |
            Длина упаковки в см.
          example: 65.55
          type: number
          minimum: 0
        width:
          description: |
            Ширина упаковки в см.
          example: 50.7
          type: number
          minimum: 0
        height:
          description: |
            Высота упаковки в см.
          example: 20
          type: number
          minimum: 0
        weight:
          description: |
            Вес товара в кг с учетом упаковки (брутто).
          example: 1.001
          type: number
          minimum: 0
    /home/sandbox/.ya/build/build_root/4217/00000b/market/mbi/docs/partner-api/docfiles/__docsbuild/.tmp_input/ru/openapi/partner-api-spec/offer-mappings/schemas.yaml#/OfferProcessingStatusType:
      description: >
        Статус публикации товара:


        * `UNKNOWN` — неизвестный статус.

        * `READY` — товар прошел модерацию. Чтобы разместить его на Маркете,
        установите для него цену.

        * `IN_WORK` — товар проходит модерацию. Это занимает несколько дней.

        * `NEED_INFO` — товар не прошел модерацию из-за ошибок или недостающих
        сведений в описании товара. Информация о причинах отклонения
        возвращается в параметре `notes`.

        * `NEED_MAPPING` — у товара нельзя создать карточку.

        * `NEED_CONTENT` — для товара без SKU на Маркете (`marketSku`) нужно
        найти карточку самостоятельно (через API или кабинет продавца на
        Маркете) или создать ее, если товар еще не продается на Маркете.

        * `CONTENT_PROCESSING` — товар находится на модерации.

        * `SUSPENDED` — товар не прошел модерацию, так как Маркет пока не
        размещает подобные товары.

        * `REJECTED` — товар не прошел модерацию, так как Маркет не планирует
        размещать подобные товары.

        * `REVIEW` — принимается решение о размещении товара.

        * `CREATE_ERROR` — не удалось создать карточку товара.

        * `UPDATE_ERROR` — у карточки товара есть непримененные изменения.
      type: string
      enum:
        - UNKNOWN
        - READY
        - IN_WORK
        - NEED_INFO
        - NEED_MAPPING
        - NEED_CONTENT
        - CONTENT_PROCESSING
        - SUSPENDED
        - REJECTED
        - REVIEW
        - CREATE_ERROR
        - UPDATE_ERROR
    /home/sandbox/.ya/build/build_root/4217/00000b/market/mbi/docs/partner-api/docfiles/__docsbuild/.tmp_input/ru/openapi/partner-api-spec/offer-mappings/schemas.yaml#/OfferProcessingNoteType:
      description: "Тип причины, по которой товар не прошел модерацию:\n\n* `ASSORTMENT` — товар производится в разных вариантах. Каждый из них нужно описать как отдельный товар (параметр `offerMappings` в запросе [POST\_v2/businesses/{businessId}/offer-mappings/update](../../reference/business-assortment/updateOfferMappings.md) или строка в каталоге, если вы загружаете товары через кабинет продавца на Маркете).\n* `CANCELLED` — товар отозван с модерации по вашей инициативе.\n* `CONFLICTING_INFORMATION` _(ранее ошибочно `CONFLICTING`)_ — вы предоставили противоречивую информацию о товаре. Параметры, которые нужно исправить, указаны в параметре `payload`.\n* `OTHER` — товар не прошел модерацию по другой причине. Обратитесь в службу поддержки или к вашему менеджеру.\n* `DEPARTMENT_FROZEN` — правила размещения товаров в данной категории перерабатываются, поэтому товар пока не может пройти модерацию.\n* `INCORRECT_INFORMATION` — информация о товаре, которую вы предоставили, противоречит описанию от производителя. Параметры, которые нужно исправить, указаны в параметре `payload`.\n* `LEGAL_CONFLICT` — товар не прошел модерацию по юридическим причинам. Например, он официально не продается в России или у вас нет разрешения на его продажу.\n* `NEED_CLASSIFICATION_INFORMATION` — информации о товаре, которую вы предоставили, не хватает, чтобы отнести его к категории. Проверьте, что правильно указали название, категорию, производителя и страны производства товара, а также URL изображений или страниц с описанием, по которым можно идентифицировать товар.\n* `NEED_INFORMATION` — товар раньше не продавался в России и пока не размещается на Маркете. Для него можно создать карточку. Подробнее см. в разделе [Работа с карточкой товара](https://yandex.ru/support/marketplace/assortment/content/index.html) Справки Маркета для продавцов.\n* `NEED_PICTURES` — для идентификации товара нужны его изображения. Отправьте URL изображений товара в запросе [POST\_v2/businesses/{businessId}/offer-mappings/update](../../reference/business-assortment/updateOfferMappings.md) или загрузите обновленный каталог через кабинет продавца на Маркете.\n* `NEED_VENDOR` — неверно указан производитель товара.\n* `NO_CATEGORY`, `NO_KNOWLEDGE` — товары из указанной категории пока не размещаются на Маркете. Если категория появится, товар будет снова отправлен на модерацию.\n* `NO_PARAMETERS_IN_SHOP_TITLE` — товар производится в разных вариантах, и из указанного названия непонятно, о каком идет речь. Параметры, которые нужно добавить в название товара, указаны в параметре `payload`.\n* `NO_SIZE_MEASURE` — для этого товара нужна размерная сетка. Отправьте ее в службу поддержки или вашему менеджеру. Требования к размерной сетке указаны в параметре `payload`.\n* `SAMPLE_LINE` — товар не прошел модерацию из-за лишней строки.\n"
      type: string
      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
    /home/sandbox/.ya/build/build_root/4217/00000b/market/mbi/docs/partner-api/docfiles/__docsbuild/.tmp_input/ru/openapi/partner-api-spec/offer-mappings/schemas.yaml#/OfferProcessingStateDTO:
      description: Информация о статусе публикации товара на Маркете.
      type: object
      properties:
        status:
          description: Статус публикации товара
          $ref: '#/$defs/OfferProcessingStatusType'
        notes:
          description: Причины, по которым товар не прошел модерацию.
          type: array
          nullable: true
          minItems: 1
          items:
            description: Причины, по которым товар не прошел модерацию.
            type: object
            properties:
              type:
                description: Тип причины, по которой товар не прошел модерацию.
                $ref: '#/$defs/OfferProcessingNoteType'
              payload:
                description: |
                  Дополнительная информация о причине отклонения товара.
                type: string
    /home/sandbox/.ya/build/build_root/4217/00000b/market/mbi/docs/partner-api/docfiles/__docsbuild/.tmp_input/ru/openapi/partner-api-spec/offer-mappings/schemas.yaml#/OfferAvailabilityStatusType:
      description: >
        Планы по поставкам:


        * `ACTIVE` — поставки будут.

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

        * `DELISTED` — архив: товар закончился на складе, и его поставок больше
        не будет. Если товар вернется на склад (например, покупатель вернет
        заказ), этот статус изменится на `INACTIVE`.
      type: string
      enum:
        - ACTIVE
        - INACTIVE
        - DELISTED
    /home/sandbox/.ya/build/build_root/4217/00000b/market/mbi/docs/partner-api/docfiles/__docsbuild/.tmp_input/ru/openapi/partner-api-spec/common/schemas.yaml#/TimeUnitType:
      description: |
        Единица измерения времени:

        * `HOUR` — час.
        * `DAY` — сутки.
        * `WEEK` — неделя.
        * `MONTH` — месяц.
        * `YEAR` — год.
      type: string
      enum:
        - HOUR
        - DAY
        - WEEK
        - MONTH
        - YEAR
    /home/sandbox/.ya/build/build_root/4217/00000b/market/mbi/docs/partner-api/docfiles/__docsbuild/.tmp_input/ru/openapi/partner-api-spec/offer-mappings/schemas.yaml#/TimePeriodDTO:
      description: >-
        Временной отрезок с комментарием. Требования к содержанию комментария
        зависят от контекста использования параметра и указаны в описании поля,
        которое его содержит.
      type: object
      required:
        - timePeriod
        - timeUnit
      properties:
        timePeriod:
          description: Продолжительность в указанных единицах.
          type: integer
        timeUnit:
          description: Единица измерения.
          $ref: '#/$defs/TimeUnitType'
        comment:
          description: Комментарий.
          type: string
          maxLength: 500
    /home/sandbox/.ya/build/build_root/4217/00000b/market/mbi/docs/partner-api/docfiles/__docsbuild/.tmp_input/ru/openapi/partner-api-spec/offer-mappings/api/updateOfferMappingEntries.yaml#/UpdateMappingsOfferDTO:
      description: Информация о товарах в каталоге.
      type: object
      allOf:
        - description: Базовая информация о товарах в каталоге.
          type: object
          properties:
            name:
              description: >
                Составляйте название по схеме: тип + бренд или производитель +
                модель + особенности, если есть (например, цвет, размер или вес)
                и количество в упаковке.


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


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


                [Рекомендации и
                правила](https://yandex.ru/support/marketplace/assortment/fields/title.html)
              example: Ударная дрель Makita HP1630, 710 Вт
              type: string
              maxLength: 256
            shopSku:
              description: "Ваш SKU —\_идентификатор товара в вашей системе.\n\nПравила использования SKU:\n\n* У каждого товара SKU должен быть свой.\n\n* Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.\n\nSKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте [в Справке Маркета для продавцов](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku).\n\n{% note warning %}\n\nПробельные символы в начале и конце значения автоматически удаляются. Например, `\"  SKU123  \"` и `\"SKU123\"` будут обработаны как одинаковые значения.\n\n{% endnote %}\n\n[Что такое SKU и как его назначать](https://yandex.ru/support/marketplace/assortment/add/index.html#fields)\n"
              type: string
              pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$
              x-transform: trim
              minLength: 1
              maxLength: 255
            category:
              description: "{% note warning \"Вместо него используйте `marketCategoryId`.\" %}\n\n\_\n\n{% endnote %}\n\nКатегория товара в вашем магазине.\n"
              type: string
              deprecated: true
            vendor:
              description: >-
                Название бренда или производителя. Должно быть записано так, как
                его пишет сам бренд.
              example: LEVENHUK
              type: string
            vendorCode:
              description: Артикул товара от производителя.
              example: VNDR-0005A
              type: string
            description:
              description: >
                Подробное описание товара: например, его преимущества и
                особенности.


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


                Для форматирования текста можно использовать теги HTML:


                * \<h>, \<h1>, \<h2> и так далее — для заголовков;

                * \<br> и \<p> — для переноса строки;

                * \<ol> — для нумерованного списка;

                * \<ul> — для маркированного списка;

                * \<li> — для создания элементов списка (должен находиться
                внутри \<ol> или \<ul>);

                * \<div> — поддерживается, но не влияет на отображение текста.


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


                [Рекомендации и
                правила](https://yandex.ru/support/marketplace/assortment/fields/description.html)
              type: string
              maxLength: 6000
            id:
              description: "Ваш SKU —\_идентификатор товара в вашей системе.\n\nПравила использования SKU:\n\n* У каждого товара SKU должен быть свой.\n\n* Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.\n\nSKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте [в Справке Маркета для продавцов](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku).\n\n{% note warning %}\n\nПробельные символы в начале и конце значения автоматически удаляются. Например, `\"  SKU123  \"` и `\"SKU123\"` будут обработаны как одинаковые значения.\n\n{% endnote %}\n\n[Что такое SKU и как его назначать](https://yandex.ru/support/marketplace/assortment/add/index.html#fields)\n"
              type: string
              pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$
              x-transform: trim
              minLength: 1
              maxLength: 255
            feedId:
              description: Идентификатор фида.
              type: integer
              format: int64
            barcodes:
              description: >
                Штрихкод.


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


                Для товаров [определенных категорий и торговых
                марок](https://yastatic.net/s3/doc-binary/src/support/market/ru/yandex-market-list-for-gtin.xlsx)
                штрихкод должен быть действительным кодом GTIN.
                Обратите внимание: внутренние штрихкоды, начинающиеся на 2 или
                02, и коды формата Code 128 не являются
                GTIN.


                Что такое GTIN
              type: array
              nullable: true
              minItems: 1
              uniqueItems: true
              items:
                type: string
                example: '46012300000000'
            urls:
              description: >
                URL фотографии товара или страницы с описанием на вашем сайте.


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


                Должен содержать один вложенный параметр `url`.
              type: array
              nullable: true
              minItems: 1
              uniqueItems: true
              items:
                type: string
                minLength: 1
                maxLength: 2000
            pictures:
              description: >
                Ссылки (URL) изображений товара в хорошем качестве.


                Можно указать до 30 ссылок. При этом изображение по первой
                ссылке будет основным. Оно используется в качестве изображения
                товара в поиске Маркета и на карточке товара. Другие изображения
                товара доступны в режиме просмотра увеличенных изображений.
              type: array
              nullable: true
              minItems: 1
              maxItems: 30
              uniqueItems: false
              items:
                type: string
                minLength: 1
                maxLength: 2000
            manufacturer:
              description: >
                Изготовитель товара: компания, которая произвела товар, ее адрес
                и регистрационный номер (если есть).


                Необязательный параметр.
              type: string
            manufacturerCountries:
              description: |
                Список стран, в которых произведен товар.

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

                Должен содержать хотя бы одну, но не больше 5 стран.
              type: array
              nullable: true
              minItems: 1
              maxItems: 5
              uniqueItems: true
              items:
                type: string
            minShipment:
              description: >
                Минимальное количество единиц товара, которое вы поставляете на
                склад.


                Например, если вы поставляете детское питание партиями минимум
                по 10 коробок, а в каждой коробке по 6 баночек, укажите значение
                60.
              type: integer
              format: int32
            transportUnitSize:
              description: >
                Количество единиц товара в одной упаковке, которую вы
                поставляете на склад.


                Например, если вы поставляете детское питание коробками по 6
                баночек, укажите значение 6.
              type: integer
              format: int32
            quantumOfSupply:
              deprecated: true
              description: >
                Добавочная партия: по сколько единиц товара можно добавлять к
                минимальному количеству `minShipment`.


                Например, если вы поставляете детское питание партиями минимум
                по 10 коробок и хотите добавлять к минимальной партии по 2
                коробки, а в каждой коробке по 6 баночек, укажите значение 12.
              type: integer
              format: int32
            deliveryDurationDays:
              description: Срок, за который продавец поставляет товары на склад, в днях.
              type: integer
              format: int32
            boxCount:
              description: >
                Сколько мест (если больше одного) занимает товар.


                Параметр указывается, только если товар занимает больше одного
                места (например, кондиционер занимает два места: внешний и
                внутренний блоки в двух коробках). Если товар занимает одно
                место, не указывайте этот параметр.
              type: integer
              format: int32
            customsCommodityCodes:
              description: >
                Список кодов товара в единой Товарной номенклатуре
                внешнеэкономической деятельности (ТН ВЭД).


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


                Может содержать только один вложенный код ТН ВЭД.
              type: array
              nullable: true
              minItems: 1
              uniqueItems: true
              items:
                type: string
            weightDimensions:
              description: |
                Габариты упаковки и вес товара.
              $ref: '#/$defs/OfferWeightDimensionsDTO'
            supplyScheduleDays:
              description: Дни недели, в которые продавец поставляет товары на склад.
              type: array
              nullable: true
              minItems: 1
              uniqueItems: true
              items:
                description: |
                  День недели:

                  * `MONDAY` — понедельник.
                  * `TUESDAY` — вторник.
                  * `WEDNESDAY` — среда.
                  * `THURSDAY` — четверг.
                  * `FRIDAY` — пятница.
                  * `SATURDAY` — суббота.
                  * `SUNDAY` — воскресенье.
                type: string
                enum:
                  - MONDAY
                  - TUESDAY
                  - WEDNESDAY
                  - THURSDAY
                  - FRIDAY
                  - SATURDAY
                  - SUNDAY
            shelfLifeDays:
              description: "{% note warning \"Вместо него используйте `shelfLife`. Совместное использование обоих параметров приведет к ошибке.\" %}\n\n\_\n\n{% endnote %}\n\nСрок годности: через сколько дней товар станет непригоден для использования.\n"
              type: integer
              format: int32
              deprecated: true
            lifeTimeDays:
              description: "{% note warning \"Вместо него используйте `lifeTime`. Совместное использование обоих параметров приведет к ошибке.\" %}\n\n\_\n\n{% endnote %}\n\nСрок службы: сколько дней товар будет исправно выполнять свою функцию, а изготовитель — нести ответственность за его существенные недостатки.\n"
              type: integer
              format: int32
              deprecated: true
            guaranteePeriodDays:
              description: >
                Гарантийный срок товара: сколько дней возможно обслуживание и
                ремонт товара или возврат денег, а изготовитель или продавец
                будет нести ответственность за недостатки товара.
              type: integer
              format: int32
            processingState:
              description: Информация о статусе публикации товара на Маркете.
              $ref: '#/$defs/OfferProcessingStateDTO'
            availability:
              description: >
                Планы по поставкам:


                * `ACTIVE` — поставки будут.

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

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


                Значения по умолчанию:


                * при добавлении товара — `ACTIVE`;

                * при редактировании товара — такое же, как и при последнем
                обновлении каталога (в том числе другими способами, не через
                API).
              $ref: '#/$defs/OfferAvailabilityStatusType'
            shelfLife:
              description: >
                Информация о сроке годности: через какое время (в годах,
                месяцах, днях, неделях или часах) товар станет непригоден для
                использования. Например, срок годности есть у таких категорий,
                как продукты питания и медицинские препараты.


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


                {% note alert "У товара есть срок годности, а вы не укажете его"
                %}


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


                {% endnote %}
              $ref: '#/$defs/TimePeriodDTO'
            lifeTime:
              description: >
                Информация о сроке службы: в течение какого периода (в годах,
                месяцах, днях, неделях или часах) товар будет исправно выполнять
                свою функцию, а изготовитель — нести ответственность за его
                существенные недостатки.


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


                {% note alert "У товара есть срок службы, а вы не укажете его"
                %}

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

                {% endnote %}
              $ref: '#/$defs/TimePeriodDTO'
            guaranteePeriod:
              description: >
                Информация о гарантийном сроке: в течение какого периода (в
                годах, месяцах, днях, неделях или часах) возможны обслуживание и
                ремонт товара или возврат денег, а изготовитель или продавец
                будет нести ответственность за недостатки товара.


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


                {% note alert "У товара есть гарантийный срок, а вы не укажете
                его" %}


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


                {% endnote %}
              $ref: '#/$defs/TimePeriodDTO'
            certificate:
              description: >
                Номер документа на товар.


                Перед указанием номера документ нужно загрузить в кабинете
                продавца на Маркете.
                [Инструкция](https://yandex.ru/support/marketplace/assortment/restrictions/certificates.html)
              type: string
    /home/sandbox/.ya/build/build_root/4217/00000b/market/mbi/docs/partner-api/docfiles/__docsbuild/.tmp_input/ru/openapi/partner-api-spec/common/schemas.yaml#/MarketSku:
      description: Идентификатор карточки товара на Маркете.
      type: integer
      format: int64
      minimum: 1
    /home/sandbox/.ya/build/build_root/4217/00000b/market/mbi/docs/partner-api/docfiles/__docsbuild/.tmp_input/ru/openapi/partner-api-spec/offer-mappings/schemas.yaml#/OfferMappingDTO:
      description: Информация о текущей карточке товара на Маркете.
      type: object
      properties:
        marketSku:
          description: >
            SKU на Маркете — идентификатор карточки товара на Маркете.


            При первом запросе `marketSku` привязывает товар к карточке Маркета.
            В дальнейшем изменить SKU через отправку запроса нельзя, для этого
            нужно обратиться в службу поддержки.
          $ref: '#/$defs/MarketSku'
        modelId:
          x-hidden: true
          description: >
            Идентификатор модели для текущей карточки товара на Маркете.


            Например, две лопатки разных цветов имеют разные SKU на Маркете
            (параметр `marketSku`), но одинаковый идентификатор модели товара.
          type: integer
          format: int64
        categoryId:
          description: Идентификатор категории для текущей карточки товара на Маркете.
          type: integer
          format: int64
bodyType: application/json
method: post
security:
  - type: apiKey
    name: Api-Key
    in: header
  - type: oauth2
    x-inline: true
    flows:
      implicit:
        authorizationUrl: https://oauth.yandex.ru/authorize
        scopes:
          market:partner-api: API Яндекс.Маркета / Поиска по товарам для партнеров
path: v2/campaigns/{campaignId}/offer-mapping-entries/updates
host: https://api.partner.market.yandex.ru

No longer supported, please use an alternative and newer version.

Что такое GTIN
GTIN — это уникальный номер, присвоенный товару в единой международной базе GS1. Из этого номера получается штрихкод формата EAN, UPC или ISBN.

Как убедиться, что товар есть в базе
Проверить код можно на странице проверки на сайте ассоциации GS1. Если товар не находится, запросите код GTIN у вашего поставщика.

Как получить GTIN для своих товаров
Чтобы получить коды GTIN, производителю нужно вступить в ассоциацию GS1 и зарегистрировать товары.