Ozon Delivery API — справочник методов

Базовый URL: https://api-delivery.ozon.ru

Все методы — POST, тело и ответ в JSON, авторизация — заголовок Authorization: Bearer <access_token>.

Во всех ответах приходит заголовок x-o3-trace-id — идентификатор запроса для обращения в поддержку.

Сгенерировано из официальной OpenAPI-спеки Ozon Delivery API: ozon-delivery-openapi.json.

Содержание#

• Оформление заказа
  • /v1/delivery/check-client — Проверить доступность доставки для покупателя
  • /v1/delivery/location — Рассчитать предварительный срок доставки до локации покупателя
  • /v1/order/checkout — Проверить доступность доставки и расчёт условий по заказу
  • /v1/order/create — Создать заказ
• Пункты выдачи заказов
  • /v1/delivery-point/list — Получить список всех пунктов выдачи
  • /v1/delivery-point/check-availability — Проверить доступность доставки отправлений в конкретные пункты выдачи
  • /v1/delivery-point/info — Получить информацию о пунктах выдачи
• Отгрузка отправлений
  • /v1/posting/approve — Подтвердить отправление к отгрузке
  • /v1/posting/label — Получить этикетку отправления
• Обработка отправлений
  • /v1/posting/search — Найти отправления
  • /v1/posting/info — Получить информацию об отправлении
  • /v1/posting/status-history — Получить историю статусов отправления
  • /v1/posting/cancel — Запустить процесс отмены отправления
• Обработка возвратов
  • /v1/return/search — Найти возвраты
  • /v1/return/info — Получить информацию о возвратах
  • /v1/return/status-history — Получить историю статусов возврата
  • /v1/return/download_barcode — Скачать штрихкод получения возвратов в формате PDF
  • /v1/return/reset_barcode — Сбросить штрихкод получения возвратов

Оформление заказа#

Проверить доступность доставки для покупателя#

POST /v1/delivery/check-client

operationId: DeliveryCheckClient

Тело запроса (application/json)

Пример запроса

{
  "phone_number": "+79000000000"
}

Ответы

Тело ответа 200 (application/json)

Пример ответа 200

{
  "can_be_delivered": true
}

---

Рассчитать предварительный срок доставки до локации покупателя#

POST /v1/delivery/location

operationId: DeliveryLocation

Тело запроса (application/json)

Пример запроса

{
  "coordinates": {
    "latitude": 55.7558,
    "longitude": 37.6176
  },
  "shipment_methods": [
    {
      "shipment_method_id": 1,
      "cutoff_at": "2026-07-16T09:00:00Z"
    }
  ]
}

Ответы

Тело ответа 200 (application/json)

Пример ответа 200

{
  "results": [
    {
      "shipment_method_id": 1,
      "estimated_delivery_days": 1
    }
  ]
}

---

Проверить доступность доставки и расчёт условий по заказу#

POST /v1/order/checkout

operationId: OrderCheckout

Тело запроса (application/json)

Пример запроса

{
  "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
    }
  }
}

Ответы

Тело ответа 200 (application/json)

Пример ответа 200

{
  "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"
      }
    }
  ]
}

---

Создать заказ#

POST /v1/order/create

operationId: OrderCreate

Параметры запроса (header/query/path)

Тело запроса (application/json)

Пример запроса

{
  "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
      }
    }
  ]
}

Ответы

Тело ответа 200 (application/json)

Пример ответа 200

{
  "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

{
  "error": {
    "message": "Не удалось создать заказ."
  },
  "details": [
    {
      "item_id": "1",
      "error": {
        "code": "recipient_error",
        "message": "Невозможно доставить заказ получателю."
      }
    }
  ]
}

---

Пункты выдачи заказов#

Получить список всех пунктов выдачи#

POST /v1/delivery-point/list

operationId: DeliveryPointList

Тело запроса (application/json)

Пример запроса

{
  "pagination": {
    "cursor": "string",
    "limit": 100
  }
}

Ответы

Тело ответа 200 (application/json)

Пример ответа 200

{
  "delivery_points": [
    {
      "delivery_point_id": 1,
      "shipment_method_ids": 1
    }
  ],
  "next_cursor": "string"
}

---

Проверить доступность доставки отправлений в конкретные пункты выдачи#

POST /v1/delivery-point/check-availability

operationId: DeliveryPointCheckAvailability

Тело запроса (application/json)

Пример запроса

{
  "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
      }
    }
  ]
}

Ответы

