Rentu External API v2 (1.0)

Download OpenAPI specification:

Внешнее API Rentu для интеграций торговых центров: выручка, чеки, посещаемость, аномалии, состояние касс, заявки и пропуска портала арендаторов.

Это машиночитаемый справочник методов. Повествовательная документация — как получить доступ, чем отличаются тарифы, что повторять при ошибке — на отдельном сайте документации.

Базовый URL

Среда URL
Production https://api.rentu.ru/api/external/v2
Stage https://stage-api.rentu.ru/api/external/v2

Авторизация

POST /auth/token меняет пару client_id + client_secret на JWT. Токен живёт час и передаётся заголовком Authorization: Bearer <token>. Токены v1 и v2 несовместимы в обе стороны.

Ключ принадлежит сотруднику торгового центра: доступные центры определяются его ролями и проверяются на каждом запросе. Сняли роль — центр пропадает из выдачи, отдельно отзывать ключ не нужно.

Конверт ответа

Успех — {"success": true, "data": ..., "meta": ...}, ошибка — {"success": false, "error": {"code": ..., "message": ..., "details": ...}}.

Ветвитесь по error.code, а не по HTTP-статусу: одному статусу соответствует несколько кодов. Повторять имеет смысл только token_expired (после обновления токена), rate_limited (после Retry-After), rights_unavailable, traffic_unavailable, portal_unavailable, query_timeout и internal_error.

Тарифы

Тариф — свойство торгового центра, а не ключа: один ключ может покрывать несколько центров на разных тарифах.

Basic PRO
Период в одном запросе, подневные данные 31 день 366 дней
Период в одном запросе, месячные итоги 12 месяцев 36 месяцев
Самая свежая дата вчера сегодня
Чеки и аномалии — да
Посещаемость по часам, по зоне и по точке — да
Расчётный товарооборот (turnover) — да
Начисленная аренда (rent) и OCR — да
Заявки и пропуска портала арендаторов да да
Средний чек, выручка на м² — да
Частота 60/мин, 5 000/сутки 300/мин, 50 000/сутки

Заявки и пропуска портала — исключение: они доступны на любом тарифе, и пределы периода и свежести к ним не применяются, период может быть любым. Объём одного ответа там ограничивает per_page, а не тариф. Лимиты частоты действуют наравне с остальными методами.

Форматы

Денежные суммы — целые копейки. Даты в параметрах — YYYY-MM-DD. Моменты времени в ответах — ISO 8601 со смещением таймзоны центра; сама зона приходит в meta.time_zone. Границы суток считаются в таймзоне центра, а не в UTC.

Лимиты частоты

Считаются по торговому центру, а не по ключу: сотрудники одного центра делят общий бюджет запросов. Заводить дополнительные ключи ради скорости бесполезно. На успешных ответах приходят X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset для минутного окна; на 429 — ещё и Retry-After.

Anomalies v2

Anomalies of the shopping centre

Аномалии продаж, найденные системой: те же, что видит менеджер ТЦ. Только тариф PRO. Период задаётся start_date/end_date (до 366 дней), границы суток считаются в таймзоне ТЦ. Фильтры: shop_id, status (new, completed, archived), level (high, medium, low). Сортировка — от свежих к старым. Пагинация page/per_page (по умолчанию 100, максимум 500).

path Parameters
sc_id
string
Example: 6af5aa897ea8b76db3ce5833
header Parameters
Accept
any
Example: application/json

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Attendance submission v2

Submit daily attendance

Приём посещаемости за сутки от собственных счётчиков ТЦ. Доступно на любом тарифе.

Обязательны date и visitors. scope задаёт адресата тем же словарём, что и чтение посещаемости: sc — периметр всего центра (по умолчанию), zone — отдельная зона, и тогда обязателен zone_id из справочника зон. При scope=sc передавать zone_id нельзя.

Дата в будущем отклоняется, граница считается в таймзоне ТЦ. Повторный вызов за те же сутки перезаписывает значение.

В API v1 это были два отдельных метода — по ТЦ и по зоне; здесь они сведены в один.

path Parameters
sc_id
string
Example: 6af5aa8a7ea8b76db3ce5849
header Parameters
Accept
any
Example: application/json
Content-Type
any
Example: application/x-www-form-urlencoded
Request Body schema: application/x-www-form-urlencoded
Schema not provided

Responses

Request samples

Content type
application/x-www-form-urlencoded
date=2026-11-11&visitors=5000

Response samples

Content type
application/json; charset=utf-8
{
  • "success": true,
  • "data": {
    }
}

