Список полигонов с фильтрами и пагинацией

POST /v1/polygon/list

POST/v1/polygon/list

Метод возвращает список полигонов с фильтрами и пагинацией.

Тело запроса

filter
object
required

Фильтр. Если поле фильтра не передано, равно null или передан пустой массив [], фильтрация по этому полю не применяется. При одновременном указании нескольких фильтров условия объединяются по AND.

Показать свойства
location_id
array

Фильтр по идентификаторам склада.

polygon_id
array

Фильтр по идентификаторам полигона.

status
array

Фильтр по статусам полигона.

DRAFT: создан

PENDING: в обработке

ACTIVE: активен

FAILED: не прошёл модерацию

DELETED: удалён

Допустимые значения
DRAFTPENDINGACTIVEFAILEDDELETED
cursor
string

Курсор начала отсчёта.

limit
integer
required

Размер страницы. min = 1; max = 300; default = 100.

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

200A successful response.
application/json
object
polygons
array

Элементы списка. Полигоны с недоступными или несуществующими polygon_id в ответ не возвращаются.

PolygonListItem

Показать свойства

PolygonListItem

polygon_id
string
required

Идентификатор полигона.

location_id
string

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

name
string

Название полигона.

status
string
required

Статус полигона.

DRAFT: создан

PENDING: в обработке

ACTIVE: активен

FAILED: не прошёл модерацию

DELETED: удалён

Допустимые значения
DRAFTPENDINGACTIVEFAILEDDELETED
issue
object

Текущая проблема по полигону. Пустой объект или не передаётся, если проблем нет (например при статусах DRAFT, ACTIVE и DELETED).

Показать свойства
code
string

Код проблемы.

message
string

Детальное описание проблемы.

changed_at
string

Момент изменения (RFC3339, например 2026-04-16T08:00:00Z). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.

delivery_options
array
required

Список цен доставки по объёмному весу.

Опция доставки в ответе polygon/list (элемент delivery_options[]). Required внутри опции — как в polygon/create: price, currency, delivery_time_minutes, delivery_types. Для Express — опциональный calculation_mode.

Опция доставки в ответе polygon/list (элемент delivery_options[]). Required внутри опции — как в polygon/create: price, currency, delivery_time_minutes, delivery_types. Для Express — опциональный calculation_mode.

Показать свойства
volume_weight_from
number

Объёмный вес (кг) от: длина (см) × ширина (см) × высота (см) * масса брутто (кг) / 300.

volume_weight_to
number

Объёмный вес (кг) до: длина (см) × ширина (см) × высота (см) * масса брутто (кг) / 300.

price
number
required

Цена доставки, значение умноженное на 100. При calculation_mode = STATIC (или при отсутствии поля) — итоговая стоимость для заказа. При calculation_mode = DYNAMIC — конфигурационный параметр тарифа; итоговая стоимость конкретной доставки определяется ответом POST /v1/polygon/delivery-options/calculate.

currency
string
required

Валюта цены.

RUB: Российский рубль

BYN: Белорусский рубль

KZT: Тенге

EUR: Евро

USD: Доллар США

CNY: Юань

Допустимые значения
RUBBYNKZTEURUSDCNY
vat
string

НДС.

VAT_0: Ставка НДС 0%

VAT_5: Ставка НДС 5%

VAT_7: Ставка НДС 7%

VAT_10: Ставка НДС 10%

VAT_22: Ставка НДС 22%

NO_VAT: Без НДС

Допустимые значения
VAT_0VAT_5VAT_7VAT_10VAT_22NO_VAT
provider_id
string

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

CDEK: СДЭК

RUSSIAN_POST: Почта России

BOXBERRY: Boxberry

YANDEX: Яндекс Доставка

5POST: 5Post

DPD: DPD

HERMES: Hermes

IML: IML

TOP_DELIVERY: Top Delivery

OZON: Ozon

KSE: КСЕ

STRIZH: Стриж

DL: Деловые Линии

PEK: ПЭК

SBL: Сберлогистика

MVIDEO: М.Видео

Допустимые значения
CDEKRUSSIAN_POSTBOXBERRYYANDEX5POSTDPDHERMESIMLTOP_DELIVERYOZONKSESTRIZHDLPEKSBLMVIDEO
delivery_time_minutes
integer
required

Минимальное (базовое) ожидаемое время доставки в минутах. Конфигурационный параметр Express SLA в polygon delivery option. При calculation_mode = STATIC (или при отсутствии поля) — используется как итоговый срок доставки. При calculation_mode = DYNAMIC — конкретный интервал доставки для заказа определяется ответом POST /v1/polygon/delivery-options/calculate.

