Обновление опций доставки (диапазоны, цена, время)

POST /v1/polygon/delivery-options/update

POST/v1/polygon/delivery-options/update

Тело запроса

polygon_id

string

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

delivery_options

array

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

Опция доставки по диапазону объёмного веса.

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

volume_weight_from

number

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

volume_weight_to

number

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

price

number

Цена доставки, значение умноженное на 100.

currency

string

Валюта цены.

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

RUBBYNKZTEURUSDCNY

vat

string

НДС.

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

VAT_0VAT_5VAT_7VAT_10VAT_22NO_VAT

provider_id

string

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

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

CDEKBOXBERRY5POSTRUSSIAN_POSTYANDEXSBLMVIDEO

delivery_time_minutes

integer

Время доставки в минутах.

delivery_types

array

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

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

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

delivery_type

string

required

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

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

COURIERPICKUP_POINT

weight_from

number

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

weight_to

number

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

time_slots

array

Доступные интервалы доставки по времени (опционально).

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

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

from

string

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

string

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

trunk_schedule

object

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

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

working_schedule

array

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

PolygonWorkingSchedule

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

PolygonWorkingSchedule

day

string

День недели.

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

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

shipping_cutoff

string

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

individual_schedule

array

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

PolygonIndividualSchedule

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

PolygonIndividualSchedule

date

string

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

shipping_cutoff

string

is_works

boolean

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

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

200A successful response.

application/json

object

polygon_id

string

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

errors

array

Ошибки валидации по полям; пустой массив при успехе. Коды только из PolygonDeliveryOptionsValidationErrorCode.

Ошибка валидации/бизнеса поля для scope «PolygonDeliveryOptions». Допустимые field: polygon_id, delivery_options[], time_slots, trunk_schedule, price, weight_*, volume_weight_*. Для бизнес-правил витрины: code=STOREFRONT_RULE_VIOLATION.

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

field

string

required

Путь к полю. Ожидаемые: polygon_id, delivery_options[], time_slots, trunk_schedule, price, weight_*, volume_weight_*.

code

string

required

Коды ошибок ручки (scope PolygonDeliveryOptions). Допустимые field: polygon_id, delivery_options[], time_slots, trunk_schedule, price, weight_*, volume_weight_*. - REQUIRED: Поле отсутствует или пустое, но обязательно - INVALID_TYPE: Неверный JSON-тип - INVALID_FORMAT: Общий сбой формата значения - INVALID_ENUM: Значение не из допустимого enum - CONDITIONALLY_REQUIRED: Поле обязательно при выполнении условия - INVALID_TIME: Не формат HH:MM - INVALID_TIME_RANGE: Некорректный диапазон времени (from >= to и т.п.) - INVALID_DATE: Не формат YYYY-MM-DD - INVALID_DATE_TIME: Не RFC3339 или отсутствует timezone - MIN_VALUE: Значение ниже минимума - MAX_VALUE: Значение выше максимума - NEGATIVE_VALUE: Отрицательное значение недопустимо - INVALID_RANGE: Некорректный диапазон (from > to) - TOO_MANY_ITEMS: Превышен maxItems / лимит пакета - NOT_FOUND: Сущность не найдена (уточняется полем field) - STOREFRONT_RULE_VIOLATION: Запрос синтаксически валиден, но отклонён бизнес-правилом витрины (детали в message)

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

REQUIREDINVALID_TYPEINVALID_FORMATINVALID_ENUMCONDITIONALLY_REQUIREDINVALID_TIMEINVALID_TIME_RANGEINVALID_DATEINVALID_DATE_TIMEMIN_VALUEMAX_VALUENEGATIVE_VALUEINVALID_RANGETOO_MANY_ITEMSNOT_FOUNDSTOREFRONT_RULE_VIOLATION

message

string

required

Текст для клиента. Для STOREFRONT_RULE_VIOLATION — описание правила.

Ошибки

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

application/json

object

error_type

string

ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.

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

ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST

code

string

код ошибки

message

string

сообщение

details

object

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

application/json

object

error_type

string

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

ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST

code

string

код ошибки

message

string

сообщение

details

object

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

application/json

object

error_type

string

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

ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST

code

string

код ошибки

message

string

сообщение

details

object

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

application/json

object

error_type

string

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

ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST

code

string

код ошибки

message

string

сообщение

details

object

defaultОшибка (неожиданная или прочие)

application/json

object

error_type

string

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

ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST

code

string

код ошибки

message

string

сообщение

details

object

POST/v1/polygon/delivery-options/update

1curl https://api.omninet.ru/v1/polygon/delivery-options/update \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "polygon_id": "string",6  "delivery_options": [7    {8      "volume_weight_from": 0,9      "volume_weight_to": 0,10      "price": 0,11      "currency": "RUB",12      "vat": "string",13      "provider_id": "string",14      "delivery_time_minutes": 0,15      "delivery_types": [16        {17          "delivery_type": "COURIER"18        }19      ],20      "weight_from": 0,21      "weight_to": 0,22      "time_slots": [23        {24          "from": "string",25          "to": "string"26        }27      ],28      "trunk_schedule": {29        "working_schedule": [30          {31            "day": "MONDAY",32            "shipping_cutoff": "string"33          }34        ],35        "individual_schedule": [36          {37            "date": "string",38            "shipping_cutoff": "string",39            "is_works": true40          }41        ]42      }43    }44  ]45}'

{
  "polygon_id": "string",
  "errors": [
    {
      "field": "delivery_options[0].price",
      "code": "NEGATIVE_VALUE",
      "message": "Цена доставки не может быть отрицательной"
    }
  ]
}

A successful response.