Получить список заказов

Параметр	Тип	Обязательный	Описание
date_start	string	Нет	Фильтр по заказам с датой создания после этой даты, формат: YYYY-MM-DDThh:mm:ssZ.
date_end	string	Нет	Фильтр по заказам с датой создания не позднее этой даты, формат: YYYY-MM-DDThh:mm:ssZ.
order_statuses	array of strings	Нет	Статус заказа, может принимать значения: Created (Создан), InProgress (Обрабатывается), Finished (Завершен), Cancelled (Отменён).
payment_statuses	array of strings	Нет	Статус оплаты заказа, может принимать значения: NotPaid (заказ не оплачен), Hold или Paid (заказ оплачен), Cancelled (отмена списания), Failed (ошибка оплаты).
delivery_statuses	array of strings	Нет	Статус доставки заказа, может принимать значения: Init (заказ ожидает отправки), PartialShipped (заказ частично отправлен), Shipped (заказ полностью отправлен), Delivered (заказ доставлен), Cancelled (отправка заказа отменена).
antifraud_statuses	array of strings	Нет	Статус защиты заказа, может принимать значения: NotChecked (заказ ещё не проверен), Checking (выполняется проверка), Blocked (заказ заблокирован), Passed (проверка пройдена).
order_ids	array of integers	Нет	Идентификатор заказа.
sorting_order	string	Нет	Порядок сортировки заказов в списке, может принимать значения: Asc (по возрастанию), Desc (по убыванию), None (не сортировать).
sorting_field	string	Нет	Поле, по которому сортируется список заказов.
tracking_numbers	array of strings	Нет	Номер отслеживания заказа.
page_size	int	Да	Число страниц, которые нужно вывести.
page	int	Да	Номер страницы из списка, которую необходимо вывести.
update_at_from	string	Нет	Фильтр по заказам с датой изменения после этой даты, формат: YYYY-MM-DDThh:mm:ssZ.
updated_at_to	string	Нет	Фильтр по заказам с датой изменения не позднее этой даты, формат: YYYY-MM-DDThh:mm:ssZ.
shipping_day_from	string	Нет	Фильтр по заказам с датой отгрузки после этой даты, формат: YYYY-MM-DDThh:mm:ssZ.
shipping_day_to	string	Нет	Фильтр по заказам с датой отгрузки не позднее этой даты, формат: YYYY-MM-DDThh:mm:ssZ.
trade_order_info	string	Нет	Флаг, показывающий какую информацию добавить в ответ: Common — базовая информация о заказах, LogisticInfo — информация об отправлениях.

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

curl --location --request POST 'https://openapi.ru.laliexpress.com/seller-api/v1/order/get-order-list' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--data-raw '{
    "page_size": 1,
    "page": 1,
    "trade_order_info": "LogisticInfo",
    "sorting_order": "Desc"
}'

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

