Таблицы размеров

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

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

Колонки таблицы — это размерные сетки (например, RU, EU, INT) и обмеры (например, обхват груди, длина стопы). Каждая строка описывает один размер: его значения во всех сетках и обмерах.

Можно использовать готовую таблицу Маркета или создать свою.

Подобрать готовую таблицу

  1. Подберите таблицы для категории товара с помощью POST v2/businesses/{businessId}/size-tables/suggest. Подбор можно уточнить брендом и полом.

    В ответ вы получите:

    • подходящие таблицы: таблицы Маркета (STANDARD) и таблицы, которые вы создали (CUSTOM);
    • идентификатор размерной характеристики категории в поле result.sizeParameterId. Он понадобится, чтобы создать свою таблицу.
  2. Чтобы посмотреть содержимое таблиц, получите их по идентификаторам с помощью POST v2/businesses/{businessId}/size-tables.

Создать свою таблицу

  1. Передайте sizeParameterId в POST v2/businesses/{businessId}/size-tables/charts. В ответе вернутся размерные сетки и обмеры, которые можно использовать в таблице. Для каждой из них есть:

    • идентификатор sizeChartId и название;
    • признак обязательности required. В таблице должна быть хотя бы одна обязательная сетка;
    • справочник значений sizeValues, если это стандартная размерная сетка Маркета.
  2. Создайте таблицу с помощью POST v2/businesses/{businessId}/size-tables/create. В каждой строке передайте по одной ячейке на сетку или обмер. Остальные требования к таблице описаны в справке метода.

    Для каждой созданной таблицы в ответе вернется ее идентификатор sizeTableId.

  3. Чтобы изменить таблицу, передайте ее полное содержимое в POST v2/businesses/{businessId}/size-tables/update. Изменять можно только свои таблицы: у них в ответе POST v2/businesses/{businessId}/size-tables указано editable: true.

Указать таблицу и размер в карточке товара

  1. Получите характеристики категории товара с помощью POST v2/category/{categoryId}/parameters. У категорий с таблицами размеров в списке есть:

    • таблица размеров (id: 73979829);
    • размерная сетка, в которой указан размер товара (id: 73979830);
    • размерная характеристика категории. Ее идентификатор совпадает с sizeParameterId.

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

  2. Передайте характеристики с помощью POST v2/businesses/{businessId}/offer-cards/update:

    • в характеристике 73979829 укажите идентификатор таблицы в value;
    • в характеристике 73979830 укажите sizeChartId сетки, в которой задан размер товара, в value;
    • в размерной характеристике укажите размер товара в этой сетке. Для стандартной сетки Маркета передайте в valueId значение из ее справочника, sizeValueId из ответа POST v2/businesses/{businessId}/size-tables/charts. Для остальных сеток передайте размер текстом в value.

    Сетку и размер передавайте вместе. Размер должен быть в выбранной сетке таблицы.

Какую таблицу Маркет применит к товару

Ваша таблица применяется к товару, только если она указана в характеристике 73979829.

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

  1. Если у товара указан бренд и для этого бренда есть таблица, выбирается брендовая таблица. Иначе выбирается стандартная.
  2. Из подходящих таблиц выбирается та, в которой есть сетка из характеристики 73979830. Если эта сетка есть в нескольких таблицах и одна из них указана в карточке, применяется указанная. Если сетки нет ни в одной таблице, применяется таблица Маркета по умолчанию.

Размер товара Маркет ищет в колонке этой сетки: в стандартной сетке по значению справочника, в остальных по тексту. Если сетки нет в таблице или размера нет в сетке, в карточке появится ошибка.

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