Attendance v2

Attendance of the shopping centre

Посещаемость по данным системы подсчёта. Период — start_date/end_date по тарифу.

granularity: day (по умолчанию), week, month — Basic; hour — только PRO, и период для него не больше 31 дня. scope: sc (по умолчанию) — Basic; zone (с zone_id из справочника зон) и shop (с shop_id) — только PRO. Неподходящее тарифу значение — 403 plan_required.

Метки периода: дата для day/week/month, время со смещением ТЦ для hour. Если ТЦ или точка не покрыты зонами подсчёта, data пустой — это не ошибка. Если система подсчёта в ТЦ не настроена вовсе — 404 traffic_not_configured; если подсистема подсчёта не ответила — 503 traffic_unavailable, запрос можно повторить.

path Parameters
sc_id
string
Example: 6af5aa8a7ea8b76db3ce584f
header Parameters
Accept
any
Example: application/json

Responses

Response samples

Content type
application/json; charset=utf-8
Example
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Auth v2

Issue access token

Выдача токена по client_credentials (client_id + client_secret выдаются командой Rentu). Токен живёт 1 час, передаётся в заголовке Authorization: Bearer <token>. Токены v2 не работают в v1 и наоборот.

Ключ принадлежит сотруднику ТЦ, и доступ к данным определяется его ролями: отобрали роль — ТЦ пропадает из выдачи, отдельный отзыв ключа не нужен.

Глубина данных зависит от тарифа торгового центра, а не ключа: один ключ может покрывать несколько ТЦ на разных тарифах. Частота запросов тоже считается по ТЦ — сотрудники одного ТЦ делят общий лимит.

header Parameters
Accept
any
Example: application/json
Content-Type
any
Example: application/json
Request Body schema: application/json
Schema not provided

Responses

Request samples

Content type
application/json
{
  • "client_id": "4c6356d0-92f8-4b60-b42a-eda1c33ea40f",
  • "client_secret": "v2-client-secret-000000000000000000000000000000"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "success": true,
  • "access_token": "eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiI0YzYzNTZkMC05MmY4LTRiNjAtYjQyYS1lZGExYzMzZWE0MGYiLCJhdWQiOiJleHRlcm5hbC12MiIsImp0aSI6ImMzNjI2YTgwLTM1MWEtNDcwMi05Nzk5LTAwZWFiZmQyZDJmYSIsImlhdCI6MTc5NDQ4NDg3NCwiZXhwIjoxNzk0NDg4NDc0fQ.5p_jPe4vVBBYIBiDUiC_rM0eYFn9GFi2M4jmpDi_AYIMz04rD4kuqJETs9KUZIhnD_NwKM6xuDuzBPRkInBx1Q",
  • "token_type": "Bearer",
  • "expires_in": 3600
}

Events v2

Register an event of the shopping centre

Приём событий ТЦ — акций, распродаж, ремонтов. Доступно на любом тарифе: за передачу данных нам мы денег не берём.

Обязательны name, description, event_type, start_date, end_date. event_type — calendar, marketing или other; служебные типы платформы снаружи не принимаются. shop_ids — точки, к которым относится событие, проверяются по этому ТЦ. color — HEX вида #RRGGBB, по умолчанию серый; другие записи цвета (rgb(...), имена) не принимаются.

Метод создаёт новое событие. Полный дубль — совпали название, тип и обе даты в рамках ТЦ — отклоняется с 409 already_exists_in_sc. Существующее событие при этом не меняется: чтобы поправить описание или цвет, редактируйте событие в интерфейсе ТЦ.

path Parameters
sc_id
string
Example: 6af5aa8a7ea8b76db3ce5860
header Parameters
Accept
any
Example: application/json
Content-Type
any
Example: application/x-www-form-urlencoded
Request Body schema: application/x-www-form-urlencoded
Schema not provided

Responses

Request samples

Content type
application/x-www-form-urlencoded
name=%D0%A7%D1%91%D1%80%D0%BD%D0%B0%D1%8F+%D0%BF%D1%8F%D1%82%D0%BD%D0%B8%D1%86%D0%B0&description=%D0%A1%D0%BA%D0%B8%D0%B4%D0%BA%D0%B8+%D0%B2%D0%BE+%D0%B2%D1%81%D1%91%D0%BC+%D0%A2%D0%A6&event_type=marketing&start_date=2026-11-12&end_date=2026-11-15&shop_ids[]=6af5aa8a7ea8b76db3ce5862

Response samples

