---
metadata:
  - name: generator
    content: Diplodoc Platform v5.48.2
alternate:
  - https://yandex.com/dev/eda-vendor/doc/en/ref/Vendor-Management-Integration-API/partner.integration.v1.get.orders.details.post.md
  - https://yandex.com/dev/eda-vendor/doc/ru/ref/Vendor-Management-Integration-API/partner.integration.v1.get.orders.details.post.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/eda-vendor/doc/ru/llms.txt

<div class="openapi">

# Детальная информация о заказах

<!-- markdownlint-disable-file -->

Позволяет получать подробную информацию по заказам.

Ограничения метода:
    - В запросе можно передать не более 100 заказов
    - История хранится для заказов за последние 180 дней


## Request

<div class="openapi__requests">

<div class="openapi__request__wrapper" style="--method: var(--dc-openapi-methods-post);margin-bottom: 12px">

<div class="openapi__request">

POST {.openapi__method}
```text translate=no
/v1/get-orders-details
```

</div>

</div>

</div>

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "eats_ids": [
    "230328-354380"
  ]
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_eats_ids_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [EatsId](#entity-EatsId)[]

Список номеров заказов для поиска

_Min items:_{.json-schema-reset .json-schema-assertion} `1`

_Max items:_{.json-schema-reset .json-schema-assertion} `100`

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  "230328-354380"
]
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

<div class="openapi-entity">

### EatsId {#entity-EatsId}

Номер заказа в системе Яндекс.Еда

**Type**: string

_Min length:_{.json-schema-reset .json-schema-assertion} `13`

_Example:_{.json-schema-reset .json-schema-example} `230328-354380`

</div>

## Responses

<div class="openapi__response__code__200">

## 200 OK

OK

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "orders": [
    {
      "eats_id": "230328-354380",
      "order_id": "example",
      "status": "NEW",
      "items": [
        {
          "id": "example",
          "name": "example",
          "quantity": 3.5,
          "price": 123.78,
          "original_price": 100.23,
          "weight": 0.5,
          "measure_unit": "example",
          "modifications": [
            null
          ]
        }
      ],
      "items_cost": 0.5,
      "cancel_reason": {
        "code": "place.missing_dish",
        "message": "Заказ был отменён на стороне пользователя"
      }
    }
  ],
  "not_found_eats_ids": [
    null
  ]
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_not_found_eats_ids_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [EatsId](#entity-EatsId)[]

Список номеров заказов, по которым информация не найдена или недоступна

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  "230328-354380"
]
```

{% endcut %}
{.table-cell}
||
||

_orders_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [OrderDetails](#entity-OrderDetails)[]

Список заказов с детальной информацией

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "eats_id": "230328-354380",
    "order_id": "example",
    "status": "NEW",
    "items": [
      {
        "id": "example",
        "name": "example",
        "quantity": 3.5,
        "price": 123.78,
        "original_price": 100.23,
        "weight": 0.5,
        "measure_unit": "example",
        "modifications": [
          {}
        ]
      }
    ],
    "items_cost": 0.5,
    "cancel_reason": {
      "code": "place.missing_dish",
      "message": "Заказ был отменён на стороне пользователя"
    }
  }
]
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

<div class="openapi-entity">

### OrderHistoryStatus {#entity-OrderHistoryStatus}

Статус заказа в системе Яндекс.Еды

**Type**: string | null

_Enum:_{.json-schema-reset .json-schema-value} `NEW`, `CANCELLED`, `DELIVERED`

</div>

<div class="openapi-entity">

### OrderItemOption {#entity-OrderItemOption}

Опция товара

#|
|| **Name** | **Description** ||
||

_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Идентификатор опции на стороне ресторана/магазина

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_price_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: number

Цена опции товара
{.table-cell}
||
||

_quantity_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer

Количество опций в рамках этой позиции
{.table-cell}
||
||

_group_id_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

ID группы в системе партнера, к которой принадлежит опция

_Example:_{.json-schema-reset .json-schema-example} `937c57f6-4508-4858-be7f-20691a16fbb1`
{.table-cell}
||
||

_name_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Название опции

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "id": "example",
  "group_id": "937c57f6-4508-4858-be7f-20691a16fbb1",
  "name": "example",
  "quantity": 0,
  "price": 10.5
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### OrderItem {#entity-OrderItem}

Товар с опциями

#|
|| **Name** | **Description** ||
||

_id_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Идентификатор товара на стороне ресторана/магазина

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_measure_unit_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Единицы измерения веса, например GRM

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_modifications_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [OrderItemOption](#entity-OrderItemOption)[]

Опции товара

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "id": "example",
    "group_id": "937c57f6-4508-4858-be7f-20691a16fbb1",
    "name": "example",
    "quantity": 0,
    "price": 10.5
  }
]
```

