Ошибки и проверка обмена с iiko

Если обмен работает не так, как ожидается, проверьте по порядку:

1. API-логин, организацию и терминальную группу.

2. Актуальность данных после изменения настроек — нажмите «Обновить данные».

3. Привязку webhook для статусов заказов и стоп-листа.

4. Совпадение артикулов товаров и опций.

5. Настройку «Маркированный товар» у позиций, которые iiko должен получать отдельными строками.

6. Совпадение формата адресов доставки в iiko и Result.Rest.

7. Соответствие способов оплаты, скидки и статусов.

После исправления создайте тестовый заказ и проверьте его в iiko и Result.Rest. Если проблема остаётся, приложите к обращению время заказа, номер филиала и текст ошибки без API-ключей и других секретов.

Типовые ошибки при передаче заказов

Адрес доставки не принят или передан некорректно

Проверьте, одинаковый ли формат адресов включён для организации в iiko и в настройках интеграции Result.Rest.

Что сделать:

1. Уточните, переведена ли организация iiko на новый формат адресов доставки.

2. В Result.Rest откройте настройки филиала: «Внешние программы учёта» → «iiko».

3. Если организация уже использует новый формат, включите «Передавать адреса в новом формате iikoCloud». Если iiko ещё работает в прежнем формате, оставьте настройку выключенной.

4. Сохраните филиал.

5. Создайте тестовый заказ с доставкой и проверьте адрес в iiko.

Подробнее: Передача адресов в новом формате iikoCloud.

Заказ с несколькими единицами маркированного товара не передаётся

Если ошибка появляется только в заказах, где одной маркированной позиции больше одной единицы, проверьте формат передачи товара.

Что сделать:

1. Откройте «Каталог» → «Товары» и выберите проблемную позицию.

2. Перейдите на этап «Метки и Акции».

3. Включите «Маркированный товар» и сохраните карточку.

4. Создайте новый тестовый заказ с двумя единицами товара.

5. Убедитесь, что в iiko появились две отдельные строки, по одной единице в каждой.

Настройка доступна только при подключённой интеграции iiko. Подробнее: Маркированные товары iiko.

Product is excluded from menu for order's table

Ошибка означает, что передаваемая в заказе позиция недоступна для продажи в отделении, связанном с выбранным терминалом или служебным столом доставки.

Что проверить:

1. Позиция активна в номенклатуре iiko.

2. Для неё указано нужное место продажи.

3. Активна родительская номенклатурная группа.

4. Позиция включена в прейскурант и доступна для используемой ценовой категории.

5. В интеграции используется актуальный идентификатор позиции.

6. Терминальная группа связана с правильным отделением.

7. После изменений выполнена синхронизация меню с кассой и интеграцией.

Также рекомендуется проверить наличие дублей номенклатуры. Интеграция может передавать одну позицию, тогда как в iiko для продажи настроена другая с похожим названием.

После исправления настроек обновите меню в интеграции и повторно отправьте заказ.

Too small delivery date

Ошибка означает, что переданное время готовности или доставки уже прошло либо оказалось меньше минимально допустимого времени, рассчитанного iiko.

Что проверить:

1. Время доставки указано в будущем.

2. Учитывается часовой пояс ресторана.

3. Время на кассе и сервере интеграции совпадает.

4. Учтена настроенная продолжительность приготовления и доставки.

5. При повторной отправке заказа время рассчитано заново.

Если заказ должен быть выполнен как можно быстрее, не передавайте конкретное время, если интеграция поддерживает такой сценарий. Тогда iiko рассчитает его автоматически на основании настроек точки.

Для заказа ко времени передавайте значение с достаточным запасом относительно текущего времени.

Терминал неактивен

Ошибка означает, что выбранная терминальная группа сейчас не может принять заказ.

Что проверить:

1. Компьютер кассы включён.

2. iikoFront запущен и полностью загрузился.

3. На кассе есть интернет и связь с сервером iiko.

4. Терминальная группа активна.

5. В интеграции выбрана актуальная терминальная группа.

6. Терминал не был пересоздан или заменён после первоначальной настройки интеграции.

7. Действует лицензия и работает модуль Cloud API.

Если iikoFront работает, перезапустите его и повторно проверьте состояние терминала.

Если терминал остаётся неактивным, проверьте его доступность через Cloud API либо обратитесь к обслуживающему партнёру iiko.

После восстановления связи заказ можно отправить повторно.

Order item modifier has invalid group amount

Ошибка означает, что количество переданных модификаторов не соответствует ограничениям, настроенным для блюда в iiko.

Например:

• обязательный модификатор не был передан;

• передано больше модификаторов, чем разрешено;

• используется устаревшая структура модификаторов;

• передан модификатор, который больше не относится к этому блюду.

Что проверить:

1. Минимальное и максимальное количество модификаторов в карточке блюда.

2. Обязателен ли выбор модификатора.

3. Передаёт ли сайт или приложение выбранный модификатор вместе с блюдом.

4. Соответствуют ли идентификаторы блюда, группы и модификатора актуальной номенклатуре.

5. Доступен ли модификатор для выбранного блюда и его размера.

6. Выполнено ли обновление меню после изменений в iiko.

Если модификатор должен быть обязательным, интерфейс оформления заказа не должен позволять добавить блюдо без выбора.

Если модификатор должен быть необязательным, в iiko установите минимальное количество, равное нулю.

После изменения настроек синхронизируйте меню и повторно отправьте заказ.

Apilogin’s license for using the Cloud API has expired

Ошибка означает, что закончился срок действия лицензии Cloud API, связанной с используемым API-логином.

Что сделать:

1. Определить владельца API-логина: ресторан, обслуживающий партнёр или интегратор.

2. Проверить оплату и срок действия лицензии Cloud API.

3. Обратиться к партнёру iiko или владельцу API-логина для продления лицензии.

4. После продления повторно получить токен авторизации.

5. Проверить доступ к организации и терминальным группам.

6. Повторно отправить заказы, не переданные во время блокировки.

Простая замена токена обычно не устраняет ошибку, пока лицензия API-логина не будет восстановлена.

Рекомендуемый порядок диагностики

1. Проверить лицензию Cloud API.

2. Проверить активность терминала.

3. Обновить номенклатуру и меню.

4. Проверить настройку «Маркированный товар» у поштучно учитываемых позиций.

5. Проверить доступность позиций в нужном месте продажи.

6. Проверить настройки обязательных модификаторов.

7. Проверить дату, время и часовой пояс заказа.

8. Проверить, совпадает ли формат адресов доставки в iiko и Result.Rest.

9. После устранения причины повторно отправить заказ.