Установка службы ECR

ECR представляет собой службу Windows для работы с кассовыми аппаратами.

Установка драйверов АТОЛ (только для касс АТОЛ)

Если кассовый аппарат НЕ АТОЛ, то переходите к следующему шагу Инструкция по установке службы.

Внимание

Нужно устанавливать именно эту версию драйвера (8.14.0.0). Если на компьютере клиента стоит эта версия, то этот шаг можно пропустить. Если версия отличается, например 8.14.0.1 или 8.14.0.2, то надо установить драйвера.

Инструкция по установке службы

  • Скачать архив со службой.
  • Разархивировать содержимое архива на диск C (так, чтобы получилось C:\EcrService) ecr_install1
  • Из каталога C:\EcrService\ce_install установить SSCERuntime_x64-RUS.exe если система 64-битная или SSCERuntime_x86-RUS.exe если 32-битная ecr_install2
  • Запустить от имени администратора командную строку (Пуск -> Все программы -> Стандартные -> Командная строка) ecr_install3
  • Перейти в каталог C:\EcrService ecr_install4
  • Запустить Install.bat ecr_install5
  • Дождаться окончания установки

Внимание

Для того чтобы установить службу из консоли нужно набрать:

cd C:\EcrService
Install.bat

Внимание

Для работы службы нужен .NET Framework 4.0. Если при установке службы возникает ошибка вида “’installutil’ is not recognized as an internal or external command, operable program or batch file”, то надо установить .NET Framework 4.0

Внимание

Если предполагается, что служба будут использовать с другого компьютера и если брандмауэр включен, нужно будет открыть порт этой службы как описано в Открытие порта в брандмауэре Windows

Инструкция по запуску службы (только для касс АТОЛ)

Если кассовый аппарат НЕ АТОЛ, то переходите к следующему шагу Инструкция по запуску службы (общая).

  • Зайти в Панель управления -> Администрирование -> Службы. В списке служб найти EcrService и зайти в его Свойства ecr1
  • Перейти во вкладку Вход в систему ecr2
  • Выберите С учетной записью и нажмите Обзор ecr3
  • В открывшемся окне нажмите Дополнительно ecr4
  • Нажмите Поиск ecr5
  • Найдите в списке аккаунт текущего пользователя, выберите его и нажмите OK ecr6
  • Убедитесь что в Введите имена набираемых объектов правильный аккаунт и нажмите OK ecr7
  • Узнайте пароль пользователя у клиента и введите их в поля Пароль и Подтверждение и нажмите OK. Если у пользователя пароля нет, то спросите можно ли поставить пароль и поставьте пароль, например 1 ecr8

Внимание

Пароль у пользователя должен быть обязательно! Иначе без этого не запустить службу с нужными правами

Инструкция по запуску службы (общая)

  • Зайти в Панель управления -> Администрирование -> Службы. В списке служб найти EcrService и нажать Запустить службу ecr9

Внимание

Также можно запустить службу из консоли набрав:

cd C:\EcrService
StartService.bat
  • Если состояние службы изменилось на Работает, то значит служба успешно запустилась

Известные проблемы

Не устанавливаются АТОЛовские драйвера, SSCERuntime_x64-RUS.exe или SSCERuntime_x86-RUS.exe

Решение. Скорее всего у пользователя нет администраторских прав. Нужно попросить клиента чтобы предоставили пользователя с администраторскими правами

Не запускается служба. Ошибка 1067

error_2

Решение. Один из возможных вариантов в том, что порт для сервиса уже занят другой программой.

Внимание

Чтобы убедиться в этом можно проверить логи, как написано в Логи службы и если там есть ошибка вида HTTP could not register URL http://+:8095/ because TCP port 8095 is being used by another application, то значит порт занят

  • По умолчанию служба запускается на порту 8095. Это можно изменить в файле C:\EcrService\Ecr.SelfHosting.exe.config error_3
  • Нажимаем правый кнопкой на этом файле, выбираем Открыть с помощью error_4
  • Открываем этот файл в блокноте error_5
  • Находим строку с http://localhost:8095 и изменяем 8095 на какой-нибудь другой порт, например 8099 error_6
  • Сохраняем файл и перезапускаем службу

