Добавление товаров в каталог и изменение информации о них

offerMappings

Type: UpdateOfferMappingDTO[]

Список товаров, которые нужно добавить или обновить.

Min items: 1

Max items: 500

[
  {
    "offer": {
      "offerId": "example",
      "name": "Ударная дрель Makita HP1630, 710 Вт",
      "marketCategoryId": 0,
      "category": "example",
      "pictures": [
        "example"
      ],
      "videos": [
        null
      ],
      "manuals": [
        {}
      ],
      "vendor": "LEVENHUK",
      "barcodes": [
        "46012300000000"
      ],
      "description": "example",
      "manufacturerCountries": [
        "Россия"
      ],
      "weightDimensions": {
        "length": 65.55,
        "width": 50.7,
        "height": 20,
        "weight": 1.001
      },
      "vendorCode": "VNDR-0005A",
      "tags": [
        "до 500 рублей"
      ],
      "shelfLife": {
        "timePeriod": 0,
        "timeUnit": "HOUR",
        "comment": "example"
      },
      "lifeTime": null,
      "guaranteePeriod": null,
      "customsCommodityCode": "8517610008",
      "commodityCodes": [
        {}
      ],
      "certificates": [
        "example"
      ],
      "boxCount": 1,
      "condition": {
        "type": "PREOWNED",
        "quality": "PERFECT",
        "reason": "example"
      },
      "type": "DEFAULT",
      "downloadable": true,
      "adult": true,
      "age": {
        "value": 0,
        "ageUnit": "YEAR"
      },
      "params": [
        {}
      ],
      "parameterValues": [
        {}
      ],
      "basicPrice": {},
      "purchasePrice": null,
      "additionalExpenses": null,
      "firstVideoAsCover": true,
      "deleteParameters": [
        "ADDITIONAL_EXPENSES"
      ]
    },
    "mapping": {
      "marketSku": 1
    }
  }
]

onlyPartnerMediaContent

Type: boolean

Будут ли использоваться только переданные вами данные о товарах.

Значение по умолчанию: false. Чтобы удалить данные, которые добавил Маркет, передайте значение true.

url

Type: Url

Ссылка на инструкцию.

Min length: 1

Max length: 2000

Example: example

title

Type: string

Название инструкции, которое будет отображаться на карточке товара.

Max length: 500

Example: example

height

Type: number

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

Min value: 0

length

Type: number

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

Min value: 0

weight

Type: number

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

Min value: 0

width

Type: number

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

Min value: 0

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

code

Type: string

Товарный код.

Example: example

type

Type: CommodityCodeType

Тип товарного кода.

Тип товарного кода:

• CUSTOMS_COMMODITY_CODE — код товара в единой Товарной номенклатуре внешнеэкономической деятельности (ТН ВЭД) — 10 или 14 цифр без пробелов.
• IKPU_CODE — идентификационный код продукции и услуг (ИКПУ) в Узбекистане – 17 цифр без пробелов.

Не передавайте несколько кодов одного типа.

Enum: CUSTOMS_COMMODITY_CODE, IKPU_CODE

quality

Type: OfferConditionQualityType

Внешний вид товара.

Внешний вид товара:

• PERFECT — идеальный.
• EXCELLENT — отличный.
• GOOD — хороший.
• NOT_SPECIFIED — не выбран.

Enum: PERFECT, EXCELLENT, GOOD, NOT_SPECIFIED

reason

Type: string

Описание товара. Подробно опишите дефекты, насколько они заметны и где их искать.

Example: example

type

Type: OfferConditionType

Тип уценки.

Тип уценки:

• PREOWNED — бывший в употреблении товар, раньше принадлежал другому человеку.
• SHOWCASESAMPLE — витринный образец.
• REFURBISHED — повторная продажа товара.
• REDUCTION — товар с дефектами.
• RENOVATED — восстановленный товар.
• NOT_SPECIFIED — не выбран.

