Список складов маркетплейса, доступных для подключения FBS

POST /v1/market/location/list

POST/v1/market/location/list

Тело запроса

filter
object
required
Параметры фильтрации складов маркетплейса.
Показать свойства
market_location_id
array
Фильтр по идентификаторам складов маркетплейса (опционально).
city
array
Фильтр по городам расположения склада маркетплейса (опционально).
is_active
boolean
Фильтр по доступности склада для новых FBS-отгрузок (опционально).
accepts_kgt
boolean
Вернуть только склады, принимающие КГТ-отгрузки (опционально).
accepts_mgt
boolean
Вернуть только склады, принимающие МГТ-отгрузки (опционально).
cursor
string
required
Курсор постраничной выборки.
limit
integer
required
Размер страницы (min=1, max=300, default=100).

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

200A successful response.
application/json
object
locations
array
required
Список складов маркетплейса, доступных для подключения.
MarketLocationListItem
Показать свойства
MarketLocationListItem
market_location_id
string
required
Идентификатор склада маркетплейса.
name
string
required
Название склада маркетплейса.
city
string
required
Город расположения склада маркетплейса.
address_tail
string
required
Адрес склада маркетплейса в текстовом формате.
timezone
string
required
Часовой пояс склада маркетплейса.
is_active
boolean
required
Склад доступен для подключения и новых FBS-отгрузок.
acceptance_schedule
array
required
Расписание приёмки отгрузок на складе маркетплейса.
LocationWorkingSchedule
Показать свойства
LocationWorkingSchedule
day
string
required
День недели.
Допустимые значения
MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY
schedule
object
required
Расписание на день.
Показать свойства
time_start
string
required
Время начала, формат «00:00».
time_end
string
required
Время окончания, формат «00:00».
break
string
required
Перерыв, формат «13:00–14:00».
shipping_cutoff
string
required
Время, после которого отсчёт слота доставки начнётся со следующего дня. Формат «16:30». Если пустое — не применяется.
shipment_limits
object
required
Ограничения склада маркетплейса по типам и габаритам отгрузок.
Показать свойства
accepts_standard
boolean
required
Склад принимает стандартные FBS-отгрузки.
accepts_kgt
boolean
required
Склад принимает КГТ-отгрузки.
accepts_mgt
boolean
required
Склад принимает МГТ-отгрузки.
max_weight_kg
number
required
Максимальный вес одного грузоместа в килограммах.
max_length_cm
number
required
Максимальная длина одного грузоместа в сантиметрах.
max_width_cm
number
required
Максимальная ширина одного грузоместа в сантиметрах.
max_height_cm
number
required
Максимальная высота одного грузоместа в сантиметрах.
max_sum_dimensions_cm
number
required
Максимальная сумма измерений одного грузоместа в сантиметрах.
comment
string
required
Дополнительный комментарий по ограничениям отгрузки.
acceptance_instructions
string
required
Краткая инструкция продавцу по подготовке отгрузки на выбранный склад.
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/market/location/list
1curl https://api.omninet.ru/v1/market/location/list \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "filter": {6    "market_location_id": [7      "string"8    ],9    "city": [10      "string"11    ],12    "is_active": true,13    "accepts_kgt": true,14    "accepts_mgt": true15  },16  "cursor": "string",17  "limit": 018}'
{
  "locations": [
    {
      "market_location_id": "string",
      "name": "string",
      "city": "string",
      "address_tail": "string",
      "timezone": "string",
      "is_active": true,
      "acceptance_schedule": [
        {
          "day": "MONDAY",
          "schedule": {
            "time_start": "string",
            "time_end": "string",
            "break": "string",
            "shipping_cutoff": "string"
          }
        }
      ],
      "shipment_limits": {
        "accepts_standard": true,
        "accepts_kgt": true,
        "accepts_mgt": true,
        "max_weight_kg": 0,
        "max_length_cm": 0,
        "max_width_cm": 0,
        "max_height_cm": 0,
        "max_sum_dimensions_cm": 0,
        "comment": "string"
      },
      "acceptance_instructions": "string"
    }
  ],
  "next_cursor": "string",
  "total": 0
}

A successful response.