delivery_types
array
required

Типы доставки.

Тип доставки в ответе polygon/list.

Показать свойства
delivery_type
string
required

Тип доставки.

COURIER: доставка курьером

PICKUP_POINT: доставка в пункт выдачи

EXPRESS: срочная курьерская доставка заказа клиенту

Допустимые значения
COURIERPICKUP_POINTEXPRESS
calculation_mode
string

Режим расчёта условий Express-доставки. Поле опционально; располагается на уровне delivery option после delivery_types. При отсутствии — STATIC.

  • DYNAMIC: Dynamic Express: delivery option задаёт поддержку Express и конфигурационные параметры в полигоне; стоимость и сроки конкретной доставки для заказа рассчитываются через POST /v1/polygon/delivery-options/calculate. Business rule: допустимо только при delivery_type = EXPRESS.
Допустимые значения
STATICDYNAMIC
is_return
boolean

true — опция для возвратной логистики; false или нет поля — прямая доставка. На комбинацию delivery_types + диапазон ВГХ — один возвратный бакет.

weight_from
number

Масса брутто (кг) от.

weight_to
number

Масса брутто (кг) до.

time_slots
array

Доступные интервалы доставки по времени. Конфигурационный параметр delivery option. При calculation_mode = DYNAMIC конкретные интервалы для заказа определяются ответом POST /v1/polygon/delivery-options/calculate.

Интервал времени доставки в течение дня (локальное время).

Показать свойства
from
string

Начало интервала, формат «HH:MM» (например, «10:00»).

to
string

Конец интервала, формат «HH:MM» (например, «12:00»).

trunk_schedule
object

График магистральной перевозки по городу.

Показать свойства
working_schedule
array

Расписание по дням недели; в каждом элементе — day и shipping_cutoff для магистрали.

PolygonWorkingSchedule

Показать свойства

PolygonWorkingSchedule

day
string

День недели.

MONDAY: понедельник

TUESDAY: вторник

WEDNESDAY: среда

THURSDAY: четверг

FRIDAY: пятница

SATURDAY: суббота

SUNDAY: воскресенье

Допустимые значения
MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY
shipping_cutoff
string

Время, после которого отсчёт слота доставки начнётся со следующего дня магистральной перевозки. Формат «16:30». Если пустое — не применяется.

individual_schedule
array

Индивидуальное расписание на даты; в каждом элементе — date, shipping_cutoff для магистрали, is_works.

PolygonIndividualSchedule

Показать свойства

PolygonIndividualSchedule

date
string

Дата, формат «YYYY-MM-DD».

shipping_cutoff
string

Время, после которого отсчёт слота доставки начнётся со следующего дня магистральной перевозки. Формат «16:30». Если пустое — не применяется.

is_works
boolean

Признак работы в дату.

delivery_time_minutes_max
integer

Максимальное ожидаемое время доставки в минутах (Express SLA). Конфигурационный параметр; вместе с delivery_time_minutes задаёт интервал N–M минут в polygon delivery option. При calculation_mode = DYNAMIC не заменяет сроки конкретной доставки из POST /v1/polygon/delivery-options/calculate.

order_cutoff
string

Время, после которого данную опцию доставки нельзя заказать. Формат «HH:MM» (например, «17:30»). Конфигурационный параметр Express в polygon delivery option.

additional_options
array

Дополнительные опции доставки в рамках этой delivery option. Поле опционально; отсутствие массива — доп. опций нет.

Известные option_name: is_fitting, fitting_duration_minutes, unloading, first_minutes_free, delivery_time_minutes. Другие имена — по договорённости с витриной.

Универсальная доп. опция. Одна форма на всех уровнях: option_name + value, вложенные опции — тот же объект.

value — boolean, number или string (флаг, минуты, произвольное значение).

Показать свойства
option_name
string
required

Машинное имя опции. Не закрытый enum.

Известные значения: is_fitting (примерка), fitting_duration_minutes (время на примерку в минутах), unloading (разгрузка), first_minutes_free (первые бесплатные минуты), delivery_time_minutes (время доставки в минутах).

Другие имена — по договорённости с витриной.

value
required

Значение опции: boolean, number или string.

options
array

Вложенные опции той же формы. Опционально; нет массива, если опция самодостаточна.

Circular Reference to PolygonAdditionalOption

