iikoCloud API: адрес legacy в заказах доставки не примут с 1 октября 2026 - как проверить интеграцию

С 1 октября 2026 года iiko прекращает поддержку формата адреса legacy в методе deliveries/create iikoCloud API. После этой даты заказ доставки с адресом legacy не примут: в ответ на запрос придёт ошибка. Если заказы доставки попадают в iiko с сайта, из приложения или другого сервиса через API, проверьте формат адреса до 1 октября и переведите интеграцию на формат City.

Чем отличаются форматы адреса legacy и City?

При создании заказа доставки адрес передаётся в поле deliveryPoint.address, а формат задаёт параметр type: legacy или city.

Формат legacy:

• улица - объект street: из справочника iiko по id или classifierId либо название вместе с городом;
• дом - поле house, обязательное;
• корпус и индекс - поля building и index;
• квартира, подъезд, этаж, домофон - flat, entrance, floor, doorphone;
• зона доставки - regionId.

Формат City:

• адрес строкой - поле line1, обязательное, до 250 символов; отдельных полей для улицы, дома, корпуса и индекса нет;
• квартира, подъезд, этаж, домофон - те же поля flat, entrance, floor, doorphone;
• зона доставки - regionId.

Главное отличие: в legacy адрес собирается из улицы (из справочника iiko или названием вместе с городом) и дома, а в City основная часть адреса уходит одной строкой. Координаты и комментарий к адресу передаются в deliveryPoint одинаково для обоих форматов.

Кого касается отключение формата legacy?

Тех, у кого заказы доставки создаются в iiko через iikoCloud API:

• собственный сайт доставки;
• мобильное приложение;
• другой сервис, который отправляет заказы доставки в iiko через API.

Уведомление iiko относится к запросам через Cloud API. Если заказы доставки не создаются через iikoCloud API, изменение вас не касается. При сомнениях уточните у разработчика интеграции.

Как проверить интеграцию до 1 октября?

Шаг 1. Узнайте формат адреса организации

Формат адреса хранится у организации в iiko, в API это параметр addressFormatType. Его возвращает запрос /api/1/organizations/settings, если указать AddressFormatType в массиве parameters, или POST-запрос /api/1/organizations с returnAdditionalInfo: true. Возможные значения: Legacy, City, International, IntNoPostcode.

Шаг 2. Посмотрите, что уходит при создании заказа

Попросите разработчика найти в коде или журнале запросов поле deliveryPoint.address.type. Значение legacy означает, что интеграцию нужно переводить.

Шаг 3. Сведите формат организации и формат заказа

По документации iikoCloud API тип city в заказе допустим, только если у организации addressFormatType равен City. Если у организации стоит Legacy, формат нужно сменить: порядок уточните у своей обслуживающей организации.

Шаг 4. Сверьте версию iiko

В канале iiko для разработчиков указано, что новый формат адреса доступен с версии RMS 9.1.7. Версию возвращает запрос /api/1/organizations/settings, если указать Version в массиве parameters.

Шаг 5. Отправьте тестовый заказ

После перехода проверьте на тестовом заказе, что в iiko пришли адрес, квартира, подъезд, этаж и домофон, что заказ попал в нужную зону доставки и что курьер видит адрес так, как его ввёл гость.

Что ещё изменилось в iikoCloud API в 2026 году?

• Справочник улиц. С 10 февраля 2026 года iiko не обновляет через Cloud API справочники улиц и районов: метод /streets/by_city отдаёт данные на 9 февраля. Новые клиенты улицы из API не получают и сразу создают доставки в новом формате адреса.
• Авторизация. Старая схема авторизации API с 1 июня 2026 года не принимает новые ключи, а с 29 августа 2026 года, по объявлению iiko, полностью отключена.
• Номенклатура. С 1 ноября 2026 года iiko прекращает поддержку метода /api/1/nomenclature: запросы к нему будут возвращать ошибку, iiko предлагает перейти на метод /api/2/menu.

Как Restohub поможет с переходом?

Если интеграцию делали мы, напишите своему менеджеру: проверим формат адреса и обновим интеграцию. Если интеграцию делал другой разработчик, поможем проверить настройки организации и тестовые заказы. Телефон: +7 (905) 243-72-50, почта: sale@restohub.pro.