REFURBISHED — специальное значение для одежды, обуви и аксессуаров. Используется только для уцененных товаров из этой категории. Другие значения для одежды, обуви и аксессуаров не используются.

Enum: PREOWNED, SHOWCASESAMPLE, REFURBISHED, REDUCTION, RENOVATED, NOT_SPECIFIED

ageUnit

Type: AgeUnitType

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

Единицы измерения возраста:

• YEAR — год.
• MONTH — месяц.

Enum: YEAR, MONTH

value

Type: number

Значение.

Min value: 0

name

Type: string

Название характеристики.

Должно совпадать с названием характеристики на Маркете. Узнать его можно из Excel-шаблона категории или через запрос POST v2/category/{categoryId}/parameters.

Max length: 200

Example: Wi-Fi

value

Type: string

Значение.

Example: есть

offerId

Type: ShopSku

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

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

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

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

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

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

Min length: 1

Max length: 255

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

Example: example

adult

Type: BaseOfferAdult

Параметр включает для товара пометку 18+. Устанавливайте ее только для товаров, которые относятся к удовлетворению сексуальных потребностей.

Example: true

age

Type: AgeDTO

Если товар не предназначен для детей младше определенного возраста, укажите это.

Возрастное ограничение можно задавать в годах (с нуля, с 6, 12, 16 или 18) или в месяцах (любое число от 0 до 12).

Возраст в заданных единицах измерения.

{
  "value": 0,
  "ageUnit": "YEAR"
}

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

[
  "46012300000000"
]

boxCount

Type: BaseOfferBoxCount

Количество грузовых мест.

Параметр используется, если товар представляет собой несколько коробок, упаковок и так далее. Например, кондиционер занимает два места — внешний и внутренний блоки в двух коробках.

Для товаров, занимающих одно место, не передавайте этот параметр.

Min value: 1

Example: 1

category

Type: OfferCategory

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

Example: example

certificates

Type: string[] | null

Номера документов на товар: сертификата, декларации соответствия и т. п.

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

Min items: 1

Max items: 6

Unique items: true

[
  "example"
]

commodityCodes

Type: BaseOfferCommodityCodes

Товарные коды.

Min items: 1

[
  {
    "code": "example",
    "type": "CUSTOMS_COMMODITY_CODE"
  }
]

condition

Type: OfferConditionDTO

Состояние уцененного товара.

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

Правила продажи уцененных товаров

Состояние уцененного товара.

{
  "type": "PREOWNED",
  "quality": "PERFECT",
  "reason": "example"
}

customsCommodityCode

Type: BaseOfferCustomsCommodityCode

Код товара в единой Товарной номенклатуре внешнеэкономической деятельности (ТН ВЭД) — 10 или 14 цифр без пробелов.

Обязательно укажите, если он есть.

Example: 8517610008

description

Type: OfferDescription

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

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

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

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

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

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

Max length: 6000

Example: example

downloadable

Type: BaseOfferDownloadable

Признак цифрового товара. Укажите true, если товар доставляется по электронной почте.

Как работать с цифровыми товарами

Example: true

guaranteePeriod

Type: TimePeriodDTO

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

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

В комментарии опишите особенности гарантийного обслуживания. Например, Гарантия на аккумулятор — 6 месяцев.

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

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

lifeTime

Type: TimePeriodDTO

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

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

В комментарии укажите условия хранения. Например, Использовать при температуре не ниже −10 градусов.

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

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

manuals

Type: OfferManualDTO[] | null

Список инструкций по использованию товара.

Min items: 1

Max items: 6

[
  {
    "url": "example",
    "title": "example"
  }
]

manufacturerCountries

Type: BaseOfferManufacturerCountries

Страна, где был произведен товар.

Записывайте названия стран так, как они записаны в списке.

Min items: 1

Unique items: true

[
  "Россия"
]

marketCategoryId

Type: PartnerMarketCategoryId

Идентификатор категории на Маркете, к которой вы относите свой товар.

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

Список категорий Маркета можно получить с помощью запроса POST v2/categories/tree.

