Размерные сетки в API

При создании товара необходимо указать размерную сетку (size_scale) и значения размеров (size_value). Это одна из самых частых причин ошибок при интеграции.

Структура размеров в товаре

Товар в Lamoda состоит из двух частей:

• product (attributes) — общие атрибуты товара, включая size_scale
• variations (variation_attributes) — атрибуты для каждого размера

Пример структуры:

{
    "product": {
        "size_scale": {
            "type": "dictionary_entry",
            "value": "SH_M_EUR"
        },
        "brand": {...},
        "title": {...}
    },
    "variations": [
        {
            "size_value": {"type": "dictionary_entry", "value": "42"},
            "supplier_sku": {"type": "string", "value": "ABC-42"},
            "tax_class": {"type": "dictionary_entry", "value": "vat20"}
        },
        {
            "size_value": {"type": "dictionary_entry", "value": "43"},
            "supplier_sku": {"type": "string", "value": "ABC-43"},
            "tax_class": {"type": "dictionary_entry", "value": "vat20"}
        }
    ]
}

Получение доступных размерных сеток

Размерные сетки зависят от категории товара. Используйте метод v1.attributes-dictionaries-mappings.get для получения доступных сеток.

POST v1.attributes-dictionaries-mappings.get
Content-Type: application/json

{
    "jsonrpc": "2.0",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "method": "v1.attributes-dictionaries-mappings.get",
    "params": {
        "rec_id": "5637156836"
    }
}

В ответе в секции size_scale будут доступные шкалы:

"size_scale": {
    "ACC_W_BELTS_INT": {
        "size_value": ["XXS", "XS", "S", "M", "L", "XL", "XXL"],
        "gender": ["women"],
        "single_size_forbidden": true
    },
    "SH_M_EUR": {
        "size_value": ["36", "37", "38", "39", "40", "41", "42", "43", "44", "45"],
        "gender": ["men"],
        "single_size_forbidden": true
    }
}

Правила выбора размерной сетки

1. Соответствие категории — шкала должна быть доступна для выбранной категории (rec_id)
2. Соответствие полу — шкала привязана к gender (men, women, kids и т.д.)
3. Все размеры из шкалы — size_value должны быть из списка доступных для этой шкалы

Ограничение: несколько размеров

Для большинства размерных сеток действует ограничение single_size_forbidden: true — нельзя создать товар только с одним размером.

Ошибка при нарушении:

{
    "message": "Для этой шкалы необходимо наличие нескольких размеров",
    "attribute": "size_scale"
}

Решение: при создании товара указывайте все доступные размеры сразу. Если товар реально существует только в одном размере, обратитесь к KAM — возможно, нужна специальная шкала (например, ONESIZE).

Типичные ошибки

Размер не входит в шкалу

{
    "message": "Размерная шкала не соответствует размеру",
    "attribute": "size_value"
}

Причина: размер 35 указан для шкалы SH_M_EUR, но в ней нет 35-го размера (только 36-45).
Решение: проверьте допустимые размеры через /v1/attributes-dictionaries-mappings.get или используйте другую шкалу.

Шкала не соответствует полу

{
    "message": "Выбранная категория сайта не соответствует выбранному полу"
}

Причина: шкала SH_M_EUR (мужская) использована для товара с gender=women.
Решение: используйте шкалу, соответствующую указанному полу.

Один размер при single_size_forbidden

{
    "message": "Для этой шкалы необходимо наличие нескольких размеров"
}

Причина: в variations передан только один размер.
Решение: добавьте все размеры или используйте шкалу ONESIZE (если применимо).

Добавление новых размеров

Для добавления размеров к существующему товару используйте template = "reduced":

POST v1.nomenclatures.store
{
    "jsonrpc": "2.0",
    "id": "...",
    "method": "v1.nomenclatures.store",
    "params": {
        "seller_id": 12345,
        "template": "reduced",
        "nomenclatures": [{
            "product": {
                "supplier_parent_sku": {"type": "string", "value": "PARENT-SKU-123"},
                "erp_id": {"type": "dictionary_entry", "value": "5637156453"},
                ...обязательные атрибуты...
            },
            "variations": [
                {
                    "size_value": {"type": "dictionary_entry", "value": "46"},
                    "supplier_sku": {"type": "string", "value": "ABC-46"},
                    "tax_class": {"type": "dictionary_entry", "value": "vat20"}
                }
            ]
        }]
    }
}

Важно: supplier_parent_sku должен совпадать с тем, что был передан при создании. Получить его можно через /v1/attributes.sku.list.

Популярные размерные сетки

Рекомендации

• Выгрузите маппинги через /v1/attributes-dictionaries-mappings.get для всех ваших категорий
• Сохраните локально таблицу: категория → пол → доступные шкалы → доступные размеры
• Валидируйте размеры на своей стороне перед отправкой в API
• Если новый размер отсутствует в шкале (например, 35 для мужской обуви) — это реальная проблема данных, обратитесь к KAM
• Обновляйте локальный кэш шкал раз в неделю — иногда добавляются новые размеры