Расчёт вариантов Express-доставки (Dynamic Express)
POST /v1/polygon/delivery-options/calculate
/v1/polygon/delivery-options/calculateMerchant-hosted метод (Marketplace → Merchant). Marketplace сначала по конфигурации location → polygon → delivery_options определяет поддержку Express (delivery_type = EXPRESS). Для delivery option с calculation_mode = DYNAMIC витрина вызывает этот метод при оформлении заказа и получает доступные варианты Express-доставки: стоимость (price) и временной интервал (delivery_date_begin, delivery_date_end) каждого варианта — в options[] ответа. Метод не заменяет polygon/delivery_options и не сообщает о поддержке Express в полигоне. Не выполняет reserve/confirm; в ответе возвращается idempotency_key витрины.
Тело запроса
Идентификатор склада продавца.
Идентификатор полигона.
Ключ идемпотентности. Генерирует витрина.
Адрес доставки до покупателя.
Показать свойстваСкрыть свойства
Адрес в текстовом формате. Формат: «196653, Россия, г. Санкт-Петербург, г. Колпино, ул. Октябрьская, д. 77/27, подъезд 1, этаж 3, кв. 12».
Широта.
Долгота.
Состав заказа (без quantity; один товар — один заказ).
Товар в запросе расчёта. Заполняется offer_id и/или product_id; при обоих используется только product_id.
Показать свойстваСкрыть свойства
Идентификатор товара в системе маркетплейса.
Артикул продавца.
Сумма корзины, значение умноженное на 100.
Валюта корзины (order_total).
RUB: Российский рубль
BYN: Белорусский рубль
KZT: Тенге
EUR: Евро
USD: Доллар США
CNY: Юань
Объёмный вес всей корзины, кг.
Масса брутто всей корзины, кг.
Успешный ответ
200A successful response. application/json
Ключ идемпотентности из запроса.
Обязательное при условии получения расчёта. Момент, после которого результат расчёта не считается актуальным. Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
Доступные варианты Express-доставки с конкретной стоимостью и временным интервалом для заказа.
PolygonDeliveryOptionsCalculateOption
Показать свойстваСкрыть свойства
PolygonDeliveryOptionsCalculateOption
Начало интервала доставки (date-time, RFC3339). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
Конец интервала доставки (date-time, RFC3339). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
Стоимость доставки, значение умножено на 100.
Валюта стоимости доставки.
RUB: Российский рубльBYN: Белорусский рубльKZT: ТенгеEUR: ЕвроUSD: Доллар СШАCNY: Юань
Ошибки полей.
Ошибка поля запроса расчёта.
Показать свойстваСкрыть свойства
Путь к полю.
Коды ошибок расчёта.
REQUIRED: Поле отсутствует или пустое, но обязательноINVALID_TYPE: Неверный JSON-типINVALID_FORMAT: Неверный формат значенияINVALID_ENUM: Значение не из допустимого набораINVALID_ADDRESS_FORMAT: Адрес не соответствует шаблонуNEGATIVE_VALUE: Отрицательное значение недопустимоNOT_FOUND: Сущность не найденаCONFLICT: Конфликт состоянияSTOREFRONT_RULE_VIOLATION: Отклонено бизнес-правилом витрины
Текст для клиента.
Ошибки
400Некорректный запрос application/json
Класс транспортной ошибки запроса (HTTP 4xx/5xx).
Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.
ERROR_TYPE_UNSPECIFIED: не используетсяERROR_TYPE_UNAUTHORIZED: HTTP 401ERROR_TYPE_RATE_LIMIT: HTTP 429ERROR_TYPE_INTERNAL: HTTP 500ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Машинный код ошибки. Уточняет error_type.
Человекочитаемое сообщение об ошибке.
401Ошибка авторизации application/json
Класс транспортной ошибки запроса (HTTP 4xx/5xx).
Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.
ERROR_TYPE_UNSPECIFIED: не используетсяERROR_TYPE_UNAUTHORIZED: HTTP 401ERROR_TYPE_RATE_LIMIT: HTTP 429ERROR_TYPE_INTERNAL: HTTP 500ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Машинный код ошибки. Уточняет error_type.
Человекочитаемое сообщение об ошибке.
429Превышен лимит запросов application/json
Класс транспортной ошибки запроса (HTTP 4xx/5xx).
Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.
ERROR_TYPE_UNSPECIFIED: не используетсяERROR_TYPE_UNAUTHORIZED: HTTP 401ERROR_TYPE_RATE_LIMIT: HTTP 429ERROR_TYPE_INTERNAL: HTTP 500ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Машинный код ошибки. Уточняет error_type.
Человекочитаемое сообщение об ошибке.
500Внутренняя ошибка сервера application/json
Класс транспортной ошибки запроса (HTTP 4xx/5xx).
Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.
ERROR_TYPE_UNSPECIFIED: не используетсяERROR_TYPE_UNAUTHORIZED: HTTP 401ERROR_TYPE_RATE_LIMIT: HTTP 429ERROR_TYPE_INTERNAL: HTTP 500ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Машинный код ошибки. Уточняет error_type.
Человекочитаемое сообщение об ошибке.