Создать и загрузить товары
Для метода используется авторизация по jwt токену.
Адрес рабочей среды: https://openapi.ru.laliexpress.com

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

POST /api/v1/product/create
Создаёт и загружает на платформу товары. В запросе можно передать до 1000 товаров.
В течение 4 часов вы можете создать или обновить не более 100 000 товаров. Квота суммируется по всем методам создания/редактирования товаров.
В результате запроса формируется группа заданий (параметр group_id) на загрузку товаров на платформу. Статус выполнения заданий можно получить с помощью метода GET /api/v1/tasks?group_id=.

200 ОК в результате запроса не гарантирует создание товара. Нужно обязательно проверить статус выполнения задания.
В запросе укажите следующие заголовки:
ЗаголовокОписание
x-auth-tokenВаш jwt токен для авторизации.
x-request-locale
Необязательный. Язык ответа от API. Укажите значение ru_RU

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

ПараметрТипОбязательныйОписание
productsarrayДаМассив, в котором передаются объекты товаров.
aliexpress_category_idintДаИдентификатор категории нижнего уровня. Как получить категорию нижнего уровня.
attribute_listarray of objectsДа, если в категории есть хотя бы один обязательный параметр.Для каждого атрибута передайте объект, содержащий attribute_name, attribute_name_id, attribute_value, attribute_value_id. Вы можете получить их в массиве properties метода POST /api/v1/categories/get.
  ↳ attribute_namestringНет
Название характеристики, значение properties.name из ответа метода POST /api/v1/categories/get.
Вы также можете задать своё название характеристики.
  ↳ attribute_name_idstring(int)НетИдентификатор названия характеристики, значение properties.id из ответа метода POST /api/v1/categories/get, преобразованное из типа string > int. Чтобы задать своё название характеристики, укажите значение "-1".
  ↳ attribute_valuestringНетЗначение характеристики, значение values.name из ответа метода POST /api/v1/categories/values-dictionary. В запросе укажите `is_sku_property`:false. Вы также можете задать своё значение характеристики.
  ↳ attribute_value_idstring(int)НетИдентификатор значения характеристики, значение values.id из ответа метода POST /api/v1/categories/values-dictionary, преобразованное из типа string > int. В запросе укажите `is_sku_property`:false. Чтобы задать своё значение характеристики, укажите значение "-1".
  ↳ attribute_unitstringНетЕдиница измерения характеристики, значение units.name из ответа метода POST /api/v1/categories/get.
brand_namestringНет, УстаревшийНазвание бренда.
freight_template_idintДаИдентификатор шаблона доставки. Как получить идентификатор шаблона.
inventory_deduction_strategystringНет, Устаревший
В какой момент будет вычитаться остаток товара. Возможные значения:
  • payment_success_deduct — в момент оплаты заказа (значение по умолчанию),
  • place_order_withhold — в момент размещения заказа.
languagestringДа
Язык карточки товара по умолчанию. Возможные значения:
  • ru,
  • en.
lot_numstringНетКоличество товара в лоте. Обязательный параметр, если выбран метод продаж лотами (package_type: true).
main_image_urls_listarray of stringsДа
Массив ссылок на основные изображения товара. Все ссылки должны быть прямыми, то есть вести на изображение на вашем сервере или на CDN LAliExpress. От 1 до 6 ссылок. Требования к изображению
multi_language_description_listarray of objectsДа
Список описаний товара на нескольких языках.
Поддерживаемые языки:
  • русский,
  • турецкий,
  • английский.
Для русского и английского есть автоперевод: если не передать описание на каком-то из этих языков, система добавит описание, переведённое автоматически.
  ↳ languagestringДа
Язык описания товара. Возможные значения:
  • tr,
  • ru,
  • en,
  • tr_TR,
  • ru_RU,
  • en_US.
  ↳ webstringДаОписание товара на сайте, можно передать HTML разметку или просто текст.
  ↳ mobilestringДаОписание товара в мобильном приложении, можно передать HTML разметку или просто текст.
  ↳ mobile_detailobjectНет, УстаревшийИнформация о товаре для отображения в мобильном приложении.
    ↳ module_listobjectНет, УстаревшийСписок модулей.
      ↳ htmlobjectНет, Устаревший
Содержимое описания.
      ↳ contentstringНет, УстаревшийОписание товара в мобильном приложении, можно передать HTML разметку или просто текст.
    ↳ typestringНет, УстаревшийТип контента, передайте html.
  ↳ versionstringНет, УстаревшийВерсия модуля описания. Укажите 2.0.0.
  ↳ web_detailobjectНет, УстаревшийИнформация о товаре в web-версии.
    ↳ module_listobjectНет, УстаревшийСписок модулей.
      ↳ htmlobjectНет, УстаревшийСодержимое описания.
      ↳ contentstringНет, УстаревшийОписание товара на сайте, можно передать HTML разметку или просто текст.
    ↳ typestringНет, УстаревшийТип контента. Укажите html.
  ↳ versionstringНет, УстаревшийВерсия модуля описания. Укажите 2.0.0.
