Обновление слота даты и времени доставки

POST /v1/order/dbs/timeslot/set

POST/v1/order/dbs/timeslot/set

Метод изменяет (обновляет) ранее установленный слот даты и времени доставки заказа. Первичная установка слота выполняется в другом сценарии.

Тело запроса

merchant_order_id
string
Идентификатор заказа продавца.
delivery_date_begin
string
Дата и время начала доставки (date-time, RFC3339). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T00:00:00+03:00). При наличии слота — точное время начала; при отсутствии — 00:00:00 выбранной даты. Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
delivery_date_end
string
Дата и время окончания доставки (date-time, RFC3339). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T23:59:59+03:00). При наличии слота — точное время окончания; при отсутствии — 23:59:59 выбранной даты. Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
changed_by
string
Инициатор.
Допустимые значения
MERCHANTCLIENT
comment
string
Комментарий к обновлению слота даты и времени доставки (опционально).

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

200A successful response.
application/json
object
failed
object
Ошибка обновления слота. Если отсутствует — успех.
Показать свойства
merchant_order_id
string
Идентификатор заказа продавца.
error_message
string
Текст ошибки (compat). Предпочтительно использовать errors.
errors
array
Структурированные ошибки. Коды: OrderTimeslotValidationErrorCode.
Ошибка валидации/бизнеса поля для scope «OrderTimeslot». Допустимые field: merchant_order_id, delivery_date_begin, delivery_date_end, changed_by, comment. Для бизнес-правил витрины: code=STOREFRONT_RULE_VIOLATION.
Показать свойства
field
string
required
Путь к полю. Ожидаемые: merchant_order_id, delivery_date_begin, delivery_date_end, changed_by, comment.
code
string
required
Коды ошибок ручки (scope OrderTimeslot). Допустимые field: merchant_order_id, delivery_date_begin, delivery_date_end, changed_by, comment. - REQUIRED: Поле отсутствует или пустое, но обязательно - INVALID_TYPE: Неверный JSON-тип - INVALID_FORMAT: Общий сбой формата значения - INVALID_DATE_TIME: Не RFC3339 или отсутствует timezone - INVALID_RANGE: Некорректный диапазон (from > to) - NOT_FOUND: Сущность не найдена (уточняется полем field) - CONFLICT: Конфликт состояния ресурса - STOREFRONT_RULE_VIOLATION: Запрос синтаксически валиден, но отклонён бизнес-правилом витрины (детали в message)
Допустимые значения
REQUIREDINVALID_TYPEINVALID_FORMATINVALID_DATE_TIMEINVALID_RANGENOT_FOUNDCONFLICTSTOREFRONT_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_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
429Превышен лимит запросов
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
500Внутренняя ошибка сервера
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
defaultОшибка (неожиданная или прочие)
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
POST/v1/order/dbs/timeslot/set
1curl https://api.omninet.ru/v1/order/dbs/timeslot/set \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "merchant_order_id": "string",6  "delivery_date_begin": "2026-07-02T00:00:00+03:00",7  "delivery_date_end": "2026-07-02T23:59:59+03:00",8  "changed_by": "string",9  "comment": "string"10}'
{
  "failed": {
    "merchant_order_id": "string",
    "error_message": "string",
    "errors": [
      {
        "field": "delivery_date_begin",
        "code": "INVALID_DATE_TIME",
        "message": "Ожидается RFC3339 с timezone"
      }
    ]
  }
}

A successful response.