---
metadata:
  - name: generator
    content: Diplodoc Platform v5.48.2
alternate:
  - https://yandex.com.tr/dev/metrika/en/management/openapi/schema/uploadSimpleOrders.md
  - https://yandex.com.tr/dev/metrika/ru/management/openapi/schema/uploadSimpleOrders.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/metrika/ru/llms.txt

<!-- source: ru/management-src/Upravlenie-dannymi-o-klientah-i-zakazah-iz-CRM/uploadSimpleOrders.md -->
<div class="openapi">

# Загрузка упрощенных данных о клиентах и заказах (CSV)

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

Упрощенный метод помогает отправлять в Метрику информацию о заказах и клиентах в CSV-файле без дополнительных настроек ([сопоставления статусов заказов](https://yandex.com.tr/dev/metrika/ru/data-import/maporderstatuses-about.md), загрузки отдельных списков [клиентов](https://yandex.com.tr/dev/metrika/ru/data-import/contacts-data.md) и [заказов](https://yandex.com.tr/dev/metrika/ru/data-import/orders-data.md), загрузки [списка товаров](https://yandex.com.tr/dev/metrika/ru/management-src/Upravlenie-dannymi-o-klientah-i-zakazah-iz-CRM/createProducts.md) и [дополнительных атрибутов](https://yandex.com.tr/dev/metrika/ru/management-src/Upravlenie-dannymi-o-klientah-i-zakazah-iz-CRM/createAttributes.md)). Для сбора статистики достаточно передавать дату и время создания заказа в часовом поясе счетчика (`create_date_time`) и один из параметров клиентов ([ClientID](https://yandex.ru/support/metrica/objects/get-client-id.html), номер телефона или адрес электронной почты, хеши телефона или почты). Вы можете передавать заказы в разных статусах с данными о выручке и себестоимости.

Отправленная информация учитывается в отчетах [Сквозной аналитики](https://yandex.com.tr/dev/metrika/ru/stat/presets/preset_cdp_orders.md). Кроме этого, вы можете использовать данные для ретаргетинга и оптимизации конверсий в Директе.

[Подробно о формате передаваемых данных](https://yandex.com.tr/dev/metrika/ru/data-import/simple-orders-data.md)

{% note info %}

Ограничение на размер файла — 1 Гб.

{% endnote %}

{% cut "Примеры загружаемого файла" %}

- [Загрузка данных по ClientID](https://download.cdn.yandex.net/from/yandex.ru/support/ru/metrica/files/simple_orders_client_ids.csv). Рекомендуем использовать этот тип идентификатора, так как он обеспечивает более точную привязку загруженных данных с информацией о посетителях сайта в Метрике.
- [Загрузка данных по адресам электронной почты](https://download.cdn.yandex.net/from/yandex.ru/support/ru/metrica/files/simple_orders_emails.csv).
- [Загрузка данных по номерам телефонов](https://download.cdn.yandex.net/from/yandex.ru/support/ru/metrica/files/simple_orders_phones.csv).
- [Загрузка в одном файле разных идентификаторов](https://download.cdn.yandex.net/from/yandex.ru/support/ru/metrica/files/simple_orders_full.csv).

{% endcut %}

При отправке данных о заказах в параметре `merge_mode` передавайте значение, соответствующее состоянию загружаемых заказов. Если при повторной отправке данных вы не уверены, какой именно статус нужно передавать, укажите значение `SAVE`.

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

```http translate=no
POST https://api-metrika.yandex.net/cdp/api/v1/counter/2215573/data/simple_orders?merge_mode=SAVE&delimiter_type=COMMA
Content-Disposition: form-data; name="file"; filename="data.csv"
Content-Type: multipart/form-data; boundary=------------------------7zDUQOAIAE9hEWoV
Context-Length: TBD

--------------------------7zDUQOAIAE9hEWoV
Content-Disposition: form-data; name="file"; filename="data.csv"
Content-Type: text/csv

id,create_date_time,client_uniq_id,client_ids,emails,phones,order_status,revenue,cost,goals,currency
s_ord1,10.01.2024 11:56,s_user1,,"mail@example.com,mail2@example.com",,PAID,200,150,"oplata_cash:200,filial_1",
s_ord2,20.01.2024 11:59,,12345,mail3@example.com,,,200,150,,EUR
,12.02.2024,,34456,,79876543210,SPAM,,,plohoy_lead,
--------------------------7zDUQOAIAE9hEWoV--
```

{% cut "Разберем пример отправки" %}

В примере мы отправили три заказа:

#### Заказ с id s_ord1

- **Дата заказа**: 10.01.2024 11:56
- **Идентификатор клиента в CRM**: `s_user1`
- **Почты клиента**: mail@example.com, mail2@example.com
- **ClientID и телефоны**: отсутствуют
- **Статус заказа**: `PAID` (будет достигнуты цели **CRM – Заказ Создан** + **CRM – Заказ Оплачен**)
- **Доход**: 200
- **Себестоимость**: 150 (в целях будет указан доход в 50)
- **Дополнительно отправлены javascript-цели**:
     - `oplata_cash` с доходом в 200
     - `filial_1` без дохода (доход по цели будет использован из основных колонок заказа, а именно 200-150=50)
- **Валюта**: не указана (все доходы будут в рублях)

#### Заказ с id s_ord2

- **Дата заказа**: 20.01.2024 11:59
- **Идентификатор клиента в CRM**: не передан
- **Почта клиента**: mail3@example.com
- **ClientID**: 12345
- **Телефоны**: отсутствуют
- **Статус заказа**: не передан (по умолчанию будет отправлен `PAID`, достигнуты цели: **CRM – Заказ Создан** + **CRM – Заказ Оплачен**)
- **Доход**: 200
- **Себестоимость**: 150 (в целях будет указан доход в 50)
- **Дополнительные цели**: отсутствуют
- **Валюта**: EUR (все доходы будут в евро)

#### Заказ без id

- **Дата заказа**: 12.02.2024 (без указания часов/минут — Метрика будет искать для привязки заказа визиты в прошлом, начиная с 12.02.2024 23:59)
- **Идентификатор клиента в CRM**: не передан
- **Почта клиента**: mail3@example.com
- **ClientID**: 34456
- **Телефон**: 79876543210
- **Статус заказа**: `SPAM` (цели не будут достигнуты)
- **Доход и себестоимость**: не указаны
- **Дополнительно отправлена javascript-цель**:
     - `plohoy_lead` — будет достигнута без дохода
- **Валюта**: не указана

{% endcut %}


## 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
https://api-metrika.yandex.net/cdp/api/v1/counter/{counterId}/data/simple_orders
```

</div>

</div>

</div>

### Path parameters

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

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

Идентификатор счетчика, для которого вы хотите загрузить заказы.
{.table-cell}
||
|#{.json-schema-properties}

### Query parameters

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

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

Режим сохранения данных. При любом из значений передавайте все [обязательные поля](https://yandex.com.tr/dev/metrika/ru/data-import/orders-data.md) — даже те, которые не меняются.

- `SAVE` — вся ранее переданная информация полностью заменяется новой. [Подробно](https://yandex.com.tr/dev/metrika/ru/data-import/modes.md).
- `UPDATE` – обновляется только та информация, которую вы загружаете в данный момент. [Подробно](https://yandex.com.tr/dev/metrika/ru/data-import/modes.md).
- `APPEND` — новая информация добавляется к ранее загруженной. [Подробно](https://yandex.com.tr/dev/metrika/ru/data-import/modes.md).


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

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

Вид разделителя столбцов в файле:
- `COMMA` — разделитель "запятая".
- `SEMICOLON` — разделитель "точка с запятой".


_Default:_{.json-schema-reset .json-schema-value} `COMMA`

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

<div class="openapi-entity">

### Body

{% cut "multipart/form-data" %}

```json translate=no
{
  "file": "example"
}
```

{% endcut %}

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

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

Ограничение на размер файла — 1 Гб.

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

</div>

## Responses

<div class="openapi__response__code__200">

## 200 OK

OK

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "uploading": {
    "uploading_id": "example",
    "datetime": "2020-04-21 11:59:21",
    "api_validation_status": "example",
    "elements_count": 0,
    "entity_type": "example",
    "uploading_format": "example",
    "uploading_source": "example"
  }
}
```

{% endcut %}

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

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

Информация о загрузке

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

```json translate=no
{
  "uploading_id": "example",
  "datetime": "2020-04-21 11:59:21",
  "api_validation_status": "example",
  "elements_count": 0,
  "entity_type": "example",
  "uploading_format": "example",
  "uploading_source": "example"
}
```

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

</div>

<div class="openapi-entity">

### UploadingMetaExternal {#entity-UploadingMetaExternal}

Информация о загрузке

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

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

Статус валидации загрузки:
- `PASSED` — валидация прошла успешно.
- `FAILED` — валидация прошла не успешно.


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

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

Время загрузки.

_Example:_{.json-schema-reset .json-schema-example} `2020-04-21 11:59:21`
{.table-cell}
||
||

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

Количество элементов в загрузке.
{.table-cell}
||
||

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

Тип сущности:
- `SYSTEM` — системная сущность, например, контакты или заказы.
- `CUSTOM_LIST` — пользовательский список.
- `SYSTEM_LIST` — системный список, например товары.


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

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

Формат загрузки. Возможные значения:
- `JSON`.
- `CSV`.


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

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

Идентификатор загрузки.

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

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

Источник загрузки. Возможные значения: `API`.

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

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

```json translate=no
{
  "uploading_id": "example",
  "datetime": "2020-04-21 11:59:21",
  "api_validation_status": "example",
  "elements_count": 0,
  "entity_type": "example",
  "uploading_format": "example",
  "uploading_source": "example"
}
```

{% endcut %}

</div>

</div>

</div>
<!-- endsource: ru/management-src/Upravlenie-dannymi-o-klientah-i-zakazah-iz-CRM/uploadSimpleOrders.md -->

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