Warning Прекращение поддержки локальной версии iikoCard
01 апреля 2021 года мы прекратили продажи локальной версии iikoCard. Новые функции появляются только в облачной версии, а функционал локальной установки остановился на уровне iiko 7.3.3 Pro.
С 01.01.2023 мы прекращаем техническую поддержку этого решения. Это не значит, что программа перестанет работать у вас, но мы перестанем исправлять найденные ошибки и выполнять доработки, связанные с государственным регулированием.
Если вы все еще используете локальную версию, предлагаем вам рассмотреть переход на облако. В настоящий момент для текущих пользователей действуют специальные условия. Подробнее на https://cloud.iiko.ru.

Вместо главного сервера iikoCard компании iiko, который доступен по адресу http://iiko.biz, вы можете использовать его локальную версию. Подключение к нему системы iikoRMS и касс, а также маркетинговые программы настраиваются точно так же, как и на сервере компании iiko.

Сервер iiko.biz кроме системы лояльности iikoCard предоставляет API доставки.

Локальную версию можно использовать только для программ лояльности. Для работы с заказами доставки нужно использовать iiko.biz. На локальном сервере доставка работать не будет.

В данной статье описано, как установить и настроить главный сервер для программ лояльности iikoCard на своем оборудовании в локальной сети предприятия.

Системные требования

Минимальные системные требования к оборудованию, на котором вы планируете устанавливать сервер iikoCard:

Выделите для iikoCard и его базы данных отдельную машину. Не устанавливайте его вместе с сервером iikoRMS или iikoChain на одном оборудовании!

Установка и настройка главного сервера

Cервер iikoCard имеет два сервиса:

При установке сервера автоматически создаются учетные записи API, которые используются для подключения стандартных приложений (Delivery Man, Delivery Club, Smart Report). При их подключении достаточно указать адрес вашего сервера iikoCard.

Чтобы установить сервер iikoCard:

  1. Согласуйте локальную установку iikoCard с партнерским отделом компании iiko.
  2. Скачайте с ftp файлы установки компонентов сервера и скопируйте их на жесткий диск компьютера, на который планируете установить сервер iikoCard.
  3. Запустите файл Setup.iikoBiz.exe от имени учетной записи с правами администратора и следуйте указаниям на каждом шаге установки. В результате главный сервер будет установлен в каталог C:\Program Files\iiko\iikoBiz, в котором расположены следующие подкаталоги:

    4. В списке служб появится сервис iikoBiz Host Service, а в IIS — сайт \сайты\Default Web Site\iikoBiz.

    Если на этом компьютере ранее не был установлен MS SQL с экземпляром Resto, то инсталлятор установит «MS SQL 2014 Express». Вы можете оставить SQL Express, если предполагается, что нагрузка на сервер iikoCard будет минимальной. Мы рекомендуем устанавливать промышленный MS SQL Standart или MS SQL Entreprise на этот же компьютер или выделенный.

    Если у вас на этом компьютере уже был установлен MS SQL с экземпляром Resto, то при установке база данных определится автоматически.

    Вместе с главным сервером iikoCard устанавливается сервер обмена сообщениями между системами RabbitMQ. Автоматически создается учетная запись corpit с паролем xGh4RApm7v. Она используется для подключения iikoRMS к iikoCard.

  4. Запустите файл Setup.iikoRMS.ApiService.msi от имени учетной записи с правами администратора и следуйте указаниям на каждом шаге установки. В результате сервис установится в каталог C:\Program Files\iiko\iikoBiz\RMSAPI, в списке служб появится сервис iikoRMS API Service.
  5. Если хотите изменить настройки сервера iikoCard, сделайте это в специальном файле конфигурации. После его редактирования перезапустите службу iikoBiz Host Service для применения новых настроек.
  6. Проверьте работоспособность сервера iikoCard. Для этого:
    1. Убедитесь, что служба iikoBiz Host Service запущена и работает.
    2. Служба протоколирует свою работу в логах C:\logs\iikoNetServer. После окончания установки и начала работы службы, проверьте, что в файле iikonet-server-error.log нет ошибок.
    3. Выполните запрос http://localhost:9900/api/0/auth/access_token?user_id=test&user_secret=test.
      Сервер работоспособен, если он вернет ответ вида:
      Copy Code
      JSON
      {
        "code": null,
        "description": null,
        "httpStatusCode": 500,
        "message": "Wrong user name [test] or password [test]."
      }

    4. В браузере перейдите по адресу http://localhost/iikobiz. Если все настроено правильно, то откроется страница входа на портал iiko.biz.

