Для метода используется авторизация по jwt токену.

Адрес рабочей среды: https://openapi.ru.laliexpress.com

Создать товар

В течение 4 часов вы можете создать или обновить не более 100 000 товаров. Квота суммируется по всем методам создания/редактирования товаров.

Параметры запроса

Пример создания товара

• Категория верхнего уровня — Женская одежда, категория второго уровня — Джинсы. Идентификатор категории Джинсы — 200000361.
• Цвет: Белый — в системе LAliExpress, Беленький — в вашей системе.
• Артикул в вашей системе: 123456789.

Шаг 1. Создайте массив для объектов товара

1. Добавьте массив products, в котором будут передаваться ваши товары. В одном запросе можно создать до 1000 товаров.

Шаг 2. Укажите категории товара

1. Получите идентификатор категории товара. Прочитайте статью в Базе знаний Как выбрать категорию.
   Пример дерева категорий в личном кабинете
   Товары на платформу нужно загружать только в категорию нижнего уровня (у неё нет дочерних категорий). Чтобы её получить:
   • Получите верхнеуровневый список категорий LAliExpress с помощью метода POST /api/v1/categories/top.
   • Сопоставьте ваши категории товаров с категориями платформы. Для джинсов подходит категория Женская одежда, её id — 200000345.
   • Рекурсивно вызывайте метод POST /api/v1/categories/get для каждой дочерней категории из children_ids, пока не получите необходимую категорию нижнего уровня. Например, у категории Джинсы id — 200000361.
2. Добавьте в массив products параметр aliexpress_category_id с идентификатором для категории Джинсы — 200000361.
   Пример

Шаг 3. [Опционально] Укажите внешний ID товара

Шаг 4. Укажите атрибуты товара

1. Получите список атрибутов LAliExpress. Для этого используйте метод POST /api/v1/categories/get. В его ответе, в массиве properties будут атрибуты для нужной категории. Обязательные атрибуты помечены `is_required`:true.
   Пример атрибутов для категории Джинсы
2. Добавьте массив объектов attribute_list — это будет список атрибутов товара. Например, для джинс — длина, материал, стиль, тип посадки и т. д.

   Пока не добавляйте атрибут Название бренда. О нём речь пойдёт в следующем шаге.
   Один атрибут — один объект.
   Каждый объект содержит такие параметры:
   • attribute_name (string) — название атрибута;
   • attribute_name_id (string) — ID атрибута;
   • attribute_value (string) — значение атрибута;
   • attribute_value_id (string) — ID значения.
     Название и ID атрибута возьмите из списка атрибутов, полученного на предыдущем шаге:
   • attribute_name — из properties.name;
   • attribute_name_id — из properties.id.
     Пример массива с атрибутами товара
3. Задайте значения атрибутов (например, материал, из которого сшиты джинсы). Возьмите их из списка значений LAliExpress. Для этого используйте метод POST /api/v1/categories/values-dictionary, указав в запросе `is_sku_property`: false. Передайте их в attribute_value и attribute_value_id.
   Пример атрибутов при создании товара
4. Задайте атрибут Название бренда:
   1. Убедитесь, что он входит в список брендов вашего магазина. Если нужного бренда в списке нет, добавьте его в свой магазин.
   2. Передайте три параметра: attribute_name, attribute_name_id и attribute_value_id.

      Не передавайте параметр attribute_value, чтобы избежать ошибок. Он будет добавлен автоматически.
      • attribute_name — это название бренда.
      • attribute_name_id — это ID названия атрибута. Для атрибута Бренд передайте значение 2.
      • attribute_value_id — это ID бренда. Передайте одно из следующих значений:
        • либо list.id из ответа метода POST /api/v1/brand/get-brand-list;
        • либо values.id из ответа метода POST /api/v1/categories/values-dictionary для "property_id": "2".
          Пример атрибута "Бренд"
5. [Опционально] Задайте свой атрибут. Для этого добавьте такой объект:
   • attribute_name — имя вашего атрибута;
   • attribute_name_id — укажите "-1";
   • attribute_value — значение вашего атрибута;
   • attribute_value_id — укажите "-1".
     Пример создания вашего атрибута

Шаг 5. Задайте вариации товара

1. Добавьте в запрос параметр sku_info_list, который содержит массив объектов . Это будет список вариаций товара.
2. Внутрь массива добавьте столько объектов, сколько вариаций товара у вас есть.
   Каждый объект вариации содержит такие параметры:
   • sku_code (string) — артикул или штрихкод вариации — ваше значение. Например, из системы складского учёта;
   • price (string) — цена;
   • [опционально] discount_price (string) — цена со скидкой;
   • inventory (int) — остаток на складе;
   • sku_attributes_list (array of objects) — атрибуты вариации (описаны в следующем шаге).
     Пример объекта для вариации товара
3. Получите список атрибутов для вариаций LAliExpress. Для этого используйте метод POST /api/v1/categories/get. В его ответе, в массиве sku_properties будут атрибуты вариаций для нужной категории. Обязательные атрибуты помечены `is_required`:true.
   Пример полученных атрибутов вариации
   Атрибуты вариаций в карточке товара
