Управлять ценами и остатками

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

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

Параметр	Тип	Обязательный	Описание
stocks	array of objects	Да	Массив артикулов товара.
↳ sku	string(int)	Да	Идентификатор артикула товара. Передайте значение параметра sku.sku_id из ответа метода POST /api/v1/product/get-seller-product.
↳ sc_item_id	string(int)	Нет	Уникальный идентификатор товара в системе управления поставками ASCP. Параметр нужно заполнить, если товар привязан к этой системе.

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

curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/stocks' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--data-raw '{
    "stocks": [
        {
            "sku": "12000030548567848"
        }
    ]
}'

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

Параметр	Тип	Описание
data	object	Данные с ответом на запрос.
↳ skus_info	array of objects	Информация о товарах, идентификаторы которых указаны в запросе.
↳ sku	string(int)	Идентификатор вариации товара.
↳ max_sellable_quantity	string(int)	Количество товара, доступное к продаже.
↳ error	object	Ошибка.
↳ code	string	Код ошибки.
↳ message	string	Сообщение об ошибке.
↳ details	object	Подробное описание ошибки.

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

{
    "data": {
        "skus_info": [
            {
                "sku": "12000030548567848",
                "prefer_sellable_quantity": "15",
                "max_sellable_quantity": "15",
                "inventory_type": "100",
                "inv_snapshot": "0^0_1^12000030548567848_2^4000000002531691933",
                "prefer_warehouse": {
                    "warehouse_type": "dropshipping",
                    "warehouse_code": "ae_marketplace",
                    "warehouse_owner_id": "0",
                    "warehouse_address": {
                        "address_id": "",
                        "detail_address": "",
                        "longitude": 0,
                        "latitude": 0,
                        "location_tree_address_id": "",
                        "location_tree_address_name": ""
                    }
                },
                "inventory_line": [
                    {
                        "batch_code": null,
                        "active_time": null,
                        "expire_time": null,
                        "sellable_quantity": "15",
                        "estimate_inbound_time": null
                    }
                ],
                "warehouse_id": "0",
                "channel_inventory_line": {
                    "active_time": "0",
                    "expire_time": "0",
                    "sellable_quantity": "0",
                    "total_quantity": "0",
                    "sold_quantity": "0"
                }
            }
        ]
    },
    "error": null
}

Обновить остатки товара по SKU коду

POST /api/v1/product/update-sku-stock

Обновляет количество экземпляров товара на складе по его SKU коду.

В результате запроса формируется группа заданий (параметр group_id). Статус выполнения заданий можно получить с помощью метода GET /api/v1/tasks?group_id=.

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

В запросе укажите следующие заголовки:

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

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

Параметр	Тип	Обязательный	Описание
product_id	string	Да	Идентификатор товара, в котором нужно произвести изменение. В запросе можно передать до 1000 идентификаторов.
external_id	string	Нет	Ваш собственный идентификатор товара. Нужен, чтобы сопоставить задание на изменение товара с самим товаром. Укажите либо ID товара из внешней системы (например, из системы складского учёта), либо product_id.
skus	array of strings	Да	Параметры экземпляров товара.
↳ sku_code	string	Да	Идентификатор экземпляра: артикул или штрихкод.
↳ inventory	string minimum: 0 maximum: 999999	Да	Остаток товара на складе.

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

curl --location --request POST 'openapi.ru.laliexpress.com/api/v1/product/update-sku-stock' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--data-raw '{
    "products": [
        {
            "product_id": "1005004632052714",
            "skus": [
                {
                    "sku_code": "1634134071O7gXx6rY57",
                    "inventory": "100"
                }
            ],
            "external_id": "1005006950054494"
        }
    ]
}'

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

Параметр	Тип	Описание
group_id	string	Идентификатор запроса. По нему можно будет посмотреть статусы загрузки и обновления товаров.
results	object	Результаты запроса.
↳ ok	boolean	Был ли запрос успешным.
↳ task_id	string	Идентификатор задания.
↳ errors	array of strings	Массив с текстами ошибок.
↳ external_id	string	Ваш собственный идентификатор товара. Используйте, чтобы сопоставить задание на изменение товара с самим товаром.

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

{
    "group_id": "10762304",
    "results": [
        {
            "ok": true,
            "task_id": "398838541",
            "errors": {},
            "external_id": "1005006950054494"
        }
    ]
}

Обновить цену товара по SKU коду

POST /api/v1/product/update-sku-price

Обновляет цену экземпляра товара по его SKU коду.

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

В запросе укажите следующие заголовки:

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

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

Параметр	Тип	Обязательный	Описание
product_id	string	Да	Идентификатор товара, в котором нужно произвести изменение. В запросе можно передать до 1000 идентификаторов.
external_id	string	Нет	Ваш собственный идентификатор товара. Нужен, чтобы сопоставить задание на изменение товара с самим товаром. Укажите либо ID товара из внешней системы (например, из системы складского учёта), либо product_id.
skus	array of objects	Да	Параметры экземпляров товара.
↳ sku_code	string	Да	Идентификатор экземпляра: артикул или штрихкод.
↳ 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.

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

curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/product/update-sku-price' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--data-raw '{
    "products": [
        {
            "product_id": "1005004632052714",
            "skus": [
                {
                    "sku_code": "1634134071O7gXx6rY57",
                    "price": "9999.0",
                    "discount_price": "8999.0"
                }
            ],
            "external_id": "1005006950054494"
        }
    ]
}'

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

Параметр	Тип	Описание
group_id	string	Идентификатор запроса. По нему можно будет посмотреть статусы загрузки и обновления товаров.
results	object	Результаты запроса.
↳ ok	boolean	Был ли запрос успешным.
↳ task_id	string	Идентификатор задания.
↳ errors	array of strings	Массив с текстами ошибок.
↳ external_id	string	Ваш собственный идентификатор товара. Используйте, чтобы сопоставить задание на изменение товара с самим товаром.

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

{
    "group_id": "10762989",
    "results": [
        {
            "ok": true,
            "task_id": "398841083",
            "errors": {},
            "external_id": "1005006950054494"
        }
    ]
}