Все ошибки где есть libzkfpcsharp, например Could not load file or assembly 'libzkfpcsharp' исправляются переустановкой дров, либо установкой фреймворка, а так же в первую очередь проверьте что офис запускается в 32bit режиме.
На фтп есть архив ZKFingerSDK 5.3_ZK10.0 , там есть необходимые драйвера, а так же родная утилита в папке ZKFingerSDK 5.3_ZK10.0.rar\ZKFingerSDK 5.3_ZK10.0\ZKFingerSDK 5.3_Windows_ZK10.0\C#\Demo\bin  можете запустить и посмотреть коннектиться ли в ней сканер.
Ошибки BackOffice

  1.  Не появляется вкладка “Сотрудники”.
    Скорее всего офис запущен в 64 битном режиме, можно посмотреть в диспетчере задач


    Для установки 32 битного режима нужно подкинуть corflags в корень офиса
    и в командной строке от имени администратора написать путь до офиса
    cd C:\Program Files\iiko\iikoRMS\Office
    а далее команду
    CorFlags.exe/32bit+ BackOffice.exe
    Так выглядит успешная команда


  2.  Ошибка “нет лицензии” при открытии вкладки сотрудников
    У вас просто нет лицензии, но ввести настройки сервера вам все равно можно, но сотрудников и их пальцы вы не увидите. Некоторым подходит такой режим работы, что пальцы заносят только через чейн, они автоматически поступят на все рмсы(а в последствие и на фронты) если рмсы зарегистрированы в сети биометрии.

  3.  Пальцы не отправляются на сервер биометрии, не появляется галочка и палец в UI не становиться зеленым после трех нажатий.
    Тут две причины либо у вас некорректные настройки, а конкретно строка адреса сервера, она должна выглядеть так ( обязательно порт и / )

    Адрес обязательно должен совпадать с адресом, который вы указали при регистрации.
    Вторая причина, ваш сервер вообще не зарегистрирован, об этом можно узнать во вкладке мониторинга

    Если он не зарегистрирован там будет ошибка и необходимо зарегистрировать его через настройки.
    Третья причина, настройки неполностью сохранились после регистрации, зайдите в "Изменить настройки" и нажмите применить. Такое происходит, когда при регистрации сервера не нажимают кнопку сохранить, а просто выходят из настроек, половина настроек при этом запоминается 

    Есть еще четвертая причина, но очень редкая, на данной точке нет прав для внесения отпечатков на сервер, в основном это касается старых клиентов зарегистрированных в ручную. Чтобы посмотреть создайте заявку по форме https://pyrus.com/t#uf565461 .

  4.  Сканер не определяется в UI, при нажатии на кнопку инициализации ничего не происходит или выходит ошибка

    Скорее всего не установлены драйвера для устройства, так же посмотрите есть ли устройство в диспетчере устройств. Попробуйте переустановить/установить драйвера и перезагрузить пк.

  5.  Ошибка авторизации
    Если выходит ошибка авторизации, ваш сервер скорее всего не зарегистрирован и логин пароль не существует или введен некорректно.

  6.  Не удаляется отпечаток.
    Иногда бывает достаточно просто закрыть вкладку и открыть ее еще раз, но если у вас выходит ошибка такого вида, то дела ваши плохи

    Это значит что сотруднику поменяли номер карты, а пальцы не удалили. Если вы хотите удалить или поменять номер карты, удалите сначала пальцы, а потом делайте все что захотите. Удаление таких сотрудников, только через заявку (удаляться будем напрямую из базы). В скором времени будет доработка этой ошибки.