Внимание

Не забудьте, если вы поменяли порт, то в настройках ассистента в Медеске тоже надо будет поменять хост на http://Admin:1233@http://localhost:8099

Ошибки при проверке кассы

Ошибка. -3 (Порт недоступен (System Error. Code: 2.Не удается найти указанный файл))

Решение. Скорее всего вы либо выбрали неправильный COM порт или у вас не полностью установились драйвера для кассы. Попробуйте Ручная установка USB драйверов кассы (только для касс АТОЛ)

Ошибка. -1 (Нет связи)

Решение. Тут либо касса не включена или кабель поврежден.

Конфликт со службой Хеликса

Если клиент использует Хеликс для печати чеков, то скорее всего COM порт всегда занят их службой

Внимание

Для того, чтобы убедиться, что это так, стоит зайти в логи, как описано в Логи службы. Если в логах есть ошибки вида Порт занят, то это значит, что служба Хеликса заняла порт

Решение. Единственный вариант пока, отключать Службу печати чеков Хеликс (неточное название)

Дополнительно

Логи службы

Если при запуске или в ходе работы службы произошла ошибка, то стоит для начала зайти в каталог C:\EcrService\logs, открыть файл ecr-service.log и изучить логи error_1

Ручная установка USB драйверов кассы (только для касс АТОЛ)

Иногда при установке драйверов не устанвливаются драйвера для эмуляции COM порта через USB. Для того чтобы понять установились ли они, вам надо:

  • Зайти в Панель управления -> Система -> Диспетчер устройств
  • Если есть неизвестные устройства значит драйвера не установились advanced_1
  • Зайдите в контекстное меню и нажмите Обновить драйвер advanced_2
  • Выберите Выполнить поиск драйверов на этом компьютере advanced_3
  • Введите в место для поиска C:\Program Files\ATOL\Drivers8\USB_Drivers (либо Program files(x86) если система 64-битная) advanced_4
  • Если выскочит предупреждение выберите Все равно установить этот драйвер advanced_5
  • Дождитесь окончания установки
  • Проделайте тоже самое для второго неизвестного устройства
  • В итоге у вас в диспетчере должны появиться два устройства advanced_6

Проверка кассы через Тест драйвер ККМ

  • Зайдите в Пуск -> Все программы -> АТОЛ -> Драйверы торгового оборудования v.8 -> Тесты -> Драйвер ККМ advanced_7
  • Нажмите Настройка свойств advanced_8
  • Убедитесь что выбрана правильная модель и COM порт и нажмите Проверка связи. Должно выйти сообщение примерно как на скриншоте advanced_9
  • Если есть ошибки проверьте в Ошибки при проверке кассы

Настройка возможности отправки чеков в ОФД

  • Зайдите в Пуск -> Все программы -> АТОЛ -> Драйверы торгового оборудования v.8 -> Управление драйверами advanced_10
  • Все должно быть выставлено как на скриншоте, кроме Подключенные ККМ advanced_11
  • В Подключенные ККМ нужно выставить в COM-порт второй COM порт который имеет имя вроде COM4: FPrintUSB1, т.е заканчивается на FPrintUSB1

Открытие порта в брандмауэре Windows

  • Зайдите в Пуск -> Панель управления -> Брандмауэр Windows
  • Нажмите слева Дополнительные параметры advanced_12
  • Перейдите в раздел Правила для входящих подключений и нажмите справа Создать правило advanced_13
  • Выберите Для порта и нажмите Далее advanced_14
  • Выберите Протокол TCP и в Определенные локальные порты введите порт на котором запущена служба (по умолчанию это 8095) и нажмите Далее advanced_15
  • Выберите Разрешить подключение и нажмите Далее advanced_16
  • Нажмите Далее advanced_17
  • Введите любое имя в поле Имя и нажмите Готово advanced_18