Information
При установке сервера iikoCard автоматически создается учетная запись с именем и паролем по умолчанию admin/admin. В текущей версии системы пароль изменить нельзя. Эта учетная запись имеет широкие полномочия: ей доступны все организации в iiko.biz, а также дополнительные функции администрирования.
  1. В файле конфигурации iikoRMS resto.properties измените адрес подключения к серверу RabbitMQ:
  1. Вместо rabbit-mq-uri=amqps://corpit:xGh4RApm7v@mq.iiko.biz:5671
    пропишите rabbit-mq-uri=amqp://corpit:xGh4RApm7v@BIZ_LOCAL_HOSTNAME:5672

    Здесь corpit:xGh4RApm7v — логин и пароль пользователя, который создается автоматически, BIZ_LOCAL_HOSTNAME:5672 — имя и порт сервера RabbitMQ.
    Warning Файл конфигурации resto.properties доступен только клиентам на тарифе iikoClassic. Клиентам облачных тарифов iikoCloud необходимо обращаться в обслуживающую организацию.

  2. Добавьте строки, если они отсутствуют:
    iikonet-rmsapi-export-address=http://localhost:9901/api
    iikonet-nomenclature-export-address=http://localhost:9900/api
    где localhost замените на адрес вашего сервера iikoCard.
    Это нужно для регистрации организации на локальном сервере iikoCard.
  1. Перезапустите сервер iikoRMS.
  2. Укажите в iikoRMS настройки подключения к своему серверу iikoCard и к серверу RabbitMQ. Как это сделать, описано в статье Подключение к iikoCard.
  3. Зарегистрируйте свою организацию на своем локальном сервере iikoCard. Как это сделать, см. в статье Регистрация на портале iiko.biz. Ваша организация будет зарегистрирована именно на вашем экземпляре сервера iikoCard, подключение к которому вы настроили в п. 7.
  4. С помощью указанных при регистрации учетных данных авторизуйтесь на локальном портале.

Альтернативный файл конфигурации

Основным файлом конфигурации iikoCard является iikoNet.Host.WinService.exe.config. В процессе обновления сервера он перезаписывается инсталлятором. Если вы изменяли его, то настройки сбросятся до стандартных значений. Чтобы этого не произошло, параметры сервера iikoCard вы можете указать в специальном файле, который не будет перезаписываться при обновлении, и ваши настройки будут сохранены.

Этот файл конфигурации расположен в каталоге C:\Users\iikoBizSvc\AppData\Roaming\iiko\iikoBizServer и называется iikoBizServer.override.config.

Структура файла конфигурации

Information После каждого редактирования файла конфигурации перезагружайте службу iikoBiz Host Service, чтобы применились внесенные изменения.


По умолчанию он имеет следующую структуру:

Copy Code
XML
<overridableAppSettings>
<add key="КЛЮЧ" value="ЗНАЧЕНИЕ" />
</overridableAppSettings>

Вместо строки <add key="КЛЮЧ" value="ЗНАЧЕНИЕ" /> вставьте нужный ключ и укажите его значение. Например,

Copy Code
XML
<overridableAppSettings>
<add key="db.connection_string" value="Data Source=localhost\RESTO;Initial Catalog=iikoCard5;Integrated Security=True;" />
<add key="db.connection_string.master" value="Data Source=localhost\RESTO;Initial Catalog=master;Integrated Security=True;Connection Timeout=5;" />
</overridableAppSettings>