multi_language_subject_listarray of objectsДа
Список названий товара на нескольких языках.
Поддерживаемые языки:
  • русский,
  • турецкий,
  • английский.
Для русского и английского есть автоперевод: если не передать название на каком-то из этих языков, система добавит название, переведённое автоматически.
  ↳ languagestringДа
Язык названия товара. Возможные значения:
  • tr,
  • ru,
  • en,
  • tr_TR,
  • ru_RU,
  • en_US.
  ↳ subjectstringДаНазвание товара на языке.
package_height
int
minimum: 1 maximum: 700
ДаВысота упаковки в сантиметрах.
package_length
int
minimum: 1 maximum: 700
ДаДлина упаковки в сантиметрах.
package_typebooleanНетМетод продаж: true - лотами, false - поштучно.
package_width
int
minimum: 1 maximum: 700
ДаШирина упаковки в сантиметрах.
weight
string
minimum: 0.01 maximum: 700
ДаВес товара в упаковке, в килограммах (используется для расчёта доставки).
product_unitintДа
Единица измерения товара:
  • 100000013 — пара,
  • 100000014 — упаĸовĸа/упаĸовĸи,
  • 100000015 — штуĸа/штуĸи,
  • 100000017 — ĸомплеĸт/ĸомплеĸты,
  • 100000019 — ĸвадратный метр.
service_policy_idintНет, УстаревшийИдентификатор шаблона услуг, описывающего условия возврата.
shipping_lead_time
int
minimum: 1 maximum: 30
Да
Время на отправку заказа (количество дней, за которое вы обязуетесь ввести трек-номер, если у вас своя логистика).
Рекомендуем указывать не больше 5.
  • Для FBS LAliExpress и Почты России трек-номер генерируется автоматически.
  • Для FBA LAliExpress укажите любое значение, оно автоматически заменится на 30.
size_chart_idintНет
Идентификатор таблицы размеров. Нужен для одежды, обуви, аксессуаров и белья. Значение data.id из ответа метода POST /api/v1/getSizeChartTemplates.
ae_group_idstring(int)Нет, УстаревшийИдентификатор группы товаров.
bulk_discount
int
minimum: 1 maximum: 99
Да, если заполнено bulk_order.Процент скидки для оптовой покупки.
bulk_order
int
minimum: 2 maximum: 100000
Да, если заполнено bulk_discount.Минимальное количество заказов для оптовой покупки.
sku_info_listarray of objectsДаМассив вариаций (SKU) товара.
  ↳ sku_codestringДаАртикул или штрихкод вариации в вашей системе (задайте своё значение).
  ↳ price
string
minimum: 0.01 maximum: {max_value}
Да
Основная цена товара.
Может быть дробной. Например:
  • 1.01 — рубль с копейкой;
  • 1.1 — рубль с десятью копейками.
max_value:
  • USD: 999999;
  • RUB: 5000000;
  • CNY: 100000000;
  • TRY: 100000000;
  • AED: 100000000.
  ↳ discount_price
string
minimum: 0.01 maximum: {max_value}
Нет
Цена со скидкой.
Может быть дробной. Например:
  • 1.01 — рубль с копейкой;
  • 1.1 — рубль с десятью копейками.
max_value:
  • USD: 999999;
  • RUB: 5000000;
  • CNY: 100000000;
  • TRY: 100000000;
  • AED: 100000000.
  ↳ inventory
int
minimum: 0 maximum: 999999
ДаOстаток товара на складе.
  ↳ sku_attributes_listarray of objectsНетСписок характеристик вариации товара.
    ↳ sku_attribute_name_idstringДаИдентификатор характеристики вариации товара.,Укажите значение sku_properties.id из ответа метода POST /api/v1/categories/get.
    ↳ sku_attribute_value_idstringДаИдентификатор значения характеристики вариации.,Укажите значение values.id из ответа метода POST /api/v1/categories/values-dictionary, указав в запросе `is_sku_property`: true.
    ↳ sku_attribute_value_definition_namestringНетНазвание характеристики вариации товара, заданное продавцом. До 40 символов.
    ↳ sku_image_urlstringНетСсылка на изображение атрибута вариации товара, для характеристик, у которых параметр has_customized_pic: true. Учтите требования к изображению вариации
  ↳ tnved_codesarray of stringsНетКлассификатор товаров из товарной номенĸлатуры внешнеэĸономичесĸой деятельности, обязательный для некоторых категорий товаров.
  ↳ gtinstringНетГлобальный номер товарной продуĸции в единой международной базе товаров GS1.,Если передать gtin, то коды ОКПД2 и ТНВЭД будут определены и переданы автоматически.
  ↳ okpd2_codesarray of stringsНетОбщероссийсĸий ĸлассифиĸатор продуĸции по видам эĸономичесĸой деятельности. Для некоторых категорий товаров, производимых в РФ.
videoobjectНетВидео товара.
  ↳ video_urlstringНет
