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

Name

Type

Description

offerMappingEntries*

UpdateOfferMappingEntryDTO[]

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

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

Обязательный параметр.
Информация о карточке товара.

Name

Type

Description

offer

MappingsOfferInfoDTO

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

mapping

OfferMappingDTO

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

Если параметр не указан, сотрудники Маркета сами подберут или создадут подходящую карточку товара, либо у него появится статус NEED_CONTENT (нужно найти карточку или создать ее самостоятельно) в выходных данных запроса GET campaigns/{campaignId}/offer-mapping-entries.

awaitingModerationMapping

OfferMappingDTO

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

rejectedMapping

OfferMappingDTO

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

Name

Type

Description

name

string

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

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

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

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

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

shopSku

string

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

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

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

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

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

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

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

Min length: 1
Max length: 80

category

string

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

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

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

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

vendor

string

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

vendorCode

string

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

description

string

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

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

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

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

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

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

Max length: 6000

id

string

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

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

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

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

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

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

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

Min length: 1
Max length: 80

feedId

integer<int64>

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

barcodes

string[]

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

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

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

Что такое GTIN

Example: 46012300000000

urls

string[]

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

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

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

pictures

string[]

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

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

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

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

manufacturer

string

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

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

manufacturerCountries

string[]

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

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

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

minShipment

integer<int32>

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

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

transportUnitSize

integer<int32>

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

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

quantumOfSupply

integer<int32>

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

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

deliveryDurationDays

integer<int32>

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

boxCount

integer<int32>

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

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

customsCommodityCodes

string[]

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

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

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

weightDimensions

OfferWeightDimensionsDTO

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

supplyScheduleDays

DayOfWeekType[]

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

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

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

shelfLifeDays

integer<int32>

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

lifeTimeDays

integer<int32>

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

guaranteePeriodDays

integer<int32>

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

processingState

OfferProcessingStateDTO

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

availability

OfferAvailabilityStatusType

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

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

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

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

Enum: ACTIVE, INACTIVE, DELISTED

shelfLife

TimePeriodDTO

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

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

lifeTime

TimePeriodDTO

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

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

guaranteePeriod

TimePeriodDTO

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

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

certificate

string

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

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

Name

Type

Description

marketSku

integer<int64>

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

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

modelId

integer<int64>

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

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

categoryId

integer<int64>

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

Name

Type

Description

length*

number

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

Example: 65.55

width*

number

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

Example: 50.7

height*

number

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

Example: 20

weight*

number

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

Example: 1.001

Type

Description

DayOfWeekType

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

Name

Type

Description

status

OfferProcessingStatusType

Статус публикации товара
Enum: UNKNOWN, READY, IN_WORK, NEED_INFO, NEED_MAPPING, NEED_CONTENT, CONTENT_PROCESSING, SUSPENDED, REJECTED, REVIEW, CREATE_ERROR, UPDATE_ERROR

notes

OfferProcessingNoteDTO[]

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

Type

Description

OfferAvailabilityStatusType

Enum: ACTIVE, INACTIVE, DELISTED

Name

Type

Description

timePeriod*

integer

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

timeUnit*

TimeUnitType

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

comment

string

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

Type

Description

OfferProcessingStatusType

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

Name

Type

Description

type

OfferProcessingNoteType

Тип причины, по которой товар не прошел модерацию.
Enum: ASSORTMENT, CANCELLED, CONFLICTING_INFORMATION, OTHER, DEPARTMENT_FROZEN, INCORRECT_INFORMATION, LEGAL_CONFLICT, NEED_CLASSIFICATION_INFORMATION, NEED_INFORMATION, NEED_PICTURES, NEED_VENDOR, NO_CATEGORY, NO_KNOWLEDGE, NO_PARAMETERS_IN_SHOP_TITLE, NO_SIZE_MEASURE, SAMPLE_LINE

payload

string

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

Type

Description

TimeUnitType

Enum: HOUR, DAY, WEEK, MONTH, YEAR

Type

Description

OfferProcessingNoteType

Enum: ASSORTMENT, CANCELLED, CONFLICTING_INFORMATION, OTHER, DEPARTMENT_FROZEN, INCORRECT_INFORMATION, LEGAL_CONFLICT, NEED_CLASSIFICATION_INFORMATION, NEED_INFORMATION, NEED_PICTURES, NEED_VENDOR, NO_CATEGORY, NO_KNOWLEDGE, NO_PARAMETERS_IN_SHOP_TITLE, NO_SIZE_MEASURE, SAMPLE_LINE