Подключение iiko

Подключение iiko — это один сервер iiko, куда Римира выгружает документы. У сети таких подключений несколько: по одному на каждый ресторан.

Создаются они в кабинете: меню «ЭДО → Подключения», блок «Подключения iiko» → «Добавить сервер iiko».

Адрес, логин и пароль#

Поле	Что писать
«Название»	как вам удобно, например «iiko ресторан №1» — оно будет видно в документах
«Адрес iiko»	адрес, как при запуске iiko: restaurant.iiko.it
«Логин»	логин пользователя iiko
«Пароль»	его пароль

Адрес вводится «голым», без https:// и без служебного пути: остальное Римира допишет сама. Полный адрес с /resto/api тоже принимается.

Логин и пароль шифруются (AES-256-GCM) и наружу не отдаются. При нажатии «Изменить» поле «Пароль» всегда пустое: оставьте его пустым, чтобы пароль не менялся.

Проверить связь#

Кнопка «Проверить связь» делает две вещи подряд: авторизуется на сервере iiko по адресу, логину и паролю, а затем проверяет, готово ли подключение к актам приёма услуг.

Ответ бывает двух видов:

Ответ	Что это значит
«Связь с iiko установлена. Акты приёма услуг: готово (Cloud API, ресторан «…»)»	всё настроено: и накладные, и акты
«Связь с iiko установлена, накладные будут выгружаться. Акты приёма услуг не готовы: …»	сервер доступен, но с Cloud API что-то не так — накладные пойдут, акты нет

Во втором случае хвост сообщения объясняет причину: «не задан Cloud API-ключ», «не определён ресторан (проверьте API-ключ)», «ресторан недоступен по этому API-ключу» или «Cloud API недоступен: …».

Если авторизация не удалась вовсе — проверьте адрес, логин и пароль: Римира отвечает «iiko: авторизация не удалась». Ту же проверку можно запустить для уже сохранённого подключения кнопкой «Проверить» в таблице.

Ключ Cloud API и ресторан#

Акты приёма услуг создаются только через iiko Cloud API — обычный серверный API iiko такой документ создавать не умеет. Поэтому ключ нужен всем, кто получает по ЭДО услуги, а не только товары.

Ключ создаёт сам клиент в своём iikoWeb: «Интеграции → API Keys». Вставьте его в поле «API-ключ iiko Cloud» в блоке «Акты приёма услуг · iiko Cloud API».

Дальше нажмите «Получить список ресторанов»:

• ресторан по ключу один — подставится сам;
• ресторанов от двух до пяти — появится выпадающий список;
• ресторанов больше пяти — появится поиск, введите не меньше трёх символов.

Выбранный ресторан виден строкой «Ресторан: …», сбросить его можно кнопкой «Сбросить». Подразделение для накладных Римира определяет сама — по совпадению кода ресторана и кода подразделения на сервере.

Кнопка «Сохранить» недоступна, пока не заполнены название и API-ключ. При редактировании поле ключа можно оставить пустым — тогда сохранённый ключ не меняется.

Ключ Cloud API решает ещё одну задачу: серверы с одинаковым ключом Римира считает одной сетью (чейном) — от этого зависит разнесение акта по ресторанам, см. серверы и сети.

Комментарий к документам#

Поле «Шаблон комментария для документов» задаёт текст, который попадёт в комментарий создаваемого документа iiko. По умолчанию это «Создано Римирой».

Галочка «Комментарий для выгрузки в банк» заменяет шаблон на формулу, которую iiko понимает при выгрузке платежей: «Оплата за продукты/услуги по документу №… от дд.мм.гггг, на сумму … руб., в т.ч. НДС … руб.» (или «Без НДС»). При включённой галочке поле шаблона недоступно.

В самом документе перед выгрузкой комментарий можно переписать вручную — поле «Комментарий» в карточке документа.

Таблица подключений#

В списке серверов iiko видно название, адрес, режим комментария и колонку «Акты»: значок «Cloud ✓» с названием ресторана означает, что ключ сохранён. Кнопки строки — «Изменить», «Проверить», «Удалить».

Чтобы сервер стал доступен в документах, отметьте его в ЭДО-подключении — см. серверы и сети.