Адрес рабочей среды: https://openapi.ru.laliexpress.com
{
"fields": [
{<товар-1>},
{<товар-2>},
]
}
{
"fields": [
{
"product_id": "1234506032543210",
"key": <название_параметра>,
"value": <значение_параметра>,
"external_id": "1005006950054494"
}
]
}
{
"fields": [
{
"product_id": "1234506032543210",
"key": "image_urls",
"value": [
"https://ae04.alicdn.com/kf/S4b4c0eb782d14046a44b5cc88ff05f08J.jpeg",
"https://st.aestatic.net/scqa-storage/open-async-pictures/TEST%20PIC%204.jpeg"
],
"external_id": "1005006950054494"
}
]
}
{
"fields": [
{
"product_id": "1234506032543210",
"key": "delivery_time",
"value": 4,
"external_id": "1005006950054494"
}
]
}
"key": "subject",
"value": "<название_товара_на_основном_языке>"
"value": "[{}{}]"
"language": "<локаль>",
"subject": "<название для указанной локали>"
"value": "[{\"language\": \"<локаль>\", \"subject\": \"название для указанной локали\"}]"
{
"fields": [
{
"product_id": "1234506032543210",
"key": "subject",
"value": "[{\"language\": \"ru_RU\", \"subject\": \"Дверь №2\"}, {\"language\": \"en_US\", \"subject\": \"Door No2\"}]",
"external_id": "1005006950054494"
}
]
}
Заголовок | Описание |
---|---|
x-auth-token | Ваш JWT-токен для авторизации. |
x-request-locale | Необязательный. Язык ответа от API. Укажите значение ru_RU |
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
fields | object | Да | Информация по изменяемым параметрам товара. |
↳ key | string | Да | Ключ с названием параметра. Возможные значения:
|
↳ value | dynamic | Да | Значение для ключа key. Тип данных value зависит от того, что передано в key:
|
↳ product_id | string(int) | Да | Идентификатор товара, в котором нужно произвести изменение. В запросе можно передать до 1000 идентификаторов. |
↳ external_id | string | Нет | Ваш собственный идентификатор товара. Нужен, чтобы сопоставить задание на изменение товара с самим товаром. Укажите либо ID товара из внешней системы (например, из системы складского учёта), либо product_id. |
curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/product/update-field' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--data-raw '{
"fields": [
{
"key": "delivery_time",
"value": 4,
"product_id": "1005004449114979",
"external_id": "1005006950054494"
}
]
}'
Параметр | Тип | Описание |
---|---|---|
group_id | string | Идентификатор запроса. По нему можно будет посмотреть статусы загрузки и обновления товаров. |
results | array of objects | Результаты запроса. |
↳ ok | boolean | Был ли запрос успешным. |
↳ task_id | string | Идентификатор задания. |
↳ error | string | Текст ошибки. |
↳ external_id | string | Ваш собственный идентификатор товара. Используйте, чтобы сопоставить задание на изменение товара с самим товаром. |
{
"group_id": "10757515",
"results": [
{
"ok": true,
"task_id": "398792610",
"error": "",
"external_id": "1005006950054494"
}
]
}
В течение 4 часов вы можете создать или обновить не более 100 000 товаров. Квота суммируется по всем методам создания/редактирования товаров.
Заголовок | Описание |
---|---|
x-auth-token | Ваш JWT-токен для авторизации. |
x-request-locale | Необязательный. Язык ответа от API. Укажите значение ru_RU |
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
products | array of objects | Да | Товары. |
↳ product_id | string(int) | Да | Идентификатор товара. В запросе можно передать до 1000 идентификаторов. |
↳ external_id | string | Нет | Ваш собственный идентификатор товара. Нужен, чтобы сопоставить задание на изменение товара с самим товаром. Укажите либо ID товара из внешней системы (например, из системы складского учёта), либо product_id. |
↳ aliexpress_category_id | int | Да | Идентификатор категории самого нижнего уровня (у которой нет дочерних категорий). |
↳ attribute_list | object | Нет | Список ключей и значений атрибутов товара. |
↳ attribute_name | string | Нет | Название атрибута. Чтобы изменить существующий атрибут, передайте значение properties.name из ответа метода POST /api/v1/categories/get. Чтобы создать новый атрибут, передайте новое название. |
↳ attribute_name_id | string(int) | Нет | Идентификатор названия атрибута. Если вы обновляете существующий атрибут, передайте её идентификатор — это значение properties.id из ответа метода POST /api/v1/categories/get. Если вы создаёте новый атрибут, у которого пока нет ID в системе, передайте значение «-1». |
↳ attribute_value | string | Нет | Значение атрибута. Чтобы использовать существующее значение атрибута, передайте значение values.name из ответа метода POST /api/v1/categories/values-dictionary. При этом в запросе вам нужно указать `is_sku_property`:false. Чтобы добавить новое значение атрибута, передайте новое значение. |
↳ attribute_value_id | string(int) | Нет | Идентификатор значения атрибута. Если вы передаёте существующее значение атрибута, то в этом параметре передайте соответствующий идентификатор — это значение values.id из ответа метода POST /api/v1/categories/values-dictionary. Если вы добавляете новое значение атрибута, у которого пока нет ID в системе, укажите значение «-1». |
↳ attribute_unit | string | Нет | Единица измерения атрибута, значение units.name из ответа метода POST /api/v1/categories/get. |
↳ gtin | string | Нет | Глобальный номер товарной продуĸции в единой международной базе товаров GS1. |
↳ inventory_deduction_strategy | string | Нет | В какой момент будет вычитаться остаток товара. Возможные значения:
|
↳ freight_template_id | int | Да | Идентификатор шаблона доставки. Передайте значение templates.templateId из ответа метода GET /api/v1/sellercenter/get-count-product-on-onboarding-template. |
↳ language | string | Да | Язык карточки товара по умолчанию. Возможные значения:
|
↳ lot_num | string | Нет | Количество товара в лоте. |
↳ main_image_urls_list | array of strings | Да | Массив ссылок на основные изображения товара. Все ссылки должны быть прямыми, то есть вести на изображение на вашем сервере или на CDN LAliExpress. Требования к изображениям |
↳ multi_language_description_list | array of objects | Да | Список описаний товара на нескольких языках. Поддерживаемые языки:
Для русского и английского есть автоперевод: если не передать описание на каком-то из этих языков, система добавит описание, переведённое автоматически. |
↳ language | string | Да | Язык описания товара. Возможные значения:
|
↳ web | string | Да | Описание товара на сайте, можно передать HTML разметку или просто текст. |
↳ mobile | string | Да | Описание товара в мобильном приложении, можно передать HTML разметку или просто текст. |
↳ multi_language_subject_list | object | Да | Список названий товара на нескольких языках. Поддерживаемые языки:
Для русского и английского есть автоперевод: если не передать название на каком-то из этих языков, система добавит название, переведённое автоматически. |
↳ language | string | Да | Язык названия товара. Возможные значения:
|
↳ subject | string | Да | Название товара на языке. |
↳ okpd2_codes | array of strings | Нет | Общероссийсĸий ĸлассифиĸатор продуĸции по видам эĸономичесĸой деятельности, обязательный для некоторых категорий товаров.,Если вы передали gtin, то система определит okpd2_codes автоматически. |
↳ package_height | int minimum: 1
maximum: 700 | Да | Высота упаковки в сантиметрах. |
↳ package_length | int minimum: 1
maximum: 700 | Да | Длина упаковки в сантиметрах. |
↳ package_type | boolean | Нет | Метод продаж:
|
↳ package_width | int minimum: 1
maximum: 700 | Да | Ширина упаковки в сантиметрах. |
↳ product_unit | int | Нет | Единица измерения товара:
|
↳ service_policy_id | int | Нет | Идентификатор шаблона услуг, описывающего условия возврата. id = 0 соответствует шаблону по умолчанию: Service Template for New Sellers. |
↳ shipping_lead_time | string minimum: 1
maximum: 30 | Да | Время на отправку заказа (количество дней, за которое вы обязуетесь ввести трек-номер, если у вас своя логистика). Рекомендуем указывать не больше 5.
|
↳ size_chart_id | string | Нет | Идентификатор таблицы размеров. Нужен для одежды, обуви, аксессуаров и белья. Значение data.id из ответа метода POST /api/v1/getSizeChartTemplates. |
↳ bulk_discount | int minimum: 1
maximum: 99 | Да, если заполнено bulk_order. | Процент скидки для оптовой покупки. |
↳ bulk_order | int minimum: 2
maximum: 100000 | Да, если заполнено bulk_discount. | Минимальное количество заказов для оптовой покупки. |
↳ sku_info_list | array of objects | Да | Информация о вариациях этого товара. Одна вариация отличается от другой уникальным набором атрибутов. Не создавайте две вариации с одинаковым набором атрибутов. |
↳ price | string minimum: 0.01 | Нет | Цена товара. Обязательное поле для новых товаров. Рекомендации:
|
↳ discount_price | string minimum: 0.01 | Нет | Цена со скидкой. Рекомендации:
|
↳ gtin | string | Нет | Глобальный номер товарной продуĸции в единой международной базе товаров GS1. Если передать gtin, то okpd2_codes и tnved_codes будут определены и переданы автоматически. |
↳ inventory | int minimum: 0
maximum: 999999 | Нет | Oстаток товара на складе. Рекомендации:
|
↳ okpd2_codes | array of strings | Нет | Общероссийсĸий ĸлассифиĸатор продуĸции по видам эĸономичесĸой деятельности, обязательный для некоторых категорий товаров. Если вы передали gtin, то система определит okpd2_codes автоматически. |
↳ sku_attributes_list | object | Нет | Список атрибутов вариации товара. Когда вы обновите атрибуты одной вариации, у вас в списке товаров могут появиться новые вариации, которые вы не добавляли. Система создаёт новые вариации путём комбинирования атрибутов. У них будут автоматически сгенерированные артикулы, но не будет цены и остатка. Пример: У вас есть две вариации одной модели джинс:
Вы редактируете вариацию и меняете размер белых джинс на 34. В результате у вас есть две вариации, которые вы добавили сами:
Автоматически будут добавлены белые размера 32 и чёрные размера 34. В итоге вместо двух у вас станет четыре вариации:
|
↳ sku_attribute_name_id | string | Да | Идентификатор названия атрибута вариации. |
↳ sku_attribute_value_id | string | Да | Идентификатор значения атрибута вариации. |
↳ sku_attribute_value_definition_name | string | Нет | Название атрибута вариации товара, заданное продавцом. До 40 символов. |
↳ sku_image_url | string | Нет | Ссылка на изображение атрибута вариации товара, для тех атрибутов, у которых параметр has_customized_pic: true. Учтите требования к изображению вариации |
↳ sku_code | string | Да | Идентификатор вариации товара: артикул или штрихкод (задаётся продавцом). |
↳ tnved_codes | array of strings | Нет | Классификатор товаров из товарной номенĸлатуры внешнеэĸономичесĸой деятельности, обязательный для некоторых категорий товаров. Если вы передали gtin, то система определит tnved_codes автоматически. |
↳ tnved_codes | array of strings | Нет | Классификатор товаров из товарной номенĸлатуры внешнеэĸономичесĸой деятельности, обязательный для некоторых категорий товаров. Если вы передали gtin, то система определит tnved_codes автоматически. |
↳ weight | string minimum: 0.01
maximum: 500 | Да | Вес товара в упаковке (используется для расчёта доставки) в килограммах. |
↳ video | object | Нет | Видео товара. Укажите один из параметров:
|
↳ video_id | string | Нет | Идентификатор видео товара. Значение video.video_id из ответа метода POST /api/v1/product/get-seller-product |
↳ video_url | string | Нет | Внешняя ссылка на видео товара.
|
↳ preview_url | string | Нет | Ссылка на изображение, которое будет стоп-кадром в карточке товара. По умолчанию — первая секунда видео.
|
curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/product/edit' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--data-raw '{
"products": [
{
"product_id": 1005004632052714,
"external_id": "1005006950054494",
"aliexpress_category_id": 201323501,
"attribute_list": [
{
"attribute_name": "Название бренда",
"attribute_name_id": "2",
"attribute_value": "Alvin",
"attribute_value_id": "310368382"
},
{
"attribute_name": "Происхождение",
"attribute_name_id": "219",
"attribute_value": "CS (производитель)",
"attribute_value_id": "9441834204"
},
{
"attribute_name": "Номер модели",
"attribute_name_id": "3",
"attribute_value": "bBuzmVEbLf"
},
{
"attribute_name": "Сертификация",
"attribute_name_id": "348",
"attribute_value": "Отходов электрического и электронного оборудования",
"attribute_value_id": "202243828"
},
{
"attribute_name": "Источник питания",
"attribute_name_id": "200000914",
"attribute_value": "Сухой и перезаряжаемый",
"attribute_value_id": "202605811"
},
{
"attribute_name": "Объем",
"attribute_name_id": "26",
"attribute_value": "MODkblDcrI",
"attribute_unit": "inch"
}
],
"freight_template_id": 24097758402,
"language": "ru",
"lot_num": 1742,
"main_image_urls_list": [
"https://ae04.alicdn.com/kf/S4b4c0eb782d14046a44b5cc88ff05f08J.jpeg",
"https://st.aestatic.net/scqa-storage/open-async-pictures/TEST%20PIC%204.jpeg",
"https://st.aestatic.net/scqa-storage/open-async-pictures/TEST%20PIC%201.jpeg",
"https://st.aestatic.net/scqa-storage/open-async-pictures/TEST%20PIC%202.jpeg",
"https://st.aestatic.net/scqa-storage/open-async-pictures/TEST%20PIC%209.jpeg"
],
"multi_language_description_list": [
{
"language": "tr",
"web": "<p>Тут описание товара на турецком языке, предназначенное для отображения <b>на сайте</b>. Оно размечено в HTML.</p>",
"mobile": "<p>Тут описание товара на турецком языке, предназначенное для отображения <b>в мобильном приложении</b>. Оно размечено в HTML.</p>"
},
{
"language": "en",
"web": "<p>Тут описание товара на английском языке, предназначенное для отображения <b>на сайте</b>. Оно размечено в HTML.</p>",
"mobile": "<p>Тут описание товара на английском языке, предназначенное для отображения <b>в мобильном приложении</b>. Оно размечено в HTML.</p>"
}
],
"multi_language_subject_list": [
{
"language": "tr",
"subject": "1633451947 TEST ÜRÜNÜ ASENKRON tr"
},
{
"language": "en",
"subject": "1633451947 TEST PRODUCT ASYNC en"
}
],
"tnved_codes": [
"3306200000"
],
"package_height": 7,
"package_length": 38,
"package_type": true,
"package_width": 70,
"product_unit": 100078587,
"shipping_lead_time": 16,
"size_chart_id": 0,
"bulk_discount": 10,
"bulk_order": 3,
"sku_info_list": [
{
"discount_price": "888906.0",
"gtin": "",
"inventory": 192406,
"price": "966154.0",
"sku_attributes_list": [
{
"sku_attribute_name_id": "200007763",
"sku_attribute_value_id": "5581"
},
{
"sku_attribute_name_id": "14",
"sku_attribute_value_id": "175"
}
],
"sku_code": "777771code10001"
},
{
"discount_price": "888906.0",
"inventory": 192406,
"price": "966154.0",
"sku_attributes_list": [
{
"sku_attribute_name_id": "200007763",
"sku_attribute_value_id": "5581"
},
{
"sku_attribute_name_id": "14",
"sku_attribute_value_id": "173"
}
],
"sku_code": "777771code10002",
"sku_id": "123412654"
}
],
"weight": "259.23",
"video": {
"video_id": 1100181441116
}
/* Turkish sellers also should pass HS codes */
}
]
}'
Параметр | Тип | Описание |
---|---|---|
group_id | string | Идентификатор запроса. По нему можно будет посмотреть статусы загрузки и обновления товаров. |
results | array of objects | Результаты запроса. |
↳ ok | boolean | Был ли запрос успешным. |
↳ task_id | string | Идентификатор задания. |
↳ errors | object | Ошибки запроса. |
↳ external_id | string | Ваш собственный идентификатор товара. Используйте, чтобы сопоставить задание на изменение товара с самим товаром. |
{
"group_id": "10758379",
"results": [
{
"ok": true,
"task_id": "398799059",
"errors": {},
"external_id": "1005006950054494"
}
]
}
В течение 4 часов вы можете создать или обновить не более 100 000 товаров. Квота суммируется по всем методам создания/редактирования товаров.
Заголовок | Описание |
---|---|
x-auth-token | Ваш JWT-токен для авторизации. |
x-request-locale | Необязательный. Язык ответа от API. Укажите значение ru_RU |
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
productIds | array of strings | Да | Идентификаторы товаров на LAliExpress. |
curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/product/offline' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--data-raw '{
"productIds": [
"1005002305964192",
"1005003559229967"
]
}'
Параметр | Тип | Описание |
---|---|---|
group_id | string | Идентификатор запроса. По нему можно будет посмотреть статусы загрузки и обновления товаров. |
results | object | Результаты запроса. |
↳ ok | boolean | Был ли запрос успешным. |
↳ task_id | string | Идентификатор задания. |
↳ errors | object | Сообщения об ошибках. |
{
"group_id": "10759303",
"results": [
{
"ok": true,
"task_id": "398812675",
"errors": {}
}
]
}
В течение 4 часов вы можете создать или обновить не более 100 000 товаров. Квота суммируется по всем методам создания/редактирования товаров.
Заголовок | Описание |
---|---|
x-auth-token | Ваш JWT-токен для авторизации. |
x-request-locale | Необязательный. Язык ответа от API. Укажите значение ru_RU |
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
productIds | array of strings | Да | Идентификаторы товаров на LAliExpress. |
curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/product/online' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--data-raw '{
"productIds": [
"1005002305964192",
"1005002306096362",
"1005003559229967"
]
}'
Параметр | Тип | Описание |
---|---|---|
group_id | string | Идентификатор запроса. По нему можно будет посмотреть статусы загрузки и обновления товаров. |
results | object | Результаты запроса. |
↳ ok | boolean | Был ли запрос успешным. |
↳ task_id | string | Идентификатор задания. |
↳ errors | object | Сообщения об ошибках. |
{
"group_id": "10759236",
"results": [
{
"ok": true,
"task_id": "398812303",
"errors": {}
}
]
}
Заголовок | Описание |
---|---|
x-auth-token | Ваш JWT-токен для авторизации. |
x-request-locale | Необязательный. Язык ответа от API. Укажите значение ru_RU |
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
productIds | array of strings | Да | Идентификаторы товаров на LAliExpress. |
curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/product/delete' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--data '{
"productIds": [
"1005002305964192",
"1005003559229967"
]
}'
Параметр | Тип | Описание |
---|---|---|
group_id | string | Идентификатор запроса. По нему можно будет посмотреть статусы удаления товаров. |
results | object | Результаты запроса. |
↳ ok | boolean | Был ли запрос успешным. |
↳ task_id | string | Идентификатор задания. |
↳ errors | object | Сообщения об ошибках. |
{
"group_id": "10759303",
"results": [
{
"ok": true,
"task_id": "398812675",
"errors": {}
}
]
}
Заголовок | Описание |
---|---|
x-auth-token | Ваш JWT-токен для авторизации. |
x-request-locale | Необязательный. Язык ответа от API. Укажите значение ru_RU |
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
group_id | int | Да | Идентификатор запроса, полученный в ответе при загрузке, обновлении полей товара, снятии или возвращении товаров в продажу. Передаётся в виде URL-параметра. |
curl --location --request GET 'https://openapi.ru.laliexpress.com/api/v1/tasks?group_id=10758365' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>'
Параметр | Тип | Описание |
---|---|---|
data | array of objects | Объекты с результатами запроса. |
↳ id | string | Идентификатор задачи. |
↳ group_id | string | Идентификатор группы задач. |
↳ action | int | Какое действие осуществлялось в запросе:
|
↳ status | int | Статус:
|
↳ product_id | string | Идентификатор товара. |
↳ sku_codes | array of strings | Артикулы вариаций товара. |
↳ error | object | Информация об ошибках. |
↳ code | string | Код ошибки. |
↳ message | string | Сообщение об ошибке. |
↳ created_at | string | Время создания задания на добавление или обновление товара, в формате: YYY-MM-DDThh:mm:ss. |
↳ updated_at | string | Время, когда обновился статус по заданию на добавление или обновление товара. Например, товар создался или создание товара завершилось с ошибкой, в формате: YYY-MM-DDThh:mm:ss. |
↳ external_id | string | Ваш собственный идентификатор товара. Используйте, чтобы сопоставить задание на изменение товара с самим товаром. |
{
"data": [
{
"id": "409720502",
"group_id": "11316813",
"action": 1,
"status": 1,
"product_id": "0",
"sku_codes": [
"RMC-PM380"
],
"error": null,
"created_at": "2022-08-16T08:44:41.830143Z",
"updated_at": "2022-08-16T08:44:41.830143Z",
"warnings": [],
"batch_results": {},
"external_id": "1005006950054494"
}
]
}
{
"data": [
{
"id": "398799028",
"group_id": "10758365",
"action": 2,
"status": 3,
"product_id": "1005004632052714",
"sku_codes": [],
"error": null,
"created_at": "2022-08-11T11:56:04.617928Z",
"updated_at": "2022-08-11T11:56:05.554716Z",
"warnings": [],
"batch_results": {},
"external_id": "1005006950054494"
}
]
}
{
"data": [
{
"id": "409720502",
"group_id": "11316813",
"action": 1,
"status": 4,
"product_id": "0",
"sku_codes": [
"RMC-PM380"
],
"error": {
"code": "2",
"message": "createProduct failed: p.propertyValueIdLong must not be null"
},
"created_at": "2022-08-16T08:44:41.830143Z",
"updated_at": "2022-08-16T10:08:28.189502Z",
"warnings": [],
"batch_results": {},
"external_id": "1005006950054494"
}
]
}