Перейти к содержанию

Подмены и неверные вложения

GET /api/analytics/v1/deductions

Метод возвращает отчёт об удержаниях за подмены и неверные вложения

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

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

Параметры

Имя Расположение Тип Обязательный Описание
dateFrom query string нет Начало отчётного периода. По умолчанию используются дата и время, когда были впервые получены данные для отчёта
dateTo query string да Конец отчётного периода
sort query string нет Сортировка: - nmId — по артикулу WB - dtBonus — по дате и времени удержания - bonusSumm — по сумме удержания
order query string нет Порядок выдачи: - desc — по убыванию - asc — по возрастанию
limit query integer да Количество удержаний в ответе
offset query integer нет Сколько элементов пропустить. Например, для значения 10 ответ начнётся с 11 элемента

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

import os
from wildberries_sdk import reports

token = os.getenv("WB_API_TOKEN")
api = reports.DefaultApi(
    reports.ApiClient(reports.Configuration(api_key={"HeaderApiKey": token}))
)
result = api.get_deductions(dateTo=..., limit=...)
print(result)
import { Configuration, DefaultApi } from 'wildberries-sdk';

const api = new DefaultApi(new Configuration({ apiKey: process.env.WB_API_TOKEN }));
const result = await api.getDeductions({ ... });
console.log(result);
cfg := reports.NewConfiguration()
cfg.AddDefaultHeader("Authorization", os.Getenv("WB_API_TOKEN"))
client := reports.NewAPIClient(cfg)
result, _, err := client.DefaultApi.GetDeductions(context.Background()).Execute()
<?php
$config = Wildberries\Sdk\Reports\Configuration::getDefaultConfiguration()
    ->setApiKey('Authorization', getenv('WB_API_TOKEN'));
$api = new Wildberries\Sdk\Reports\Api\DefaultApi(new GuzzleHttp\Client(), $config);
$result = $api->getDeductions(..., ...);
use wildberries_sdk_reports::apis::{configuration::Configuration, configuration::ApiKey, default_api};

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