4. Для каждой вариации заполните список атрибутов в объекте sku_attributes_list.
   Каждый атрибут — это объект с такими параметрами:
   • sku_attribute_name_id (string) — Идентификатор атрибута. Укажите значение sku_properties.id из ответа метода POST /api/v1/categories/get.
   • sku_attribute_value_id (string) — Идентификатор значения атрибута. Укажите значение values.id из ответа метода POST /api/v1/categories/values-dictionary, указав в запросе is_sku_property: true.
   • [Опционально] sku_attribute_value_definition_name (string) — Ваше собственное название атрибута. До 40 символов.
   • [Опционально] sku_image_url (string) — Ссылка на изображение атрибута — для атрибутов, у которых параметр has_customized_pic имеет значение true. Учтите требования к изображению вариации — смотрите раздел Требования к файлам.
     Если у товара несколько вариаций (как в примере с джинсами), передайте в поле sku_attributes_list несколько размеров или цветов по числу сочетаний. В примере ниже 2 цвета и 2 размера, то есть 4 сочетания параметров.
     Пример
5. Получите системные значения для атрибутов вариаций (например, для атрибута вариации Цвет значения это Синий, Белый, Чёрный). Для этого используйте метод POST /api/v1/categories/values-dictionary, указав в запросе `is_sku_property`: true. Передайте полученное значение в sku_attribute_value_id.
6. Чтобы добавить собственное название атрибуту вариации, укажите это название в параметре sku_attribute_value_definition_name. Например, цвет Беленький.
   Пример атрибутов вариации при создании товара

   В результате добавления, в системе появятся не только те вариации, которые вы сами добавите, но и автоматически сгененированные вариации — путём комбинирования атрибутов: если вы добавите чёрные джинсы размера 32 и белые джинсы размера 34, то автоматически будут добавлены белые размера 32 и чёрные размера 34, с автоматически сгенерированными артикулами, но без цены и количества.

Шаг 6. Привяжите шаблон доставки

Пример запроса

curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/product/create' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--header 'x-request-locale: ru_RU' \
--data-raw '{
    "products": [
        {
            "aliexpress_category_id": 200000361,
            "external_category_id": "ololo_external_category_id",
            "external_id": "1005006950054494",
            "attribute_list": [
                {
                    "attribute_name": "Стиль",
                    "attribute_name_id": "326",
                    "attribute_value": "Повседневные",
                    "attribute_value_id": "200000072"
                },
                {
                    "attribute_name": "Пол",
                    "attribute_name_id": "284",
                    "attribute_value": "Жен",
                    "attribute_value_id": "494"
                },
                {
                    "attribute_name": "Длина",
                    "attribute_name_id": "380",
                    "attribute_value": "До щиколоток",
                    "attribute_value_id": "200660989",
                    "attribute_unit": "inch"
                },
                {
                    "attribute_name": "Стирка",
                    "attribute_name_id": "200000355",
                    "attribute_value": "Холодная стирка",
                    "attribute_value_id": "201450895"
                },
                {
                    "attribute_name": "Фактура ткани",
                    "attribute_name_id": "100002012",
                    "attribute_value": "Хлопковый деним",
                    "attribute_value_id": "58832792"
                },
                {
                    "attribute_name": "Фит",
                    "attribute_name_id": "200000277",
                    "attribute_value": "Обычный",
                    "attribute_value_id": "200004119"
                },
                {
                    "attribute_name": "Стиль джинсов",
                    "attribute_name_id": "200001084",
                    "attribute_value": "Прямые",
                    "attribute_value_id": "200001036"
                }
            ],
            "freight_template_id": 24117182098,
            "language": "ru",
            "main_image_urls_list": [
                     "https://st.aestatic.net/scqa-storage/open-async-pictures/PIC209.jpeg",
                     "https://st.aestatic.net/scqa-storage/open-async-pictures/PIC201.jpeg",
                     "https://st.aestatic.net/scqa-storage/open-async-pictures/PIC210.jpeg",
                     "https://st.aestatic.net/scqa-storage/open-async-pictures/PIC03.png",
                     "https://st.aestatic.net/scqa-storage/open-async-pictures/PIC207.jpeg"
            ],
            "multi_language_description_list": [
                {
                    "language": "ru",
                    "web": "test"
                }
            ],
            "multi_language_subject_list": [
                {
                    "language": "ru",
                    "subject": "Джинсы прямого кроя с необработанным краем"
                },
                {
                    "language": "en",
                    "subject": "Straight cut jeans with a raw edge"
                }
            ],
            "package_length": 30,
            "package_width": 30,
            "package_height": 5,
            "weight": "2",
            "shipping_lead_time": 5,
            "product_unit": 100000015,
            "bulk_discount": 10,
            "bulk_order": 3,
            "sku_info_list": [
                {
                    "sku_code": "123456789",
                    "price": "999999",
                    "discount_price": "888888",
                    "inventory": 999,
                    "sku_attributes_list": [
                        {
                            "sku_attribute_name_id": "14",
                            "sku_attribute_value_id": "29",
                            "sku_attribute_value_definition_name": "Беленькие",
                            "sku_image_url": "https://st.aestatic.net/scqa-storage/open-async-pictures/202.jpeg"
                        },
                        {
                            "sku_attribute_name_id": "5",
                            "sku_attribute_value_id": "4183",
                            "sku_attribute_value_definition_name": "Большие"
                        }
                    ]
                }
            ],
            "video": {
                    "preview_url": "https://ae01.alicdn.com/kf/S6b61a0ee7d314042bd117b2b4bf49789w.jpg",
                    "video_url": "https://ae01.alicdn.com/kf/jeans.avi"
            },
            "seller_legal_information": {
                    "external_seller_id": "string",
                    "name": "string",
                    "inn": "string",
                    "ogrn": "string",
                    "phone": "string",
                    "legal_address": "string",
                    "vat": 0,
                    "taxation_type": "UNKNOWN"
            }
/* Turkish sellers also should pass HS codes */
        }
    ]
}'

Параметры ответа

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