iiko

Общее описание

Требования

Минимальная версия iiko 8.7.6 так как плагин использует Front API V8
Наличие лицензии api payment (21016318)
Запуск iikoF ront от администратора
При раскатке на точку с несколькими официантскими станциями/ведомыми
терминалами плагин устанавливается на все терминалы.

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

Необходимо скачать плагин, разблокировать файлы и разархивировать
папку с плагином в папку с плагинами iikoFront, располагающуюся по пути
C:\Program Files\iiko\iikoRMS\Front.Net\Plugins

Лог плагина plugin-Get.Front.Ecvi.log хранится по пути:

C:\Users\User\AppData\Roaming\iiko\CashServer\Logs.

Параметры конфигурационного файла Get.Front.Ecvi.dll.config (хранится по пути C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\Get.Front.Ecvi):

"BaseUrl" - Адрес сервиса, куда направляются запросы (без слеша на конце);
"HotelToken" - токен отеля на сервере ECVI;
"EnableSearchByGuestCard" - параметр, отвечающий за возможность поиска гостя по номеру карты. При указании в поле значения "True", в меню выбора способа чекина гостя будут выведены две кнопки для поиска гостя по номеру комнаты и по номеру карты.
"IncreaseProductName" - наименование надбавки, которая отправляется в ECVI

Пример отправки в api IncreaseProductName = "Надбавка"

{
   "OrderID": "35950",
   "DepartCode": "RS",
   "InvoiceDate": "2024-10-14 15:06:56",
   "ServiceDate": "2024-10-14 15:06:56",
   "Count": "1",
   "Discount": 0,
   "Amount": 44.00,
   "Price": 44.00,
   "AmountWithoutDiscount": 44.00,
   "Comments": "1",
   "NDS": "0",
   "NdsAmount": "0",
   "Items": [
    {
       "Name": "Сахар10",
       "Amount": 1,
       "Price": 10.00,
       "DiscountPrice": 0,
       "Total": 10.00,
       "Tax": null,
       "Comment": null
    },
    {
       "Name": "Сахар15",
       "Amount": 2,
       "Price": 15.00,
       "DiscountPrice": 0,
       "Total": 30.00,
       "Tax": null,
       "Comment": null
    },
    {
       "Name": "Надбавка",
       "Amount": 1,
       "Price": 4.00,
       "DiscountPrice": 0,
       "Total": 4.00,
       "Tax": null,
       "Comment": null
    }
  ]
}

Пример:

<userSettings>
      <Get.Front.Ecvi.Properties.Settings>
          <setting name="BaseUrl" serializeAs="String">
              <value>https://demo2.ecvi.ru/iikoapi</value>
          </setting>
          <setting name="HotelToken" serializeAs="String">
              <value>k6K5Acz1Ib-vxT5j0-FaEZWwoqicyLpn</value>
          </setting>
          <setting name="EnableSearchByGuestCard"
serializeAs="String">
              <value>True</value>
          </setting>
            <setting name="IncreaseProductName" serializeAs="String">
              <value>Надбавка</value>
          </setting>
      </Get.Front.Ecvi.Properties.Settings>
  </userSettings>