---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com.tr/dev/metrika/en/data-import/simple-orders-data.md
  - https://yandex.com.tr/dev/metrika/ru/data-import/simple-orders-data.md
  - href: ru/data-import/simple-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

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

Описанные ниже поля передавайте с помощью метода [POST /cdp/api/v1/counter/{counterId}/data/simple_orders](https://yandex.com.tr/dev/metrika/ru/management/openapi/schema/uploadSimpleOrders.md).

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

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

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

- `client_ids` — список ClientID. Подробно см. в [Подготовка данных для привязки к визитам](https://yandex.com.tr/dev/metrika/ru/data-import/simple-orders-prep.md#data).
- `emails` — список адресов электронной почты клиента. Строка латиницей, включающая символ `@` и имя домена. Нельзя использовать прописные буквы. Пример: `mail@yandex.ru`.
- `phones` — список телефонных номеров клиента. Числовая строка, содержащая номер мобильного телефона с указанием кода страны. Можно использовать пробелы, круглые скобки, символы `-` и `+`. Пример: `+7(999)5551111`.
- `emails_md5` — список адресов электронной почты клиента, [хешированных в формате md5](https://yandex.com.tr/dev/metrika/ru/data-import/hashing.md). Для проверки алгоритма, которым вы пользуетесь для хеширования, вы можете использовать почту `mail@yandex.ru`. Хеш от нее должен получиться: `3c56ff8fef0f6c65b36b2d25720fe276`.
- `phones_md5` — список телефонных номеров клиента, [хешированных в формате md5](https://yandex.com.tr/dev/metrika/ru/data-import/hashing.md). Для проверки алгоритма, которым вы пользуетесь для хеширования, вы можете использовать номер телефона `79995551111`. Хеш от него должен получиться: `f09f2c3d48f31e2a802944ade2e5aec5`.

{% note info %}

Чтобы передавать один или несколько телефонных номеров или адресов электронной почты, оберните их в кавычки. При передаче нескольких значений разделите их запятой. Если вы передаете хеши от телефонов и почт, захешируйте каждый телефон/почту отдельно, оберните хеши от телефонов и почт в кавычки и разделите запятой без пробелов.
Пример: `"79876543210,79991234567"` или `"mail@example.com,mail2@example.com"`.

{% endnote %}

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

- `client_uniq_id` — идентификатор клиента в CRM, связанного с заказом.
- `order_status` — тип статуса заказа. Произвольная строка. Статус можно менять.

    Возможные значения:

    - `PAID` — оплачен (применяется по умолчанию если вы не передаете статусы заказов), при передаче будут достигнуты цели **CRM: Заказ создан** и **CRM: Заказ оплачен**;
    - `IN_PROGRESS` — в работе, при передаче будет достигнута цель **CRM: Заказ создан**;
    - `CANCELLED` — отменен, при передаче будет достигнута цель **CRM: Заказ отменен**;
    - `SPAM` — спам, при передаче будет достигнута цель **CRM: Спам заказ**;
    - Аналогично статусам выше вы можете отправить значение javascript-идентификатора ваших целей **JavaScript-событие** — в таком случае будет достигнута переданная цель.

     {% cut "Пример" %}

     Вы можете использовать цель **JavaScript-событие** **Квалифицированнный лид** с идентификатором `kval_lead` и присылать в качестве статуса заказа этот идентификатор для достижения в заказе соответствующей цели.

     {% endcut %}

- `revenue` — доход. Суммарная стоимость заказа. Десятичная дробь. Передавайте выручку от заказа. Это значение будет использоваться в отчетах [Сквозной аналитики](https://yandex.com.tr/dev/metrika/ru/stat/presets/preset_cdp_orders.md), чтобы показать сколько денег принесли заказы с рекламных каналов. Значение будет показано в метрике «Выручка».
- `cost` — себестоимость. Десятичная дробь. Вы можете передать себестоимость заказов, чтобы учитывать прибыль в отчетах Сквозной аналитики. Прибыль будет рассчитана по формуле: `Выручка - Себестоимость`.
  
  {% note info %}
  
  При указании себестоимости доход целей выполняемых в заказе будет указан как revenue-cost.
  
  {% endnote %}

- `currency` — валюта заказа в виде трехбуквенного кода валюты по ISO 4217. Без указания параметра всегда выбраны рубли (RUB).
- `goals` — дополнительные цели заказа. Помимо основной цели, которая выполняется при отправке соответствующего `order_status` заказа (`IN_PROGRESS`, `PAID`, JavaScript-идентификаторы) и доход которой будет указан как revenue-cost, вы можете отправить дополнительные идентификаторы JavaScript-целей с возможностью передачи своего дохода.
  
  {% cut "Пример" %}
  
  Поле goals заказа заполнено как "branch1:15000,oformlenie_analizov,oplata_cash:15000".

  Используются три идентификатора JavaScript-целей счетчика:

  Оплата в первом филиале — `branch1` — на сумму 15000 руб.

  Оформление анализов — `oformlenie_analizov` — без указания суммы. Для этой цели доход будет рассчитан по формуле: revenue-cost, если эти данные заполнены для заказа.

  Оплата наличными — `oplata_cash` — на сумму 15000 руб.
  
  {% endcut %}

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

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