---
metadata:
  - name: generator
    content: Diplodoc Platform v5.48.2
alternate:
  - https://yandex.com/dev/eda-vendor/doc/en/ref/Feedback/partner.feedback.post.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/eda-vendor/doc/en/llms.txt

<div class="openapi">

# Send the customer's feedback on the order.

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

Send the customer's feedback on the order.

{% note info %}

The method is available only by subscription.

{% endnote %}

The method for providing a response to a feedback is inside the block Vendor Management Integration API.


## 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/feedback
```

</div>

</div>

</div>

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "feedback": {
    "id": "example",
    "createdAt": "1937-01-01T12:00:27.870000+00:20",
    "eatsId": "190330-12345678",
    "orderId": "example",
    "predefinedComment": "example",
    "comment": "example",
    "restaurantId": "example",
    "rating": 5,
    "takenAt": "1937-01-01T12:00:27+00:20",
    "deliveredAt": "1937-01-01T12:00:27+00:20"
  },
  "orderInfo": {
    "createdAt": "1937-01-01T12:00:27.870000+00:20",
    "platform": "YE",
    "discriminator": "marketplace",
    "deliveryInfo": {
      "clientName": "John Cena"
    },
    "paymentInfo": {
      "total": 200.99
    },
    "items": [
      {
        "id": "937c57f6-4508-4858-be7f-20691a16fbb0",
        "name": "Pizza Pepperoni",
        "quantity": 3.5,
        "price": 100,
        "modifications": [
          {}
        ]
      }
    ],
    "comment": "Additional order information: ..."
  }
}
```

{% endcut %}

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

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

Information about the customer's feedback

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

```json translate=no
{
  "id": "example",
  "createdAt": "1937-01-01T12:00:27.870000+00:20",
  "eatsId": "190330-12345678",
  "orderId": "example",
  "predefinedComment": "example",
  "comment": "example",
  "restaurantId": "example",
  "rating": 5,
  "takenAt": "1937-01-01T12:00:27+00:20",
  "deliveredAt": "1937-01-01T12:00:27+00:20"
}
```

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

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

Order information

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

```json translate=no
{
  "createdAt": "1937-01-01T12:00:27.870000+00:20",
  "platform": "YE",
  "discriminator": "marketplace",
  "deliveryInfo": {
    "clientName": "John Cena"
  },
  "paymentInfo": {
    "total": 200.99
  },
  "items": [
    {
      "id": "937c57f6-4508-4858-be7f-20691a16fbb0",
      "name": "Pizza Pepperoni",
      "quantity": 3.5,
      "price": 100,
      "modifications": [
        {
          "id": "937c57f6-4508-4858-be7f-20691a16fbb0",
          "name": "Utensils",
          "quantity": 3,
          "price": 100
        }
      ]
    }
  ],
  "comment": "Additional order information: ..."
}
```

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

</div>

<div class="openapi-entity">

### Feedback {#entity-Feedback}

Information about the customer's feedback

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

_createdAt_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string&lt;date-time&gt;

The date the feedback was created in the RFC 3339 format from fractional part of seconds (Y-m-d\TH:i:s.uP)

_Example:_{.json-schema-reset .json-schema-example} `1937-01-01T12:00:27.870000+00:20`
{.table-cell}
||
||

_deliveredAt_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string&lt;date-time&gt;

The date when the order was delivered in ISO 8601 format without fractional part of seconds (Y-m-d\TH:i:s+hh:ss)

_Example:_{.json-schema-reset .json-schema-example} `1937-01-01T12:00:27+00:20`
{.table-cell}
||
||

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

End-to-end order identifier on the Yandex side in the format DDDDDD-DDDDDDDD

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

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

Order identifier in the partner's system

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

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

The customer's rating for the order is from 1 to 5
{.table-cell}
||
||

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

The ID of the restaurant in the partner's system

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

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

Text feedback from the customer on the order

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

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

feedback's ID on the Yandex side

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

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

Predefined comments on the Yandex side, selected by the client

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

_takenAt_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string&lt;date-time&gt;

The date when the courier picked up the order from the restaurant, in ISO format 8601 without fractional part of seconds (Y-m-d\TH:i:s+hh:ss)

_Example:_{.json-schema-reset .json-schema-example} `1937-01-01T12:00:27+00:20`
{.table-cell}
||
|#{.json-schema-properties}

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

