Получение обновлений статусов заказов

POST /v1/order/fbs/status/list

POST/v1/order/fbs/status/list

Тело запроса

cursor
string
required
Курсор страницы обновлений.
limit
integer
required
Размер страницы (min=1, max=300, default=100).
filter
object
required
Фильтры по обновлениям.
Показать свойства
merchant_order_id
array
required
Фильтр по идентификаторам заказов продавца.
status
array
required
Фильтр по статусам заказов.
Статусы заказа FBS: NEW — новый; CONFIRMED — подтверждён; READY_TO_SHIP — готов к отгрузке; SHIPPED — отгружен; ACCEPTED_AT_WAREHOUSE — принят на складе приёмки; DELIVERED — доставлен; CANCELLED — отменён.
updated_since
string
required
Нижняя граница времени обновления (RFC3339).

Успешный ответ

200A successful response.
application/json
object
order_updates
array
required
Список изменившихся заказов.
ordersFbsOrderUpdatesListItem
Показать свойства
ordersFbsOrderUpdatesListItem
merchant_order_id
string
required
Идентификатор заказа продавца.
client_order_id
string
required
Идентификатор заказа клиента. Может объединять несколько заказов продавца.
status
string
required
Новый/текущий статус заказа.
Допустимые значения
NEWCONFIRMEDREADY_TO_SHIPSHIPPEDACCEPTED_AT_WAREHOUSEDELIVEREDCANCELLED
updated_at
string
required
Момент изменения статуса (RFC3339).
next_cursor
string
required
Курсор следующей страницы обновлений.
total
integer
required
Общее количество обновлений по фильтру.

Ошибки

400Некорректный запрос
application/json
object
error_type
string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code
string
код ошибки
message
string
сообщение
details
object
401Ошибка авторизации
application/json
object
error_type
string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code
string
код ошибки
message
string
сообщение
details
object
429Превышен лимит запросов
application/json
object
error_type
string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code
string
код ошибки
message
string
сообщение
details
object
500Внутренняя ошибка сервера
application/json
object
error_type
string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code
string
код ошибки
message
string
сообщение
details
object
defaultОшибка (неожиданная или прочие)
application/json
object
error_type
string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code
string
код ошибки
message
string
сообщение
details
object
POST/v1/order/fbs/status/list
1curl https://api.omninet.ru/v1/order/fbs/status/list \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "cursor": "string",6  "limit": 0,7  "filter": {8    "merchant_order_id": [9      "string"10    ],11    "status": [12      "string"13    ],14    "updated_since": "string"15  }16}'
{
  "order_updates": [
    {
      "merchant_order_id": "string",
      "client_order_id": "string",
      "status": "string",
      "updated_at": "string"
    }
  ],
  "next_cursor": "string",
  "total": 0
}

A successful response.