- Request
- Path parameters
- Body
- OfferName
- ShopSku
- OfferCategory
- OfferVendor
- OfferVendorCode
- OfferDescription
- OfferBarcodes
- Url
- OfferWeightDimensionsDTO
- DayOfWeekType
- OfferProcessingStatusType
- OfferProcessingNoteType
- OfferProcessingNoteDTO
- OfferProcessingStateDTO
- OfferAvailabilityStatusType
- TimeUnitType
- TimePeriodDTO
- MappingsOfferInfoDTO
- UpdateMappingsOfferDTO
- MarketSku
- OfferMappingDTO
- OfferMappingInfoDTO
- UpdateOfferMappingEntryDTO
- Responses
- 200 OK
- 400 Bad Request
- 401 Unauthorized
- 403 Forbidden
- 404 Not Found
- 420 Method Failure
- 423 Locked
- 500 Internal Server Error
Добавление и редактирование товаров в каталоге
Deprecated
Метод доступен для всех моделей.
Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке
- offers-and-cards-management — Управление товарами и карточками
- all-methods — Полное управление кабинетом
Какой метод использовать вместо устаревшего
Добавляет товары, указанные в запросе, в ваш каталог товаров и редактирует уже имеющиеся товары.
Информацию о товарах нужно передать в теле 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: |
Body
application/json
{
"offerMappingEntries": [
{
"offer": {}
}
]
}
|
Name |
Description |
|
offerMappingEntries |
Type: UpdateOfferMappingEntryDTO[] Информация о товарах в каталоге. Min items: Max items: 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: |
|
length |
Type: number Длина упаковки в см. Min value: |
|
weight |
Type: number Вес товара в кг с учетом упаковки (брутто). Min value: |
|
width |
Type: number Ширина упаковки в см. Min value: |
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: |
|
type |
Type: OfferProcessingNoteType Тип причины, по которой товар не прошел модерацию. Тип причины, по которой товар не прошел модерацию:
Enum: |
Example
{
"type": "ASSORTMENT",
"payload": "example"
}
OfferProcessingStateDTO
Информация о статусе публикации товара на Маркете.
|
Name |
Description |
|
notes |
Type: OfferProcessingNoteDTO[] | null Причины, по которым товар не прошел модерацию. Min items: Example
|
|
status |
Type: OfferProcessingStatusType Статус публикации товара Статус публикации товара:
Enum: |
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 Единица измерения. Единица измерения времени:
Enum: |
|
comment |
Type: string Комментарий. Max length: Example: |
Example
{
"timePeriod": 0,
"timeUnit": "HOUR",
"comment": "example"
}
MappingsOfferInfoDTO
Базовая информация о товарах в каталоге.
|
Name |
Description |
|
availability |
Type: OfferAvailabilityStatusType Планы по поставкам:
Значения по умолчанию:
Планы по поставкам:
Enum: |
|
barcodes |
Type: OfferBarcodes Штрихкод. Указывайте в виде последовательности цифр. Подойдут коды EAN-13, EAN-8, UPC-A, UPC-E или Code 128. Для книг — ISBN. Для товаров определенных категорий и торговых марок штрихкод должен быть действительным кодом GTIN. Обратите внимание: внутренние штрихкоды, начинающиеся на 2 или 02, и коды формата Code 128 не являются GTIN. Что такое GTIN Min items: Unique items: Example
|
|
boxCount |
Type: integer Сколько мест (если больше одного) занимает товар. Параметр указывается, только если товар занимает больше одного места (например, кондиционер занимает два места: внешний и внутренний блоки в двух коробках). Если товар занимает одно место, не указывайте этот параметр. |
|
category |
Type: OfferCategory Вместо него используйте Категория товара в вашем магазине. Example: |
|
certificate |
Type: string Номер документа на товар. Перед указанием номера документ нужно загрузить в кабинете продавца на Маркете. Инструкция Example: |
|
customsCommodityCodes |
Type: string[] | null Список кодов товара в единой Товарной номенклатуре внешнеэкономической деятельности (ТН ВЭД). Обязательный параметр, если товар подлежит особому учету (например, в системе «Меркурий» как продукция животного происхождения или в системе «Честный ЗНАК»). Может содержать только один вложенный код ТН ВЭД. Min items: Unique items: Example
|
|
deliveryDurationDays |
Type: integer Срок, за который продавец поставляет товары на склад, в днях. |
|
description |
Type: OfferDescription Подробное описание товара: например, его преимущества и особенности. Не давайте в описании инструкций по установке и сборке. Не используйте слова «скидка», «распродажа», «дешевый», «подарок» (кроме подарочных категорий), «бесплатно», «акция», «специальная цена», «новинка», «new», «аналог», «заказ», «хит». Не указывайте никакой контактной информации и не давайте ссылок. Для форматирования текста можно использовать теги HTML:
Оптимальная длина — 400–600 символов. Max length: Example: |
|
feedId |
Type: integer Идентификатор фида. |
|
guaranteePeriod |
Type: TimePeriodDTO Информация о гарантийном сроке: в течение какого периода (в годах, месяцах, днях, неделях или часах) возможны обслуживание и ремонт товара или возврат денег, а изготовитель или продавец будет нести ответственность за недостатки товара. Обязательный параметр, если у товара есть гарантийный срок. У товара есть гарантийный срок, а вы не укажете его Товар будет скрыт с Маркета. Временной отрезок с комментарием. Требования к содержанию комментария зависят от контекста использования параметра и указаны в описании поля, которое его содержит. Example
|
|
guaranteePeriodDays |
Type: integer Гарантийный срок товара: сколько дней возможно обслуживание и ремонт товара или возврат денег, а изготовитель или продавец будет нести ответственность за недостатки товара. |
|
id |
Type: ShopSku Ваш SKU — идентификатор товара в вашей системе. Правила использования SKU:
SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов. Важно Пробельные символы в начале и конце значения автоматически удаляются. Например, Что такое SKU и как его назначать Min length: Max length: Pattern: Example: |
|
lifeTime |
Type: TimePeriodDTO Информация о сроке службы: в течение какого периода (в годах, месяцах, днях, неделях или часах) товар будет исправно выполнять свою функцию, а изготовитель — нести ответственность за его существенные недостатки. Обязательный параметр, если у товара есть срок службы. У товара есть срок службы, а вы не укажете его Товар будет скрыт с Маркета. Временной отрезок с комментарием. Требования к содержанию комментария зависят от контекста использования параметра и указаны в описании поля, которое его содержит. Example
|
|
lifeTimeDays |
Type: integer Вместо него используйте Срок службы: сколько дней товар будет исправно выполнять свою функцию, а изготовитель — нести ответственность за его существенные недостатки. |
|
manufacturer |
Type: string Изготовитель товара: компания, которая произвела товар, ее адрес и регистрационный номер (если есть). Необязательный параметр. Example: |
|
manufacturerCountries |
Type: string[] | null Список стран, в которых произведен товар. Обязательный параметр. Должен содержать хотя бы одну, но не больше 5 стран. Min items: Max items: Unique items: Example
|
|
minShipment |
Type: integer Минимальное количество единиц товара, которое вы поставляете на склад. Например, если вы поставляете детское питание партиями минимум по 10 коробок, а в каждой коробке по 6 баночек, укажите значение 60. |
|
name |
Type: OfferName Составляйте название по схеме: тип + бренд или производитель + модель + особенности, если есть (например, цвет, размер или вес) и количество в упаковке. Не включайте в название условия продажи (например, «скидка», «бесплатная доставка» и т. д.), эмоциональные характеристики («хит», «супер» и т. д.). Не пишите слова большими буквами — кроме устоявшихся названий брендов и моделей. Оптимальная длина — 50–60 символов. Max length: Example: |
|
pictures |
Type: Url[] | null Ссылки (URL) изображений товара в хорошем качестве. Можно указать до 30 ссылок. При этом изображение по первой ссылке будет основным. Оно используется в качестве изображения товара в поиске Маркета и на карточке товара. Другие изображения товара доступны в режиме просмотра увеличенных изображений. Min items: Max items: Example
|
|
processingState |
Type: OfferProcessingStateDTO Информация о статусе публикации товара на Маркете. Example
|
|
quantumOfSupply |
Type: integer Добавочная партия: по сколько единиц товара можно добавлять к минимальному количеству Например, если вы поставляете детское питание партиями минимум по 10 коробок и хотите добавлять к минимальной партии по 2 коробки, а в каждой коробке по 6 баночек, укажите значение 12. |
|
shelfLife |
Type: TimePeriodDTO Информация о сроке годности: через какое время (в годах, месяцах, днях, неделях или часах) товар станет непригоден для использования. Например, срок годности есть у таких категорий, как продукты питания и медицинские препараты. Обязательный параметр, если у товара есть срок годности. У товара есть срок годности, а вы не укажете его Товар будет скрыт с Маркета. Временной отрезок с комментарием. Требования к содержанию комментария зависят от контекста использования параметра и указаны в описании поля, которое его содержит. Example
|
|
shelfLifeDays |
Type: integer Вместо него используйте Срок годности: через сколько дней товар станет непригоден для использования. |
|
shopSku |
Type: ShopSku Ваш SKU — идентификатор товара в вашей системе. Правила использования SKU:
SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов. Важно Пробельные символы в начале и конце значения автоматически удаляются. Например, Что такое SKU и как его назначать Min length: Max length: Pattern: Example: |
|
supplyScheduleDays |
Type: DayOfWeekType[] | null Дни недели, в которые продавец поставляет товары на склад. Min items: Unique items: Example
|
|
transportUnitSize |
Type: integer Количество единиц товара в одной упаковке, которую вы поставляете на склад. Например, если вы поставляете детское питание коробками по 6 баночек, укажите значение 6. |
|
urls |
Type: Url[] | null URL фотографии товара или страницы с описанием на вашем сайте. Переданные данные не будут отображаться на витрине, но они помогут специалистам Маркета найти карточку для вашего товара. Должен содержать один вложенный параметр Min items: Unique items: Example
|
|
vendor |
Type: OfferVendor Название бренда или производителя. Должно быть записано так, как его пишет сам бренд. Example: |
|
vendorCode |
Type: OfferVendorCode Артикул товара от производителя. Example: |
|
weightDimensions |
Type: OfferWeightDimensionsDTO Габариты упаковки и вес товара. Габариты упаковки и вес товара. Если товар занимает несколько коробок, перед измерением размеров сложите их компактно.
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"
}
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 на Маркете — идентификатор карточки товара на Маркете. При первом запросе Идентификатор карточки товара на Маркете. Min value: Example: |
|
modelId |
Type: integer Идентификатор модели для текущей карточки товара на Маркете. Например, две лопатки разных цветов имеют разные SKU на Маркете (параметр |
Example
{
"marketSku": 1,
"modelId": 0,
"categoryId": 0
}
OfferMappingInfoDTO
Информация о карточке товара.
|
Name |
Description |
|
awaitingModerationMapping |
Type: OfferMappingDTO Информация о карточке товара на Маркете, проходящей модерацию для данного товара Информация о текущей карточке товара на Маркете. Example
|
|
mapping |
Type: OfferMappingDTO Информация о карточке товара на Маркете. Если параметр не указан, сотрудники Маркета сами подберут или создадут подходящую карточку товара, либо у него появится статус Информация о текущей карточке товара на Маркете. Example
|
|
rejectedMapping |
Type: OfferMappingDTO Информация о последней карточке товара на Маркете, отклоненной на модерации для данного товара Информация о текущей карточке товара на Маркете. Example
|
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 Тип ответа. Возможные значения:
Enum: |
Example
{
"status": "OK"
}
400 Bad Request
Запрос содержит неправильные данные. Подробнее об ошибке
Body
application/json
{
"status": "OK"
}
Type: object
ApiErrorDTO
Общий формат ошибки.
|
Name |
Description |
|
code |
Type: string Код ошибки. Example: |
|
message |
Type: string Описание ошибки. 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:
1Example
[ { "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: >
Габариты упаковки и вес товара.
Если товар занимает несколько коробок, перед измерением размеров сложите
их компактно.

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 и зарегистрировать товары.