Загрузка заказов (CSV)

Выполняет загрузку заказов.

Данные передаются как multipart/form-data в формате CSV. В первой строке запроса необходимо передать названия колонок. Подробно о формате передаваемых данных

Пример загружаемого файла

Чтобы Метрика обработала информацию о заказах, обязательно передайте данные о клиентах. Метрика привязывает информацию о клиентах к визитам, а данные о заказах — к визитам и клиентам. Это необходимо для расчета и отображения статистики.

Примечание. Для одного клиента можно передать не более 100 000 заказов.

Синтаксис запроса

counterId — идентификатор счетчика, для которого вы хотите загрузить заказы.

https://api-metrika.yandex.net/cdp/api/v1/counter/{counterId}/data/orders
 ? merge_mode=<update_type>
 & [columns_mapping=<string>]
 & [delimiter_type=<delimiter_type>]

merge_mode *

Режим сохранения данных. При любом из значений передавайте все обязательные поля — даже те, которые не меняются.

Допустимые значения:

SAVE — вся ранее переданная информация полностью заменяется новой. Подробно
UPDATE — обновляется только та информация, которую вы загружаете в данный момент. Подробно
APPEND — новая информация добавляется к ранее загруженной. Подробно

columns_mapping Соответствие названий столбцов названиям атрибутов.

delimiter_type

Вид разделителя столбцов в файле.

Значение по умолчанию: COMMA

Допустимые значения:

COMMA — разделитель "запятая"
SEMICOLON — разделитель "точка с запятой"

^* Обязательный параметр

В теле запроса


POST https://api-metrika.yandex.net/cdp/api/v1/counter/2215573/data/orders?
    merge_mode=SAVE&
    columns_mapping=
        "id":"ИД",
        "client_uniq_id":"ИД клиента",
        "client_type":"Тип клиента",
        "order_status":"Статус",
        "create_date_time":"Дата создания",
        "revenue":"Сумма"&
    delimiter_type=COMMA
Content-Type: multipart/form-data; boundary=------------------------7zDUQOAIAE9hEWoV
Context-Length: TBD

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

ИД,ИД клиента,Тип клиента,Статус,Дата создания,Сумма
100,11,CONTACT,paid,2020-06-11 12:30:00,43089.54
101,42,CONTACT,paid,2019-10-11 09:10:00,109999
102,42,CONTACT,created,2020-12-24 12:30:00,1004.17
--------------------------7zDUQOAIAE9hEWoV--

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

POST https://api-metrika.yandex.net/cdp/api/v1/counter/{counterId}/data/orders?merge_mode=SAVE

Формат ответа


{
    "uploading" : {
        "uploading_id" :  < string > ,
        "datetime" :  < local_date_time > ,
        "api_validation_status" :  < api_validation_status > ,
        "elements_count" :  < integer > ,
        "entity_type" :  < entity_type > ,
        "entity_subtype" :  < string > ,
        "uploading_format" :  < uploading_format > ,
        "uploading_source" :  < uploading_source > 
    }
}


Параметры	Описание
uploading	Информация о загрузке
uploading
uploading_id	Идентификатор загрузки
datetime	Время загрузки
api_validation_status	Статус валидации загрузки Возможные значения: PASSED — Валидация прошла успешно FAILED — Валидация прошла не успешно
elements_count	Количество элементов в загрузке
entity_type	Тип сущности Возможные значения: SYSTEM — Системная сущность, например контакты или заказы CUSTOM_LIST — Пользовательский список SYSTEM_LIST — Системный список, например товары
entity_subtype	Подтип сущности
uploading_format	Формат загрузки Возможные значения: JSON — JSON CSV — CSV
uploading_source	Источник загрузки Возможные значения: API — API


Параметры	Описание
uploading	Информация о загрузке
uploading
uploading_id	Идентификатор загрузки
datetime	Время загрузки
api_validation_status	Статус валидации загрузки Возможные значения: PASSED — Валидация прошла успешно FAILED — Валидация прошла не успешно
elements_count	Количество элементов в загрузке
entity_type	Тип сущности Возможные значения: SYSTEM — Системная сущность, например контакты или заказы CUSTOM_LIST — Пользовательский список SYSTEM_LIST — Системный список, например товары
entity_subtype	Подтип сущности
uploading_format	Формат загрузки Возможные значения: JSON — JSON CSV — CSV
uploading_source	Источник загрузки Возможные значения: API — API