Ошибки в iikoFront

  1.  Не сканируются пальцы на фронте при обычно режиме разблокировки 
    Вариантов может быть много, нужно смотреть лог находится он тут \AppData\Roaming\iiko\CashServer\Logs называется plugin-BeOpen.iiko.Front.Biometric.log
    Ошибка в логе  
    Score: 41 is not enough. Looks like 90098 FP. ProcessedFP 90098 , ATemplate System.Byte[]
     - returnedFP: 90098
    Это значит что отпечаток совпал только на 41% , порог указывается в настройках в бэк офисе и по умолчанию 75%, сильно ниже делать не рекомендую.

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

  2.  Сканер не реагирует на нажатия 
    Смотрим опять в лог, там есть настройки  если где то стоит Null, вам надо зайти в настройки в бэке и сохранить их еще раз, сделать синхронизацию на фронте и все будет работать. Такое происходит, когда при регистрации сервера не нажимают кнопку сохранить, а просто выходят из настроек.

    Вторая причина почему такое может произойти. Смотрим лог 
    Ошибка ERROR [ 8] - BiometricPlugin: Versions are not equal: front version: 2.0.1.33666, version from settings: 2.1
    Тут все очень просто заходите на бэк смотрите на свойства библиотеки

     потом заходите на фронт и смотрите там так же.

    Если не совпадают меняете тот плагин что ниже версии, совпадать должны первые две цифры, то есть либо 2.0 и 2.0 , либо 2.1 и 2.1
    Если это плагин бэка то рекомендую после замены плагина зайти в офис и пересохранить настройки иначе проблема не уйдет.

    Так же можете проверить файлы в кеше,\AppData\Roaming\iiko\CashServer\EntitiesStorage\Plugins\BeOpen.iiko.Front.Biometric в файлах employeeCache и fingerprintCach должны быть сотрудники, в файле employeeCache  вы можете найти сотрудника по номеру карты, а далее и отпечаток в файле fingerprintCach  по id сотрудника. Если там пусто, значит пальцев либо нет на сервере, либо настройки некорректные. Смотрим 1 и 2 причину.


  3. Не запускается плагин
    Ошибка в логе
    Couldn't create plugin instance, constructor thrown an exception:
    System.Reflection.TargetInvocationException: Адресат вызова создал исключение. ---> System.TypeLoadException: Отсутствует реализация метода "get_DepartmentCode" в типе "Resto.Front.Api.V7.Data.Organization.Restaurant" из сборки "Resto.Front.Api, Version=7.6.7003.0, Culture=neutral, PublicKeyToken=null".
    Даже если ошибка не такая, но похожая, то поможет взять плагин с фтп, который подходит под вашу версию или наиболее близка к вашей версии. Если все равно не стартует, то заявку по форме, соберем вам плагин.
  4.  Ошибки с режимом TimeControl
    ERROR [26] - iikoApiClient::OpenAttendance Conflict,
    responseBody: Cannot create attendance entry which intersects other attendance entries: [2022-03-18T09:53:00.000+03:00/2022-03-19T00:07:47.730+03:00]

    reason: Conflict
    System.Net.WebException: Удаленный сервер возвратил ошибку: (409) Конфликт.
    Это значит что явку уже открыли в другом месте и учет рабочего времени не отключен 
    Ссылка про учет рабочего времени  https://ru.iiko.help/articles/#!iikooffice-7-9/topic-261/q/%25D1%2583%25D1%2587%25D0%25B5%25D1%2582%2520%25D1%2580%25D0%25B0%25D0%25B1%25D0%25BE%25D1%2587%25D0%25B5%25D0%25B3%25D0%25BE%2520%25D0%25B2%25D1%2580%25D0%25B5%25D0%25BC%25D0%25B5%25D0%25BD%25D0%25B8/qid/994282/qp/1 Так же вы можете зайти в офис, в журнал явок и увидеть что смена у этого сотрудника уже открыта.
    При других проблемах необходимо посмотреть указано ли тп по умолчанию у сотрудника в айко, в крайних случаях снесли кэш из папки \AppData\Roaming\iiko\CashServer\EntitiesStorage\Plugins\BeOpen.iiko.Front.Biometric
  5. Ошибка в логе 
    ERROR [16] - iikoApiClient::Auth Unauthorized,
    responseBody: Неверный пароль для пользователя 'Администратор'
    reason: Unauthorized
    System.Net.WebException: Удаленный сервер возвратил ошибку: (401) Несанкционированный.
    в System.Net.HttpWebRequest.GetResponse()
    в BeOpen.iiko.Front.Biometric.WebApiClient.IikoApiClient.Auth() в C:\Work\git\bio\iiko-attendance-biometric-trunk767\BeOpen.iiko.Front.Biometric\WebApiClient\IikoApiClient.cs:строка 100
    Очевидно что пароль и логин от айко указанный в офисе неверный, необходимо ввести корректный логин и пароль и сохранить настройки в офисе, произвести синхронизацию на фронте.