Поиск
API docs by Redocly

Документы и бухгалтерия (finances)

Узнать больше о документах и бухгалтерии можно в справочном центре

Просмотр финансовых отчётов и документов продавца.

Документы и бухгалтерия

Узнать больше о документах и бухгалтерии можно в справочном центре

Просмотр финансовых отчётов и документов продавца.

Финансовые отчёты

Для доступа к методам используйте токен для категории Статистика
Узнать больше о финансовых отчётах можно в справочном центре

Чтобы получить отчёт о продажах по реализации, воспользуйтесь методом загрузки.

Отчёт о продажах по реализации{{ /api/v5/supplier/reportDetailByPeriod }}

Описание метода

Метод предоставляет детализации к еженедельным отчётам реализации.

Данные доступны с 29 января 2024 года.

Вы можете выгрузить данные в Google Таблицы
Максимум 1 запрос в минуту на один аккаунт продавца
Authorizations:
HeaderApiKey
query Parameters
dateFrom
required
string <RFC3339>

Начальная дата отчёта.
Дата в формате RFC3339. Можно передать дату или дату со временем. Время можно указывать с точностью до секунд или миллисекунд.
Время передаётся в часовом поясе Мск (UTC+3).
Примеры:

  • 2019-06-20
  • 2019-06-20T23:59:59
  • 2019-06-20T00:00:00.12345
  • 2017-03-25T00:00:00
limit
integer
Default: 100000

Максимальное количество строк ответа, возвращаемых методом. Не может быть более 100000.

dateTo
required
string <date>

Конечная дата отчёта

rrdid
integer

Уникальный ID строки отчёта. Необходим для получения отчёта частями.
Загрузку отчёта нужно начинать с rrdid = 0 и при последующих вызовах API передавать в запросе значение rrd_id из последней строки, полученной в результате предыдущего вызова.
Таким образом, для загрузки одного отчёта может понадобиться вызывать API до тех пор, пока в ответе не будет отдан пустой массив [].

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Документы

Для доступа к методам используйте токен для категории Документы

С помощью этих методов вы можете получить документы продавца различных категорий: акты, бухгалтерские отчёты, оферты, письма, списки товаров, УКД, УПД, уведомления и так далее.

Для работы с документами получите списки:

  1. Категорий документов
  2. Документов продавца, доступных для загрузки

Вы можете загрузить один или несколько документов из полученного списка.

Категории документов{{ /api/v1/documents/categories }}

Описание метода

Метод предоставляет категории документов для получения списка документов продавца.

Максимум 1 запрос в 10 секунд на один аккаунт продавца
Authorizations:
HeaderApiKey
query Parameters
locale
string
Default: "en"
Example: locale=ru

Язык поля title:

  • ru — русский
  • en — английский
  • zh — китайский

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Список документов{{ /api/v1/documents/list }}

Описание метода

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

Максимум 1 запрос в 10 секунд на один аккаунт продавца
Authorizations:
HeaderApiKey
query Parameters
locale
string
Default: "en"
Example: locale=ru

Язык поля category:

  • ru — русский
  • en — английский
  • zh — китайский
beginTime
string <date>
Example: beginTime=2024-07-09

Начало периода. Только вместе с endTime

endTime
string <date>
Example: endTime=2024-07-15

Конец периода. Только вместе с beginTime

sort
string
Default: "date"
Enum: "date" "category"
Example: sort=category

Сортировка:

  • date — по дате создания документа
  • category — по категории (только при locale=ru)

Только вместе с order

order
string
Default: "desc"
Enum: "desc" "asc"
Example: order=asc

Порядок данных:

  • desc — от поздней даты к ранней, от первой до последней буквы алфавита по названиям категорий
  • asc — от ранней даты к поздней, от последней до первой буквы алфавита по названиям категорий

Только вместе с sort

category
string
Example: category=redeem-notification
serviceName
string
Example: serviceName=redeem-notification-44841941

Уникальный ID документа

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Получить документ{{ /api/v1/documents/download }}

Описание метода

Метод загружает один документ из списка документов продавца.

Максимум 1 запрос в 10 секунд на один аккаунт продавца
Authorizations:
HeaderApiKey
query Parameters
serviceName
required
string
Example: serviceName=redeem-notification-44841941

Уникальный ID документа

extension
required
string
Example: extension=zip

Формат документа

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Получить документы{{ /api/v1/documents/download/all }}

Описание метода

Метод загружает несколько документов из списка документов продавца. Количество документов не ограничено.

Максимум 1 запрос в 5 минут на один аккаунт продавца
Authorizations:
HeaderApiKey
Request Body schema: application/json
Array of objects

Responses

Request samples

Content type
application/json
{
  • "params": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}