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

Name

Type

Description

offerMappings*

UpdateOfferMappingDTO[]

Перечень товаров, которые нужно добавить или обновить.
Информация о товаре.

Name

Type

Description

offer*

UpdateOfferDTO

Параметры товара.
Основные параметры товара.

mapping

UpdateMappingDTO

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

Name

Type

Description

offerId*

string

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

Разрешена любая последовательность длиной до 80 знаков. В нее могут входить английские и русские буквы, цифры и символы . , / \ ( ) [ ] - = _

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

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

• SKU товара нельзя менять — можно только удалить товар и добавить заново с новым SKU.

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

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

Min length: 1
Max length: 80

name

string

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

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

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

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

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

marketCategoryId

integer<int64>

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

Если не указать marketCategoryId, то маркетная категория будет определена автоматически.

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

category

string

Категория товара в вашем магазине. Значение будет использовано для определения категории товара на Маркете в случае, если вы не передали категорию в параметре marketCategoryId.

Указывайте конкретные категории — например, набор ножей лучше отнести к категории Столовые приборы, а не просто Посуда.

Выбирайте категории, которые описывают товар, а не абстрактный признак — например, Духи, а не Подарки.

Значение будет использовано для определения категории товара на Маркете в случае, если вы не передали категорию в параметре marketCategoryId.

pictures

string[]

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

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

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

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

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

❌ /images/sku12345.jpg

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

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

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

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

videos

string[]

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

Максимальное количество ссылок — 6.

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

• Указывайте ссылку целиком, включая протокол http или https.
• Максимальная длина — 512 символов.
• Русские буквы в 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

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

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

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

manuals

OfferManualDTO[]

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

Максимальное количество инструкций — 6.

Если вы передадите пустое поле manuals, загруженные ранее инструкции удалятся.
Инструкция по использованию товара.

vendor

string

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

barcodes

string[]

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

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

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

Что такое GTIN

Example: 46012300000000

description

string

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

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

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

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

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

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

Max length: 6000

manufacturerCountries

string[]

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

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

weightDimensions

OfferWeightDimensionsDTO

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

vendorCode

string

Артикул товара от производителя.
Example: VNDR-0005A

tags

string[]

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

Максимальная длина тега 20 символов. У одного товара может быть максимум 10 тегов. Всего можно создать не больше 50 разных тегов.
Example: до 500 рублей

shelfLife

TimePeriodDTO

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

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

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

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

lifeTime

TimePeriodDTO

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

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

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

guaranteePeriod

TimePeriodDTO

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

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

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

customsCommodityCode

string

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

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

Example: 8517610008

certificates

string[]

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

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

boxCount

integer<int32>

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

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

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

condition

OfferConditionDTO

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

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

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

type

OfferType

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

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

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

downloadable

boolean

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

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

adult

boolean

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

age

AgeDTO

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

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

params

OfferParamDTO[]

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

parameterValues

ParameterValueDTO[]

Список характеристик с их значениями. Обновляется всегда целиком. Максимальное количество — 300.
Значение характеристики.

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

• Тип характеристики — ENUM.
• В ответе на запрос POST category/{categoryId}/parameters у данной характеристики поле multivalue имеет значение true.

Для этого в parameterValues передавайте каждое значение отдельно — несколько объектов с параметрами parameterId, valueId и value. Параметр parameterId должен быть одинаковым.

purchasePrice

BasePriceDTO

Себестоимость — затраты на самостоятельное производство товара или закупку у производителя или поставщиков.

additionalExpenses

BasePriceDTO

Дополнительные расходы на товар. Например, на доставку или упаковку.

cofinancePrice

BasePriceDTO

Цена для скидок с Маркетом

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

Если Маркет не готов софинансировать скидку, покупатель ее не увидит.

Name

Type

Description

marketSku

integer<int64>

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

Name

Type

Description

url*

string

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

title

string

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

Name

Type

Description

length*

number

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

Example: 65.55

width*

number

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

Example: 50.7

height*

number

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

Example: 20

weight*

number

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

Example: 1.001

Name

Type

Description

timePeriod*

integer

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

timeUnit*

TimeUnitType

Единица измерения.
Enum: HOUR, DAY, WEEK, MONTH, YEAR

comment

string

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

Name

Type

Description

type

OfferConditionType

Тип уценки.

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

quality

OfferConditionQualityType

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

Enum: PERFECT, EXCELLENT, GOOD, NOT_SPECIFIED

reason

string

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

Type

Description

OfferType

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

Name

Type

Description

value*

number

Значение.

ageUnit*

AgeUnitType

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

Enum: YEAR, MONTH

Name

Type

Description

name*

string

Название.

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

Example: Wi-Fi

value*

string

Значение.

Example: есть

Name

Type

Description

parameterId*

integer<int64>

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

unitId

integer<int64>

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

valueId

integer<int64>

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

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

Только для характеристик типа ENUM.

value*

string

Значение.

Name

Type

Description

value*

number

Значение.

currencyId*

CurrencyType

Валюта.

Если BasePriceDTO присутствует в запросе, указывайте RUR — российский рубль.

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

Type

Description

TimeUnitType

Enum: HOUR, DAY, WEEK, MONTH, YEAR

Type

Description

OfferConditionType

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

Type

Description

OfferConditionQualityType

Enum: PERFECT, EXCELLENT, GOOD, NOT_SPECIFIED

Type

Description

AgeUnitType

Enum: YEAR, MONTH

Type

Description

CurrencyType

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