Аномалии продаж

GET /api/external/v2/sc/{sc_id}/anomalies PRO

Параметры#

Имя	Тип	Обяз.	По умолчанию	Значения
`sc_id`	string, в пути	да	—	Идентификатор центра
`start_date`	date	да	—	`YYYY-MM-DD`
`end_date`	date	да	—	`YYYY-MM-DD`, не раньше `start_date`
`shop_id`	string	нет	—	Фильтр по точке этого центра
`status`	string	нет	—	`new`, `completed`, `archived`
`level`	string	нет	—	`high`, `medium`, `low`
`page`	integer	нет	`1`	Номер страницы
`per_page`	integer	нет	`100`	Размер страницы, от 1 до 500

Сортировка идёт от свежих к старым. Метод доступен только на PRO, поэтому окно периода составляет 366 дней и сегодняшний день разрешён.

Ответ#

Поле	Тип	Описание
`id`	string	Идентификатор аномалии
`date`	string	Дата, к которой относится аномалия
`created_at`	string	Когда платформа её обнаружила
`type`	integer \| null	Код типа
`type_title`	string \| null	Название типа
`level`	string \| null	`high`, `medium`, `low`
`magnitude`	number \| null	Величина отклонения
`status`	string	`new`, `completed`, `archived`
`shop_id`	string \| null	Торговая точка
`shop_name`	string \| null	Её название
`title`	string \| null	Краткая формулировка
`description`	string \| null	Развёрнутое описание
`period`	array of string	Период, за который найдено отклонение

Все даты приходят в ISO 8601 со смещением зоны центра.

json

{
  "success": true,
  "data": [
    {
      "id": "66a1000000000000000000f1",
      "date": "2026-07-29T00:00:00+03:00",
      "created_at": "2026-07-30T04:15:03+03:00",
      "type": 12,
      "type_title": "Резкое падение выручки",
      "level": "high",
      "magnitude": -0.62,
      "status": "new",
      "shop_id": "6512a2000000000000000101",
      "shop_name": "Zarina",
      "title": "Выручка ниже обычной",
      "description": "Выручка за 29 июля на 62% ниже медианы за 4 недели",
      "period": [
        "2026-07-29T00:00:00+03:00",
        "2026-07-29T23:59:59+03:00"
      ]
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "per_page": 100,
      "total": 1
    },
    "time_zone": "Europe/Moscow"
  }
}

Практика#

date и created_at означают разное. Первое это день, в котором нашлось отклонение, второе момент, когда платформа его обнаружила. Аномалия за вчера может появиться сегодня утром, поэтому для инкрементальной выгрузки удобнее фильтровать период по датам и перезабирать последние несколько дней.

status отражает работу с аномалией в интерфейсе Rentu. Статус new значит, что аномалию ещё никто не разбирал. Если на стороне интеграции строится своя очередь разбора, стоит ориентироваться на этот статус.

Ошибки#

Код	HTTP	Когда
`plan_required`	403	Центр не на PRO
`not_found`	404	Точка не найдена или принадлежит другому центру
`period_too_long`	422	Период больше 366 дней
`validation_error`	422	Неизвестный `status` или `level`, `per_page` больше 500, `end_date` раньше `start_date`