Тело ответа 200 (application/json)

Пример ответа 200

{
  "results": [
    {
      "request_id": 101,
      "cutoff_at": "2026-07-16T12:00:00Z",
      "delivery_point_id": 1,
      "error": {
        "code": "DeliveryPointNotFound",
        "message": "Не удалось найти информацию о пункте выдачи."
      }
    }
  ]
}

---

Получить информацию о пунктах выдачи#

POST /v1/delivery-point/info

operationId: DeliveryPointInfo

Тело запроса (application/json)

Пример запроса

{
  "delivery_point_ids": "1"
}

Ответы

Тело ответа 200 (application/json)

Пример ответа 200

{
  "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"
        }
      }
    }
  ]
}

---

Отгрузка отправлений#

Подтвердить отправление к отгрузке#

POST /v1/posting/approve

operationId: PostingApprove

Тело запроса (application/json)

Пример запроса

{
  "posting_number": "123BE456PY78-90YY"
}

Ответы

---

Получить этикетку отправления#

POST /v1/posting/label

operationId: PostingLabel

Ответ 200 — PDF-файл с этикеткой (бинарные данные, не JSON). Этикетку можно получить только для отправлений в статусе ready_for_shipping; она обязательна для приёмки в логистику Ozon.

Тело запроса (application/json)

Пример запроса

{
  "posting_number": "123BE456PY78-90YY"
}

Ответы

---

Обработка отправлений#

Найти отправления#

POST /v1/posting/search

operationId: PostingSearch

Тело запроса (application/json)

Пример запроса

{
  "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
  }
}

Ответы

Тело ответа 200 (application/json)

Пример ответа 200

{
  "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"
}

---

Получить информацию об отправлении#

POST /v1/posting/info

operationId: PostingInfo

Тело запроса (application/json)

Пример запроса

{
  "posting_numbers": [
    "123BE456PY78-90YY"
  ]
}

Ответы

Тело ответа 200 (application/json)

Пример ответа 200

{
  "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": "Иванов И. И."
      }
    }
  ]
}

---

Получить историю статусов отправления#

POST /v1/posting/status-history

operationId: PostingStatusHistory

Тело запроса (application/json)

Пример запроса

{
  "posting_number": "123BE456PY78-90YY"
}

Ответы

Тело ответа 200 (application/json)

Пример ответа 200

{
  "history": [
    {
      "status": "created",
      "status_changed_at": "2026-07-14T09:30:00Z"
    }
  ]
}

---

Запустить процесс отмены отправления#

POST /v1/posting/cancel

operationId: PostingCancel

Тело запроса (application/json)

Пример запроса

{
  "posting_number": "123BE456PY78-90YY"
}

Ответы

---

Обработка возвратов#

Найти возвраты#

POST /v1/return/search

operationId: ReturnSearch

Тело запроса (application/json)

Пример запроса

{
  "pagination": {
    "cursor": "string",
    "limit": 100
  }
}

Ответы

Тело ответа 200 (application/json)

Пример ответа 200

{
  "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"
}

---

Получить информацию о возвратах#

POST /v1/return/info

operationId: ReturnInfo

Тело запроса (application/json)

Пример запроса

{
  "return_numbers": [
    "string"
  ]
}

Ответы

Тело ответа 200 (application/json)

Пример ответа 200

{
  "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": "Покупатель отказался при вручении: товар не подошел."
    }
  ]
}

---

Получить историю статусов возврата#

POST /v1/return/status-history

operationId: ReturnStatusHistory

Тело запроса (application/json)

Пример запроса

{
  "return_number": "123BE456PY78-90YY"
}

Ответы

Тело ответа 200 (application/json)

Пример ответа 200

{
  "status_history": [
    {
      "return_status": "moving",
      "changed_at": "2026-07-30T00:00:00Z"
    }
  ]
}

---

Скачать штрихкод получения возвратов в формате PDF#

POST /v1/return/download_barcode

operationId: ReturnDownloadBarcode

Ответ 200 — PDF-файл со штрихкодом (бинарные данные, не JSON). Срок действия штрихкода указан в файле; запрашивайте его непосредственно перед получением возвратов.

Ответы

---

Сбросить штрихкод получения возвратов#

POST /v1/return/reset_barcode

operationId: ReturnResetBarcode

Ответы

Тело ответа 200 (application/json)

Пример ответа 200

{
  "barcode_content": {
    "barcode": "123456789101112",
    "expires_at": "2026-07-14T09:30:00Z"
  }
}

---