---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com.tr/dev/metrika/en/data-import/orders-data.md
  - https://yandex.com.tr/dev/metrika/ru/data-import/orders-data.md
  - href: ru/data-import/orders-data.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/metrika/ru/llms.txt

# Формат данных о заказах

Обязательные колонки:

- `id` — идентификатор заказа в вашей CRM. Произвольное значение. Нужен для обновления статусов заказа и перепривязки заказа к другим клиентам.
- `client_uniq_id` — идентификатор клиента в CRM, связанного с заказом.
- `client_type` — тип клиента с `client_uniq_id`. Допустимое значение: `CONTACT`.
- `create_date_time` — дата и время создания заказа в часовом поясе счетчика. Значение нельзя менять. [Подробно](https://yandex.com.tr/dev/metrika/ru/data-import/date.md).
- `order_status` — идентификатор статуса заказа. Произвольная строка. Статус можно менять. Укажите значение, которое вы передавали при [сопоставлении статусов](https://yandex.com.tr/dev/metrika/ru/data-import/maporderstatuses-about.md) в поле `id`.

Необязательные колонки:

- `update_date_time` — дата и время обновления заказа в часовом поясе счетчика. Если параметр не передан, значение подставляется автоматически. [Подробно](https://yandex.com.tr/dev/metrika/ru/data-import/date.md).
- `finish_date_time` — дата и время завершения заказа в часовом поясе счетчика. Если значение не передавать, то оно будет автоматически определяться, как дата первой загрузки сделки в статусе группы `PAID`. [Подробно](https://yandex.com.tr/dev/metrika/ru/data-import/date.md)
- `revenue` — доход. Суммарная стоимость заказа. Десятичная дробь. Передавайте выручку от заказа. Это значение будет использоваться в отчетах [Сквозной аналитики](https://yandex.com.tr/dev/metrika/ru/stat/presets/preset_cdp_orders.md), чтобы показать сколько денег принесли заказы с рекламных каналов. Значение будет показано в метрике «Выручка».
- `cost` — себестоимость. Десятичная дробь. Вы можете передать себестоимость заказов, чтобы учитывать прибыль в отчетах [Сквозной аналитики](https://yandex.com.tr/dev/metrika/ru/stat/presets/preset_cdp_orders.md). Прибыль будет рассчитана по формуле: `Выручка - Себестоимость`.

  {% note info %}
  
  При указании себестоимости доход целей, выполняемых в заказе, будет указан как revenue-cost.
  
  {% endnote %}
  
- `products` — товары в заказе. Передавайте идентификаторы товаров и их количество в заказе. Идентификаторы будут доступны при формировании сегмента в Метрике, если вы не передаете списки товаров. Если вы [создаете списки товаров](https://yandex.com.tr/dev/metrika/ru/management/openapi/schema/createProducts.md), то в Метрике будут доступны данные из этих списков, например, названия товаров.
- `goals` — JS-цели и их стоимости в заказе. Передавайте идентификаторы JS-целей и стоимость этих целей (опционально) в заказе. В качестве идентификатора JS-цели используйте значение параметра `conditions.url` ([пример создания JS-цели](https://yandex.com.tr/dev/metrika/ru/management/addgoal-example.md#action)).

Кроме этого, вы можете передавать дополнительную информацию о заказах, например, тип услуги. Для этого:

1. Создайте атрибут, который будет соответствовать вашему дополнительному параметру — с помощью метода [POST /cdp/api/v1/counter/{counterId}/schema/attributes](https://yandex.com.tr/dev/metrika/ru/management/openapi/schema/createAttributes.md).
2. Передайте атрибут вместе с другими данными о заказах — с помощью метода `POST /cdp/api/v1/counter/{counterId}/data/orders` ([CSV](https://yandex.com.tr/dev/metrika/ru/management/openapi/schema/uploadOrders.md) или [JSON](https://yandex.com.tr/dev/metrika/ru/management/openapi/schema/uploadOrdersJson_1.md)). При использовании JSON для удобства можно использовать массив `attribute_values`.

## Узнайте больше

- [Формат даты и времени](https://yandex.com.tr/dev/metrika/ru/data-import/date.md)
- [Формат данных о клиентах](https://yandex.com.tr/dev/metrika/ru/data-import/contacts-data.md)