Что можно настроить

Подключение к MS SQL, если используется база данных не по умолчанию:

Подключение к RabbitMQ, если они отличаются от стандартных:

Для отправки СМС:

Information
Значения параметров вы получите у провайдера после регистрации. С какими СМС-сервисами работает iikoCard, а также примеры конфигурации см. Настройка СМС-провайдера.

Отправка электронной почты:

Электронный адрес для отправки уведомлений о состоянии системы:

Формирование корректных URL к веб-интерфейсам сервера в почтовых сообщениях:

Подписка на пуш-уведомления:

Настройка СМС-провайдера

Чтобы отправлять гостям сообщения на телефон, например, об операциях по счету, подключитесь к сервису рассылки СМС.

Система iikoCard на локальном сервере умеет отправлять сообщения только через службу SMS-центр.

Чтобы настроить работу iikoCard с любым из провайдеров:

  1. Заключите договор на обслуживание с выбранным провайдером.
  2. Получите у провайдера:
  3. В конфигурационном файле iikoBizServer.override.config укажите своего провайдера и параметры, полученные у него. Подробнее о том, где он находится и как его настроить см.  Альтернативный файл конфигурации. Например, для настройки отправки СМС в файл конфигурации вы можете добавить следующие строки (используется служба SMSC):
    Copy Code
    XML
    <add key="SmsProcessor" value="smsSmscProcessor" />
    <add key="SmsProvider_Company" value="iiko.biz" />
    <add key="SmsProvider_Login" value="Resto Software"/>
    <add key="SmsProvider_Password" value="password"/>
    <add key="SmsProvider_Gate" value="smsc.ru" />
    <add key="SmsProvider_Port" value="80" />
  4. После изменения файлов конфигурации перезапустите службу iikoBiz Host Service для применения настроек.

Изображения блюд

Если вы используете интеграцию iiko с сайтом доставки и выгружаете меню с изображениями блюд, то нужно настроить хранилище картинок. Для хранения изображений блюд используется сервис Selectel. При локальной установке iiko.biz нужно самостоятельно зарегистрироваться и настроить к нему подключение. Для этого:

  1. Зарегистрируйтесь в сервисе Selectel и оплатите его услуги. Как это сделать, см. в базе знаний Selectel.
  2. В личном кабинете Selectel создайте:
  3. В конфигурационном файле iikoBizServer.override.config добавьте строки с параметрами подключения к Selectel:
    Copy Code
    XML
    <add key="SelectelLogin" value="64060_API_USER" />
    <add key="SelectelPassword" value="YourPassword" />
    <add key="SelectelDomainUrl" value="http://111111.selcdn.ru" />
    <add key="SelectelNomenclatureContainerName" value="nomenclature_images" /> 
    <add key="SelectelImagesContainerName" value="images" />
    <add key="SelectelPosLogsContainerName" value="pos_logs_test" />
    <add key="SelectelAttemptsToUploadImage" value="3" />
    <add key="SelectelPosLogsAutoDeleteDays" value="3" />

    4. в следующих параметрах измените значения

  4. Перезапустите службу iikoBiz Host Service для применения настроек.
  5. В файл конфигурации сервера iiko resto.properties добавьте настройку
    iikonet-nomenclature-export-address = http://хх.хх.хх.хх:9900/api.
    Этот адрес используется для передачи изображений блюд из RMS в iiko.biz. Впишите сюда адрес свой локального сервера iiko.biz, например, http://restotest.ru:9900/api. Перезапустите iikoRMS Server.
    Warning Файл конфигурации resto.properties доступен только клиентам на тарифе iikoClassic. Клиентам облачных тарифов iikoCloud необходимо обращаться в обслуживающую организацию.
  6. Выгрузите меню в iikoOffice или с помощью скрипта forceNomenclatureImport.jsp.