Content type
application/json; charset=utf-8
{
  • "success": true,
  • "data": {
    }
}

Kkts v2

Kkt shifts by days

Подневный отчёт по сменам кассы: суммы по типам оплаты и ставкам НДС в копейках. Только тариф PRO

path Parameters
sc_id
string
Example: 6af5aa8b7ea8b76db3ce5878
shop_id
string
Example: 6af5aa8b7ea8b76db3ce587b
kkt_id
string
Example: 6af5aa8b7ea8b76db3ce5889
query Parameters
start_date
required
string
end_date
required
string
page
integer
per_page
integer
header Parameters
Accept
any
Example: application/json

Responses

Response samples

Content type
application/json; charset=utf-8
Example
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Cash registers of the shop

Кассы торговой точки и признаки их состояния: статус подключения, когда пришёл последний чек, открыта ли смена, когда заканчивается ФН. Даты — ISO 8601 в таймзоне ТЦ, сама зона в meta.time_zone. Пагинации нет — касс у точки единицы. Архивные кассы по умолчанию не отдаются. Чтобы получить их вдобавок к действующим, передайте archived=true; отличать их можно по полю is_archived.

path Parameters
sc_id
string
Example: 6af5aa8d7ea8b76db3ce5955
shop_id
string
Example: 6af5aa8e7ea8b76db3ce5957
header Parameters
Accept
any
Example: application/json

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Portal passes v2

Portal passes registry

Пропуска арендаторов для реестра ЧОПа. Доступны на любом тарифе. Передаётся не больше одной полной пары периода: start_created_date/end_created_date или start_active_date/end_active_date. Active-период выбирает пропуска, срок действия которых пересекается с запрошенным периодом — пропуск, оформленный заранее, по дате создания в смену не попадёт. Пара обязательна, кроме выборки по ticket_uids (до 500 номеров, можно сочетать с периодом). Опциональный фильтр statuses[]. Без фильтра возвращаются все статусы и архивные записи. Номер пропуска — id пропуска в портале арендаторов. author — автор связанной заявки, а для пропуска без заявки — создатель пропуска. Идентификатор автора строковый и совпадает с его id в main. Номера из ticket_uids, которых нет в этом ТЦ, игнорируются: в ответ попадают пропуска только по найденным заявкам. Результат отсортирован от новых пропусков к старым.

path Parameters
sc_id
string
Example: 6af5aa8e7ea8b76db3ce596a
header Parameters
Accept
any
Example: application/json

Responses

Response samples

Content type
application/json; charset=utf-8
Example
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Portal tickets v2

Portal tickets registry

Заявки арендаторов для реестра ЧОПа. Доступны на любом тарифе. Выборка задаётся либо ровно одной полной парой периода (start_created_date/end_created_date или start_active_date/end_active_date), либо списком ticket_uids[] (до 100 номеров). Active-период выбирает заявки, интервалы действия которых пересекаются с запрошенным периодом. Длина периода не ограничена. Неизвестные номера в ticket_uids[] игнорируются — в ответ попадают только найденные заявки. Опциональный фильтр statuses[]. Без фильтра возвращаются все статусы, включая архивные записи. Каждый элемент содержит бизнес-тип заявки (ticket_type с вложенным children либо null), параметры с выбранными значениями, торговую точку, арендатора, автора, дополнительные поля и условия согласования — отдельного запроса за деталями заявки нет. parameters — параметры и их значения; значение, которое пользователь не выбирал, в ответ не попадает, у такого параметра values пустой. custom_fields не содержат файлов и ссылок на них: у файловых полей value всегда null. У option-полей ответ лежит в selected_options. agreement_comments — условия согласования объектами {id, body, created_at}; условия ставят разные отделы, поэтому возвращаются все, а не последнее. Пагинация: page (1), per_page (50, максимум 100). Результат отсортирован от новых заявок к старым.

path Parameters
sc_id
string
Example: 6af5aa8e7ea8b76db3ce5978
header Parameters
Accept
any
Example: application/json

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Receipts v2

Shop receipts

Почековая выгрузка (только тариф PRO). Все суммы — в копейках, даты-время — ISO 8601 с явным смещением таймзоны ТЦ. Требуется полная пара дат: created (start_created_date+end_created_date) и/или received (start_received_date+end_received_date); каждая пара — не больше 30 дней. Пагинация page/per_page (по умолчанию 500, максимум 1000), метаданные в meta.pagination.

document_types — какие типы фискальных документов выгружать, через запятую. По умолчанию только продажи: receipt, delivery, form_of_strict_accountability. Полный список значений — в описании поля document_type; неизвестное значение даёт 422.

