для разработчиков На сайт Rentu

Изменения

Что менялось в API и что из этого требует внимания при интеграции.

Что мы считаем совместимым#

Без предупреждения мы можем добавить:

  • новое поле в ответе;
  • новое значение в перечислении, которое возвращается (не принимается);
  • новый необязательный параметр запроса;
  • новый метод.

Разбор ответа на стороне интеграции должен переживать незнакомое поле. Удаление, переименование или смена типа считаются несовместимым изменением, о таком предупредим заранее.

Октябрь 2026. Арендаторы, итоги по всем точкам, кассы по дням и погода#

Четыре новых метода на чтение:

  • GET /sc/{sc_id}/renters — справочник арендаторов центра: реквизиты, юридический адрес, контакты владельца и менеджера;
  • GET /sc/{sc_id}/reports/shops/by_period — итоги продаж за период по каждой точке центра с арендатором в той же строке. Ночная выгрузка всего центра теперь делается одним обходом, а не запросом на каждую точку;
  • GET /sc/{sc_id}/shops/{shop_id}/kkts/{kkt_id}/by_days — дневные суммы отдельной кассы, только на PRO;
  • GET /sc/{sc_id}/weather — погода по дням в городе центра. Новый код ошибки city_not_configured, если город центру не задан.

Изменения в существующих методах, все обратно совместимые:

  • в GET /sc/{sc_id}/shops появился фильтр renter_id;
  • POST /sc/{sc_id}/shops/{shop_id}/turnover принимает разбивку по НДС: выручку, дополнительную выручку и возвраты с НДС и без, сумму НДС. Ответ возвращает её вместе с оборотом;
  • в GET /sc/{sc_id}/shops/{shop_id}/receipts kkt_fiscal_drive_number берётся из самого чека: после замены ФН у старых чеков остаётся прежний номер. Чеки с одинаковым временем упорядочены по id, и граница страницы между ними больше не плавает.

Сентябрь 2026. Арендатор в списке торговых точек#

Из GET /sc/{sc_id}/shops до сих пор нельзя было узнать, кто арендует помещение: в ответе были только название точки и её положение в центре. Теперь у каждой точки есть объект renter:

  • id, legal_name, inn, kpp: реквизиты юрлица;
  • is_contractor: арендатор оформлен как подрядчик.

Старые поля остались прежними, существующие интеграции продолжают работать.

Сентябрь 2026. Заявки и пропуска портала#

Два метода на чтение данных портала арендаторов, доступны на любом тарифе:

Тарифные пределы периода и свежести к ним не применяются. При недоступности портала приходит 503 portal_unavailable — запрос можно повторить.

Август 2026. Запуск обновлённого External API v2#

Первый публичный релиз второй версии API. Ключевое:

  • доступ от лица сотрудника: ключ выдаётся человеку, права и список доступных центров определяются его ролями на каждом запросе;
  • тариф закреплён за торговым центром — Basic и PRO, состав в разделе Тарифы;
  • методы на чтение и на запись: продажи, чеки с позициями, посещаемость, кассы, аномалии, сдача товарооборота и передача посещаемости.

Для интеграций с API v1 версии несовместимы: токены различаются в обе стороны, все суммы в v2 приходят и принимаются в копейках, методы и форматы ответов другие. Маршрут переезда описан в разделах Авторизация и Все методы.