coordinates
array
required

Координаты полигона в формате GeoJSON (RFC 7946): массив линейных колец (number[][][]).

Линейное кольцо (LinearRing).

next_cursor
string

Курсор начала отсчёта.

total
integer

Общее количество записей.

Ошибки

400Некорректный запрос
application/json
object
error_type
string

Класс транспортной ошибки запроса (HTTP 4xx/5xx).

Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.

  • ERROR_TYPE_UNSPECIFIED: не используется
  • ERROR_TYPE_UNAUTHORIZED: HTTP 401
  • ERROR_TYPE_RATE_LIMIT: HTTP 429
  • ERROR_TYPE_INTERNAL: HTTP 500
  • ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string

Машинный код ошибки. Уточняет error_type.

message
string

Человекочитаемое сообщение об ошибке.

details
object
401Ошибка авторизации
application/json
object
error_type
string

Класс транспортной ошибки запроса (HTTP 4xx/5xx).

Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.

  • ERROR_TYPE_UNSPECIFIED: не используется
  • ERROR_TYPE_UNAUTHORIZED: HTTP 401
  • ERROR_TYPE_RATE_LIMIT: HTTP 429
  • ERROR_TYPE_INTERNAL: HTTP 500
  • ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string

Машинный код ошибки. Уточняет error_type.

message
string

Человекочитаемое сообщение об ошибке.

details
object
429Превышен лимит запросов
application/json
object
error_type
string

Класс транспортной ошибки запроса (HTTP 4xx/5xx).

Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.

  • ERROR_TYPE_UNSPECIFIED: не используется
  • ERROR_TYPE_UNAUTHORIZED: HTTP 401
  • ERROR_TYPE_RATE_LIMIT: HTTP 429
  • ERROR_TYPE_INTERNAL: HTTP 500
  • ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string

Машинный код ошибки. Уточняет error_type.

message
string

Человекочитаемое сообщение об ошибке.

details
object
500Внутренняя ошибка сервера
application/json
object
error_type
string

Класс транспортной ошибки запроса (HTTP 4xx/5xx).

Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.

  • ERROR_TYPE_UNSPECIFIED: не используется
  • ERROR_TYPE_UNAUTHORIZED: HTTP 401
  • ERROR_TYPE_RATE_LIMIT: HTTP 429
  • ERROR_TYPE_INTERNAL: HTTP 500
  • ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string

Машинный код ошибки. Уточняет error_type.

message
string

Человекочитаемое сообщение об ошибке.

details
object
POST/v1/polygon/list
1curl https://api.omninet.ru/v1/polygon/list \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "filter": {6    "location_id": [7      "string"8    ],9    "polygon_id": [10      "string"11    ],12    "status": [13      "string"14    ]15  },16  "cursor": "string",17  "limit": 018}'
{
  "polygons": [
    {
      "polygon_id": "string",
      "location_id": "string",
      "name": "string",
      "status": "string",
      "issue": {
        "code": "string",
        "message": "string",
        "changed_at": "2026-07-02T10:25:00+02:00"
      },
      "delivery_options": [
        {
          "volume_weight_from": 0,
          "volume_weight_to": 0,
          "price": 0,
          "currency": "RUB",
          "vat": "string",
          "provider_id": "string",
          "delivery_time_minutes": 0,
          "delivery_types": [
            {
              "delivery_type": "COURIER"
            }
          ],
          "calculation_mode": "STATIC",
          "is_return": true,
          "weight_from": 0,
          "weight_to": 0,
          "time_slots": [
            {
              "from": "string",
              "to": "string"
            }
          ],
          "trunk_schedule": {
            "working_schedule": [
              {
                "day": "MONDAY",
                "shipping_cutoff": "string"
              }
            ],
            "individual_schedule": [
              {
                "date": "string",
                "shipping_cutoff": "string",
                "is_works": true
              }
            ]
          },
          "delivery_time_minutes_max": 0,
          "order_cutoff": "string",
          "additional_options": [
            {
              "option_name": "is_fitting",
              "value": true,
              "options": [
                {
                  "option_name": "fitting_duration_minutes",
                  "value": 15
                }
              ]
            }
          ]
        }
      ],
      "coordinates": [
        [
          [
            100,
            0
          ],
          [
            101,
            0
          ],
          [
            101,
            1
          ],
          [
            100,
            1
          ],
          [
            100,
            0
          ]
        ]
      ]
    }
  ],
  "next_cursor": "string",
  "total": 0
}

A successful response.