Min value: 0

Exclusive min: true

Example: 0

name

Type: OfferName

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

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

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

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

Max length: 256

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

params

Type: BaseOfferParams

Характеристики, которые есть только у товаров конкретной категории — например, диаметр колес велосипеда или материал подошвы обуви.

Min items: 1

[
  {
    "name": "Wi-Fi",
    "value": "есть"
  }
]

pictures

Type: Url[] | null

Ссылки на изображения товара. Изображение по первой ссылке считается основным, остальные дополнительными.

Требования к ссылкам

• Указывайте ссылку целиком, включая протокол http или https.
• Русские буквы в URL можно.
• Можно использовать прямые ссылки на изображения и на Яндекс Диск. Ссылки на Яндекс Диске нужно копировать с помощью функции Поделиться. Относительные ссылки и ссылки на другие облачные хранилища — не работают.

✅ https://example-shop.ru/images/sku12345.jpg

✅ https://yadi.sk/i/NaBoRsimVOLov

❌ /images/sku12345.jpg

❌ https://www.dropbox.com/s/818f/tovar.jpg

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

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

Требования к изображениям

Min items: 1

Max items: 30

[
  "example"
]

shelfLife

Type: TimePeriodDTO

Срок годности — период, по прошествии которого товар становится непригоден.

Указывайте срок, указанный на банке или упаковке. Текущая дата, дата поставки или дата отгрузки значения не имеет.

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

В комментарии укажите условия хранения. Например, Хранить в сухом помещении.

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

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

tags

Type: BaseOfferTags

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

Максимальная длина тега — 20 символов. У одного товара может быть максимум 10 тегов.

Min items: 1

Max items: 50

Unique items: true

[
  "до 500 рублей"
]

type

Type: OfferType

Особый тип товара. Указывается, если товар:

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

Особый тип товара:

• DEFAULT — товары, для которых вы передавали особый тип ранее и хотите убрать его.
• MEDICINE — лекарства.
• BOOK — бумажные и электронные книги.
• AUDIOBOOK — аудиокниги.
• ARTIST_TITLE — музыкальная и видеопродукция.
• ON_DEMAND — товары на заказ.
• ALCOHOL — алкоголь.

Enum: DEFAULT, MEDICINE, BOOK, AUDIOBOOK, ARTIST_TITLE, ON_DEMAND, ALCOHOL

vendor

Type: OfferVendor

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

Example: LEVENHUK

vendorCode

Type: OfferVendorCode

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

Example: VNDR-0005A

videos

Type: Url[] | null

Ссылки (URL) на видео товара.

Требования к ссылке

• Указывайте ссылку целиком, включая протокол http или https.
• Русские буквы в URL можно.
• Можно использовать прямые ссылки на видео и на Яндекс Диск. Ссылки на Яндекс Диске нужно копировать с помощью функции Поделиться. Относительные ссылки и ссылки на другие облачные хранилища — не работают.

✅ https://example-shop.ru/video/sku12345.avi

✅ https://yadi.sk/i/NaBoRsimVOLov

❌ /video/sku12345.avi

❌ https://www.dropbox.com/s/818f/super-tovar.avi

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

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

Требования к видео

Min items: 1

Max items: 6

[
  "example"
]

weightDimensions

Type: OfferWeightDimensionsDTO

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

Должны быть больше 0.

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

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

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

parameterId

Type: integer

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

Min value: 1

unitId

Type: integer

Идентификатор единицы измерения. Если вы не передали параметр unitId, используется единица измерения по умолчанию.

value

Type: string

Значение.

Для характеристик типа ENUM передавайте:

• вместе с valueId, если значение берете из справочника;
• без valueId, если значение собственное.

Example: example

valueId

Type: integer

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

• Обязательно указывайте идентификатор, если передаете значение из перечня допустимых значений, полученного от Маркета.
• Не указывайте для собственных значений.
• Только для характеристик типа ENUM.

currencyId

Type: CurrencyType

Валюта.

