{ "openapi": "3.0.4", "info": { "title": "Документация Ozon Delivery API", "description": "В документе описаны методы Ozon Delivery API для Ozon Доставки для бизнеса.
\n[Подробнее об Ozon Доставке для бизнеса в Базе знаний продавца](https://seller-edu.ozon.ru/libra/ozon-logistika/dostavka-dlya-biznesa)\n\nРабочая среда: .\n", "version": null, "x-disableAuth": true }, "servers": [ { "url": "https://api-delivery.ozon.ru" } ], "x-tagGroups": [ { "name": "Общее описание", "tags": [ "Introduction", "GetStarted", "Process", "News" ] }, { "name": "Методы API", "tags": [ "ShipmentMethod", "DropOffPoint", "ReturnPoint", "CreateOrder", "DeliveryPoint", "PostingShipping", "ContainerShipping", "ContainerProcess", "PostingProcess", "ReturnProcess" ] }, { "name": "Приложения", "tags": [ "Status Model", "Error Codes" ] } ], "tags": [ { "name": "Introduction", "x-displayName": "Введение", "description": "Ozon Delivery API — программный интерфейс для интеграции логистики Ozon в инфраструктуру продавца. API позволяет автоматизировать работу с доставкой: от расчёта условий и создания заказов до отслеживания и обработки возвратов.\n\nС помощью Ozon Delivery API можно:\n\n[//]: # (- создавать методы доставки и управлять ими;)\n\n[//]: # (- выбирать точки отгрузки и получения возвратов;)\n- проверять доступность доставки для покупателя; \n- рассчитывать предварительные сроки и стоимость доставки, а также стоимость страховки;\n- создавать заказы с одним или несколькими отправлениями;\n- подтверждать готовность отправлений к отгрузке, генерировать этикетки;\n- получать информацию об отправлениях, историю статусов;\n- отменять отправления;\n- отслеживать возвраты, скачивать штрихкоды для их получения.\n\n[//]: # (- формировать грузоместа для доверительной приёмки; [встанет на 12 строку после фулл релиза] ) " }, { "name": "GetStarted", "x-displayName": "Начало работы", "description": "## Создание приложения\n\nOzon Delivery API работает через OAuth-токен в частном приложении. Для подключения создайте приложение:\n\n1. В личном кабинете Ozon Доставки в разделе [**Настройки → Управление частными приложениями**](https://seller.ozon.ru/app/settings/private-apps) нажмите **Создать**. \n2. Выберите уровни доступа приложения к API:\n - `delivery-api.delivery` — методы для проверки доступности доставки и сроков;\n - `delivery-api.delivery-point` — методы для получения информации по пунктам выдачи;\n - `delivery-api.order` — методы для оформления заказа;\n - `delivery-api.posting` — методы для работы с отправлениями;\n - `delivery-api.return` — методы для работы с возвратами;\n - `delivery-api.all` — все методы.\n3. Нажмите **Создать**.\n\nВ строке с приложением нажмите и скопируйте `client_id` и `client_secret`.\nИспользуйте их для авторизации в API.\n\n\n\nВы также можете выдать доступ разработчикам для управления частным приложением.
\n[Подробнее о выдаче доступа](https://docs.ozon.ru/api/applications/#section/Rabota-s-chastnym-prilozheniem/Vydat-dostup)\n\n## Авторизация\n\nЧтобы получить OAuth-токен, отправьте POST-запрос по ссылке \nс обязательными параметрами:\n\n- `client_id` — уникальный идентификатор OAuth-клиента;\n- `client_secret` — секретный ключ OAuth-клиента;\n- `grant_type = client_credentials` — тип гранта c прямой авторизацией;\n- `scope` — массив с уровнями доступа к API.\n\nЕсли запрос выполнен успешно, Ozon возвращает ответ в JSON-формате с токеном доступа `access_token`.\nС ним вы можете обращаться к методам API.\n\n## Защита от DDoS-атак\n\nСерверы Ozon защищены модулем testcookie.\nДля успешного взаимодействия с API приложение должно корректно обрабатывать редиректы:\n\n1. При вызове метода модуль перехватывает входящий HTTP-запрос для проверки.\n2. Сервер отправляет клиенту HTTP-редирект с кодом 302 или 307 с заголовками `Location` и `Set-Cookie`.\n3. Клиент выполняет запрос с тем же телом по пути из заголовка `Location`, приложив `Cookie` из заголовка `Set-Cookie`.\n4. Клиент сохраняет значение заголовка `Set-Cookie` и использует его для последующих запросов к API.\n5. Последующие запросы работают без редиректа при наличии указанных `Cookie` в запросе.\n\nЗначение `Set-Cookie` является уникальным, зашифрованным и может измениться без уведомления.\nВ некоторых случаях при отсутствии `Cookie` в запросе сервер может позволить сделать вызов без редиректа,\nа в некоторых всегда отвечает редиректом до получения корректных `Cookie`.\n\n## Работа с API\n\nРабочая среда: .\n\nШаблон запроса:\n\n```bash\ncurl -X POST https://api-delivery.ozon.ru/{эндпоинт метода Ozon Delivery API} \\\n-H \"Authorization: Bearer ACCESS_TOKEN\"\n```\n\n### Пример работы с API на bash\n\n#### Переменные окружения\n\n```bash\n# Укажите ваш CLIENT_ID.\nexport CLIENT_ID=\"...\" \n\n# Укажите ваш CLIENT_SECRET.\nexport CLIENT_SECRET=\"...\"\n\n# Адрес рабочей среды.\nexport HOST=\"api-delivery.ozon.ru\"\n\n# Адрес получения токена авторизации.\nexport AUTH_URL=\"https://xapi.ozon.ru/oauth/token\"\n```\n\n#### Получить и сохранить токен\n\n```bash\ncurl -sL -c ~/.b2c_cookies -b ~/.b2c_cookies -X POST \"$AUTH_URL\" \\\n -H \"Content-Type: application/json\" \\\n -d \"{\\\"client_id\\\":\\\"$CLIENT_ID\\\",\\\"client_secret\\\":\\\"$CLIENT_SECRET\\\", \\\"grant_type\\\": \\\"client_credentials\\\", \\\"scope\\\": [ \\\"delivery-api.delivery\\\", \\\"delivery-api.delivery-point\\\", \\\"delivery-api.order\\\", \\\"delivery-api.posting\\\" ]}\" \\\n | jq -r '.access_token' > ~/.b2c_token\n \ncat ~/.b2c_token\n```\nРезультат:\n\n```bash\neyJhbGciOU73Dutst9_0eoU73Dutst9_cDBM0VmkL0W1I6RGDcYM41M6bkFMx3-1lSZ-SjfOh2_ZGguYPQcRA...\n```\n\n#### Пример вызова метода\n\n```bash\n# Номер телефона покупателя для проверки.\nexport PHONE_NUMBER=\"+7...\"\n\ncurl -sL -c ~/.b2c_cookies -b ~/.b2c_cookies -X POST \"https://$HOST/v1/delivery/check-client\" \\\n -H \"Authorization: Bearer $(cat ~/.b2c_token)\" \\\n -H \"Content-Type: application/json\" \\\n -d \"{\\\"phone_number\\\": \\\"$PHONE_NUMBER\\\"}\"\n```\n\nРезультат:\n\n```bash\n{\"can_be_delivered\":true}%\n```\n" }, { "name": "Process", "x-displayName": "Порядок работы с методами", "description": "Перед использованием методов для оформления заказов,\nнастройте логистику вашего магазина в личном кабинете Ozon Доставки.\n\nЧтобы добавить метод доставки, в разделе [**Методы доставки**](https://seller.ozon.ru/app/delivery/delivery-methods) нажмите **Создать метод доставки**.\nУкажите, как и куда будете передавать нам отправления.\nВы можете добавить несколько методов доставки с разными точками отгрузки.
\n[Подробнее о настройке методов доставки в Базе знаний продавца](https://seller-edu.ozon.ru/libra/ozon-logistika/dostavka-dlya-biznesa/nastroika-metoda-dostavki)\n\nКогда вы добавите метод, для него будет сгенерирован штрихкод с номером,\nкоторый соответствует параметру `shipment_method_id`.\nПри оформлении заказа каждое отправление в нём должно быть привязано к одному из методов доставки\nчерез `shipment_method_id`. Так мы сможем рассчитать маршрут и срок доставки отправлений.\n\n## Предварительный расчёт и оформление заказа\n\n\n\n1. Покупатель авторизуется на сайте продавца.\n\n2. Продавец проверяет доступность доставки Ozon для покупателя по его номеру телефона: [/v1/delivery/check-client](#operation/DeliveryCheckClient).\n Доставка доступна только для покупателей, которые зарегистрированы на Ozon.\n\n3. Продавец может показать примерный срок доставки товаров на основе местоположения покупателя: [/v1/delivery/location](#operation/DeliveryLocation).\n Рекомендуем использовать метод в случае, если покупатель ещё не выбрал товар,\n так как срок доставки предварительный и не учитывает параметры конкретного товара и точки доставки.\n\n По умолчанию расчёт срока ведётся от текущего момента времени.\n При указании плановой даты и времени отгрузки `cutoff_at` расчёт будет сделан от указанного момента отгрузки.\n\n4. Покупатель выбирает на сайте продавца товар для покупки и указывает тип доставки:\n - в пункт выдачи — выбирает пункт на карте или из списка;\n - курьером — указывает адрес доставки.\n\n5. При доставке в пункт выдачи продавец может:\n - Получить список всех доступных пунктов: [/v1/delivery-point/list](#operation/DeliveryPointList).\n Из них продавец самостоятельно может отфильтровать пункты по местоположению и показать их покупателю списком или на карте.\n - Проверить доступность пунктов выдачи для доставки выбранных товаров: [/v1/delivery-point/check-availability](#operation/DeliveryPointCheckAvailability).\n Доступность пунктов зависит от метода доставки, габаритов и объявленной стоимости заказа.\n - Получить информацию о пункте, включая его адрес и график работы: [/v1/delivery-point/info](#operation/DeliveryPointInfo).\n\n6. Продавец проверяет возможность доставки отправлений из заказа: [/v1/order/checkout](#operation/OrderCheckout). В запросе передаётся:\n - метод доставки, через который будет отгружаться товар;\n - предполагаемые объёмно-весовые характеристики (ОВХ) отправления;\n - тип доставки — в пункт выдачи или курьером;\n - объявленная стоимость отправления.\n\n Если доставка отправления возможна, в ответе возвращается предварительный расчёт срока, стоимости доставки и страховки.\n\n7. Покупатель оформляет заказ на сайте продавца.\n\n8. Продавец создаёт заказ в Ozon методом [/v1/order/create](#operation/OrderCreate). В запросе передаётся:\n - метод доставки;\n - предполагаемые ОВХ отправления;\n - тип доставки;\n - объявленная стоимость отправления;\n - описание содержимого отправления. \n\n Чтобы проверить актуальность предварительного расчёта, перед методом [/v1/order/create](#operation/OrderCreate)\n используйте метод [/v1/order/checkout](#operation/OrderCheckout) с теми же параметрами.\n\n## Подтверждение и отгрузка отправлений\n\n\n\n1. Если товар в наличии, продавец подтверждает начало сборки: [/v1/posting/approve](#operation/PostingApprove).\n\n2. Мы проверяем баланс продавца для возможности отгружать отправления.\n Посмотреть и пополнить баланс можно в [личном кабинете Ozon Доставки](https://seller.ozon.ru/app/delivery/).\n\n3. Продавец может узнать результат подтверждения сборки: [/v1/posting/info](#operation/PostingInfo).\n Если подтверждение успешно, отправление переходит в статус `ready_for_shipping`.\n\n4. Продавец получает этикетку отправления: [/v1/posting/label](#operation/PostingLabel).\n Она обязательна для приёмки в логистику Ozon.\n Получить этикетку можно только для отправлений в статусе `ready_for_shipping`.\n\n## Обработка отправлений\n\n\n\nПродавец может:\n\n- Получить информацию обо всех своих отправлениях и их актуальных статусах: [/v1/posting/search](#operation/PostingSearch).\n Можно фильтровать список по статусу, методу доставки, дате создания отправления.\n- Получить параметры и статус конкретного отправления: [/v1/posting/info](#operation/PostingInfo).\n- Запросить историю статусов отправления: [/v1/posting/status-history](#operation/PostingStatusHistory).\n История учитывает только статусы отправления на прямом потоке.\n\nЕсли покупатель отменяет заказ на сайте продавца или продавец не может выполнить заказ,\nдля отмены отправлений в этом заказе используется метод [/v1/posting/cancel](#operation/PostingCancel).\nОтмена доступна до перехода отправления в статус `delivered`.\n\nПродавец может узнать результат отмены: [/v1/posting/info](#operation/PostingInfo).\nЕсли отмена успешна, отправление переходит в статус `canceled`. \nДвижение отменённого отправления обратно к продавцу можно отслеживать через методы по возвратам.\n\n## Обработка возвратов\n\n\n\nПродавец может:\n- Получить список всех своих отменённых отправлений и возвратов: [v1/return/search](#operation/ReturnSearch).\n- Получить параметры и статус по конкретному возврату: [v1/return/info](#operation/ReturnInfo).\n- Запросить историю статусов возвратов: [/v1/return/status-history](#operation/ReturnStatusHistory).\n История учитывает только статусы отправления на возвратном потоке.\n- Скачать PDF-файл со штрихкодом для получения возвратов: [/v1/return/download-barcode](#operation/ReturnDownloadBarcode).\n Срок действия штрихкода указан в файле. Получайте штрихкод непосредственно перед получением возвратов.\n\n Чтобы обновить действующий штрихкод, используйте: [/v1/return/reset-barcode](#operation/ReturnResetBarcode)." }, { "name": "CreateOrder", "x-displayName": "Оформление заказа" }, { "name": "DeliveryPoint", "x-displayName": "Пункты выдачи заказов" }, { "name": "PostingShipping", "x-displayName": "Отгрузка отправлений" }, { "name": "PostingProcess", "x-displayName": "Обработка отправлений" }, { "name": "ReturnProcess", "x-displayName": "Обработка возвратов" }, { "name": "Status Model", "x-displayName": "Статусная модель", "description": "### Отправление\n\n| Статус | Описание |\n|----------------------------|----------------------------------------------------------------------------|\n| `CREATED` | Отправление создано, но не подтверждено. Отгружать в Ozon нельзя. |\n| `FORMING` | Отправление в процессе подтверждения. |\n| `FORMING_FAILED` | Ошибка при подтверждении отправления. |\n| `READY_FOR_SHIPPING` | Отправление подтверждено и готово к отгрузке в Ozon. |\n| `ON_WAY` | Отправление принято в логистику Ozon и доставляется получателю. |\n| `IN_DELIVERY_POINT` | Отправление доставлено в пункт выдачи заказов или постамат. |\n| `IN_COURIER_SERVICE` | Отправление передано курьеру Ozon для доставки по адресу. |\n| `DELIVERED` | Отправление выдано получателю. Отмена недоступна. |\n| `CANCELED` | Отправление отменено. Движение отслеживается как возврат. |\n\n[//]: # (Добавить в следующем этапе, порядок можно посмотреть в доке заказчиков)\n\n[\n\n| `IN_CONTAINER` | Отправление добавлено в грузоместо для доверительной приёмки. |\n| `DRIVER_PICK_UP` | Отправление принято курьером Ozon со склада продавца. |\n| `ACCEPTANCE_IN_PROGRESS` | Грузоместо с отправлением принято на точке отгрузки. Идёт приёмка состава. |\n| `NOT_ACCEPTED_TO_DELIVERY` | Отправление не было принято из грузоместа на точке отгрузки. |\n\n]: #\n\n### Возврат\n\n| Статус | Описание |\n|------------------------|----------------------------------------------------|\n| `MOVING` | Возврат доставляется по логистике Ozon к продавцу. |\n| `AT_THE_PICK_UP_POINT` | Возврат ожидает продавца в пункте выдачи. |\n| `RECEIVED` | Возврат получен продавцом. |\n| `UTILIZATION` | Возврат отправлен на утилизацию. |\n| `UTILIZED` | Возврат утилизирован. |\n| `WRITTEN_OFF` | Возврат списан в логистике. |\n| `LOOKING_FOR` | Ищем возврат в логистике. |\n\n[\n\n### Грузоместо\n\n| Статус | Описание |\n|-------------|------------------------------------------------------------------|\n| `CREATED` | Грузоместо создано, но не подтверждено. Отгружать в Ozon нельзя. |\n| `FORMING` | Грузоместо в процессе подтверждения. |\n| `FORMED` | Грузоместо подтверждено и готово к отгрузке. |\n| `ACCEPTED` | Грузоместо принято на точке отгрузки. Отмена недоступна. |\n| `FINISHED` | Приёмка состава грузоместа полностью завершена. |\n| `CANCELING` | Грузоместо в процессе отмены. |\n| `CANCELED` | Грузоместо отменено. |\n\n### Метод доставки\n\n| Статус | Описание |\n|------------|---------------------------------------------------------------|\n| `FORMING` | Метод доставки в процессе создания. |\n| `ACTIVE` | Метод доставки активен. Можно создавать отправления. |\n| `CLOSE` | Метод доставки удалён. Создание отправлений недоступно. |\n| `BLOCKED` | Метод доставки заблокирован. Создание отправлений недоступно. |\n| `ERROR` | Ошибка создания метода доставки. |\n\n]: #" }, { "name": "Error Codes", "x-displayName": "Коды ошибок", "description": "### [/v1/delivery-point/check-availability](#operation/DeliveryPointCheckAvailability)\n\n| Код ошибки | Описание |\n|----------------------------------|----------------------------------------------------------|\n| `DeliveryPointRestrictionsError` | Пункт выдачи не подходит под выбранные параметры заказа. |\n| `SamePointError` | Пункт выдачи совпадает с точкой отгрузки. |\n| `DeliveryPointNotFound` | Не удалось найти информацию по пункту выдачи. |\n| `DeliveryAvailabilityError` | Не удалось рассчитать доставку до пункта выдачи. |\n| `OtherError` | Не удалось рассчитать доставку. |\n\n### [/v1/order/checkout](#operation/OrderCheckout) и [/v1/order/create](#operation/OrderCreate)\n\n| Код ошибки | Описание |\n|----------------------------------|-----------------------------------------------------------------|\n| `RecipientError` | Невозможно доставить заказ получателю. |\n| `DeliveryAvailabilityError` | Не удалось рассчитать доставку до выбранной точки доставки. |\n| `DeliveryCalculationError` | Ошибка предрасчёта стоимости доставки или страховки. |\n| `DeliveryPointNotFound` | Не удалось найти информацию о точке доставки. |\n| `SameDeliveryPointError` | Точка доставки совпадает с точкой отгрузки. |\n| `DeliveryPointRestrictionsError` | Точка доставки не подходит под выбранные параметры заказа. |\n| `PrincipalError` | Не удалось создать заказ. Личный кабинет продавца заблокирован. |\n| `OtherError` | Не удалось рассчитать доставку. |\n\n### [/v1/posting/approve](#operation/PostingApprove)\n\n| Код ошибки | Описание |\n|--------------------|------------------------------------------------------------------|\n| `NotEnoughBalance` | Не удалось подтвердить отправление из-за недостаточного баланса. |\n| `PostingNotFound` | Отправление с указанным номером не найдено. |\n| `OtherError` | Не удалось подтвердить отправление. |\n" } ], "paths": { "/v1/delivery/check-client": { "post": { "summary": "Проверить доступность доставки для покупателя", "operationId": "DeliveryCheckClient", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.CheckClient.Request" }, "example": { "phone_number": "+79000000000" } } } }, "responses": { "200": { "description": "Доступность доставки для покупателя", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.CheckClient.Response" }, "example": { "can_be_delivered": true } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } }, "tags": [ "CreateOrder" ] } }, "/v1/delivery/location": { "post": { "summary": "Рассчитать предварительный срок доставки до локации покупателя", "operationId": "DeliveryLocation", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Location.Request" }, "example": { "coordinates": { "latitude": 55.7558, "longitude": 37.6176 }, "shipment_methods": [ { "shipment_method_id": 1, "cutoff_at": "2026-07-16T09:00:00Z" } ] } } } }, "responses": { "200": { "description": "Срок доставки до покупателя", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Location.Response" }, "example": { "results": [ { "shipment_method_id": 1, "estimated_delivery_days": 1 } ] } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } }, "tags": [ "CreateOrder" ] } }, "/v1/order/checkout": { "post": { "summary": "Проверить доступность доставки и расчёт условий по заказу", "operationId": "OrderCheckout", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Checkout.Request" }, "example": { "recipient": { "phone_number": "+79991234567" }, "postings": [ { "request_id": 101, "shipment_method_id": 1, "cutoff_at": "2026-07-16T12:00:00Z", "declared_value": { "amount": "1250.50", "currency_code": "RUB" }, "dimensions": { "weight_g": 1000, "length_mm": 200, "width_mm": 150, "height_mm": 100 } } ], "delivery": { "delivery_point": { "delivery_point_id": 1 } } } } } }, "responses": { "200": { "description": "Доступность доставки и расчёт условий по заказу", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Checkout.Response" }, "example": { "results": [ { "request_id": 101, "posting": { "estimated_delivery_cost": { "amount": "1250.50", "currency_code": "RUB" }, "estimated_insurance_cost": { "amount": "1250.50", "currency_code": "RUB" }, "estimated_delivery_days": 2, "cutoff_at": "2026-07-16T12:00:00Z" } } ] } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } }, "tags": [ "CreateOrder" ] } }, "/v1/order/create": { "post": { "summary": "Создать заказ", "operationId": "OrderCreate", "parameters": [ { "name": "Idempotency-Key", "in": "header", "description": "Ключ идемпотентности — UUID. Повторный запрос с тем же ключом возвращает исходный ответ.", "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Create.Request" }, "example": { "order_external_id": "shop-order-42", "recipient": { "phone_number": "+79991234567", "full_name": "Иванов Иван Иванович" }, "delivery": { "delivery_point": { "delivery_point_id": 1 } }, "postings": [ { "request_id": 101, "posting_external_id": "shop-posting-42-1", "shipment_method_id": 1, "description": "Смартфон и чехол", "declared_value": { "amount": "1250.50", "currency_code": "RUB" }, "cutoff_at": "2026-07-16T12:00:00Z", "dimensions": { "weight_g": 1000, "length_mm": 200, "width_mm": 150, "height_mm": 100 } } ] } } } }, "responses": { "200": { "description": "Заказ и отправления созданы", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Create.Response" }, "example": { "order_number": "YY-123BE456PY78-90YY", "order_external_id": "shop-order-42", "postings": [ { "request_id": 101, "posting_number": "123BE456PY78-90YY", "posting_external_id": "shop-posting-42-1", "estimated_delivery_days": 2, "cutoff_at": "2026-07-16T12:00:00Z" } ] } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" }, "example": { "error": { "message": "Не удалось создать заказ." }, "details": [ { "item_id": "1", "error": { "code": "recipient_error", "message": "Невозможно доставить заказ получателю." } } ] } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } }, "tags": [ "CreateOrder" ] } }, "/v1/delivery-point/list": { "post": { "tags": [ "DeliveryPoint" ], "summary": "Получить список всех пунктов выдачи", "operationId": "DeliveryPointList", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.DeliveryPoint.List.Request" }, "example": { "pagination": { "cursor": "string", "limit": 100 } } } } }, "responses": { "200": { "description": "Список пунктов выдачи", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.DeliveryPoint.List.Response" }, "example": { "delivery_points": [ { "delivery_point_id": 1, "shipment_method_ids": 1 } ], "next_cursor": "string" } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } } } }, "/v1/delivery-point/check-availability": { "post": { "tags": [ "DeliveryPoint" ], "summary": "Проверить доступность доставки отправлений в конкретные пункты выдачи", "operationId": "DeliveryPointCheckAvailability", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.DeliveryPoint.CheckAvailability.Request" }, "example": { "delivery_point_ids": 1, "shipment_method_id": 1, "postings": [ { "request_id": 101, "cutoff_at": "2026-07-16T09:00:00Z", "declared_value": { "amount": "1250.50", "currency_code": "RUB" }, "dimensions": { "weight_g": 1000, "length_mm": 200, "width_mm": 150, "height_mm": 100 } } ] } } } }, "responses": { "200": { "description": "Информация о доступности доставки", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.DeliveryPoint.CheckAvailability.Response" }, "example": { "results": [ { "request_id": 101, "cutoff_at": "2026-07-16T12:00:00Z", "delivery_point_id": 1, "error": { "code": "DeliveryPointNotFound", "message": "Не удалось найти информацию о пункте выдачи." } } ] } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } } } }, "/v1/delivery-point/info": { "post": { "tags": [ "DeliveryPoint" ], "summary": "Получить информацию о пунктах выдачи", "operationId": "DeliveryPointInfo", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.DeliveryPoint.Info.Request" }, "example": { "delivery_point_ids": "1" } } } }, "responses": { "200": { "description": "Информация о пунктах выдачи", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.DeliveryPoint.Info.Response" }, "example": { "delivery_points": [ { "delivery_point_id": 1, "name": "ПВЗ Москва Ленина 1", "delivery_point_number": "MSK-001", "type": "pvz", "full_address": "г. Москва, ул. Ленина, д. 1", "coordinates": { "latitude": 55.7558, "longitude": 37.6176 }, "schedule": [ { "date": "2026-07-14", "periods": [ { "from_local": "09:00:00", "to_local": "21:00:00" } ] } ], "is_active": true, "storage_period_days": 7, "fitting_rooms_count": 2, "is_bulky": false, "restrictions": { "min_weight_g": 10, "max_weight_g": 25000, "max_width_mm": 600, "max_length_mm": 1200, "max_height_mm": 800, "min_price": { "amount": "1250.50", "currency_code": "RUB" }, "max_price": { "amount": "1250.50", "currency_code": "RUB" } } } ] } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } } } }, "/v1/posting/approve": { "post": { "tags": [ "PostingShipping" ], "summary": "Подтвердить отправление к отгрузке", "operationId": "PostingApprove", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Approve.Request" }, "example": { "posting_number": "123BE456PY78-90YY" } } } }, "responses": { "200": { "description": "Отправление подтверждается", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } } } }, "/v1/posting/label": { "post": { "tags": [ "PostingShipping" ], "summary": "Получить этикетку отправления", "operationId": "PostingLabel", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Label.Request" }, "example": { "posting_number": "123BE456PY78-90YY" } } } }, "responses": { "200": { "description": "Этикетка отправления", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } } } }, "/v1/posting/search": { "post": { "summary": "Найти отправления", "operationId": "PostingSearch", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Search.Request" }, "example": { "filters": { "statuses": [ "created" ], "shipment_method_id": 1, "created_at_from": "2026-07-01T00:00:00Z", "created_at_to": "2026-07-14T00:00:00Z" }, "pagination": { "cursor": "example", "limit": 100 } } } } }, "responses": { "200": { "description": "Список отправлений", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Search.Response" }, "example": { "postings": [ { "posting_number": "123BE456PY78-90YY", "posting_external_id": "ext-posting-42", "order_number": "YY-123BE456PY78-90YY", "created_at": "2026-07-14T09:30:00Z", "status": "created", "status_changed_at": "2026-07-14T09:30:00Z", "description": "Смартфон и чехол", "delivery": { "shipment_method_id": 1, "type": "courier", "delivery_point_id": 1, "full_address": "г. Москва, ул. Ленина, д. 1" }, "estimated_delivery_days": 3, "original_delivery_at": "2026-07-14T09:30:00Z", "delivery_at": "2026-07-22T09:30:00Z", "dimensions": { "weight_g": 1000, "length_mm": 200, "width_mm": 150, "height_mm": 100 }, "estimated_delivery_cost": { "amount": "1250.50", "currency_code": "RUB" }, "estimated_insurance_cost": { "amount": "1250.50", "currency_code": "RUB" }, "declared_value": { "amount": "1250.50", "currency_code": "RUB" }, "recipient": { "full_name": "Иванов И. И." } } ], "next_cursor": "example" } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } }, "tags": [ "PostingProcess" ] } }, "/v1/posting/info": { "post": { "summary": "Получить информацию об отправлении", "operationId": "PostingInfo", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Info.Request" }, "example": { "posting_numbers": [ "123BE456PY78-90YY" ] } } } }, "responses": { "200": { "description": "Информация об отправлении", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Info.Response" }, "example": { "postings": [ { "posting_number": "123BE456PY78-90YY", "posting_external_id": "ext-posting-42", "order_number": "YY-123BE456PY78-90YY", "created_at": "2026-07-14T09:30:00Z", "status": "created", "status_changed_at": "2026-07-14T09:30:00Z", "description": "Смартфон и чехол", "delivery": { "shipment_method_id": 1, "type": "courier", "delivery_point_id": 1, "full_address": "г. Москва, ул. Ленина, д. 1" }, "estimated_delivery_days": 3, "original_delivery_at": "2026-07-14T09:30:00Z", "delivery_at": "2026-07-22T09:30:00Z", "dimensions": { "weight_g": 1000, "length_mm": 200, "width_mm": 150, "height_mm": 100 }, "estimated_delivery_cost": { "amount": "1250.50", "currency_code": "RUB" }, "estimated_insurance_cost": { "amount": "1250.50", "currency_code": "RUB" }, "declared_value": { "amount": "1250.50", "currency_code": "RUB" }, "recipient": { "full_name": "Иванов И. И." } } ] } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } }, "tags": [ "PostingProcess" ] } }, "/v1/posting/status-history": { "post": { "summary": "Получить историю статусов отправления", "operationId": "PostingStatusHistory", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.StatusHistory.Request" }, "example": { "posting_number": "123BE456PY78-90YY" } } } }, "responses": { "200": { "description": "История статусов отправления", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.StatusHistory.Response" }, "example": { "history": [ { "status": "created", "status_changed_at": "2026-07-14T09:30:00Z" } ] } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } }, "tags": [ "PostingProcess" ] } }, "/v1/posting/cancel": { "post": { "summary": "Запустить процесс отмены отправления", "operationId": "PostingCancel", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Cancel.Request" }, "example": { "posting_number": "123BE456PY78-90YY" } } } }, "responses": { "200": { "description": "Отправление отменяется", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } }, "tags": [ "PostingProcess" ] } }, "/v1/return/search": { "post": { "tags": [ "ReturnProcess" ], "summary": "Найти возвраты", "operationId": "ReturnSearch", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Return.Search.Request" }, "example": { "pagination": { "cursor": "string", "limit": 100 } } } } }, "responses": { "200": { "description": "Список возвратов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Return.Search.Response" }, "example": { "returns": [ { "return_number": "123BE456PY78-90YY", "return_external_id": "ext-posting-42", "created_at": "2026-07-15T09:30:00Z", "barcode": "123456789101112", "return_type": "cancellation", "description": "Смартфон и чехол", "dimensions": { "weight_g": 1000, "length_mm": 200, "width_mm": 150, "height_mm": 100 }, "declared_value": { "amount": "1250.50", "currency_code": "RUB" }, "status": "moving", "status_changed_at": "2026-07-14T09:30:00Z", "shipment_method_id": 1, "return_delivery_type": "return_point", "current_placement_name": "МОСКВА_2034", "current_placement_address": "г. Москва, ул. Ленина, д. 1", "cancellation_responsible": "client", "cancellation_reason": "Покупатель отказался при вручении: товар не подошел." } ], "next_cursor": "string" } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } } } }, "/v1/return/info": { "post": { "tags": [ "ReturnProcess" ], "summary": "Получить информацию о возвратах", "operationId": "ReturnInfo", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Return.Info.Request" }, "example": { "return_numbers": [ "string" ] } } } }, "responses": { "200": { "description": "Информация о возвратах", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Return.Info.Response" }, "example": { "returns": [ { "return_number": "123BE456PY78-90YY", "return_external_id": "ext-posting-42", "barcode": "123456789101112", "return_type": "cancellation", "description": "Смартфон и чехол", "dimensions": { "weight_g": 1000, "length_mm": 200, "width_mm": 150, "height_mm": 100 }, "declared_value": { "amount": "1250.50", "currency_code": "RUB" }, "status": "moving", "shipment_method_id": 1, "return_delivery_type": "return_point", "current_placement_name": "МОСКВА_2034", "current_placement_address": "г. Москва, ул. Ленина, д. 1", "cancellation_reason": "Покупатель отказался при вручении: товар не подошел." } ] } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } } } }, "/v1/return/status-history": { "post": { "tags": [ "ReturnProcess" ], "summary": "Получить историю статусов возврата", "operationId": "ReturnStatusHistory", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Return.StatusHistory.Request" }, "example": { "return_number": "123BE456PY78-90YY" } } } }, "responses": { "200": { "description": "История изменений", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Return.StatusHistory.Response" }, "example": { "status_history": [ { "return_status": "moving", "changed_at": "2026-07-30T00:00:00Z" } ] } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } } } }, "/v1/return/download_barcode": { "post": { "tags": [ "ReturnProcess" ], "summary": "Скачать штрихкод получения возвратов в формате PDF", "operationId": "ReturnDownloadBarcode", "responses": { "200": { "description": "Штрихкод скачан", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } } } }, "/v1/return/reset_barcode": { "post": { "tags": [ "ReturnProcess" ], "summary": "Сбросить штрихкод получения возвратов", "operationId": "ReturnResetBarcode", "responses": { "200": { "description": "Штрихкод сброшен", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Return.ResetBarcode.Response" }, "example": { "barcode_content": { "barcode": "123456789101112", "expires_at": "2026-07-14T09:30:00Z" } } } } }, "400": { "description": "Неверный параметр", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "401": { "description": "Ошибка аутентификации", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "403": { "description": "Доступ запрещён", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "404": { "description": "Ответ не найден", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "429": { "description": "Слишком много запросов", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } }, "500": { "description": "Внутренняя ошибка сервера", "headers": { "x-o3-trace-id": { "schema": { "$ref": "#/components/schemas/TraceId" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorResponse" } } } } } } } }, "components": { "schemas": { "Ozon.Delivery.CheckClient.Request": { "required": [ "phone_number" ], "type": "object", "properties": { "phone_number": { "pattern": " +7XXXXXXXXXX", "type": "string", "description": "Номер телефона покупателя." } }, "additionalProperties": false }, "TraceId": { "description": "Идентификатор трассировки запроса. Указывайте при обращении в поддержку.", "type": "string" }, "Ozon.Delivery.CheckClient.Response": { "required": [ "can_be_delivered" ], "type": "object", "properties": { "can_be_delivered": { "type": "boolean", "description": "`true`, если доставка доступна.\n" } }, "additionalProperties": false }, "Ozon.Delivery.Common.Error": { "required": [ "message" ], "type": "object", "properties": { "code": { "type": "string", "description": "Код ошибки.", "nullable": true }, "message": { "type": "string", "description": "Описание ошибки." } }, "additionalProperties": false, "description": "Информация об ошибке." }, "Ozon.Delivery.Common.ErrorDetail": { "required": [ "error", "item_id" ], "type": "object", "properties": { "item_id": { "type": "string", "description": "Ключ элемента из запроса." }, "error": { "$ref": "#/components/schemas/Ozon.Delivery.Common.Error" } }, "additionalProperties": false, "description": "Детализация ошибки запроса: ключ элемента из запроса и его ошибка." }, "Ozon.Delivery.Common.ErrorResponse": { "required": [ "error" ], "type": "object", "properties": { "error": { "$ref": "#/components/schemas/Ozon.Delivery.Common.Error" }, "details": { "type": "array", "items": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ErrorDetail" }, "description": "Дополнительная информация об ошибке.", "nullable": true } }, "additionalProperties": false, "description": "Тело любого HTTP-ответа 4xx/5xx." }, "Ozon.Delivery.Common.Coordinates": { "required": [ "latitude", "longitude" ], "type": "object", "properties": { "latitude": { "type": "number", "description": "Широта.", "format": "double", "example": 55.7558 }, "longitude": { "type": "number", "description": "Долгота.", "format": "double", "example": 37.6176 } }, "additionalProperties": false, "description": "Координаты." }, "Ozon.Delivery.Location.ShipmentMethod": { "required": [ "shipment_method_id" ], "type": "object", "properties": { "shipment_method_id": { "type": "integer", "description": "Идентификатор метода доставки.", "format": "int64" }, "cutoff_at": { "type": "string", "description": "Плановая дата и время отгрузки в UTC.", "format": "date-time", "nullable": true } }, "additionalProperties": false, "description": "Метод доставки в запросе предварительного расчёта." }, "Ozon.Delivery.Location.Request": { "required": [ "coordinates", "shipment_methods" ], "type": "object", "properties": { "coordinates": { "description": "Координаты.", "$ref": "#/components/schemas/Ozon.Delivery.Common.Coordinates" }, "shipment_methods": { "description": "Методы доставки.", "type": "array", "minItems": 1, "maxItems": 100, "items": { "$ref": "#/components/schemas/Ozon.Delivery.Location.ShipmentMethod" } } }, "additionalProperties": false }, "Ozon.Delivery.Location.ShipmentMethodEstimate": { "required": [ "cutoff_at", "shipment_method_id" ], "type": "object", "description": "Срок доставки.", "properties": { "shipment_method_id": { "type": "integer", "description": "Идентификатор метода доставки.", "format": "int64" }, "cutoff_at": { "type": "string", "description": "Плановая дата и время отгрузки в UTC.", "format": "date-time" }, "estimated_delivery_days": { "type": "integer", "description": "Предварительный срок доставки в днях.", "format": "int32", "nullable": true }, "error": { "$ref": "#/components/schemas/Ozon.Delivery.Common.Error" } }, "additionalProperties": false }, "Ozon.Delivery.Location.Response": { "required": [ "results" ], "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/Ozon.Delivery.Location.ShipmentMethodEstimate" }, "description": "Информация о сроке доставки." } }, "additionalProperties": false }, "Ozon.Delivery.Order.Checkout.Recipient": { "required": [ "phone_number" ], "type": "object", "properties": { "phone_number": { "pattern": " +7XXXXXXXXXX", "type": "string", "description": "Телефон получателя." } }, "additionalProperties": false, "description": "Информация о получателе." }, "Ozon.Delivery.Order.DeclaredValue": { "required": [ "amount", "currency_code" ], "type": "object", "properties": { "amount": { "type": "string", "description": "Сумма." }, "currency_code": { "type": "string", "description": "Валюта." } }, "additionalProperties": false, "description": "Объявленная стоимость отправления." }, "Ozon.Delivery.Order.Dimensions": { "required": [ "height_mm", "length_mm", "weight_g", "width_mm" ], "type": "object", "properties": { "weight_g": { "type": "integer", "description": "Вес отправления в граммах.", "format": "int32" }, "length_mm": { "type": "integer", "description": "Длина отправления в миллиметрах.", "format": "int32" }, "width_mm": { "type": "integer", "description": "Ширина отправления в миллиметрах.", "format": "int32" }, "height_mm": { "type": "integer", "description": "Высота отправления в миллиметрах.", "format": "int32" } }, "additionalProperties": false, "description": "Объёмно-весовые характеристики отправления." }, "Ozon.Delivery.Order.Checkout.Posting": { "required": [ "declared_value", "dimensions", "request_id", "shipment_method_id" ], "type": "object", "properties": { "request_id": { "type": "integer", "description": "Идентификатор запроса.", "format": "int64" }, "shipment_method_id": { "type": "integer", "description": "Идентификатор метода доставки.", "format": "int64" }, "cutoff_at": { "type": "string", "description": "Плановая дата и время отгрузки в UTC.", "format": "date-time", "nullable": true }, "declared_value": { "$ref": "#/components/schemas/Ozon.Delivery.Order.DeclaredValue" }, "dimensions": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Dimensions" } }, "additionalProperties": false }, "Ozon.Delivery.Order.Checkout.DeliveryPointDelivery": { "required": [ "delivery_point_id" ], "type": "object", "properties": { "delivery_point_id": { "type": "integer", "description": "Идентификатор пункта выдачи заказов или постамата.", "format": "int64" } }, "additionalProperties": false, "description": "Доставка в пункт выдачи заказов или постамат." }, "Ozon.Delivery.Order.CourierCoordinates": { "required": [ "latitude", "longitude" ], "type": "object", "properties": { "latitude": { "type": "number", "description": "Широта.", "format": "double" }, "longitude": { "type": "number", "description": "Долгота.", "format": "double" } }, "additionalProperties": false, "description": "Координаты точки доставки." }, "Ozon.Delivery.Order.Checkout.CourierDelivery": { "required": [ "coordinates" ], "type": "object", "properties": { "coordinates": { "$ref": "#/components/schemas/Ozon.Delivery.Order.CourierCoordinates" } }, "additionalProperties": false, "description": "Доставка курьером." }, "Ozon.Delivery.Order.Checkout.Delivery": { "type": "object", "properties": { "delivery_point": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Checkout.DeliveryPointDelivery" }, "courier": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Checkout.CourierDelivery" } }, "additionalProperties": false, "description": "Информация о доставке." }, "Ozon.Delivery.Order.Checkout.Request": { "required": [ "delivery", "postings", "recipient" ], "type": "object", "properties": { "recipient": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Checkout.Recipient" }, "postings": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Checkout.Posting" }, "description": "Состав отправлений для предварительного расчёта." }, "delivery": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Checkout.Delivery" } }, "additionalProperties": false }, "Ozon.Delivery.Order.EstimatedDeliveryCost": { "required": [ "amount", "currency_code" ], "description": "Предварительная стоимость доставки.", "type": "object", "properties": { "amount": { "type": "string", "description": "Сумма." }, "currency_code": { "type": "string", "description": "Валюта." } }, "additionalProperties": false }, "Ozon.Delivery.Order.EstimatedInsuranceCost": { "required": [ "amount", "currency_code" ], "description": "Предварительная стоимость страховки.", "type": "object", "properties": { "amount": { "type": "string", "description": "Сумма." }, "currency_code": { "type": "string", "description": "Валюта." } }, "additionalProperties": false }, "Ozon.Delivery.Order.Checkout.PostingResult": { "required": [ "cutoff_at", "estimated_delivery_cost", "estimated_delivery_days", "estimated_insurance_cost" ], "description": "Информация об отправлении.", "type": "object", "properties": { "estimated_delivery_cost": { "$ref": "#/components/schemas/Ozon.Delivery.Order.EstimatedDeliveryCost" }, "estimated_insurance_cost": { "$ref": "#/components/schemas/Ozon.Delivery.Order.EstimatedInsuranceCost" }, "estimated_delivery_days": { "type": "integer", "description": "Предварительный срок доставки в днях.", "format": "int32" }, "cutoff_at": { "type": "string", "description": "Плановая дата и время отгрузки в UTC.", "format": "date-time" } }, "additionalProperties": false }, "Ozon.Delivery.Order.Checkout.Result": { "required": [ "request_id" ], "type": "object", "properties": { "request_id": { "type": "integer", "description": "Идентификатор запроса.", "format": "int64" }, "posting": { "description": "Результат предварительных расчётов по отправлениям.", "$ref": "#/components/schemas/Ozon.Delivery.Order.Checkout.PostingResult" }, "error": { "$ref": "#/components/schemas/Ozon.Delivery.Common.Error" } }, "additionalProperties": false }, "Ozon.Delivery.Order.Checkout.Response": { "required": [ "results" ], "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Checkout.Result" }, "description": "Результат проверки доступности и условий доставки." } }, "additionalProperties": false }, "Ozon.Delivery.Order.Create.Recipient": { "required": [ "phone_number" ], "type": "object", "properties": { "phone_number": { "type": "string", "description": "Телефон получателя." }, "full_name": { "type": "string", "description": "ФИО получателя." } }, "additionalProperties": false, "description": "Информация о получателе." }, "Ozon.Delivery.Order.Create.DeliveryPointDelivery": { "required": [ "delivery_point_id" ], "type": "object", "properties": { "delivery_point_id": { "type": "integer", "description": "Идентификатор пункта выдачи заказов или постамата.", "format": "int64" } }, "additionalProperties": false, "description": "Доставка в пункт выдачи заказов или постамат." }, "Ozon.Delivery.Order.Create.CourierDelivery": { "required": [ "city", "coordinates", "country", "region", "street", "zip_code" ], "type": "object", "properties": { "coordinates": { "$ref": "#/components/schemas/Ozon.Delivery.Order.CourierCoordinates" }, "zip_code": { "type": "string", "description": "Почтовый индекс." }, "country": { "type": "string", "description": "Страна." }, "region": { "type": "string", "description": "Регион." }, "city": { "type": "string", "description": "Город." }, "street": { "type": "string", "description": "Улица." }, "house_number": { "type": "string", "description": "Номер дома.", "nullable": true }, "entrance": { "type": "string", "description": "Подъезд.", "nullable": true }, "floor": { "type": "string", "description": "Этаж.", "nullable": true }, "apartment": { "type": "string", "description": "Квартира.", "nullable": true }, "intercom": { "type": "string", "description": "Домофон.", "nullable": true } }, "additionalProperties": false, "description": "Доставка курьером." }, "Ozon.Delivery.Order.Create.Delivery": { "type": "object", "properties": { "delivery_point": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Create.DeliveryPointDelivery" }, "courier": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Create.CourierDelivery" } }, "additionalProperties": false, "description": "Информация о доставке." }, "Ozon.Delivery.Order.Create.Posting": { "required": [ "declared_value", "description", "dimensions", "request_id", "shipment_method_id" ], "type": "object", "properties": { "request_id": { "type": "integer", "description": "Идентификатор запроса.", "format": "int64" }, "posting_external_id": { "type": "string", "description": "Идентификатор отправления в системе продавца.", "nullable": true }, "shipment_method_id": { "type": "integer", "description": "Идентификатор метода доставки.", "format": "int64" }, "description": { "minLength": 1, "maxLength": 500, "type": "string", "description": "Описание содержимого отправления." }, "declared_value": { "$ref": "#/components/schemas/Ozon.Delivery.Order.DeclaredValue" }, "cutoff_at": { "type": "string", "description": "Плановая дата и время отгрузки в UTC.", "format": "date-time", "nullable": true }, "dimensions": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Dimensions" } }, "additionalProperties": false, "description": "Отправление в запросе создания заказа: метод доставки, ОВХ, описание и объявленная ценность." }, "Ozon.Delivery.Order.Create.Request": { "required": [ "delivery", "postings", "recipient" ], "type": "object", "properties": { "order_external_id": { "type": "string", "description": "Идентификатор заказа в системе продавца.", "nullable": true }, "recipient": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Create.Recipient" }, "delivery": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Create.Delivery" }, "postings": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Create.Posting" }, "description": "Информация об отправлениях в заказе." } }, "additionalProperties": false }, "Ozon.Delivery.Order.Create.PostingResult": { "required": [ "cutoff_at", "estimated_delivery_cost", "estimated_delivery_days", "estimated_insurance_cost", "posting_number", "request_id" ], "type": "object", "properties": { "request_id": { "type": "integer", "description": "Идентификатор запроса.", "format": "int64" }, "posting_number": { "type": "string", "description": "Номер отправления." }, "posting_external_id": { "type": "string", "description": "Идентификатор отправления в системе продавца.", "nullable": true }, "estimated_delivery_cost": { "$ref": "#/components/schemas/Ozon.Delivery.Order.EstimatedDeliveryCost" }, "estimated_insurance_cost": { "$ref": "#/components/schemas/Ozon.Delivery.Order.EstimatedInsuranceCost" }, "estimated_delivery_days": { "type": "integer", "description": "Предварительный срок доставки в днях.", "format": "int32" }, "cutoff_at": { "type": "string", "description": "Плановая дата и время отгрузки в UTC.", "format": "date-time" } }, "additionalProperties": false }, "Ozon.Delivery.Order.Create.Response": { "required": [ "order_number", "postings" ], "type": "object", "properties": { "order_number": { "type": "string", "description": "Номер заказа." }, "order_external_id": { "type": "string", "description": "Идентификатор заказа в системе продавца.", "nullable": true }, "postings": { "type": "array", "items": { "$ref": "#/components/schemas/Ozon.Delivery.Order.Create.PostingResult" }, "description": "Созданные отправления." } }, "additionalProperties": false }, "Ozon.Delivery.Common.Pagination.List": { "required": [ "limit" ], "type": "object", "properties": { "cursor": { "type": "string", "description": "Указатель для выборки следующих данных.", "nullable": true }, "limit": { "type": "integer", "maximum": 100, "description": "Максимальное количество элементов в ответе.", "format": "int32" } }, "additionalProperties": false, "description": "Разделение ответа метода." }, "Ozon.DeliveryPoint.List.Request": { "required": [ "pagination" ], "type": "object", "properties": { "pagination": { "$ref": "#/components/schemas/Ozon.Delivery.Common.Pagination.List" } }, "additionalProperties": false }, "Ozon.DeliveryPoint.List.Item": { "required": [ "delivery_point_id", "shipment_method_ids" ], "type": "object", "properties": { "delivery_point_id": { "type": "integer", "description": "Идентификатор пункта выдачи.", "format": "int64" }, "shipment_method_ids": { "type": "array", "items": { "type": "integer", "format": "int64" }, "description": "Идентификаторы методов доставки, которыми можно передать отправление в пункт выдачи." } }, "additionalProperties": false }, "Ozon.DeliveryPoint.List.Response": { "required": [ "delivery_points" ], "type": "object", "properties": { "delivery_points": { "type": "array", "items": { "$ref": "#/components/schemas/Ozon.DeliveryPoint.List.Item" }, "description": "Список пунктов выдачи с методами доставки в эти пункты." }, "next_cursor": { "type": "string", "description": "Указатель для выборки следующей страницы.", "nullable": true } }, "additionalProperties": false }, "Ozon.Delivery.Common.Money.DeclaredValue": { "required": [ "amount", "currency_code" ], "type": "object", "properties": { "amount": { "type": "string", "description": "Сумма." }, "currency_code": { "type": "string", "description": "Валюта." } }, "additionalProperties": false, "description": "Объявленная стоимость отправления." }, "Ozon.Delivery.Common.Dimensions": { "required": [ "height_mm", "length_mm", "weight_g", "width_mm" ], "type": "object", "properties": { "weight_g": { "type": "integer", "description": "Вес в граммах.", "format": "int32" }, "length_mm": { "type": "integer", "description": "Длина в миллиметрах.", "format": "int32" }, "width_mm": { "type": "integer", "description": "Ширина в миллиметрах.", "format": "int32" }, "height_mm": { "type": "integer", "description": "Высота в миллиметрах.", "format": "int32" } }, "additionalProperties": false, "description": "Объёмно-весовые характеристики отправления." }, "Ozon.DeliveryPoint.CheckAvailability.Posting": { "required": [ "declared_value", "dimensions", "request_id" ], "type": "object", "properties": { "request_id": { "type": "integer", "description": "Идентификатор запроса.", "format": "int64" }, "cutoff_at": { "type": "string", "description": "Плановая дата и время отгрузки в UTC.", "format": "date-time", "nullable": true }, "declared_value": { "$ref": "#/components/schemas/Ozon.Delivery.Common.Money.DeclaredValue" }, "dimensions": { "$ref": "#/components/schemas/Ozon.Delivery.Common.Dimensions" } }, "additionalProperties": false }, "Ozon.DeliveryPoint.CheckAvailability.Request": { "required": [ "delivery_point_ids", "postings", "shipment_method_id" ], "type": "object", "properties": { "delivery_point_ids": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "type": "integer", "format": "int64" }, "description": "Идентификаторы пунктов выдачи для проверки.", "example": 1 }, "shipment_method_id": { "type": "integer", "description": "Идентификатор метода доставки.", "format": "int64", "example": 1 }, "postings": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "$ref": "#/components/schemas/Ozon.DeliveryPoint.CheckAvailability.Posting" }, "description": "Отправления для проверки доступности доставки." } }, "additionalProperties": false }, "Ozon.DeliveryPoint.CheckAvailability.Result": { "required": [ "delivery_point_id", "request_id" ], "type": "object", "properties": { "request_id": { "type": "integer", "description": "Идентификатор запроса.", "format": "int64" }, "delivery_point_id": { "type": "integer", "description": "Идентификатор доступного пункта выдачи.", "format": "int64" }, "cutoff_at": { "type": "string", "description": "Плановая дата и время отгрузки в UTC.", "format": "date-time", "nullable": true }, "error": { "$ref": "#/components/schemas/Ozon.Delivery.Common.Error" } }, "additionalProperties": false }, "Ozon.DeliveryPoint.CheckAvailability.Response": { "required": [ "results" ], "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/Ozon.DeliveryPoint.CheckAvailability.Result" }, "description": "Результат проверки доступности доставки.\n" } }, "additionalProperties": false }, "Ozon.DeliveryPoint.Info.Request": { "required": [ "delivery_point_ids" ], "type": "object", "properties": { "delivery_point_ids": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "type": "integer", "format": "int64" }, "description": "Идентификаторы пунктов выдачи." } }, "additionalProperties": false }, "Ozon.DeliveryPoint.Types.DeliveryPointType": { "enum": [ "unknown", "pvz", "postamat" ], "type": "string", "description": "Тип пункта выдачи:\n- `unknown` — не определён;\n- `pvz` — пункт выдачи заказов — ПВЗ;\n- `postamat` — постамат.\n" }, "Ozon.Delivery.Common.Pvz": { "required": [ "latitude", "longitude" ], "type": "object", "properties": { "latitude": { "type": "number", "description": "Широта.", "format": "double" }, "longitude": { "type": "number", "description": "Долгота.", "format": "double" } }, "additionalProperties": false, "description": "Координаты пункта выдачи." }, "Ozon.Delivery.Common.WorkPeriod": { "required": [ "from_local", "to_local" ], "type": "object", "properties": { "from_local": { "type": "string", "description": "Время начала работы.", "format": "time" }, "to_local": { "type": "string", "description": "Время окончания работы.", "format": "time" } }, "additionalProperties": false, "description": "Время работы пункта." }, "Ozon.Delivery.Common.ScheduleDay": { "required": [ "date", "periods" ], "type": "object", "properties": { "date": { "type": "string", "description": "Дата работы пункта.", "format": "date" }, "periods": { "type": "array", "items": { "$ref": "#/components/schemas/Ozon.Delivery.Common.WorkPeriod" }, "description": "График работы пункта в его часовом поясе. Если список пустой — выходной." } }, "additionalProperties": false }, "Ozon.Delivery.Common.Money.Min": { "required": [ "amount", "currency_code" ], "type": "object", "properties": { "amount": { "type": "string", "description": "Сумма." }, "currency_code": { "type": "string", "description": "Валюта." } }, "additionalProperties": false, "description": "Минимальная стоимость отправления." }, "Ozon.Delivery.Common.Money.Max": { "required": [ "amount", "currency_code" ], "type": "object", "properties": { "amount": { "type": "string", "description": "Сумма." }, "currency_code": { "type": "string", "description": "Валюта." } }, "additionalProperties": false, "description": "Максимальная стоимость отправления." }, "Ozon.DeliveryPoint.Types.DeliveryPointRestrictions": { "required": [ "max_height_mm", "max_length_mm", "max_price", "max_weight_g", "max_width_mm", "min_price", "min_weight_g" ], "type": "object", "properties": { "min_weight_g": { "type": "integer", "description": "Минимальный вес отправления в граммах.", "format": "int32" }, "max_weight_g": { "type": "integer", "description": "Максимальный вес отправления в граммах.", "format": "int32" }, "max_width_mm": { "type": "integer", "description": "Максимальная ширина отправления в миллиметрах.", "format": "int32" }, "max_length_mm": { "type": "integer", "description": "Максимальная длина отправления в миллиметрах.", "format": "int32" }, "max_height_mm": { "type": "integer", "description": "Максимальная высота отправления в миллиметрах.", "format": "int32" }, "min_price": { "$ref": "#/components/schemas/Ozon.Delivery.Common.Money.Min" }, "max_price": { "$ref": "#/components/schemas/Ozon.Delivery.Common.Money.Max" } }, "additionalProperties": false, "description": "Ограничения на отправления, которые принимает пункт выдачи.\n" }, "Ozon.DeliveryPoint.Types.DeliveryPoint": { "required": [ "delivery_point_id", "full_address", "is_active", "is_bulky", "name", "schedule", "type" ], "type": "object", "properties": { "delivery_point_id": { "type": "integer", "description": "Идентификатор пункта выдачи.", "format": "int64" }, "name": { "type": "string", "description": "Название пункта выдачи." }, "delivery_point_number": { "type": "string", "description": "Номер пункта выдачи.", "nullable": true }, "type": { "$ref": "#/components/schemas/Ozon.DeliveryPoint.Types.DeliveryPointType" }, "full_address": { "type": "string", "description": "Адрес пункта выдачи." }, "coordinates": { "$ref": "#/components/schemas/Ozon.Delivery.Common.Pvz" }, "schedule": { "type": "array", "items": { "$ref": "#/components/schemas/Ozon.Delivery.Common.ScheduleDay" }, "description": "Расписание работы пункта." }, "is_active": { "type": "boolean", "description": "`true`, если пункт выдачи работает.\n" }, "storage_period_days": { "type": "integer", "description": "Срок хранения отправлений в пункте выдачи в днях.", "format": "int32", "nullable": true }, "fitting_rooms_count": { "type": "integer", "description": "Количество примерочных.", "format": "int32", "nullable": true }, "is_bulky": { "type": "boolean", "description": "`true`, если пункт выдачи работает c крупногабаритным товаром.\n" }, "restrictions": { "$ref": "#/components/schemas/Ozon.DeliveryPoint.Types.DeliveryPointRestrictions" } }, "additionalProperties": false }, "Ozon.DeliveryPoint.Info.Response": { "required": [ "delivery_points" ], "type": "object", "properties": { "delivery_points": { "type": "array", "items": { "$ref": "#/components/schemas/Ozon.DeliveryPoint.Types.DeliveryPoint" }, "description": "Пункты выдачи." } }, "additionalProperties": false }, "Ozon.Delivery.Posting.Approve.Request": { "required": [ "posting_number" ], "type": "object", "properties": { "posting_number": { "type": "string", "description": "Номер отправления." } }, "additionalProperties": false }, "Ozon.Delivery.Posting.Label.Request": { "required": [ "posting_number" ], "type": "object", "properties": { "posting_number": { "type": "string", "description": "Номер отправления." } }, "additionalProperties": false }, "Ozon.Delivery.Posting.Types.PostingStatus": { "enum": [ "unknown", "created", "forming", "forming_failed", "ready_for_shipping", "in_container", "acceptance_in_progress", "on_way", "not_accepted_to_delivery", "in_delivery_point", "in_courier_service", "delivered", "canceled" ], "type": "string", "description": "Статус отправления:\n- `unknown` — не определён;\n- `created` — создано;\n- `forming` — в процессе подтверждения;\n- `forming_failed` — ошибка при подтверждении;\n- `ready_for_shipping` — готово к отгрузке;\n- `in_container` — добавлено в грузоместо;\n- `acceptance_in_progress` — идёт приёмка;\n- `on_way` — доставляется;\n- `not_accepted_to_delivery` — не принято на сортировочном центре;\n- `in_delivery_point` — в пункте выдачи;\n- `in_courier_service` — у курьера Ozon;\n- `delivered` — доставлено;\n- `canceled` — отменено.\n" }, "Ozon.Delivery.Posting.Search.Filters": { "type": "object", "properties": { "statuses": { "type": "array", "items": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Types.PostingStatus" }, "description": "Фильтр по статусам отправления:\n- `unknown` — не определён;\n- `created` — создано;\n- `forming` — в процессе подтверждения;\n- `forming_failed` — ошибка при подтверждении;\n- `ready_for_shipping` — готово к отгрузке;\n- `in_container` — добавлено в грузоместо;\n- `acceptance_in_progress` — идёт приёмка;\n- `on_way` — доставляется;\n- `not_accepted_to_delivery` — не принято на сортировочном центре;\n- `in_delivery_point` — в пункте выдачи;\n- `in_courier_service` — у курьера Ozon;\n- `delivered` — доставлено;\n- `canceled` — отменено.\n", "nullable": true }, "shipment_method_id": { "type": "integer", "description": "Фильтр по методам доставки.", "format": "int64", "nullable": true }, "created_at_from": { "type": "string", "description": "Фильтр по дате и времени начала периода создания отправления.", "format": "date-time", "nullable": true }, "created_at_to": { "type": "string", "description": "Фильтр по дате и времени окончания периода создания отправления.", "format": "date-time", "nullable": true } }, "additionalProperties": false, "description": "Фильтры поиска отправлений." }, "Ozon.Delivery.Posting.Search.Pagination": { "required": [ "limit" ], "type": "object", "properties": { "cursor": { "type": "string", "description": "Указатель для выборки следующих данных.", "nullable": true }, "limit": { "type": "integer", "description": "Количество элементов в ответе.", "format": "int32", "maximum": 100 } }, "additionalProperties": false, "description": "Разделение ответа метода." }, "Ozon.Delivery.Posting.Search.Request": { "required": [ "pagination" ], "type": "object", "properties": { "filters": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Search.Filters" }, "pagination": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Search.Pagination" } }, "additionalProperties": false }, "Ozon.Delivery.Common.DeliveryType": { "enum": [ "unknown", "courier", "pvz", "postamat" ], "type": "string", "description": "Тип доставки отправления:\n- `unknown` — не определён;\n- `courier` — курьером;\n- `pvz` — в пункт выдачи заказов — ПВЗ;\n- `postamat` — в постамат.\n" }, "Ozon.Delivery.Posting.Types.Posting.DeliveryInfo": { "required": [ "full_address", "shipment_method_id", "type" ], "type": "object", "properties": { "shipment_method_id": { "type": "integer", "description": "Идентификатор метода доставки.", "format": "int64" }, "type": { "$ref": "#/components/schemas/Ozon.Delivery.Common.DeliveryType" }, "delivery_point_id": { "type": "integer", "description": "Идентификатор пункта выдачи заказов или постамата.", "format": "int64", "nullable": true }, "full_address": { "type": "string", "description": "Адрес доставки." } }, "additionalProperties": false, "description": "Информация о доставке отправления до получателя." }, "Ozon.Delivery.Posting.Types.EstimatedDeliveryCost": { "required": [ "amount", "currency_code" ], "type": "object", "properties": { "amount": { "type": "string", "description": "Сумма." }, "currency_code": { "type": "string", "description": "Валюта." } }, "additionalProperties": false, "description": "Предварительная стоимость доставки." }, "Ozon.Delivery.Posting.Types.EstimatedInsuranceCost": { "required": [ "amount", "currency_code" ], "type": "object", "properties": { "amount": { "type": "string", "description": "Сумма." }, "currency_code": { "type": "string", "description": "Валюта." } }, "additionalProperties": false, "description": "Предварительная стоимость страховки." }, "Ozon.Delivery.Posting.Types.DeclaredValue": { "required": [ "amount", "currency_code" ], "type": "object", "properties": { "amount": { "type": "string", "description": "Сумма." }, "currency_code": { "type": "string", "description": "Валюта." } }, "additionalProperties": false, "description": "Объявленная стоимость отправления." }, "Ozon.Delivery.Posting.Types.Recipient": { "required": [ "full_name" ], "type": "object", "properties": { "full_name": { "type": "string", "description": "ФИО получателя." } }, "additionalProperties": false, "description": "Информация о получателе отправления." }, "Ozon.Delivery.Posting.Types.Posting": { "required": [ "created_at", "delivery", "description", "dimensions", "order_number", "posting_number", "recipient", "status", "status_changed_at" ], "type": "object", "properties": { "posting_number": { "type": "string", "description": "Номер отправления." }, "posting_external_id": { "type": "string", "description": "Идентификатор отправления в системе продавца.", "nullable": true }, "order_number": { "type": "string", "description": "Номер заказа." }, "created_at": { "type": "string", "description": "Дата и время создания отправления.", "format": "date-time" }, "status": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Types.PostingStatus" }, "status_changed_at": { "type": "string", "description": "Дата и время последнего изменения статуса отправления в UTC.", "format": "date-time" }, "description": { "type": "string", "description": "Описание содержимого отправления." }, "delivery": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Types.Posting.DeliveryInfo" }, "estimated_delivery_days": { "type": "integer", "description": "Предварительный срок доставки в днях.", "format": "int32", "nullable": true }, "original_delivery_at": { "type": "string", "description": "Дата и время доставки отправления после приёма в пункте отгрузки в UTC.", "format": "date-time", "nullable": true }, "delivery_at": { "type": "string", "description": "Дата и время доставки отправления в UTC.", "format": "date-time", "nullable": true }, "dimensions": { "$ref": "#/components/schemas/Ozon.Delivery.Common.Dimensions" }, "estimated_delivery_cost": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Types.EstimatedDeliveryCost" }, "estimated_insurance_cost": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Types.EstimatedInsuranceCost" }, "declared_value": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Types.DeclaredValue" }, "recipient": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Types.Recipient" } }, "additionalProperties": false, "description": "Отправление." }, "Ozon.Delivery.Posting.Search.Response": { "required": [ "postings" ], "type": "object", "properties": { "postings": { "type": "array", "items": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Types.Posting" }, "description": "Найденные отправления." }, "next_cursor": { "type": "string", "description": "Указатель для выборки следующих данных.", "nullable": true } }, "additionalProperties": false }, "Ozon.Delivery.Posting.Info.Request": { "required": [ "posting_numbers" ], "type": "object", "properties": { "posting_numbers": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 100, "description": "Номера отправлений." } }, "additionalProperties": false }, "Ozon.Delivery.Posting.Info.Response": { "required": [ "postings" ], "type": "object", "properties": { "postings": { "type": "array", "items": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Types.Posting" }, "description": "Отправления." } }, "additionalProperties": false }, "Ozon.Delivery.Posting.StatusHistory.Request": { "required": [ "posting_number" ], "type": "object", "properties": { "posting_number": { "type": "string", "description": "Номер отправления." } }, "additionalProperties": false }, "Ozon.Delivery.Posting.StatusHistory.StatusChange": { "required": [ "status", "status_changed_at" ], "type": "object", "properties": { "status": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.Types.PostingStatus" }, "status_changed_at": { "type": "string", "description": "Дата и время последнего изменения статуса отправления в UTC.", "format": "date-time" } }, "additionalProperties": false }, "Ozon.Delivery.Posting.StatusHistory.Response": { "required": [ "history" ], "type": "object", "properties": { "history": { "type": "array", "items": { "$ref": "#/components/schemas/Ozon.Delivery.Posting.StatusHistory.StatusChange" }, "description": "История изменений статусов отправления." } }, "additionalProperties": false }, "Ozon.Delivery.Posting.Cancel.Request": { "required": [ "posting_number" ], "type": "object", "properties": { "posting_number": { "type": "string", "description": "Номер отправления." } }, "additionalProperties": false }, "Return.Pagination": { "description": "Разделение ответа метода.", "required": [ "limit" ], "type": "object", "properties": { "cursor": { "type": "string", "description": "Указатель для выборки следующих данных.", "nullable": true }, "limit": { "type": "integer", "description": "Максимальное количество элементов в ответе.", "format": "int32", "maximum": 100 } }, "additionalProperties": false }, "Return.Search.Request": { "required": [ "pagination" ], "type": "object", "properties": { "pagination": { "$ref": "#/components/schemas/Return.Pagination" } }, "additionalProperties": false }, "Return.Types.ReturnType": { "enum": [ "unknown", "client_return", "cancellation" ], "type": "string", "description": "Тип возврата:\n - `unknown` — не определён;\n - `client_return` — возврат;\n - `cancellation` — отмена.\n" }, "Return.DeclaredValue": { "description": "Объявленная стоимость возврата.", "required": [ "amount", "currency_code" ], "type": "object", "properties": { "amount": { "type": "string", "description": "Сумма." }, "currency_code": { "type": "string", "description": "Валюта." } }, "additionalProperties": false }, "Return.Types.ReturnStatus": { "enum": [ "unknown", "moving", "at_pickup_point", "received", "utilization", "utilized", "written_off", "looking_for" ], "type": "string", "description": "Статус возврата:\n - `unknown` — не определён;\n - `moving` — доставляется по логистике Ozon к продавцу;\n - `at_pickup_point` — ожидает продавца в пункте выдачи;\n - `received` — получен продавцом;\n - `utilization` — отправлен на утилизацию;\n - `utilized` — утилизирован;\n - `written_off` — списан в логистике;\n - `looking_for` — ищем в логистике.\n" }, "Return.Types.ReturnDeliveryType": { "enum": [ "unknown", "courier", "return_point", "postamat" ], "type": "string", "description": "Тип доставки возврата:\n - `unknown` — не определён;\n - `courier` — курьером;\n - `return_point` — в пункт выдачи заказов;\n - `postamat` — в постамат.\n" }, "Return.Types.CancellationResponsible": { "enum": [ "unknown", "ozon", "principal", "client" ], "type": "string", "description": "Инициатор отмены:\n - `unknown` — не определён;\n - `ozon` — Ozon;\n - `principal` — продавец;\n - `client` — покупатель.\n" }, "Return.Types.ReturnInfo": { "required": [ "created_at", "declared_value", "description", "dimensions", "return_delivery_type", "return_number", "return_type", "shipment_method_id", "status", "status_changed_at" ], "type": "object", "properties": { "return_number": { "type": "string", "description": "Номер возврата." }, "return_external_id": { "type": "string", "description": "Идентификатор возврата в системе продавца.", "nullable": true }, "created_at": { "type": "string", "description": "Дата и время создания возврата или отмены в UTC.", "format": "date-time" }, "barcode": { "type": "string", "description": "Штрихкод возврата.", "nullable": true }, "return_type": { "$ref": "#/components/schemas/Return.Types.ReturnType" }, "description": { "type": "string", "description": "Описание содержимого возврата." }, "dimensions": { "$ref": "#/components/schemas/Ozon.Delivery.Common.Dimensions" }, "declared_value": { "$ref": "#/components/schemas/Return.DeclaredValue" }, "status": { "$ref": "#/components/schemas/Return.Types.ReturnStatus" }, "status_changed_at": { "type": "string", "description": "Дата и время последнего изменения статуса отправления в UTC.", "format": "date-time" }, "shipment_method_id": { "type": "integer", "description": "Идентификатор метода доставки.", "format": "int64" }, "return_delivery_type": { "$ref": "#/components/schemas/Return.Types.ReturnDeliveryType" }, "current_placement_name": { "type": "string", "description": "Местоположение возврата: название сортировочного центра или пункта выдачи.\n", "nullable": true }, "current_placement_address": { "type": "string", "description": "Адрес местоположения возврата.", "nullable": true }, "cancellation_responsible": { "$ref": "#/components/schemas/Return.Types.CancellationResponsible" }, "cancellation_reason": { "type": "string", "description": "Причина отмены.", "nullable": true } }, "additionalProperties": false }, "Return.Search.Response": { "required": [ "returns" ], "type": "object", "properties": { "returns": { "type": "array", "items": { "$ref": "#/components/schemas/Return.Types.ReturnInfo" }, "description": "Возвраты." }, "next_cursor": { "type": "string", "description": "Указатель для выборки следующих данных. Если параметр пустой, данных больше нет.", "nullable": true } }, "additionalProperties": false }, "Return.Info.Request": { "required": [ "return_numbers" ], "type": "object", "properties": { "return_numbers": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "type": "string" }, "description": "Номера возвратов." } }, "additionalProperties": false }, "Return.Types.ReturnShortInfo": { "required": [ "declared_value", "description", "dimensions", "return_delivery_type", "return_number", "return_type", "shipment_method_id", "status" ], "type": "object", "properties": { "return_number": { "type": "string", "description": "Номер возврата." }, "return_external_id": { "type": "string", "description": "Идентификатор возврата в системе продавца.", "nullable": true }, "barcode": { "type": "string", "description": "Штрихкод возврата.", "nullable": true }, "return_type": { "$ref": "#/components/schemas/Return.Types.ReturnType" }, "description": { "type": "string", "description": "Описание содержимого возврата." }, "dimensions": { "$ref": "#/components/schemas/Ozon.Delivery.Common.Dimensions" }, "declared_value": { "$ref": "#/components/schemas/Return.DeclaredValue" }, "status": { "$ref": "#/components/schemas/Return.Types.ReturnStatus" }, "shipment_method_id": { "type": "integer", "description": "Идентификатор метода доставки.", "format": "int64" }, "return_delivery_type": { "$ref": "#/components/schemas/Return.Types.ReturnDeliveryType" }, "current_placement_name": { "type": "string", "description": "Местоположение возврата: название сортировочного центра или пункта выдачи.\n", "nullable": true }, "current_placement_address": { "type": "string", "description": "Адрес местоположения возврата.", "nullable": true }, "cancellation_reason": { "type": "string", "description": "Причина отмены.", "nullable": true } }, "additionalProperties": false }, "Return.Info.Response": { "required": [ "returns" ], "type": "object", "properties": { "returns": { "type": "array", "items": { "$ref": "#/components/schemas/Return.Types.ReturnShortInfo" }, "description": "Возвраты." } }, "additionalProperties": false }, "Return.StatusHistory.Request": { "required": [ "return_number" ], "type": "object", "properties": { "return_number": { "type": "string", "description": "Номер возврата." } }, "additionalProperties": false }, "Return.Types.ReturnStatusHistoryItem": { "required": [ "changed_at", "return_status" ], "type": "object", "properties": { "return_status": { "$ref": "#/components/schemas/Return.Types.ReturnStatus" }, "changed_at": { "type": "string", "description": "Дата и время изменения статуса в UTC.", "format": "date-time" } }, "additionalProperties": false }, "Return.StatusHistory.Response": { "required": [ "status_history" ], "type": "object", "properties": { "status_history": { "type": "array", "items": { "$ref": "#/components/schemas/Return.Types.ReturnStatusHistoryItem" }, "description": "История изменений статусов возврата." } }, "additionalProperties": false }, "Return.Types.ResetBarcodeContent": { "required": [ "barcode", "expires_at" ], "type": "object", "properties": { "barcode": { "type": "string", "description": "Штрихкод получения возвратов." }, "expires_at": { "type": "string", "description": "Дата и время истечения срока действия штрихкода в UTC.", "format": "date-time", "example": "2026-07-14T09:30:00Z" } }, "additionalProperties": false, "description": "Информация о штрихкоде." }, "Return.ResetBarcode.Response": { "required": [ "barcode_content" ], "type": "object", "properties": { "barcode_content": { "$ref": "#/components/schemas/Return.Types.ResetBarcodeContent" } }, "additionalProperties": false } } } }