Изменить статус заказа (FBS Логистика продавца)
Внимание. Методы используются только для заказов, которые доставляются способом FBS Логистика продавца.
С помощью этой группы методов вы можете менять статусы заказов, которые доставляете своей службой доставки.
Порядок перехода статусов: «Отправлен» (InTransit) → «Ожидает получения» (ReadyForPickup) → «Доставлен» (Delivered).
Для этих методов используется авторизация по jwt токену.
Адрес рабочей среды: https://openapi.ru.laliexpress.com

Присвоить заказу статус «Отправлен»

POST /api/v1/offline-ship/to-in-transit
Меняет статус заказа на «Отправлен».

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

ПараметрТипОбязательныйОписание
trade_order_idintДаИдентификатор заказа.
tracking_numberstringДаТрек-номер заказа.
provider_namestringДаНаименование логистического провайдера.
tracking_urlstringНетСсылка на отслеживание заказа по трек-номеру.
support_phone_numberstringНетТелефон службы поддержки логистического провайдера.
ignore_marking_errorsbooleanНетИгнорировать ли ошибки маркировки при запросе. По умолчанию: true — игнорировать.
markingsarray of objectНетМассив товаров для маркировки.
sku_idintНетИдентификатор вариации товара.
product_source_idintНетИдентификатор источника товара. По умолчанию: 0. Значение product_source_id из ответа метода POST /seller-api/v1/order/get-order-list.
value_signstringНетКод маркировки.
sku_indexintНетПорядковый номер вариации товара, используется для маркировки одинаковых товаров.
innstringНетИНН продавца.

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

curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/offline-ship/to-in-transit' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>>' \
--data-raw '{
    "trade_order_id": 2303211998658251,
    "tracking_number": "string230321",
    "provider_name": " IdealPost",
    "tracking_url": "https://string.com",
    "support_phone_number": "string",
    "ignore_marking_errors": false,
    "markings": [
      {
        "sku_id": 12000030050065439,
        "value_sign": "mark0",
        "sku_index": 0
      },
      {
        "sku_id": 12000030050065439,
        "value_sign": "mark1",
        "sku_index": 1
      },
      {
        "sku_id": 12000030050065439,
        "value_sign": "mark2",
        "sku_index": 2
      }
  ]
}'

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

ПараметрТипОписание
errorobjectИнформация об ошибке.
codestring

Код ошибки:

messagestringСообщение об ошибке.
detailsobjectПодробности ошибки.
datаobjectИнформация по запросу.
created_orders[object]Информация об изменениях статусов заказов.
  ↳ idint64Идентификатор отправления.
  ↳ created_atstringВремя создания заказа, формат: YYYY-MM-DDThh:mm:sssZ.
  ↳ trade_order_idint64Идентификатор заказа.
  ↳ external_providerint64Идентификатор логистического провайдера.
  ↳ linesarray of objectИнформация о товарах в заказе.
    ↳ sku_idint64Идентификатор вариации товара.
    ↳ quantityint32Количество единиц товара в заказе.
    ↳ product_source_idintИдентификатор источника заказа.
marking_errorsarray of objectМассив с ошибками маркировки.
trade_order_idintИдентификатор заказа.
item_idintИдентификатор товара.
sku_idintИдентификатор вариации товара.
product_source_idintИдентификатор источника заказа.
item_namestringНаименование товара.
quantityintКоличество единиц товара в заказе.
value_signstringКод маркировки.
messagestringСообщение об ошибке.
sku_indexstringПорядковый номер вариации товара, используется для маркировки одинаковых товаров.
innstringИНН продавца.

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

{
  "data": {
    "created_orders": [
      {
        "id": 1124235,
        "created_at": "2023-03-21T15:17:00.209293Z",
        "trade_order_id": 2303211998658251,
        "external_provider": 60,
        "lines": [
          {
            "sku_id": 12000030050065440,
            "product_source_id": 0,
            "quantity": 3
          }
        ]
      }
    ],
    "marking_errors": null
  },
  "error": null
}

Присвоить заказу статус «Ожидает получения»

POST /api/v1/offline-ship/to-ready-for-pickup
Меняет статус заказа на «Ожидает получения», переход возможен только из статуса «Отправлен» (InTransit).

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

ПараметрТипОбязательныйОписание
trade_order_idint64ДаИдентификатор заказа.

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

curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/offline-ship/to-ready-for-pickup' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--data-raw '{
  "trade_order_id": 2207214066364364
}'

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

ПараметрТипОписание
errorobjectИнформация об ошибке.
codestring
Код ошибки, возможные значения:
  • OrderNotFound (заказ или отправление из заказа не найдено),
  • SellerMismatch (изменение статуса отправления недопустимо для продавца),
  • OrdersNotOffline (заказ не был отправлен через службу доставки продавца),
  • UpdateLogisticOrdersStatusError (ошибка обновления статуса, такой переход статусов невозможен).
  • LogisticOrdersIncorrectStatusError (недопустимо изменение текущего статуса отправления).
  • InternalServerError (внутренняя ошибка сервера. Что-то пошло не так при обработке запроса.)
messagestringСообщение об ошибке.
detailsobjectПодробности ошибки.
datаobjectИнформация по запросу.

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

{
    "error": {
        "code": "OrderNotFound",
        "message": "Отправление не найдено.",
        "details": null
    },
    "data": null
}

Присвоить заказу статус «Доставлен»

POST /api/v1/offline-ship/to-delivered
Меняет статус заказа на «Доставлен», переход возможен только из статуса «Ожидает получения» (ReadyForPickup).

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

ПараметрТипОбязательныйОписание
trade_order_idint64ДаИдентификатор заказа.

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

curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/offline-ship/to-delivered' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--data-raw '{
  "trade_order_id": 2207214066364364
}'

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

ПараметрТипОписание
errorobjectИнформация об ошибке.
codestring
Код ошибки, возможные значения:
  • OrderNotFound (заказ или отправление из заказа не найдено),
  • SellerMismatch (изменение статуса отправления недопустимо для продавца),
  • OrdersNotOffline (заказ не был отправлен через службу доставки продавца),
  • UpdateLogisticOrdersStatusError (ошибка обновления статуса, такой переход статусов невозможен).
  • LogisticOrdersIncorrectStatusError (недопустимо изменение текущего статуса отправления).
  • InternalServerError (Внутренняя ошибка сервера. Что-то пошло не так при обработке запроса.)
messagestringСообщение об ошибке.
detailsobjectПодробности ошибки.
datаobjectИнформация по запросу.

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

{
    "error": {
        "code": "LogisticOrderNotFound",
        "message": "Отправление не найдено",
        "details": null
    },
    "data": null
}