Коды валют:

• RUR — российский рубль.
• UAH — украинская гривна.
• BYR — белорусский рубль.
• KZT — казахстанский тенге.
• UZS — узбекский сум.

Enum: RUR, USD, EUR, UAH, AUD, GBP, BYR, BYN, DKK, ISK, KZT, CAD, CNY, NOK, XDR, SGD, TRY, SEK, CHF, JPY, AZN, ALL, DZD, AOA, ARS, AMD, AFN, BHD, BGN, BOB, BWP, BND, BRL, BIF, HUF, VEF, KPW, VND, GMD, GHS, GNF, HKD, GEL, AED, EGP, ZMK, ILS, INR, IDR, JOD, IQD, IRR, YER, QAR, KES, KGS, COP, CDF, CRC, KWD, CUP, LAK, LVL, SLL, LBP, LYD, SZL, LTL, MUR, MRO, MKD, MWK, MGA, MYR, MAD, MXN, MZN, MDL, MNT, NPR, NGN, NIO, NZD, OMR, PKR, PYG, PEN, PLN, KHR, SAR, RON, SCR, SYP, SKK, SOS, SDG, SRD, TJS, THB, TWD, BDT, TZS, TND, TMM, UGX, UZS, UYU, PHP, DJF, XAF, XOF, HRK, CZK, CLP, LKR, EEK, ETB, RSD, ZAR, KRW, NAD, TL, UE

value

Type: number

Цена товара.

Min value: 0

Exclusive min: true

marketSku

Type: MarketSku

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

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

Min value: 1

Example: 1

offer

Type: UpdateOfferDTO

Параметры товара.

{
  "offerId": "example",
  "name": "Ударная дрель Makita HP1630, 710 Вт",
  "marketCategoryId": 0,
  "category": "example",
  "pictures": [
    "example"
  ],
  "videos": [
    null
  ],
  "manuals": [
    {
      "url": null,
      "title": "example"
    }
  ],
  "vendor": "LEVENHUK",
  "barcodes": [
    "46012300000000"
  ],
  "description": "example",
  "manufacturerCountries": [
    "Россия"
  ],
  "weightDimensions": {
    "length": 65.55,
    "width": 50.7,
    "height": 20,
    "weight": 1.001
  },
  "vendorCode": "VNDR-0005A",
  "tags": [
    "до 500 рублей"
  ],
  "shelfLife": {
    "timePeriod": 0,
    "timeUnit": "HOUR",
    "comment": "example"
  },
  "lifeTime": null,
  "guaranteePeriod": null,
  "customsCommodityCode": "8517610008",
  "commodityCodes": [
    {
      "code": "example",
      "type": "CUSTOMS_COMMODITY_CODE"
    }
  ],
  "certificates": [
    "example"
  ],
  "boxCount": 1,
  "condition": {
    "type": "PREOWNED",
    "quality": "PERFECT",
    "reason": "example"
  },
  "type": "DEFAULT",
  "downloadable": true,
  "adult": true,
  "age": {
    "value": 0,
    "ageUnit": "YEAR"
  },
  "params": [
    {
      "name": "Wi-Fi",
      "value": "есть"
    }
  ],
  "parameterValues": [
    {
      "parameterId": 1,
      "unitId": 0,
      "valueId": 0,
      "value": "example"
    }
  ],
  "basicPrice": {
    "value": 0,
    "currencyId": "RUR",
    "discountBase": 0
  },
  "purchasePrice": null,
  "additionalExpenses": null,
  "firstVideoAsCover": true,
  "deleteParameters": [
    "ADDITIONAL_EXPENSES"
  ]
}

mapping

Type: UpdateMappingDTO

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

Карточка на Маркете, которая, с вашей точки зрения, подходит товару. Чтобы определить идентификатор подходящей карточки, воспользуйтесь поиском в кабинете (Товары → Каталог → Загрузить товары).

По результатам проверки Маркет может привязать товар к более подходящей карточке.

{
  "marketSku": 1
}