Адрес рабочей среды: https://openapi.ru.laliexpress.com
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| orders | array of objects | Да | Список заказов. |
| ↳ trade_order_id | int | Да | Идентификатор заказа, значение поля orders.id из ответа метода получения списка заказов. |
| ↳ total_length | int | Да | Длина посылки (см). |
| ↳ total_width | int | Да | Ширина посылки (см). |
| ↳ total_height | int | Да | Высота посылки (см). |
| ↳ total_weight | double | Да | Вес посылки (кг). |
| ↳ items | int | Да | Список товаров в отправлении. |
| ↳ quantity | int | Да | Количество единиц вариации товара в отправлении, значение поля orders.orders_lines.quantity из ответа метода получения списка заказов. |
| ↳ sku_id | int | Да | Идентификатор вариации товара, значение поля orders.orders_lines.sku_id из ответа метода получения списка заказов. |
| ↳ product_source_id | int | Да | Идентификатор источника товара. Значение product_source_id из ответа метода POST /seller-api/v1/order/get-order-list. |
| ↳ jewelry_codes | array of objects | Нет | Массив кодов маркировки для ювелирных изделий. |
| ↳ sku_index | int | Нет | Порядковый номер вариации товара, используется для маркировки одинаковых товаров. |
| ↳ codes | array of strings | Нет | Коды маркировки ювелирных изделий. |
curl --location --request POST 'https://openapi.ru.laliexpress.com/seller-api/v1/logistic-order/create' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--data-raw '{
"orders": [
{
"trade_order_id": 2207197727599807,
"total_length": 20,
"total_width": 10,
"total_height": 5,
"total_weight": 1.5,
"items": [
{
"quantity": 1,
"sku_id": 12000027037707016
}
]
}
]
}'
| Параметр | Тип | Описание |
|---|---|---|
| data | object | Результат запроса. |
| ↳ orders | array of objects | Список заказов. |
| ↳ trade_order_id | int | Идентификатор заказа. |
| ↳ logistic_orders | array of objects | Список отправлений. |
| ↳ id | int | Идентификатор отправления. |
| ↳ lines | array of objects | Список товаров в отправлении. |
| ↳ sku_id | int | Идентификатор вариации товара. |
| ↳ quantity | int | Количество единиц этой вариации товара в отправлении. |
| ↳ product_source_id | int | Идентификатор источника товара. |
| ↳ errors | object | Информация об ошибках. |
| ↳ common_errors | object | Общие ошибки. |
| ↳ item_errors | object | Ошибки по отдельным заказам. |
| error | object | Ошибки при создании отправления. |
| ↳ code | string | Код ошибки: |
| ↳ message | string | Сообщение об ошибке. |
| ↳ details | object | Дополнительная информация по ошибке. |
{
"error": {
"code": "InternalServerError",
"message": "string",
"details": {}
},
"data": {
"orders": [
{
"trade_order_id": 2212196848241455,
"logistic_orders": [
{
"id": 9804616,
"lines": [
{
"sku_id": 12000026559024132,
"product_source_id": 0,
"quantity": 3
}
]
}
]
}
],
"errors": {
"common_errors": [
{
"code": "NoTradeOrderFound",
"message": "Order not found"
}
],
"item_errors": {
"additionalProp1": [
{
"code": "string",
"message": "string"
}
],
"additionalProp2": [
{
"code": "string",
"message": "string"
}
],
"additionalProp3": [
{
"code": "string",
"message": "string"
}
]
}
}
}
}
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| logistic_order_ids | array of integers | Нет | Список идентификаторов отправлений, значение поля orders.logistic_orders.id из ответа метода создания отправления. |
| tracking_numbers | array of strings | Нет | Номера отслеживаний. |
| trade_order_ids | array of integers | Нет | Идентификаторы заказов. |
| filter_status | string | Нет | Фильтр по статусу отправлений, может принимать значения:
|
| gmt_create_from | string | Нет | Вывести в список заказы с датой создания после этой даты, формат: YYYY-MM-DDThh:mm:ssZ. |
| gmt_create_to | string | Нет | Вывести в список заказы с датой создания не позднее этой даты, формат: YYYY-MM-DDThh:mm:ssZ. |
| page_size | int | Да | Число страниц, которые нужно вывести. |
| page | int | Да | Номер страницы из списка, которую нужно вывести. |
| gmt_cut_off_date_from | string | Нет | Фильтр заказов с датой отгрузки после этой даты, формат: YYYY-MM-DDThh:mm:ssZ. |
| gmt_cut_off_date_to | string | Нет | Фильтр заказов с датой отгрузки не позднее этой даты, формат: YYYY-MM-DDThh:mm:ssZ. |
| problem_state_filter | string | Нет | Фильтр по типу ошибки, может принимать значения:
|
| sort_params | object | Нет | Параметры сортировки. |
| ↳ order_sort_type | string | Нет | Метод сортировки, может принимать значения:
|
| ↳ query_sort | string | Нет | Тип сортировки, может принимать значения:
|
| logistic_order_info | string | Нет | Флаг предоставляемой информации, может принимать значения:
|
curl --location --request POST 'https://openapi.ru.laliexpress.com/seller-api/v1/logistic-order/get' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--data-raw '{
"page_size": 1,
"page": 1
}'
| Параметр | Тип | Описание |
|---|---|---|
| error | object | Ошибка при запросе. |
| ↳ code | string | Код ошибки, возможные значения:
|
| ↳ message | string | Сообщение об ошибке. |
| ↳ details | object | Дополнительная информация по ошибке. |
| data | object | Информация по запросу. |
| ↳ logistic_orders | array of objects | Информация по отправлениям. |
| ↳ logistic_order_id | int | Идентификатор отправления. |
| ↳ trade_order_id | int | Идентификатор заказа. |
| ↳ handover_list_id | int | Идентификатор листа передачи. |
| ↳ cut_off_date | string | Если отправление уже отгружено, указана дата отгрузки. Если отправление ещё не отгружено, указана дата, до которой его нужно отгрузить. Дата может меняться, если отгрузка переносится (не более 2 раз). |
| ↳ status | string | Статус отправления, возможные значения:
|
| ↳ state_status_name | string | Название статуса. |
| ↳ platform_tracking_code | string | Код отслеживания. |
| ↳ items_count | int | Количество товаров. |
| ↳ creation_error | string | Ошибка создания заказа. |
| ↳ error_description | string | Детальное описание ошибки при создании заказа. |
| ↳ gmt_create | string | Дата создания заказа. |
| ↳ trade_order_source | string | Источник заказа. |
| ↳ total_amount | int | Сумма заказа. |
| ↳ buyer_name | string | Имя покупателя. |
| ↳ buyer_country_code | string | Код страны покупателя. |
| ↳ items | object | Информация о товаре. |
| ↳ item_id | int | Уникальный идентификатор товара. |
| ↳ sku_id | int | Идентификатор вариации товара. |
| ↳ name | string | Название товара. |
| ↳ item_price | int | Цена товара. |
| ↳ img_url | string | Ссылка на изображение товара. |
| ↳ total_amount | int | Сумма за товар. |
| ↳ properties | [string] | Свойства товара. |
| ↳ mobile_url | string | Ссылка на товар в мобильном приложении. |
| ↳ web_url | string | Ссылка на товар на сайте. |
| ↳ product_source_id | string | Идентификатор происхождения товара. |
| ↳ currency | string | Валюта товара. |
| ↳ quantity | int | Количество единиц этой вариации товара в отправлении. |
| ↳ marking_required | boolean | Флаг обязательной маркировки. |
| ↳ jewelry_codes | array of object | Массив маркируемых ювелирных изделий. |
| ↳ sku_index | int | Порядковый номер вариации товара, используется для маркировки одинаковых товаров. |
| ↳ codes | array of string | Коды маркировки ювелирных изделий. |
| ↳ page_info | object | Информация по страницам созданного списка. |
| ↳ current | int | Номер текущей страницы в списке. |
| ↳ page_size | int | Количество страниц в списке. |
| ↳ total | int | Количество отправлений, удовлетворяющих фильтру. |
| ↳ addresses | object | Список адресов доставки. |
| ↳ receiver_address | object | Адрес получателя. |
| ↳ zip_code | int | Почтовый индекс. |
| ↳ country_code | string | Код страны доставки. |
| ↳ country | string | Страна доставки. |
| ↳ province | string | Регион (область, край). |
| ↳ city | string | Город. |
| ↳ district | string | Район. |
| ↳ street | string | Улица. |
| ↳ house | string | Дом. |
| ↳ flat | string | Квартира. |
| ↳ detail_address | string | Детальный адрес. |
| ↳ external_provider | long | Идентификатор логистического провайдера. |
| ↳ first_mile_provider | long | Логистический провайдер первой мили. |
| ↳ last_mile_provider | long | Логистический провайдер последней мили. |
{
"error": {
"code": "InternalServerError",
"message": "string",
"details": {}
},
"data": {
"logistic_orders": [
{
"logistic_order_id": 1249390,
"trade_order_id": 2409231561178782,
"handover_list_id": 0,
"cut_off_date": "2025-05-26T15:31:29.920Z",
"status": "DELIVERING",
"state_status_name": "Order accepted by carrier",
"platform_tracking_code": "21619418835187",
"items_count": 7,
"creation_error": "string",
"error_description": "string",
"gmt_create": "2024-09-23T00:06:17.312172+00:00",
"trade_order_source": "LocalTrade",
"total_amount": 184270,
"buyer_name": "Сократ Гурьевич Абрамов",
"buyer_country_code": "643",
"addresses": {
"receiver_address": {
"zip_code": "109456",
"country_code": "RU",
"country": "Россия",
"province": "Ямало-Ненецкий АО",
"city": "г. Печенга",
"street": "д. Анива, бул. Железнодорожный, д. 2/1 стр. 7/2, 068410",
"detail_address": "г. Печенга, Ямало-Ненецкий АО, д. Анива, бул. Железнодорожный, д. 2/1 стр. 7/2, 068410"
}
},
"external_provider": 6488,
"last_mile_provider": "OFFLINE",
"first_mile_provider": "OFFLINE",
"first_mile": "offline",
"danger_type": "General",
"items": [
{
"item_id": 1005004671188872,
"sku_id": 12000030050065440,
"product_source_id": 0,
"name": "TEST_MARKING_REQUIRED",
"item_price": 46036,
"currency": "RUB",
"total_amount": 92072,
"properties": [],
"mobile_url": "https://laliexpress.com/item/100500467118882.html",
"web_url": "https://laliexpress.com/item/100500467118882.html",
"quantity": 2,
"marking_required": false
},
{
"item_id": 1005004487766806,
"sku_id": 12000029404675044,
"product_source_id": 0,
"name": "2",
"item_price": 17918,
"currency": "RUB",
"total_amount": 35836,
"properties": [],
"mobile_url": "https://laliexpress.com/item/100500448766806.html",
"web_url": "https://laliexpress.com/item/100500448766806.html",
"quantity": 2
},
{
"item_id": 1005007271508429,
"sku_id": 12000040018902276,
"product_source_id": 0,
"name": "QA Gold Ring Lux",
"item_price": 34466,
"currency": "RUB",
"total_amount": 34466,
"properties": [],
"mobile_url": "https://laliexpress.com/item/1005007271508429.html",
"web_url": "https://laliexpress.com/item/1005007271508429.html",
"quantity": 1,
"jewelry_codes": [
{
"sku_index": 0,
"codes": [
"4095436341322049",
"2314167189189686"
]
}
]
}
]
}
],
"page_info": {
"current": 1,
"page_size": 25,
"total": 1
}
}
}
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| logistic_order_ids | array of integers | Да | Список идентификаторов отправлений, значение поля orders.logistic_orders.id из ответа метода создания отправления. |
curl --location --request POST 'https://openapi.ru.laliexpress.com/seller-api/v1/labels/orders/get' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--data-raw '{
"logistic_order_ids": [
88236
]
}'
| Параметр | Тип | Описание |
|---|---|---|
| error | object | Ошибки при запросе. |
| ↳ code | string | Код ошибки, возможные значения:
|
| ↳ message | string | Сообщение об ошибке. |
| ↳ details | object | Дополнительная информация по ошибке. |
| data | object | Информация по этикетке. |
| ↳ label_url | string | Cсылка на PDF с этикетками для запрошенных отправлений. |
{
"data": {
"label_url": "https://st.aestatic.net/providers-doc-storage/8317da5a-8961-4958-8e39-20ffb660f236"
},
"error": null
}
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| logistic_order_id | int | Да | Идентификатор отправления, значение поля logistic_orders.logistic_order_id из ответа метода получения списка отправлений. |
curl --location --request POST 'https://openapi.ru.laliexpress.com/seller-api/v1/logistic-order/recreate' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--data-raw '{
"logistic_order_id": 1113736
}'
| Параметр | Тип | Описание |
|---|---|---|
| data | object | Информация по запросу. |
| error | object | Ошибки запроса. |
| ↳ code | string | Код ошибки. |
| ↳ message | string | Сообщение об ошибке. |
| ↳ details | object | Дополнительная информация по ошибке. |
{
"error": {
"code": "InternalServerError",
"message": "Server unavailable",
"details": {}
},
"data": {}
}
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| logistic_order_ids | array of integers | Да | Идентификаторы отправлений, значение поля logistic_orders.logistic_order_id из ответа метода получения списка отправлений. |
curl --location --request POST 'https://openapi.ru.laliexpress.com/seller-api/v1/logistic-order/delete' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--data-raw '{
"logistic_order_ids": [
1113736
]
}'
| Параметр | Тип | Описание |
|---|---|---|
| data | object | Информация по запросу. |
| ↳ deletion_result_map | object | Результаты удаления. |
| ↳ additionalProp | object | Информация по удалению отправления. |
| ↳ deleted_at | string | Дата удаления отправления. |
| ↳ error_message | string | Сообщение об ошибке, если удаление неуспешно. |
| error | object | Ошибки при удалении отправления. |
| ↳ message | string | Сообщение об ошибке. |
| ↳ details | object | Дополнительная информация по ошибке, возможные значения:
|
{
"data": {
"deletion_result_map": {
"1113736": {
"deleted_at": null,
"error_message": "Failed to delete logistic order 1113736: it doesn't belong to seller 1042630114"
}
}
},
"error": null
}