Перейти к содержимому
Omninet

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

POST /v1/merchant/location/list

Тело запроса

Заголовок раздела «Тело запроса»
filter object
Фильтр.
Показать Скрыть
status array
Фильтр по статусам склада (опционально). В выборку попадают склады, чей статус входит в указанный набор.
Статус локации в витрине.

- DRAFT: создан.
- PENDING: в обработке.
- ACTIVE: включена, доступна к выбору.
- QUARANTINE: карантин.
- FAILED: не прошёл модерацию.
- ARCHIVED: перенесён в архив.
location_id array
Фильтр по идентификаторам склада (опционально).
location_types array
Фильтр по типам склада (опционально). В выборку попадают склады, у которых в массиве location_types есть хотя бы один из указанных типов (WAREHOUSE).
Тип склада в массиве location_types.

- WAREHOUSE: склад.
cursor string
Курсор начала отсчёта.
limit integer
Лимит записей.

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

200 A successful response.
application/json
object
locations array
Элементы списка.
Показать Скрыть
location_id string
Идентификатор склада.
merchant_location_id string
Идентификатор локации продавца (опционально).
location_types array
Типы локации; возможные значения WAREHOUSE (склад).
Тип склада в массиве location_types.

- WAREHOUSE: склад.
name string
Название склада.
status string
Статус локации в витрине.
values
DRAFTPENDINGACTIVEQUARANTINEFAILEDARCHIVED
issue object
Проблема по локации; пустой объект или не передаётся при статусах DRAFT и ACTIVE.
Показать Скрыть
code string
Код проблемы.
message string
Детальное описание проблемы.
changed_at string
Момент изменения (RFC3339, например 2026-04-16T08:00:00Z).
address_tail string
Адрес локации в текстовом формате.
latitude number
Широта точки (WGS 84).
longitude number
Долгота точки (WGS 84).
is_quarantine boolean
Признак нахождения склада в карантине.
is_archive boolean
Признак архива.
working_schedule array
Расписание работы.
Показать Скрыть
day string
День недели.
values
MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY
schedule object
Расписание на день.
Показать Скрыть
time_start string
Время начала, формат «00:00».
time_end string
Время окончания, формат «00:00».
break string
Перерыв, формат «13:00–14:00».
shipping_cutoff string
Время, после которого отсчёт слота доставки начнётся со следующего дня. Формат «16:30». Если пустое — не применяется.
individual_schedule array
Индивидуальное расписание на определённые даты. К примеру, праздничные дни (опционально при отличии от working_schedule).
Показать Скрыть
date string
Дата, формат «31.12.2020».
schedule object
Расписание на дату.
Показать Скрыть
time_start string
Время начала, формат «00:00».
time_end string
Время окончания, формат «00:00».
break string
Перерыв, формат «13:00–14:00».
shipping_cutoff string
Время, после которого отсчёт слота доставки начнётся со следующего дня. Формат «16:30». Если пустое — не применяется.
is_works boolean
Признак работы в дату.
market_connection object
Привязка склада продавца к складу маркетплейса и его ограничениям по FBS-отгрузкам.
Показать Скрыть
market_location_id string
Идентификатор подключённого склада маркетплейса.
market_location_name string
Название подключённого склада маркетплейса.
is_active boolean
Признак доступности склада маркетплейса для новых FBS-поставок.
shipment_limits object
Ограничения подключённого склада маркетплейса по типам поставок.
Показать Скрыть
accepts_standard boolean
Склад принимает стандартные FBS-отгрузки.
accepts_kgt boolean
Склад принимает КГТ-отгрузки.
accepts_mgt boolean
Склад принимает МГТ-отгрузки.
max_weight_kg number
Максимальный вес одного грузоместа в килограммах.
max_length_cm number
Максимальная длина одного грузоместа в сантиметрах.
max_width_cm number
Максимальная ширина одного грузоместа в сантиметрах.
max_height_cm number
Максимальная высота одного грузоместа в сантиметрах.
max_sum_dimensions_cm number
Максимальная сумма измерений одного грузоместа в сантиметрах.
comment string
Дополнительный комментарий по ограничениям отгрузки.
next_cursor string
Курсор начала отсчёта.
total integer
Общее количество записей.

Ошибки

400 Некорректный запрос
application/json
object
error_type string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
values
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code string
код ошибки
message string
сообщение
details object
Показать Скрыть
No properties defined
401 Ошибка авторизации
application/json
object
error_type string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
values
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code string
код ошибки
message string
сообщение
details object
Показать Скрыть
No properties defined
429 Превышен лимит запросов
application/json
object
error_type string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
values
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code string
код ошибки
message string
сообщение
details object
Показать Скрыть
No properties defined
500 Внутренняя ошибка сервера
application/json
object
error_type string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
values
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code string
код ошибки
message string
сообщение
details object
Показать Скрыть
No properties defined
POST /v1/merchant/location/list 

              1
              curl 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": 0
            
              18
              }'
            
{
  "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.

{
  "error_type": "string",
  "code": "string",
  "message": "string",
  "details": {}
}

Некорректный запрос

{
  "error_type": "string",
  "code": "string",
  "message": "string",
  "details": {}
}

Ошибка авторизации

{
  "error_type": "string",
  "code": "string",
  "message": "string",
  "details": {}
}

Превышен лимит запросов

{
  "error_type": "string",
  "code": "string",
  "message": "string",
  "details": {}
}

Внутренняя ошибка сервера