# Система лояльности {% hint style="warning" %} **Важно!** Для активации системы лояльности свяжитесь с нашей службой поддержки по почте ****, через чат в правом нижнем углу приложения или в WhatsApp по номеру +371 28 701 129. Система лояльности доступна: * **на 011 версии и** **старше** для контроллеров Mini * **на 018 версии и старше** для контроллеров Smart {% endhint %} На этой странице находится руководство по использованию [системы лояльности SmartVend](http://91.236.196.187). С ее помощью вы сможете создавать QR-коды для акций и промо-кампаний, а также удобно управлять ими. ### Регистрация Для того, чтобы зарегистрироваться в системе лояльности, вам потребуется: 1. **API Key**\ В [личном кабинете SmartVend](http://app.smartvend.ru) откройте `Настройки` —> `Интеграции` —> `API`. Нажмите `Сгенерировать ключи`. В открывшемся меню введите любое удобное вам название, установите все разрешения и нажмите `Сгенерировать`.
После генерации вам будет доступен публичный (открытый) API ключ — введите его в форму регистрации системы лояльности.
2. **User ID**\ Откройте `Профиль` в левом меню. Первой строкой в личных данных указан ваш `ID` — скопируйте его и используйте для регистрации в системе лояльности.
### Настройка контроллера SmartVend Перед созданием кодов требуется задать HTTP API адрес и HTTP API порт на контроллере. Для этого перейдите на страницу `Конфигурация` нужного вам автомата и в разделе `Карты лояльности` введите следующие данные: * `HTTP API адрес` — 91.236.196.187 * `HTTP API порт` — 5000
### Создание кодов Для того, чтобы создать QR код с акцией в системе лояльности, вам потребуется перейти на страницу `QR Generation`. Задайте нужные параметры, исходя из ваших потребностей: 1. **Single QR Code** или **Mass Generation**\ Если вам требуется создать только один QR код с акцией, используйте страницу `Single QR Code`. Если же вам требуется создать пачку кодов, например, 10 разных кодов с одинаковой акцией, то используйте вкладку `Mass Generation`.
2. **Generation Name**\ Используйте любое удобное название. Мы рекомендуем создавать названия, которые помогут вам идентифицировать коды в будущем. Например, «50% скидка на 23 февраля». 3. **Number of Codes** (доступно только в Mass Generation)\ Количество кодов с конкретной акцией. Например, мы хотим разместить акцию «50% скидка на 23 февраля» в 5 разных ТЦ. Указываем в поле `Number of Codes` число 5. 4. **Discount type**\ Акции можно создавать двух типов: \ 1\. `Percentage Discount` — скидка в процентах\ 2\. `Free Drinks` — бесплатные напитки 5. **Discount value (%)** или **Number of Free Drinks**\ В зависимости от типа акции, который вы выбрали в шаге 4, дальше требуется настроить: \ 1\. `Discount value (%)` — размер скидки в процентах\ 2\. `Number of Free Drinks` — количество бесплатных напитков 6. **Single Use**\ Если вы хотите, чтобы покупатель воспользовался QR кодом только один раз, поставьте галочку в чек-боксе `Single Use`. После использования код перестанет быть активным. Если QR кодом можно воспользоваться несколько раз, оставьте это поле пустым. 7. **Renewable Monthly**\ Если акция повторяется каждый месяц, вы можете поставить автоматическое возобновление для QR кода в первый день каждого месяца. Например, для студентов сделали акцию «Чашка кофе для пятерок». Чтобы каждый месяц вручную не создавать эту акцию, поставьте галочку в чек-боксе `Renewable Monthly`. Если продлять не нужно — просто оставьте поле пустым. 8. **Expiration date**\ Срок годности QR кода, чтобы не переживать, что акцию забудут деактивировать в нужный день. 9. **Machines**\ Выберите автоматы, на которых будет действовать данный QR код. После выставления всех параметров нажмите кнопку `Generate QR Code` внизу страницы. ### Управление кодами Для того, чтобы управлять созданными акциями, перейдите на страницу `QR List`. Здесь вам будет доступен список всех созданных акций с заданными параметрами, количеством использований, а также статусом — активна акция или нет: 1. **Creation Date** — дата создания акции 2. **Type** — `Single` (одиночный QR код) или `Mass Gen` (пачка кодов) 3. **Name** — название акции 4. **Discount Type** — тип акции `Percentage` (скидка) или `Free Drink` (бесплатные напитки) 5. **Discount/Free** — размер скидки в процентах или количество бесплатных напитков 6. **Expiration** — дата окончания акции 7. **One-Time** — одноразовая акция или нет 8. **Renewable** — возобновляется акция ежемесячно или нет 9. **Used** — количество использований 10. **Uses Left** — сколько раз акцией могут воспользоваться еще 11. **Status** — `Active` (активный код) или `Inactive` (деактивированный) 12. **Actions** — здесь можно просмотреть или изменить список привязанных автоматов, а также скачать, деактивировать или удалить коды. ### Подробнее про Actions 1. **Управление автоматами** \ Для того, чтобы просмотреть или изменить список автоматов, на которых размещена акция, кликните по иконке магазина слева в столбце `Actions`.
В списке `Assigned Machines` видно количество автоматов, к которым привязан QR код, а также их серийные номера и названия. В `Available Machines` высвечивается список доступных автоматов, к которым также можно привязать данный QR код. Для того, чтобы найти нужный автомат, воспользуйтесь строкой поиска — искать можно как по серийному номеру, так и по названию. Нажмите `Unassign All`, чтобы отвязать акцию от всех автоматов. 2. **Скачать QR** \ Для того, чтобы скачать QR код или пачку кодов на ваш компьютер, нажмите на иконку с изображением QR кода. 3. **Деактивировать QR код** \ Чтобы завершить акцию и деактивировать QR код, при этом оставив его в истории акций, нажмите на иконку отмены. После успешного выполнения деактивации в столбце `Status` появится плашка `Inactive`. 4. **Удалить QR код** \ Для того, чтобы завершить акцию и удалить ее из истории, нажмите на иконку с красной корзинкой. {% hint style="danger" %} **Обратите внимание,** что для множественных кодов, созданных в режиме `Mass Generation`, удаление одного QR кода повлечет за собой удаление всех кодов, созданных в этой пачке. {% endhint %}
### На странице неактуальные данные — что делать? Если данные в системе лояльности кажутся неточными или устаревшими, просто нажмите «Обновить» на странице QR List или Machines — так вы получите самую актуальную информацию с сервера.
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.smartvend.ru/dopolnitelno/sistema-loyalnosti.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.