path Parameters
sc_id
string
Example: 6af5aa8e7ea8b76db3ce597e
shop_id
string
Example: 6af5aa8e7ea8b76db3ce5980
header Parameters
Accept
any
Example: application/json

Responses

Response samples

Content type
application/json; charset=utf-8
Example
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Renters v2

List renters

Список арендаторов ТЦ с реквизитами и контактами

path Parameters
sc_id
string
Example: 6af5aa8f7ea8b76db3ce59b9
query Parameters
page
integer
per_page
integer
archived
boolean
header Parameters
Accept
any
Example: application/json

Responses

Response samples

Content type
application/json; charset=utf-8
Example
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Reports v2

Shop info by days

Дневные агрегаты торговой точки. Все суммы — в копейках. Пагинация page/per_page (по умолчанию 100, максимум 366), метаданные в meta. Тариф Basic: данные до вчера (D+1), период до 92 дней. Тариф PRO: включая сегодня, период до 366 дней.

path Parameters
sc_id
string
Example: 6af5aa907ea8b76db3ce5a23
shop_id
string
Example: 6af5aa907ea8b76db3ce5a25
header Parameters
Accept
any
Example: application/json

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Shop info by months

Месячные итоги торговой точки: то же, что показывает отчёт ТЦ. Все суммы — в копейках. Границы периода задаются датами start_date/end_date и расширяются до целых месяцев. Пагинации нет: строк не больше, чем месяцев в разрешённом периоде. Тариф Basic: период до 92 дней, данные до вчера (D+1). Тариф PRO: до 366 дней, включая сегодня, и дополнительно поля average_check_sum, revenue_per_area, ocr. Детализация по типам оплат и ставкам НДС — в by_days.

path Parameters
sc_id
string
Example: 6af5aa917ea8b76db3ce5a66
shop_id
string
Example: 6af5aa917ea8b76db3ce5a68
header Parameters
Accept
any
Example: application/json

Responses

Response samples

Content type
application/json; charset=utf-8
Example
{
  • "success": true,
  • "data": [
    ]
}

Shops totals by period

Итоги продаж за период по каждой точке ТЦ с реквизитами арендатора. Суммы в копейках

path Parameters
sc_id
string
Example: 6af5aa927ea8b76db3ce5a8d
query Parameters
start_date
required
string
end_date
required
string
page
integer
per_page
integer
header Parameters
Accept
any
Example: application/json

Responses

Response samples

Content type
application/json; charset=utf-8
Example
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Sensor traffic v2

Submit hourly traffic from a counter

Почасовая выгрузка со стороннего счётчика посещаемости. Доступно на любом тарифе.

Счётчик адресуется своим external_id — тем, под которым он заведён при подключении. Отдельного справочника счётчиков в API нет: идентификатор принадлежит стороне, которая передаёт данные.

data — до 1000 записей за вызов, каждая с datetime (начало часа, ISO 8601), in и out. Повторная присылка того же часа перезаписывает значения.

path Parameters
sc_id
string
Example: 6af5aa977ea8b76db3ce5cd1
external_id
string
Example: gate-1
header Parameters
Accept
any
Example: application/json
Content-Type
any
Example: application/x-www-form-urlencoded
Request Body schema: application/x-www-form-urlencoded
Schema not provided

Responses

Request samples

Content type
application/x-www-form-urlencoded
data[][datetime]=2026-11-11T12%3A00%3A00&data[][in]=120&data[][out]=90&data[][datetime]=2026-11-11T13%3A00%3A00&data[][in]=200&data[][out]=180

Response samples

Content type
application/json; charset=utf-8
{
  • "success": true,
  • "data": {
    }
}

Shopping centers v2

Shopping centres available to the key owner

Точка входа: ТЦ, в которых у владельца ключа есть роль. Отсюда берутся sc_id для всех остальных запросов. Пагинации нет — список ограничен ролями сотрудника. ТЦ, заблокированный по оплате, в списке остаётся, но данные по нему отдают 402. Роли сняли — ТЦ пропадает из списка сам, отдельного отзыва ключа не нужно. Сервис прав недоступен — 503 rights_unavailable, а не пустой список.

header Parameters
Accept
any
Example: application/json

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "success": true,
  • "data": [
    ]
}

Shops v2

Shops of the shopping centre

Используйте id точки как shop_id в запросах отчётов, чеков и касс. В renter входят id, legal_name, inn, kpp и флаг подрядчика is_contractor. Для точки без арендатора получите renter: null.

