Share:

Для списания или начисления бонусов Город клиент должен идентифицироваться. Доступны следующие варианты:

  • Числовой код карты
  • Штрихкод на карте
  • Штрихкод в мобильном приложении.

Бонусами можно оплатить часть покупки или просто сохранить карту для начисления. Это зависит от настроек на процессинге.

Списание происходит только в режиме онлайн. Начисление и возврат могут проходить и в оффлайн режиме, когда нет связи с процессингом или отсутствует доступ к интернету.

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

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

Перед установкой плагина установите библиотеку API PCX. Последнюю версию можно запросить у ЦФТ. Настраивать ничего не требуется. А также установите в систему выданный точке сертификат: для локального компьютера - в личные сертификаты.

Чтобы установить и настроить плагин системы лояльности Тройка город:

  1. Закройте iikoFront на кассе.
  2. Скопируйте в папку Resto.Front.Api.TroykaPlugin файлы (C:\Program Files\iiko\iikoRMS\Front.Net\Plugins):
    • Плагин - Resto.Front.Api.TroykaPlugin.dll.
    • Конфигурационный файл  - Resto.Front.Api.TroykaPlugin.dll.config.
    • Дополнительные библиотеки: EntityFramework.dll, EntityFramework.SqlServer.dll, EntityFramework.SqlServer.xml, EntityFramework.SqlServerCompact.dll, EntityFramework.SqlServerCompact.xml, EntityFramework.xml.
  3. Обратите внимание, что бы файлы не были заблокированны системой.

  4. Настройте конфигурационный файл данными, полученными от ЦФТ.
  5. <Resto.Front.Api.TroykaPlugin.Properties.Settings>
          <setting name="ConnectionString" serializeAs="String">
            <value>https://xml-online.demo.korona.net:20101/axis.v3/services/CFTLoyaltyPCPoints_SoapPort_term_2.7.6</value>
          </setting>
          <setting name="ConnectTimeout" serializeAs="String">
            <value>5</value>
          </setting>
          <setting name="SendRecvTimeout" serializeAs="String">
            <value>30</value>
          </setting>
          <setting name="BackgndFlushPeriod" serializeAs="String">
            <value>300</value>
          </setting>
          <setting name="Terminal" serializeAs="String">
            <value>iiko</value>
          </setting>
          <setting name="Location" serializeAs="String">
            <value>iiko</value>
          </setting>
          <setting name=" PartnerID" serializeAs="String">
            <value>1366246</value>
          </setting>
          <setting name="CertSubjectName" serializeAs="String">
            <value>testPC01</value>
          </setting>
          <setting name="EAN13" serializeAs="String">
            <value>25</value>
          </setting>
          <setting name="IdentificatorLength" serializeAs="String">
            <value>10</value>
          </setting>
          <setting name="EAN13_mobile" serializeAs="String">
            <value>26</value>
          </setting>
    	  <setting name="AuthRequired" serializeAs="String">
            <value>False</value>
          </setting>
        </Resto.Front.Api.TroykaPlugin.Properties.Settings>
      </applicationSettings>
    

    Его параметры:

    • ConnectionString – путь к процессингу. По умолчанию настроен демо-процессинг, необходимо уточнить боевой путь.
    • ConnectTimeout, SendRecvTimeout, BackgndFlushPeriod – настройки таймаутов, лучше оставить по умолчанию. Изменять только в случае крайней надобности.
    • Terminal, Location, PartnerID – настройки для конкретной точки, необходимо получить у ЦФТ.
    • CertSubjectName – имя субъекта сертификата. Сертификат должен быть установлен в системе для локального компьютера.
    • EAN13 – префикс штрихкода карты.
    • EAN13_mobile – префикс штрихкода для мобильного устройства.
    • IdentificatorLength – длина идентификатора.
    • AuthRequired – запрашивать или нет подтверждение списания по смс.
  6. Запустите iiko Front. В папке C:\Users\[Пользователь]\AppData\Roaming\iiko\CashServer\Logs\ должен появится файл plugin-Resto.Front.Api.TroykaPlugin.log. При успешном запуске лог должен выглядть примерно так:

Настройка типа оплаты

В iikoOffice зайдите в пункт меню Розничные продажи → Типы оплат и далее создайте тип оплаты «Тройка город», как показано на рисунке.

В качестве скидки должна будет указана скидка (100%), настроенная следующим образом (остальные окна при добавлении скидки оставить по умолчанию)