{% endcut %}
{.table-cell}
||
||

_name_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Название товара, например «Картошка»

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_original_price_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: number

Стоимость одной данной позиции без учета стоимости опций
{.table-cell}
||
||

_price_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: number

Стоимость одной данной позиции вместе со стоимостью опций
{.table-cell}
||
||

_quantity_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: number

Количество товаров в рамках этой позиции
{.table-cell}
||
||

_weight_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: number

Конечный вес товара
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "id": "example",
  "name": "example",
  "quantity": 3.5,
  "price": 123.78,
  "original_price": 100.23,
  "weight": 0.5,
  "measure_unit": "example",
  "modifications": [
    {
      "id": "example",
      "group_id": "937c57f6-4508-4858-be7f-20691a16fbb1",
      "name": "example",
      "quantity": 0,
      "price": 10.5
    }
  ]
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### CancelReason {#entity-CancelReason}

#|
|| **Name** | **Description** ||
||

_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Код причины отмены заказа в Яндекс Еда

_Example:_{.json-schema-reset .json-schema-example} `place.missing_dish`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Текст причины отмены заказа

_Example:_{.json-schema-reset .json-schema-example} `Заказ был отменён на стороне пользователя`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "code": "place.missing_dish",
  "message": "Заказ был отменён на стороне пользователя"
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### OrderDetails {#entity-OrderDetails}

Заказ с детальной информацией

#|
|| **Name** | **Description** ||
||

_eats_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [EatsId](#entity-EatsId)

Номер заказа в системе Яндекс.Еда

_Min length:_{.json-schema-reset .json-schema-assertion} `13`

_Example:_{.json-schema-reset .json-schema-example} `230328-354380`
{.table-cell}
||
||

_items_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [OrderItem](#entity-OrderItem)[]

Состав заказа

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "id": "example",
    "name": "example",
    "quantity": 3.5,
    "price": 123.78,
    "original_price": 100.23,
    "weight": 0.5,
    "measure_unit": "example",
    "modifications": [
      {
        "id": "example",
        "group_id": "937c57f6-4508-4858-be7f-20691a16fbb1",
        "name": "example",
        "quantity": 0,
        "price": 10.5
      }
    ]
  }
]
```

{% endcut %}
{.table-cell}
||
||

_order_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string &#124; null

Идентификатор заказа в системе партнера

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_status_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [OrderHistoryStatus](#entity-OrderHistoryStatus)

Статус заказа в системе Яндекс.Еды

_Enum:_{.json-schema-reset .json-schema-value} `NEW`, `CANCELLED`, `DELIVERED`
{.table-cell}
||
||

_cancel_reason_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [CancelReason](#entity-CancelReason)

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "code": "place.missing_dish",
  "message": "Заказ был отменён на стороне пользователя"
}
```

{% endcut %}
{.table-cell}
||
||

_items_cost_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: number

Стоимость заказа для партнера за вычетом стоимости доставки (с учетом партнерских скидок)
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "eats_id": "230328-354380",
  "order_id": "example",
  "status": "NEW",
  "items": [
    {
      "id": "example",
      "name": "example",
      "quantity": 3.5,
      "price": 123.78,
      "original_price": 100.23,
      "weight": 0.5,
      "measure_unit": "example",
      "modifications": [
        {
          "id": "example",
          "group_id": "937c57f6-4508-4858-be7f-20691a16fbb1",
          "name": "example",
          "quantity": 0,
          "price": 10.5
        }
      ]
    }
  ],
  "items_cost": 0.5,
  "cancel_reason": {
    "code": "place.missing_dish",
    "message": "Заказ был отменён на стороне пользователя"
  }
}
```

{% endcut %}

</div>

</div>

<div class="openapi__response__code__400">

## 400 Bad Request

Ошибка запроса

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "message": "example",
  "code": "example"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Код ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Сообщение об ошибке

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__500">

## 500 Internal Server Error

Ошибка сервиса

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "message": "example",
  "code": "example"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Код ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Сообщение об ошибке

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

</div>

[*Deprecated]: No longer supported, please use an alternative and newer version.