Список складов продавца и их привязок к складам маркетплейса

POST /v1/merchant/location/list

POST/v1/merchant/location/list

Тело запроса

filter
object
required
Фильтр.
Показать свойства
status
array
Фильтр по статусам склада (опционально). В выборку попадают склады, чей статус входит в указанный набор.
Статус локации в витрине. - DRAFT: создан. - PENDING: в обработке. - ACTIVE: включена, доступна к выбору. - QUARANTINE: карантин. - FAILED: не прошёл модерацию. - ARCHIVED: перенесён в архив.
location_id
array
Фильтр по идентификаторам склада (опционально).
location_types
array
Фильтр по типам склада (опционально). В выборку попадают склады, у которых в массиве location_types есть хотя бы один из указанных типов (WAREHOUSE).
Тип склада в массиве location_types. - WAREHOUSE: склад.
cursor
string
required
Курсор начала отсчёта.
limit
integer
required
Размер страницы (min=1, max=300, default=100).

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

200A successful response.
application/json
object
locations
array
required
Элементы списка.
LocationListItem
Показать свойства
LocationListItem
location_id
string
required
Идентификатор склада.
merchant_location_id
string
Идентификатор локации продавца (опционально).
location_types
array
required
Типы локации; возможные значения WAREHOUSE (склад).
Тип склада в массиве location_types. - WAREHOUSE: склад.
name
string
required
Название склада.
status
string
required
Статус локации в витрине.
Допустимые значения
DRAFTPENDINGACTIVEQUARANTINEFAILEDARCHIVED
issue
object
required
Проблема по локации; пустой объект или не передаётся при статусах DRAFT и ACTIVE.
Показать свойства
code
string
required
Код проблемы.
message
string
required
Детальное описание проблемы.
changed_at
string
required
Момент изменения (RFC3339, например 2026-04-16T08:00:00Z).
address_tail
string
required
Адрес локации в текстовом формате.
latitude
number
required
Широта точки (WGS 84).
longitude
number
required
Долгота точки (WGS 84).
is_quarantine
boolean
required
Признак нахождения склада в карантине.
is_archive
boolean
required
Признак архива.
working_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». Если пустое — не применяется.
individual_schedule
array
Индивидуальное расписание на определённые даты. К примеру, праздничные дни (опционально при отличии от working_schedule).
LocationIndividualSchedule
Показать свойства
LocationIndividualSchedule
date
string
required
Дата, формат «31.12.2020».
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». Если пустое — не применяется.
is_works
boolean
required
Признак работы в дату.
market_connection
object
required
Привязка склада продавца к складу маркетплейса и его ограничениям по FBS-отгрузкам.
Показать свойства
market_location_id
string
required
Идентификатор подключённого склада маркетплейса.
market_location_name
string
required
Название подключённого склада маркетплейса.
is_active
boolean
required
Признак доступности склада маркетплейса для новых FBS-отгрузок.
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
Дополнительный комментарий по ограничениям отгрузки.
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/merchant/location/list
1curl https://api.omninet.ru/v1/merchant/location/list \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "filter": {6    "status": [7      "string"8    ],9    "location_id": [10      "string"11    ],12    "location_types": [13      "string"14    ]15  },16  "cursor": "string",17  "limit": 018}'
{
  "locations": [
    {
      "location_id": "string",
      "merchant_location_id": "string",
      "location_types": [
        "string"
      ],
      "name": "string",
      "status": "string",
      "issue": {
        "code": "string",
        "message": "string",
        "changed_at": "string"
      },
      "address_tail": "string",
      "latitude": 0,
      "longitude": 0,
      "is_quarantine": true,
      "is_archive": true,
      "working_schedule": [
        {
          "day": "MONDAY",
          "schedule": {
            "time_start": "string",
            "time_end": "string",
            "break": "string",
            "shipping_cutoff": "string"
          }
        }
      ],
      "individual_schedule": [
        {
          "date": "string",
          "schedule": {
            "time_start": "string",
            "time_end": "string",
            "break": "string",
            "shipping_cutoff": "string"
          },
          "is_works": true
        }
      ],
      "market_connection": {
        "market_location_id": "string",
        "market_location_name": "string",
        "is_active": true,
        "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"
        }
      }
    }
  ],
  "next_cursor": "string",
  "total": 0
}

A successful response.