Что мы считаем совместимым#
Без предупреждения мы можем добавить:
- новое поле в ответе;
- новое значение в перечислении, которое возвращается (не принимается);
- новый необязательный параметр запроса;
- новый метод.
Разбор ответа на стороне интеграции должен переживать незнакомое поле. Удаление, переименование или смена типа считаются несовместимым изменением, о таком предупредим заранее.
Сентябрь 2026. Арендатор в списке торговых точек#
Из GET /sc/{sc_id}/shops до сих пор нельзя было
узнать, кто арендует помещение: в ответе были только название точки и её
положение в центре. Теперь у каждой точки есть объект renter:
id,legal_name,inn,kpp: реквизиты юрлица;is_contractor: арендатор оформлен как подрядчик.
Старые поля остались прежними, существующие интеграции продолжают работать.
Сентябрь 2026. Заявки и пропуска портала#
Два метода на чтение данных портала арендаторов, доступны на любом тарифе:
GET /sc/{sc_id}/portal/tickets— заявки;GET /sc/{sc_id}/portal/passes— пропуска.
Тарифные пределы периода и свежести к ним не применяются. При недоступности
портала приходит 503 portal_unavailable — запрос можно повторить.
Август 2026. Запуск обновлённого External API v2#
Первый публичный релиз второй версии API. Ключевое:
- доступ от лица сотрудника: ключ выдаётся человеку, права и список доступных центров определяются его ролями на каждом запросе;
- тариф закреплён за торговым центром — Basic и PRO, состав в разделе Тарифы;
- методы на чтение и на запись: продажи, чеки с позициями, посещаемость, кассы, аномалии, сдача товарооборота и передача посещаемости.
Для интеграций с API v1 версии несовместимы: токены различаются в обе стороны, все суммы в v2 приходят и принимаются в копейках, методы и форматы ответов другие. Маршрут переезда описан в разделах Авторизация и Все методы.