Создать отчёт¶

POST /api/v2/nm-report/downloads

Метод создаёт задание на генерацию отчёта с расширенной аналитикой продавца.

Вы можете создать CSV-версии отчётов по воронке продаж или параметрам поиска с группировкой по: * артикулам WB * предметам, брендам и ярлыкам

В отчётах по воронке продаж можно группировать данные по дням, неделям или месяцам.

Также можете создать CSV-версии отчётов по текстам поисковых запросов и остаткам.

Каждый новый отчёт должен иметь уникальный ID.

Не используйте одинаковые ID для разных отчётов — это может привести к ошибкам при генерации

Набор параметров запроса в объекте params зависит от типа отчёта. Чтобы получить описание параметров, выберите тип отчёта в раскрывающемся списке в описании параметра reportType.

Параметры includeSubstitutedSKUs и includeSearchTexts не могут одновременно иметь значение false.

Если не удалось получить отчёт, можно создать повторное задание на генерацию. Также можно получить список и проверить статусы отчётов.

Отчёты по остаткам — типы STOCK_HISTORY_REPORT_CSV и STOCK_HISTORY_DAILY_CSV — можно создать без подписки Джем

Лимит запросов на один аккаунт продавца:

Тип	Период	Лимит	Интервал	Всплеск
Персональный	1 мин	3 запроса	20 сек	3 запроса
Сервисный	1 мин	3 запроса	20 сек	3 запроса
Базовый с секретом	1 мин	3 запроса	20 сек	3 запроса
Базовый	1 ч	1 запрос	1 ч	1 запрос

Ответ: NmReportCreateReportResponse

Примеры вызова¶

PythonNode.jsGoPHPRust

import os
from wildberries_sdk import analytics

token = os.getenv("WB_API_TOKEN")
api = analytics.DefaultApi(
    analytics.ApiClient(analytics.Configuration(api_key={"HeaderApiKey": token}))
)
result = api.api_v2_nm_report_downloads_post()
print(result)

import { Configuration, CSVApi } from 'wildberries-sdk';

const api = new CSVApi(new Configuration({ apiKey: process.env.WB_API_TOKEN }));
const result = await api.apiV2NmReportDownloadsPost();
console.log(result);

cfg := analytics.NewConfiguration()
cfg.AddDefaultHeader("Authorization", os.Getenv("WB_API_TOKEN"))
client := analytics.NewAPIClient(cfg)
result, _, err := client.CSVAPI.ApiV2NmReportDownloadsPost(context.Background()).Execute()

<?php
$config = Wildberries\Sdk\Analytics\Configuration::getDefaultConfiguration()
    ->setApiKey('Authorization', getenv('WB_API_TOKEN'));
$api = new Wildberries\Sdk\Analytics\Api\CSVApi(new GuzzleHttp\Client(), $config);
$result = $api->apiV2NmReportDownloadsPost();

use wildberries_sdk_analytics::apis::{configuration::Configuration, configuration::ApiKey, csv_api};

let mut config = Configuration::new();
config.api_key = Some(ApiKey { prefix: None, key: std::env::var("WB_API_TOKEN").unwrap() });
let result = csv_api::api_v2_nm_report_downloads_post(&config).await?;