---
title: "Отчёт продаж за период"
method: GET
path: "/api/v1/crm/analytics/report"
tags: ["CRM analytics"]
---

# Отчёт продаж за период

`GET /api/v1/crm/analytics/report`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/crm/analytics/report`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Итоги периода и сравнение с прошлым, срезы по менеджерам, отделам, каналам продаж, источникам и воронкам, воронка этапов (конверсия и дни на этапе), рекламные кампании с окупаемостью, прогноз и причины проигрыша. Цифры - только по записям, которые смотрящий видит по правилу роли (свои, отдела или все).

## Query parameters

- `from` string, date
- `to` string, date
- `tz` string
- `compare` boolean
- `pipeline_id` string, uuid
- `owner_id` integer
- `department_id` string, uuid
- `source` string
- `channel` 'manual' | 'webchat' | 'phone' | 'email' | 'telegram' | 'whatsapp' | 'vk' | 'max' | 'instagram' | 'avito' | 'other'

## Response `200`

Отчёт за период

- CRMAnalyticsReport: Отчёт продаж за период. Суммы складываются без пересчёта валют
  - `period` CRMReportPeriod, required: Период отчёта, даты включительно
    - `from` string, date, required
    - `to` string, date, required
  - `timezone` string, required
  - `previous` CRMReportPeriod: Период отчёта, даты включительно
    - `from` string, date, required
    - `to` string, date, required
  - `summary` CRMReportTotals, required: Итоги периода
    - `leads` integer, required: Лиды, заведённые в периоде
    - `converted_leads` integer, required: Из них уже стали сделками
    - `lead_conversion` number, required: Доля лидов, ставших сделками (0..1)
    - `deals_created` integer, required: Сделки, заведённые в периоде
    - `deals_won` integer, required: Сделки, выигранные в периоде (по дате закрытия)
    - `deals_lost` integer, required: Сделки, проигранные в периоде
    - `won_amount` string, required: Сумма выигранных: «19990.50»; валюты не пересчитываются
    - `lost_amount` string, required: Сумма проигранных: «19990.50»
    - `average_deal` string, required: Средний чек выигранной сделки: «19990.50»
    - `win_rate` number, required: Доля выигранных среди закрытых (0..1)
    - `avg_cycle_days` number, required: Средний срок выигранной сделки от создания до закрытия, дней
    - `plan_amount` string: План продаж на период - доля месячных планов по дням. Есть у итогов, менеджеров и отделов
  - `previous_summary` CRMReportTotals: Итоги периода
    - `leads` integer, required: Лиды, заведённые в периоде
    - `converted_leads` integer, required: Из них уже стали сделками
    - `lead_conversion` number, required: Доля лидов, ставших сделками (0..1)
    - `deals_created` integer, required: Сделки, заведённые в периоде
    - `deals_won` integer, required: Сделки, выигранные в периоде (по дате закрытия)
    - `deals_lost` integer, required: Сделки, проигранные в периоде
    - `won_amount` string, required: Сумма выигранных: «19990.50»; валюты не пересчитываются
    - `lost_amount` string, required: Сумма проигранных: «19990.50»
    - `average_deal` string, required: Средний чек выигранной сделки: «19990.50»
    - `win_rate` number, required: Доля выигранных среди закрытых (0..1)
    - `avg_cycle_days` number, required: Средний срок выигранной сделки от создания до закрытия, дней
    - `plan_amount` string: План продаж на период - доля месячных планов по дням. Есть у итогов, менеджеров и отделов
  - `managers` CRMReportRow[], required
    - `key` string, required
    - `name` string, required: Имя; у канала пусто - подпись берёт экран по коду
    - `label_key` string: Ключ подписи стартовой воронки
    - `leads` integer, required: Лиды, заведённые в периоде
    - `converted_leads` integer, required: Из них уже стали сделками
    - `lead_conversion` number, required: Доля лидов, ставших сделками (0..1)
    - `deals_created` integer, required: Сделки, заведённые в периоде
    - `deals_won` integer, required: Сделки, выигранные в периоде (по дате закрытия)
    - `deals_lost` integer, required: Сделки, проигранные в периоде
    - `won_amount` string, required: Сумма выигранных: «19990.50»; валюты не пересчитываются
    - `lost_amount` string, required: Сумма проигранных: «19990.50»
    - `average_deal` string, required: Средний чек выигранной сделки: «19990.50»
    - `win_rate` number, required: Доля выигранных среди закрытых (0..1)
    - `avg_cycle_days` number, required: Средний срок выигранной сделки от создания до закрытия, дней
    - `plan_amount` string: План продаж на период - доля месячных планов по дням. Есть у итогов, менеджеров и отделов
    - `previous_leads` integer: Лиды в прошлом периоде (при compare)
    - `previous_deals_won` integer: Выиграно в прошлом периоде (при compare)
    - `previous_won_amount` string: Сумма выигранных в прошлом периоде (при compare)
  - `departments` CRMReportRow[], required
    - `key` string, required
    - `name` string, required: Имя; у канала пусто - подпись берёт экран по коду
    - `label_key` string: Ключ подписи стартовой воронки
    - `leads` integer, required: Лиды, заведённые в периоде
    - `converted_leads` integer, required: Из них уже стали сделками
    - `lead_conversion` number, required: Доля лидов, ставших сделками (0..1)
    - `deals_created` integer, required: Сделки, заведённые в периоде
    - `deals_won` integer, required: Сделки, выигранные в периоде (по дате закрытия)
    - `deals_lost` integer, required: Сделки, проигранные в периоде
    - `won_amount` string, required: Сумма выигранных: «19990.50»; валюты не пересчитываются
    - `lost_amount` string, required: Сумма проигранных: «19990.50»
    - `average_deal` string, required: Средний чек выигранной сделки: «19990.50»
    - `win_rate` number, required: Доля выигранных среди закрытых (0..1)
    - `avg_cycle_days` number, required: Средний срок выигранной сделки от создания до закрытия, дней
    - `plan_amount` string: План продаж на период - доля месячных планов по дням. Есть у итогов, менеджеров и отделов
    - `previous_leads` integer: Лиды в прошлом периоде (при compare)
    - `previous_deals_won` integer: Выиграно в прошлом периоде (при compare)
    - `previous_won_amount` string: Сумма выигранных в прошлом периоде (при compare)
  - `channels` CRMReportRow[], required
    - `key` string, required
    - `name` string, required: Имя; у канала пусто - подпись берёт экран по коду
    - `label_key` string: Ключ подписи стартовой воронки
    - `leads` integer, required: Лиды, заведённые в периоде
    - `converted_leads` integer, required: Из них уже стали сделками
    - `lead_conversion` number, required: Доля лидов, ставших сделками (0..1)
    - `deals_created` integer, required: Сделки, заведённые в периоде
    - `deals_won` integer, required: Сделки, выигранные в периоде (по дате закрытия)
    - `deals_lost` integer, required: Сделки, проигранные в периоде
    - `won_amount` string, required: Сумма выигранных: «19990.50»; валюты не пересчитываются
    - `lost_amount` string, required: Сумма проигранных: «19990.50»
    - `average_deal` string, required: Средний чек выигранной сделки: «19990.50»
    - `win_rate` number, required: Доля выигранных среди закрытых (0..1)
    - `avg_cycle_days` number, required: Средний срок выигранной сделки от создания до закрытия, дней
    - `plan_amount` string: План продаж на период - доля месячных планов по дням. Есть у итогов, менеджеров и отделов
    - `previous_leads` integer: Лиды в прошлом периоде (при compare)
    - `previous_deals_won` integer: Выиграно в прошлом периоде (при compare)
    - `previous_won_amount` string: Сумма выигранных в прошлом периоде (при compare)
  - `sources` CRMReportRow[], required
    - `key` string, required
    - `name` string, required: Имя; у канала пусто - подпись берёт экран по коду
    - `label_key` string: Ключ подписи стартовой воронки
    - `leads` integer, required: Лиды, заведённые в периоде
    - `converted_leads` integer, required: Из них уже стали сделками
    - `lead_conversion` number, required: Доля лидов, ставших сделками (0..1)
    - `deals_created` integer, required: Сделки, заведённые в периоде
    - `deals_won` integer, required: Сделки, выигранные в периоде (по дате закрытия)
    - `deals_lost` integer, required: Сделки, проигранные в периоде
    - `won_amount` string, required: Сумма выигранных: «19990.50»; валюты не пересчитываются
    - `lost_amount` string, required: Сумма проигранных: «19990.50»
    - `average_deal` string, required: Средний чек выигранной сделки: «19990.50»
    - `win_rate` number, required: Доля выигранных среди закрытых (0..1)
    - `avg_cycle_days` number, required: Средний срок выигранной сделки от создания до закрытия, дней
    - `plan_amount` string: План продаж на период - доля месячных планов по дням. Есть у итогов, менеджеров и отделов
    - `previous_leads` integer: Лиды в прошлом периоде (при compare)
    - `previous_deals_won` integer: Выиграно в прошлом периоде (при compare)
    - `previous_won_amount` string: Сумма выигранных в прошлом периоде (при compare)
  - `pipelines` CRMReportRow[], required
    - `key` string, required
    - `name` string, required: Имя; у канала пусто - подпись берёт экран по коду
    - `label_key` string: Ключ подписи стартовой воронки
    - `leads` integer, required: Лиды, заведённые в периоде
    - `converted_leads` integer, required: Из них уже стали сделками
    - `lead_conversion` number, required: Доля лидов, ставших сделками (0..1)
    - `deals_created` integer, required: Сделки, заведённые в периоде
    - `deals_won` integer, required: Сделки, выигранные в периоде (по дате закрытия)
    - `deals_lost` integer, required: Сделки, проигранные в периоде
    - `won_amount` string, required: Сумма выигранных: «19990.50»; валюты не пересчитываются
    - `lost_amount` string, required: Сумма проигранных: «19990.50»
    - `average_deal` string, required: Средний чек выигранной сделки: «19990.50»
    - `win_rate` number, required: Доля выигранных среди закрытых (0..1)
    - `avg_cycle_days` number, required: Средний срок выигранной сделки от создания до закрытия, дней
    - `plan_amount` string: План продаж на период - доля месячных планов по дням. Есть у итогов, менеджеров и отделов
    - `previous_leads` integer: Лиды в прошлом периоде (при compare)
    - `previous_deals_won` integer: Выиграно в прошлом периоде (при compare)
    - `previous_won_amount` string: Сумма выигранных в прошлом периоде (при compare)
  - `campaigns` CRMCampaignRow[], required
    - `campaign` string, required
    - `leads` integer, required
    - `converted_leads` integer, required
    - `deals_won` integer, required
    - `won_amount` string, required: Выручка - сумма выигранных в периоде: «19990.50»
    - `cost` string, required: Расход на период - доля месячных расходов по дням: «19990.50»
    - `cost_per_lead` string: Цена лида: расход / лиды
    - `roi` number: Окупаемость: (выручка - расход) / расход; нет расхода - нет поля
  - `funnel` CRMReportFunnel, required: Воронка этапов отчёта
    - `pipeline_id` string, required: Воронка этапов; пусто - в кабинете нет воронок
    - `pipeline_name` string, required
    - `pipeline_label_key` string
    - `deals` integer, required: Сделки воронки, заведённые в периоде
    - `stages` CRMFunnelStage[], required
      - `stage_id` string, uuid, required
      - `name` string, required
      - `label_key` string
      - `category` 'open' | 'won', required
      - `reached` integer, required: Дошли до этапа или дальше (пропуск этапа - не потеря)
      - `current` integer, required: Сейчас стоят на этапе
      - `lost` integer, required: Проиграны с этого этапа
      - `to_next` number: Доля дошедших до следующего этапа (0..1)
      - `avg_hours` number: Сколько часов в среднем сделка стоит на этапе (по уходам с этапа в периоде)
  - `forecast` CRMReportForecast, required: Открытые сделки с ожидаемой датой закрытия в периоде
    - `deals` integer, required
    - `amount` string, required: Сумма десятичной строкой: «19990.50»
    - `weighted` string, required: С учётом вероятности этапа: «19990.50»
    - `without_date` integer, required: Открытые сделки без ожидаемой даты закрытия - прогноз их не видит
  - `loss_reasons` CRMLossReasonMetric[], required
    - `id` string
    - `name` string, required
    - `count` integer, required
    - `amount` string, required: Сумма десятичной строкой: «19990.50». Разрядность берёт валюта (MONEY-ROUNDING.md)

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/a99574d597cc?raw)