Параметр	Тип	Описание
datа	object	Информация по запросу.
↳ total_count	int	Общее количество заказов, соответствующих фильтру.
↳ orders	array of objects	Массив заказов, соответствующий заданным фильтрам.
↳ id	string	Идентификатор заказа.
↳ created_at	string	Дата создания заказа, формат: YYYY-MM-DDThh:mm:ss[.SSSSSS]±hh:mm.
↳ paid_at	string	Дата оплаты заказа.
↳ updated_at	string	Дата последнего обновления заказа, формат: YYYY-MM-DDThh:mm:ss[.SSSSSS]±hh:mm.
↳ status	string	Статус заказа.
↳ payment_status	string	Статус оплаты заказа.
↳ delivery_status	string	Статус доставки заказа.
↳ delivery_address	string	Адрес доставки заказа.
↳ delivery_info	object	Информация о доставке.
↳ country	string	Страна доставки.
↳ region	string	Регион (область, край).
↳ city	string	Город.
↳ street_house	string	Адрес, улица, дом.
↳ flat	string	Номер квартиры.
↳ index	string	Почтовый индекс
↳ receiver	object	Информация о получателе посылок.
↳ name	string	Имя получателя.
↳ phone	string	Телефон получателя.
↳ antifraud_status	string	Статус защиты от мошенничества заказа.
↳ buyer_country_code	string	Код страны покупателя.
↳ buyer_name	string	Имя покупателя.
↳ order_display_status	string	Статус заказа, отображаемый в личном кабинете продавца, возможные значения: Unknown (Неизвестный статус), PlaceOrderSuccess (Ожидает оплаты), PaymentPending (Обработка платежа), WaitExamineMoney (В ожидании подтверждения платежа), WaitGroup (Выполняется групповая покупка), WaitSendGood (Ожидается отправка), PartialSendGoods (Частично отправлено), WaitAcceptGoods (Ожидается получение), InCancel (Заявка покупателя на отмену), Complete (Заказ завершён и подтверждён покупателем), Close (Заказ отменён покупателем или продавцом), InFrozen (Заморожено), InIssue (В состоянии спора).
↳ buyer_phone	string	Телефон получателя.
↳ order_lines	object	Позиции в заказе.
↳ id	int	Идентификатор позиции в заказе.
↳ item_id	string	Идентификатор товара.
↳ sku_id	string	Идентификатор вариации товара.
↳ product_source_id	int	Идентификатор источника товара.
↳ sku_code	string	Артикул или штрихкод вариации (задаётся продавцом).
↳ name	string	Наименование товара.
↳ img_url	string	Ссылка на изображение товара.
↳ item_price	int minimum: 100	Цена товара в копейках.
↳ quantity	int	Количество товаров в заказе.
↳ total_amount	int	Общая стоимость товаров в копейках.
↳ properties	array of strings	Свойства товара.
↳ properties_map	object	Словарь со свойствами товара.
↳ buyer_comment	string	Комментарий покупателя.
↳ height	int	Высота (см).
↳ weight	int	Масса (г).
↳ width	int	Ширина (см).
↳ length	int	Длина (см).
↳ issue_status	string	Статус спора по товару, возможные значения: NoDispute (По товару в заказе нет открытых споров), InProcess (Идёт спор по товару), Finished (Спор по товару завершен).
↳ promotions	array of objects	Информация о промоакциях.
↳ ae_promotion_id	int	Идентификатор китайского промокода.
↳ ae_activity_id	int	ID промоакции.
↳ code	string	Код промоакции.
↳ promotion_type	string	Тип промокода.
↳ discount	int	Сумма скидки.
↳ discount_currency	string	Валюта скидки.
↳ original_discount	int	Первоначальная сумма скидки.
↳ original_discount_currency	string	Валюта первоначальной скидки.
↳ promotion_target	string	Поле показывает, на что распространяется скидка (покупка/ доставка).
↳ budget_sponsor	string	Кто предоставляет скидку: платформа или продавец.
↳ order_line_fees	object	Комиссия за торговлю на платформе LAliExpress.
↳ line_fee	decimal	Комиссия за единицу товара.
↳ affiliate_fee	decimal	Аффилятная комиссия за единицу товара.
↳ estimate_revenue	decimal	Планируемая выручка за единицу товара.
↳ hs_code	int	Код товара в гармонизированной системе описания и кодирования товаров (Harmonized Commodity Description and Coding System).
↳ logistic_name	string	Наименование метода доставки.
↳ logistic_storage_type	string	Модель доставки.
↳ total_amount	int	Общая стоимость всех позиций в заказе копейках.
↳ seller_comment	string	Комментарий продавца.
↳ fully_prepared	boolean	Флаг показывает, что все товары из заказа отправлены.
↳ finish_reason	string	Причина завершения заказа, возможные значения: PaymentTimeout (Истёк срок оплаты заказа), ShippingTimeout (Истёк срок отправки заказа), BuyerNotPickUpPosting (Истёк срок получения заказа в пункте выдачи), CancelledByBuyer (Покупатель отменил неоплаченный заказ), SecurityClose (Заказ был отменён платформой из-за проблем с безопасностью аккаунта покупателя), LogisticOrderToPostingMapFailed (Не удалось сформировать посылку), CancelledBySeller (Продавец отменил заказ), BuyerDoesNotWantOrder (Покупатель передумал совершать заказ), BuyerWantChangeProduct (Покупатель хочет изменить товар), BuyerChangeCoupon (Покупатель хочет изменить использование купона), BuyerChangeMailAddress (Покупатель изменил адрес доставки), BuyerChangeLogistic (Покупатель изменил способ доставки), BuyerCannotPayment (Покупатель не оплатил заказ), BuyerOtherReasons (Другие причины отмены заказа со стороны покупателя), ProductNotEnough (Товар закончился на складе), SellerDidNotUseBuyerLogisticType (Продавец не использует способ доставки, выбранный покупателем), BuyerCannotContactSeller (Покупатель не смог связаться с продавцом), SellerRiseOrderAmount (Продавец увеличил цену заказа), CancelGroupBuyAfterPay (Групповая покупка отменена после оплаты), GroupBuyFailure (Групповая покупка не состоялась), FreightCommitDayNotMatch (Истёк срок обработки заказа), ConfirmedByBuyer (Покупатель подтвердил получение всех товаров), AutoConfirm (Автоматическое подтверждение получения заказа по истечении срока подтверждения), ConfirmedByLogistic (Получение заказа подтверждено логистическим провайдером).
↳ cut_off_date	string	Рекомендованная дата отгрузки, определённая при получении заказа от покупателя. Формат: YYYY-MM-DDThh:mm:ss±hh:mm.
↳ cut_off_date_histories	object	История изменений для даты отгрузки. Если она менялась, в параметре будут указаны все даты. Если вам не удалось отгрузить заказ по техническим причинам, дата отгрузки автоматически переносится, но не более 2 раз. Рекомендуем отгружать заказы вовремя и в первую дату, чтобы уровень сервиса оставался высоким.
↳ shift_number	int	Количество переносов даты отгрузки. Если отгрузка не переносилась, значение будет 0.
↳ cut_off_date	string	Ближайшая дата отгрузки, формат: YYYY-MM-DDThh:mm:ss±hh:mm.
↳ next_cut_off_date	string	Следующая возможная дата отгрузки заказа. Используется, если заказ не будет отгружен в ближайшую дату, формат: YYYY-MM-DDThh:mm:ss±hh:mm.
↳ pre_split_postings	object	Предсплитованные отправления. Поле отображает исходное сплитование заказа. Эта информация возвращается, когда в запросе вы передаёте "trade_order_info": "LogisticInfo". Предсплитованные отправления из заказа можно разделять, но нельзя объединять. Количество товаров в отправлении должно быть не больше, чем есть в предсплитованном отправлении.
↳ id	int	Идентификатор предсплитованного отправления.
↳ delivery_fee	int	Стоимость доставки.
↳ first_mile_type	string	Тип первой мили, может принимать значение: Pickup, Dropoff
↳ logistic_method	string	Методы доставки. Возможные значения приведены под таблицей.
↳ logistics_type	string	Тип доставки, может принимать значение: DBS — логистика продавца, FBS — логистика LAliExpress.
↳ package_size_limits	object	Максимально допустимые габариты для этого предсплитованного отправления. Помогает правильно выбрать упаковку, чтобы отправление не превышало лимиты провайдера доставки.
↳ max_weight	float	Максимально допустимый вес (кг).
↳ max_length	float	Максимально допустимая длина (см).
↳ max_width	float	Максимально допустимая ширина (см).
↳ max_height	float	Максимально допустимая высота (см).
↳ max_sum_of_dimensions	float	Максимально допустимая сумма размеров (см).
↳ posting_lines	object	Позиции предсплитованного отправления.
↳ id	int	Идентификатор позиции предсплитованного отправления.
↳ order_line_id	int	Идентификатор на позицию в заказе.
↳ item_id	string	Идентификатор товара.
↳ sku_id	string	Идентификатор вариации товара.
↳ product_source_id	int	Идентификатор источника товара.
↳ quantity	int	Количество.
↳ height	int	Высота (см).
↳ weight	int	Вес (г).
↳ width	int	Ширина (см).
↳ length	int	Длина (см).
↳ name	string	Наименование товара.
↳ img_url	string	Ссылка на изображение товара.
↳ item_price	int	Цена товара.
↳ properties	array of strings	Свойства товара.
↳ properties_map	object	Словарь со свойствами товара.
↳ buyer_comment	string	Комментарий покупателя.
↳ logistic_orders	array of objects	Информация об отправлениях, связанных с заказом. Эта информация возвращается, когда в запросе вы передаёте "trade_order_info": "LogisticInfo".
↳ id	int	Идентификатор отправления.
↳ trade_order_id	int	Идентификатор заказа, соответствующий отправлению.
↳ track_number	string	Номер отслеживания.
↳ status	string	Статус отправления, может принимать значения: New (Новый, не создан в 3PL), AwaitingCreateOrder (Ожидает создание отправления в логистическом провайдере), OrderCreationProblems (Ошибка создания отправления), AwaitingHandoverList (Ожидает добавления в лист передачи), AddingToHandoverProblems (Ошибки при добавлении в лист передачи), AwaitingConfirmation (Отправление успешно добавлено в лист передачи), AwaitingDispatch (Отправление готово к отгрузке), OrderReceivedFromSeller (Отправление успешно принято на склад от продавца), CrossDocSorting (Сортировка принятых отправлений у cross-doc провайдера), CrossDocSent (Отправка принятых отправлений cross-doc провайдером), ProviderPostingReceive (Отправление принято службой доставки), ProviderPostingLeftTheReception (Покинуло место приема), ProviderPostingArrivedAtSorting (Посылка прибыла на сортировочный центр в стране назначения), ProviderPostingSorting (Сортировка в сортировочном центре службы доставки), ProviderPostingLeftTheSorting (Покинуло сортировочный центр службы доставки), ProviderPostingArrived (Посылка ожидает, когда её заберёт получатель), ProviderPostingDelivered (Посылка успешно доставлена получателю), ProviderPostingUnsuccessfulAttemptOfDelivery (Неудачная попытка вручения получателю), ProviderPostingInReturn (Невозможно доставить, посылка уходит на возврат, превышено время ожидания получения посылки получателем, инициирован возврат отправителю), ProviderPostingTemporaryStorage (Отправление поступило на временное хранение), ProviderPostingReturned (Отправление возвращено отправителю), Rejected (Отправление отклонено на приёмке), Cancelled (Отправка отменена).
↳ creation_error	object	Ошибка создания отправления, появляется на отправлениях в статусе OrderCreationProblems.
↳ code	string	Код ошибки.
↳ description	string	Описание ошибки.
↳ lines	object	Позиции в отправлении.
↳ sku_id	int	Идентификатор вариации товара.
↳ quantity	int	Количество.
↳ commission	object	Комиссия, которую удерживает LAliExpress за торговлю на площадке.
↳ platform_fee	int	Комиссия платформы.
↳ affiliate_fee	int	Аффилятная комиссия.
↳ estimate_revenue	int	Планируемая выручка.
↳ actions	object	Доступные действия по отправлению (для продавцов, использующих расчётную дату отгрузки).
↳ confirm_sending	boolean	Подтвеждена ли отгрузка отправления? POST seller-api/v1/logistic-order/order-passed.
↳ send_later	boolean	Переносилась ли дата отгрузки отправления на запасную? POST /seller-api/v1/logistic-order/pass-today.
↳ cancel	boolean	Отменён ли заказ из-за переноса даты отгрузки? POST /seller-api/v1/logistic-order/cancel-before-expired.
error	object	Информация об ошибке.
↳ code	string	Код ошибки.
↳ message	string	Сообщение об ошибке. Возможные значения: ErrorCode.OrderNotFound — Отправления не найдены. ErrorCode.OrdersNotFbs — Отправления имеют неверный тип доставки. ErrorCode.MultipleProvidersError — Отправления имеют отличающихся провайдеров 3PL. ErrorCode.MultipleFirstMileProvidersError — Отправления имеют отличающихся провайдеров первой мили. ErrorCode.HandoverListNotFound — Лист передачи не найден. ErrorCode.SellerMismatch — Продавец отличается от продавца в листе передачи. ErrorCode.WrongHandoverListStatusError — Некорректный статус листа передачи. ErrorCode.ProvidersMismatch — На листе передачи и на отправлении, которое хотим добавить в лист передачи, разные провайдеры (на отправлении смотрим по провайдеру первой мили). ErrorCode.OrdersWithoutExternalIdError — Отсутствует внешний идентификатор у отправления. ErrorCode.LogisticOrdersIncorrectStatusError — Некорректный статус отправлений. ErrorCode.RupostError — Ошибка Почты России. ErrorCode.InvalidCutoffException — Некорректная дата отгрузки (для продавцов, не использующих расчётную дату отгрузки)/ заказы имеют разные даты отгрузки (для селлеров, использующих расчётную дату отгрузки)
↳ details	object	Подробности ошибки.

