Адрес рабочей среды: 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 | Нет | Идентификатор источника товара. По умолчанию: 0. Значение 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 | Идентификатор источника товара. |
error | object | Ошибки при создании отправления. |
↳ code | string | Код ошибки: |
↳ message | string | Сообщение об ошибке. |
↳ details | object | Дополнительная информация по ошибке. |
{
"data": {
"orders": [
{
"trade_order_id": 2212196848241455,
"logistic_orders": [
{
"id": 9804616,
"lines": [
{
"sku_id": 12000026559024132,
"product_source_id": 0,
"quantity": 3
}
]
}
]
}
]
}
}
{
"data": {
"orders": [],
"errors": {
"common_errors": [
{
"code": "NoTradeOrderFound",
"message": "Заказ не найден"
}
],
"item_errors": null
}
},
"error": null
}
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
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 | Ошибка создания заказа. |
↳ 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 | Ссылка на товар на сайте. |
↳ 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 | Количество отправлений, удовлетворяющих фильтру. |
{
"data": {
"logistic_orders": [
{
"logistic_order_id": 1249390,
"trade_order_id": 2409231561178782,
"handover_list_id": 0,
"cut_off_date": "2024-09-25T00:06:16+00:00",
"status": "DELIVERING",
"state_status_name": "Order accepted by carrier",
"platform_tracking_code": "21619418835187",
"items_count": 7,
"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_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
}