В position входят id, name, type, площадь area_size в м² и объекты floor/sector с id и name. Типы площадок: island — остров, pavilion — павильон, outdoor — уличная площадка. В floor.name — целочисленное название этажа. Сектор принадлежит ТЦ; у площадки есть связь с этажом и сектором. Для отсутствующей или удалённой площадки получите position: null. Отсутствующий или скрытый этаж/сектор имеет значение null, включая служебные этаж и сектор уличных площадок.

Определяйте фудкорт, якорь и прикассу по is_food_court, is_anchor, is_near_cashbox. Эти boolean-флаги могут сочетаться и не зависят от position.type. Для незаданного признака получите false. Поля external_id, renter.inn и renter.kpp могут содержать null.

Для пагинации передайте page и per_page (по умолчанию 100, максимум 500). Параметры страницы и число точек ищите в meta.pagination. Параметр archived=true включает архивные точки вместе с действующими; проверяйте статус по is_archived.

Параметр renter_id ограничивает список точками арендатора. Используйте его с archived и пагинацией. Для арендатора другого ТЦ или неизвестного ID получите пустой список с HTTP 200.

path Parameters
sc_id
string
Example: 6af5aa977ea8b76db3ce5ce3
header Parameters
Accept
any
Example: application/json

Responses

Response samples

Content type
application/json; charset=utf-8
Example
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Traffic areas v2

Traffic counting areas of the shopping centre

Зоны подсчёта посещаемости ТЦ. Отсюда берётся zone_id для attendance. В shop_ids — торговые точки, попадающие в зону. Пагинации нет — зон у ТЦ единицы. Служебные зоны офисов арендаторов не отдаются. Если в ТЦ система подсчёта не настроена, ответ — 404 traffic_not_configured.

path Parameters
sc_id
string
Example: 6af5aa987ea8b76db3ce5d47
header Parameters
Accept
any
Example: application/json

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "success": true,
  • "data": [
    ]
}

Turnover config v2

Turnover settings applied to the shop

Настройки, по которым посчитан turnover в отчётах: какие типы операций входят в товарооборот и какая доля возвратов из него вычитается. Настройка берётся у точки, если она задана, иначе у ТЦ — источник в поле source (shop, shopping_center или default, если не задана нигде).

path Parameters
sc_id
string
Example: 6af5aa997ea8b76db3ce5d5a
shop_id
string
Example: 6af5aa997ea8b76db3ce5d5d
header Parameters
Accept
any
Example: application/json

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "success": true,
  • "data": {
    }
}

Turnover submission v2

Submit turnover

Приём задекларированного товарооборота точки за месяц. Для арендаторов без подключённой кассы или с данными, которые не доходят через ОФД. Доступно на любом тарифе.

Обязательны month и turnover. month — любая дата внутри месяца, месяц берётся целиком. receipts_count и visitors_count необязательны.

Суммы в копейках. Одноимённый метод API v1 принимал рубли, поэтому при переносе интеграции значение нужно умножить на 100.

Метод идемпотентен по паре «точка + месяц»: повторный вызов за тот же месяц перезаписывает значения, а не добавляет вторую запись. Месяц заводится автоматически, если его ещё нет. Будущий месяц отклоняется, граница считается в таймзоне торговой точки.

Записанное значение возвращается в by_months полем manual_turnover и участвует в расчёте OCR.

path Parameters
sc_id
string
Example: 6af5aa997ea8b76db3ce5d6d
shop_id
string
Example: 6af5aa997ea8b76db3ce5d6f
query Parameters
month
required
string
turnover
required
integer
receipts_count
integer
visitors_count
integer
vat
integer
income_with_vat
integer
income_without_vat
integer
additional_income_with_vat
integer
additional_income_without_vat
integer
refunds_with_vat
integer
refunds_without_vat
integer
header Parameters
Accept
any
Example: application/json
Content-Type
any
Example: application/json
Request Body schema: application/json
Schema not provided

Responses

Request samples

Content type
application/json
Example
{
  • "month": "2026-10-01",
  • "turnover": 500
}

Response samples

Content type
application/json; charset=utf-8
{
  • "success": true,
  • "data": {
    }
}

Weather v2

List weather

Погода по дням для города ТЦ

path Parameters
sc_id
string
Example: 6af5aa9a7ea8b76db3ce5de1
query Parameters
start_date
required
string
end_date
required
string
header Parameters
Accept
any
Example: application/json

Responses

Response samples

Content type
application/json; charset=utf-8
Example
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}