Атрибуты и справочники

Перед созданием товаров необходимо выгрузить инфомодель Lamoda Seller и сопоставить её с вашими категориями и атрибутами. В этом разделе описаны методы для получения справочников.

Порядок получения справочников

1. Получить список категорий: v1.erp-categories.list
2. Для нужной категории получить атрибуты: v1.attributes.list
3. Для атрибутов-словарей получить значения: v1.attribute-dictionaries.list
4. При необходимости получить маппинги: v1.attributes-dictionaries-mappings.get

Список категорий

POST v1.erp-categories.list — возвращает список основных категорий, доступных для товаров.

Запрос:

POST v1.erp-categories.list
Content-Type: application/json

{
    "jsonrpc": "2.0",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "method": "v1.erp-categories.list",
    "params": {
        "seller_id": 12345
    }
}

Структура ответа (для каждой категории):

Категория 3-го уровня имеет 4 элемента в массиве path (включая себя).

Список атрибутов категории

POST v1.attributes.list — возвращает список атрибутов для указанной категории.

Запрос:

POST v1.attributes.list
Content-Type: application/json

{
    "jsonrpc": "2.0",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "method": "v1.attributes.list",
    "params": {
        "rec_id": "5637156453"
    }
}

Структура ответа (для каждого атрибута):

Типы атрибутов

Типы шаблонов (templates)

Значения справочников

POST v1.attribute-dictionaries.list — возвращает список значений для атрибутов типа dictionary_entry и array_of_dictionary_entry.

Запрос:

POST v1.attribute-dictionaries.list
Content-Type: application/json

{
    "jsonrpc": "2.0",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "method": "v1.attribute-dictionaries.list",
    "params": {
        "seller_id": 12345,
        "dictionaries": ["age_type", "gender"]
    }
}

Пример ответа:

{
    "result": {
        "age_type": {
            "33819": {"name": "для любого возраста"},
            "38108": {"name": "15+"},
            "38107": {"name": "25+"}
        },
        "gender": {
            "boys": {"name": "boys"},
            "girls": {"name": "girls"},
            "kids": {"name": "kids"},
            "men": {"name": "men"},
            "women": {"name": "women"},
            "unisex": {"name": "unisex"}
        }
    }
}

Ключ (33819, boys и т.д.) — это значение, которое нужно передавать при создании товара.

Маппинги справочников

POST 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": "5637156453"
    }
}

Ответ содержит маппинг категории на доступные значения атрибутов (размеры, пол и т.д.).

Атрибуты товара

POST v1.attributes.sku.list — возвращает текущие значения атрибутов для конкретного товара. Используйте перед обновлением товара, чтобы получить актуальные данные.

Запрос:

POST v1.attributes.sku.list
Content-Type: application/json

{
    "jsonrpc": "2.0",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "method": "v1.attributes.sku.list",
    "params": {
        "lamoda_sku": "MP002XM0ABCD01"
    }
}

Дополнительные справочники

POST v1.nomenclatures-metadata.get-brands — список доступных брендов.

POST v1.nomenclatures-metadata.get-axapta-categories — категории Axapta (внутренняя система).

POST v1.dictionaries.get — атрибуты конкретного продавца.

Типичные проблемы

Устаревшие значения словарей

Если значение атрибута устарело, оно удаляется из справочника, но может остаться в существующих товарах. При выгрузке товара вы получите ID значения, но не сможете найти его текстовое представление в словаре. Это известная проблема — такие значения остаются только в legacy-товарах.

Автоподстановка в ЛК

Если для атрибута в маппинге доступно только одно значение, оно автоматически подставляется в ЛК. Это может привести к тому, что значение, установленное через API, будет перезаписано в ЛК. Решение: не открывайте товар в ЛК, если управляете им через API.

Порядок интеграции

1. Выгрузите категории через v1.erp-categories.list
2. Сопоставьте ваши категории с категориями Lamoda
3. Для каждой нужной категории выгрузите атрибуты через v1.attributes.list
4. Выгрузите значения словарей через v1.attribute-dictionaries.list
5. При необходимости выгрузите маппинги через v1.attributes-dictionaries-mappings.get
6. Сохраните справочники локально и обновляйте периодически (рекомендуем раз в неделю)