Как получать отчеты

API Маркета позволяет получать отчеты — финансовые и другие:

  • «Аналитика продаж».
  • По бусту продаж.
  • По движению товаров (FBY).
  • По заказам.
  • «Конкурентная позиция».
  • По невыкупам и возвратам.
  • По оборачиваемости (FBY).
  • По отзывам о товарах.
  • По остаткам на складах магазина.
  • По платежам:
    • о платежах за период;
    • о платежном поручении;
    • о баллах Маркета.
  • По полкам.
  • По реализации.
  • По стоимости услуг:
    • по дате начисления услуги;
    • по дате формирования акта.
  • «Цены на рынке».

Генерация отчета занимает время, поэтому получение происходит в два этапа: вначале нужно сделать запрос на генерацию, а потом запрос на готовый отчет.

Как заказать отчет

Сделайте запрос, соответствующий типу нужного отчета. В запросе задайте настройки и фильтры, а также укажите формат, в котором вы хотите получить отчет. Доступные форматы указаны в описании каждого метода.

Вид отчета Как запустить генерацию
«Аналитика продаж» POST reports/shows-sales/generate
по бусту продаж POST reports/boost-consolidated/generate
по движению товаров POST reports/goods-movement/generate
по заказам POST reports/united-orders/generate
«Конкурентная позиция» POST reports/competitors-position/generate
по невыкупам и возвратам POST reports/united-returns/generate
по оборачиваемости POST reports/goods-turnover/generate
по остаткам на складах POST reports/stocks-on-warehouses/generate
по отзывам о товарах POST reports/goods-feedback/generate
по платежам POST reports/united-netting/generate
по полкам POST reports/shelf-statistics/generate
по реализации POST reports/goods-realization/generate
по стоимости услуг POST reports/united-marketplace-services/generate
«Цены на рынке» POST reports/prices/generate

Как узнать, что отчет готов

Сделайте запрос GET reports/info/{reportId}.

Вы получите статус генерации отчета и примерное время, оставшееся до завершения генерации.

Как получить готовый отчет

После того как время на генерацию закончится, повторите запрос GET reports/info/{reportId}. Если сгенерировать отчет удалось, вы получите ссылку на его скачивание.