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

POST /v1/market/location/list

Тело запроса

filter object

Параметры фильтрации складов маркетплейса.

Показать Скрыть

market_location_id array

Фильтр по идентификаторам складов маркетплейса (опционально).

city array

Фильтр по городам расположения склада маркетплейса (опционально).

is_active boolean

Фильтр по доступности склада для новых FBS-поставок (опционально).

accepts_kgt boolean

Вернуть только склады, принимающие КГТ-отгрузки (опционально).

accepts_mgt boolean

Вернуть только склады, принимающие МГТ-отгрузки (опционально).

cursor string

Курсор постраничной выборки.

limit integer

Размер страницы.

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

200 A successful response.

application/json

object

locations array

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

Показать Скрыть

market_location_id string

Идентификатор склада маркетплейса.

name string

Название склада маркетплейса.

city string

Город расположения склада маркетплейса.

address_tail string

Адрес склада маркетплейса в текстовом формате.

timezone string

Часовой пояс склада маркетплейса.

is_active boolean

Склад доступен для подключения и новых FBS-отгрузок.

acceptance_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». Если пустое — не применяется.

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

Дополнительный комментарий по ограничениям отгрузки.

acceptance_instructions 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/market/location/list

Copy

              1
              curl 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": true
            
              15
                },
            
              16
                "cursor": "string",
            
              17
                "limit": 0
            
              18
              }'
            

200 400 401 429 500

{
  "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.

{
  "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": {}
}

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