```json translate=no
{
  "id": "example",
  "createdAt": "1937-01-01T12:00:27.870000+00:20",
  "eatsId": "190330-12345678",
  "orderId": "example",
  "predefinedComment": "example",
  "comment": "example",
  "restaurantId": "example",
  "rating": 5,
  "takenAt": "1937-01-01T12:00:27+00:20",
  "deliveredAt": "1937-01-01T12:00:27+00:20"
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### DeliveryInfo {#entity-DeliveryInfo}

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

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

Client's name in Yandex service

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

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

```json translate=no
{
  "clientName": "John Cena"
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### PaymentInfo {#entity-PaymentInfo}

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

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

Total order cost
{.table-cell}
||
|#{.json-schema-properties}

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

```json translate=no
{
  "total": 200.99
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### ModificationsItem {#entity-ModificationsItem}

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

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

Modifier ID in the partner's system

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

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

Modifier price for the menu item (e.g., additional sauce)
{.table-cell}
||
||

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

Quantity in the order
{.table-cell}
||
||

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

Modifier ID in the partner's system

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

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

```json translate=no
{
  "id": "937c57f6-4508-4858-be7f-20691a16fbb0",
  "name": "Utensils",
  "quantity": 3,
  "price": 100
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### OrderInfoItem {#entity-OrderInfoItem}

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

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

menu item ID in the partner's system

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

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

List of selected modifications. May be empty, passed
explicitly for each individual item in the order. When ordering two
items of the same dish with different sets of modifications, different
items with different `modifications` lists are passed.


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

```json translate=no
[
  {
    "id": "937c57f6-4508-4858-be7f-20691a16fbb0",
    "name": "Utensils",
    "quantity": 3,
    "price": 100
  }
]
```

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

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

Price of one item including modification costs. In the next version, it will be corrected to the net price of the item without modifications
{.table-cell}
||
||

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

The number of items in the order
{.table-cell}
||
||

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

menu item name

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

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

```json translate=no
{
  "id": "937c57f6-4508-4858-be7f-20691a16fbb0",
  "name": "Pizza Pepperoni",
  "quantity": 3.5,
  "price": 100,
  "modifications": [
    {
      "id": "937c57f6-4508-4858-be7f-20691a16fbb0",
      "name": "Utensils",
      "quantity": 3,
      "price": 100
    }
  ]
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### OrderInfo {#entity-OrderInfo}

Order information

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

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

Additional order information

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

_createdAt_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string&lt;date-time&gt;

The date the review was created in the RFC 3339 format from fractional part of seconds (Y-m-d\TH:i:s.uP)

_Example:_{.json-schema-reset .json-schema-example} `1937-01-01T12:00:27.870000+00:20`
{.table-cell}
||
||

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

Delivery info

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

```json translate=no
{
  "clientName": "John Cena"
}
```

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

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

Type of order delivery:

yandex - delivery by Yandex couriers
marketplace - delivery by restaurant couriers
pickup - pickup by the customer from the restaurant


_Enum:_{.json-schema-reset .json-schema-value} `marketplace`, `yandex`, `pickup`
{.table-cell}
||
||

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

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

```json translate=no
[
  {
    "id": "937c57f6-4508-4858-be7f-20691a16fbb0",
    "name": "Pizza Pepperoni",
    "quantity": 3.5,
    "price": 100,
    "modifications": [
      {
        "id": "937c57f6-4508-4858-be7f-20691a16fbb0",
        "name": "Utensils",
        "quantity": 3,
        "price": 100
      }
    ]
  }
]
```

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

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

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

```json translate=no
{
  "total": 200.99
}
```

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

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

Platform ID.

_Const:_{.json-schema-reset .json-schema-value} `YE`

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

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

```json translate=no
{
  "createdAt": "1937-01-01T12:00:27.870000+00:20",
  "platform": "YE",
  "discriminator": "marketplace",
  "deliveryInfo": {
    "clientName": "John Cena"
  },
  "paymentInfo": {
    "total": 200.99
  },
  "items": [
    {
      "id": "937c57f6-4508-4858-be7f-20691a16fbb0",
      "name": "Pizza Pepperoni",
      "quantity": 3.5,
      "price": 100,
      "modifications": [
        {
          "id": "937c57f6-4508-4858-be7f-20691a16fbb0",
          "name": "Utensils",
          "quantity": 3,
          "price": 100
        }
      ]
    }
  ],
  "comment": "Additional order information: ..."
}
```

{% endcut %}

</div>

## Responses

<div class="openapi__response__code__200">

## 200 OK

The feedback was successfully processed by the restaurant's internal system.

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "result": "OK"
}
```

{% endcut %}

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

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

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

</div>

</div>

<div class="openapi__response__code__400">

## 400 Bad Request

Bad request. **_An array with an object from the error list is expected in the response body_**

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
[
  {
    "code": 100,
    "description": "Description of error"
  }
]
```

{% endcut %}

**Type**: [ErrorItem](#entity-ErrorItem)[]

</div>

<div class="openapi-entity">

### ErrorItem {#entity-ErrorItem}

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

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

Error code agreed with Yandex
{.table-cell}
||
||

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

Error message

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

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

```json translate=no
{
  "code": 100,
  "description": "Description of error"
}
```

{% endcut %}

</div>

</div>

<div class="openapi__response__code__401">

## 401 Unauthorized

Authorization failed - the token expired or was not passed in the request. A retry will be made.


<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "reason": "Access token has been expired. You should request a new one"
}
```

{% endcut %}

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

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

Reason for authorization failure

_Example:_{.json-schema-reset .json-schema-example} `Access token has been expired. You should request a new one`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__500">

## 500 Internal Server Error

Internal server errors

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
[
  {
    "code": 100,
    "description": "Description of error"
  }
]
```

{% endcut %}

**Type**: [ErrorItem](#entity-ErrorItem)[]

</div>

</div>

</div>

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