Возможные значения методов доставки

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

{
    "data": {
        "total_count": 1,
        "orders": [
            {
                "id": 2212022208130938,
                "created_at": "2022-12-02T12:01:20.524977+00:00",
                "paid_at": "2022-12-02T12:02:06.293071+00:00",
                "updated_at": "2022-12-10T12:04:58.099278+00:00",
                "status": "Cancelled",
                "payment_status": "Cancelled",
                "delivery_status": "Cancelled",
                "delivery_address": "Россия, Ленинградская область, Выборгский район, Приозёрское деревенское поселение, посёлок Глыбово, улица Моря, 908, 888900",
                "delivery_info":
                    {
                        "country": "Россия",
                        "region": "Ленинградская обл",
                        "city": "Выборгский р-н",
                        "street_house": "Ленинградская область, Выборгский район, Приозёрское деревенское поселение, посёлок Глыбово, улица Моря, 908",
                        "flat": null,
                        "index": "888900",
                        "receiver": {
                            "name": "Шумахер Горислава Яропоковна",
                            "phone": "+79111234567"
                        }
                    },
                "antifraud_status": "Passed",
                "buyer_country_code": "RU",
                "buyer_name": "Родион Раскольников -",
                "order_display_status": "Close",
                "buyer_phone": "+79261234567",
                "order_lines": [
                    {
                        "id": 2212028197197992,
                        "item_id": "1005005021833540",
                        "sku_id": "12000031366792986",
                        "sku_code": "00736249",
                        "name": "Зубной порошок для питомцев",
                        "img_url": "https://ae04.alicdn.com/kf/A8b96bd8b36894e228feeb63e7e9e1f01k.jpeg_50x50.jpeg",
                        "item_price": 100,
                        "quantity": 1.0,
                        "total_amount": 100,
                        "properties": [
                            "",
                            "Сербия",
                            "100000015",
                            "sell_by_piece",
                            "1",
                            "9.000",
                            "7",
                            "4",
                            "8"
                        ],
                        "properties_map": {
                            "Название бренда": "BONELANDICS",
                            "Происхождение": "Сербия",
                            "Единица измерения": "100000015",
                            "Способ продажи (штука/упаковка)": "sell_by_piece",
                            "Каждая упаковка": "1",
                            "Вес логистики": "9.000",
                            "Размер логистики - длина (см)": "7",
                            "Размер логистики - высота (см)": "4",
                            "Размер логистики - ширина (см)": "8"
                        },
                        "buyer_comment": null,
                        "height": 4.0,
                        "weight": 9000.0,
                        "width": 8.0,
                        "length": 7.0,
                        "issue_status": "NoDispute",
                        "promotions": [],
                        "order_line_fees": null,
                        "hs_code": null,
                        "logistic_name": "Seller's Shipping Method-City",
                        "logistic_storage_type": "Fbs"
                    }
                ],
                "total_amount": 100,
                "seller_comment": null,
                "fully_prepared": false,
                "finish_reason": "ShippingTimeout",
                "cut_off_date": "2022-12-02T12:01:19.652+00:00",
                "cut_off_date_histories": [
                    {
                        "shift_number": 0,
                        "cut_off_date": "2022-12-02T12:01:19.652+00:00"
                    }
                ],
                "next_cut_off_date": "2022-12-02T12:01:19.652+00:00",
                "pre_split_postings": [
                    {
                        "id": 2212024815059201,
                        "delivery_fee": 0,
                        "first_mile_type": "Dropoff",
                        "logistic_method": "OTHER_CITY_RUB",
                        "logistics_type": "DBS",
                        "package_size_limits": {
                            "max_weight": 10.0,
                            "max_length": 20.0,
                            "max_width": 30.0,
                            "max_height": 40.0,
                            "max_sum_of_dimensions": 90.0
                            },
                        "posting_lines": [
                            {
                                "id": 391550,
                                "order_line_id": 2212028197197992,
                                "item_id": "1005005021833540",
                                "sku_id": "12000031366792986",
                                "quantity": 1.0,
                                "height": 4.0,
                                "weight": 9000.0,
                                "width": 8.0,
                                "length": 7.0,
                                "name": "Зубной порошок для питомцев1",
                                "img_url": "https://ae04.alicdn.com/kf/A8b96bd8b36894e228feeb63e7e9e1f01k.jpeg_50x50.jpeg",
                                "item_price": 100,
                                "properties": [
                                    "",
                                    "Сербия",
                                    "100000015",
                                    "sell_by_piece",
                                    "1",
                                    "9.000",
                                    "7",
                                    "4",
                                    "8"
                                ],
                                "properties_map": {
                                    "Название бренда": "BONELANDICS",
                                    "Происхождение": "Сербия",
                                    "Единица измерения": "100000015",
                                    "Способ продажи (штука/упаковка)": "sell_by_piece",
                                    "Каждая упаковка": "1",
                                    "Вес логистики": "9.000",
                                    "Размер логистики - длина (см)": "7",
                                    "Размер логистики - высота (см)": "4",
                                    "Размер логистики - ширина (см)": "8"
                                },
                                "buyer_comment": null
                            }
                        ]
                    }
                ],
                "logistic_orders": [],
                "commission": null
            }
        ]
    },
    "error": null
}