Внешняя ссылка на видео товара.
  • Формат: AVI, MOV, 3GP.
  • Длительность: до 31 сек.
  • Размер: до 2 ГБ.
  ↳ preview_urlstringНет
Ссылка на изображение, которое будет стоп-кадром в карточке товара. По умолчанию — первая секунда видео.
  • Формат: JPEG или PNG.
  • Большая сторона от 750 px.
  • Меньшая сторона от 100 px.

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

Рассмотрим подробнее некоторые поля на примере создания товара с характеристиками:
  • Категория верхнего уровня — Женская одежда, категория второго уровня — Джинсы. Идентификатор категории Джинсы — 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. Укажите характеристики товара

  1. Укажите характеристики товара (например, цвет, длина, материал, стиль, тип посадки) в массиве attribute_list.

    Пример массива с характеристиками товара

    Характеристики товара

    Для каждой категории в системе ALiExpress есть набор характеристик: вы можете использовать их или задать свои.
  2. Чтобы получить характеристики LAliExpress, используйте метод POST /api/v1/categories/get. В его ответе, в массиве properties будут характеристики для нужной категории. Обязательные характеристики помечены `is_required`:true. В названии характеристики attribute_name укажите значение параметра name из ответа, а для идентификатор названия attribute_name_idid из ответа.

    Пример характеристик для категории Джинсы

  3. Чтобы задать значения характеристик (например, материал, из которого сшиты джинсы), используйте метод POST /api/v1/categories/values-dictionary, указав в запросе `is_sku_property`: false. Передайте их в attribute_value и attribute_value_id.

    Пример характеристик при создании товара

  4. Чтобы задать характеристику Название бренда, убедитесь, что он входит в список брендов вашего магазина. Если нужного бренда в списке нет, добавьте его в свой магазин.
    Чтобы избежать ошибок, не передавайте параметр attribute_value. Он будет добавлен автоматически.
    Передайте три параметра:
    • attribute_name — это название бренда.
    • attribute_name_id — это ID названия атрибута. Для атрибута Бренд передайте значение 2.
    • attribute_value_id — это ID бренда. Передайте одно из следующих значений:
  5. Чтобы задать свою характеристику, укажите её имя в параметре attribute_name, а значение — в attribute_value, в attribute_name_id и attribute_value_id значение "-1":

    Пример создания вашей характеристики

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

Укажите идентификатор шаблона доставки — в параметре freight_template_id передайте значение templates.templateId из ответа метода GET /api/v1/sellercenter/get-count-product-on-onboarding-template.
Если вы используете свою доставку, откройте в личном кабинете продавца раздел Магазин → Шаблоны доставки и скопируйте идентификатор из столбца ID.

ID шаблона доставки на старой версии

Шаг 5. Задайте вариации товара, если есть

  1. Если у товара есть различные вариации товара (SKU) (например, джинсы разных цветов и размеров), укажите их в массиве sku_info_list.

    Пример объекта для вариации товара

  2. В параметре sku_code задайте уникальный артикул вариации, например, скопируйте его из вашей системы.

    Пример

  3. Для каждой категории в системе LAliExpress есть набор характеристик вариации товара, например, размер и цвет, задайте их массиве sku_attributes_list.

    Характеристики вариаций товара

  4. Чтобы получить характеристики вариации LAliExpress, используйте метод POST /api/v1/categories/get. В его ответе, в массиве sku_properties будут характеристики для нужной категории. Обязательные характеристики помечены `is_required`:true. Для идентификатора названия sku_attribute_name_id скопируйте id из ответа.
  5. Если у характеристики `has_customized_pic`:true, в параметре sku_image_url добавьте изображения вариации (учтите требования к изображениям).

    Пример характеристик вариации товара

  6. Чтобы получить значение характеристики вариации (например, для характеристики Цвет указать цвет джинс: синий, белый, чёрный), используйте метод POST /api/v1/categories/values-dictionary, указав в запросе `is_sku_property`: true. Передайте полученное значение в sku_attribute_value_id.
  7. Чтобы добавить своё название характеристике вариации, укажите значение в параметре sku_attribute_value_definition_name. Например, цвет Беленькие.

    Пример характеристик вариации при создании товара

  8. Если у товара несколько вариаций, как в примере с джинсами, передайте в поле sku_attributes_list несколько размеров или цветов по числу сочетаний. В примере ниже 2 цвета и 2 размера, то есть 4 сочетания параметров.

    Пример

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

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,
            "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",
                    "mobile": "<p>Lorem ipsum dolor sit amet consectetur, adipisicing elit.</p>"
                }
            ],
            "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"
            }
        }
    ]
}'

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

ПараметрТипОписание
group_idstringИдентификатор запроса. По нему можно будет посмотреть статусы загрузки и обновления товаров.
resultsarray of objectsРезультаты запроса.
okbooleanБыл ли запрос успешным.
task_idstringИдентификатор задания.
errorsobjectСообщения об ошибках.

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

200 OK. Успешный запрос

200 OK. Ошибка в запросе