# Плагин для iikoFront: с чего начать

> Что делает плагин CWStopList, что нужно для установки и порядок подключения: сервисный пользователь, установка, config.xml, веб-хук iiko Cloud и проверка.

Плагин CWStopList (на кассе он называется CWSL) связывает кассы iikoFront со Stoplist.Tech. С ним можно:

* ставить блюда на стоп и задавать остатки из Stoplist.Tech, в том числе только на выбранных терминальных группах;
* видеть стоп-лист каждой кассы в реальном времени;
* очищать стоп-лист по расписанию или при закрытии смены;
* собирать заказы для [оповещений о скорости заказов](https://docs.stoplist.tech/automation/velocity-alerts).

Плагин ставится на каждую кассу (терминальную группу), где нужно управлять стоп-листом.

## Что понадобится

* доступ в iikoOffice, чтобы создать сервисного пользователя;
* файл `config.xml` с лицензионным ключом и адресом сервера. Его выдаёт поддержка при подключении;
* архив плагина: [cwsl-latest.zip](https://fc38e461-605e-4b0b-9134-6a5297c17600.selstorage.ru/cwsl-latest.zip). По ссылке всегда последняя версия.

> Плагин собран на iikoFront API V9. Если сомневаетесь, подойдёт ли ваша версия iikoFront, спросите в [поддержке](https://docs.stoplist.tech/settings/support).
## Порядок подключения

1. [Создайте сервисного пользователя](https://docs.stoplist.tech/plugin/service-user) с правом F_EM.
2. [Установите плагин](https://docs.stoplist.tech/plugin/install) в папку плагинов iikoFront.
3. [Положите config.xml](https://docs.stoplist.tech/plugin/configuration) в папку настроек плагина.
4. Перезапустите iikoFront и проверьте, что в **Дополнениях** появилась кнопка CWSL.
5. В iiko Cloud привяжите организации к API-ключу и настройте веб-хук на событие обновления стоп-листов. Адрес веб-хука:
   ```
   https://api.stoplist.tech/api/v2/hook/{ключ}
   ```
   где `{ключ}` — лицензионный ключ из config.xml.
6. Откройте ресторан в разделе [Стоп-листы](https://docs.stoplist.tech/stoplists/management): в шапке должны появиться версия плагина и версия iikoFront.

Меню для стоп-листа сервис берёт из внешнего меню iiko Cloud или из самого плагина. Что подходит вам, поддержка настроит при подключении.

## Обновление

Закройте iikoFront, замените файлы в папке плагина файлами из нового архива и запустите iikoFront. Файл `config.xml` лежит в другой папке, его трогать не нужно. Что изменилось в версиях, смотрите в [истории версий](https://docs.stoplist.tech/plugin/changelog).

---
Раздел: Плагин для iiko. Источник: https://docs.stoplist.tech/plugin/quick-start