💱Настройка интеграции и ККМ и подключение кассового аппарата и терминала
Данная интеграция необходима, для связки физического фискального накопителя/эквайрингового терминала с системой. Интеграция осуществляется путём настройки расширения и ПО kkm-server.
Перейди по данной ссылке можно увидеть список рекомендованного оборудования: 🔗Рекомендуемое оборудование
Так же за более точной информацией по поддерживаемым фискальным накопителя можно обратиться в kkm-server.
Почта для связи с ними: kkmserver@gmail.com
Шаблон сообщения для обращения в kkmserver:
Обязательно указать тему письма иначе оно не будет доставлено.
Текст сообщения начните с данных:
- ИНН 745801167833 (Можно посмотреть в меню kkmserver — «Лицензии»)
- Anydesk 171 198 367
- пароль (здесь напишите пароль от своего anydesk)
Далее напишите проблему "Не выполнена транзакция по оплате: Отказ в доступе к порту или порт уже открыт, Message: Порт закрыт. Отказ в доступе к порту или порт уже открыт, Message: Порт закрыт."
Текст команды: "Можно посмотреть в меню kkmserver — «Логи команд» "
Не выключайте ПК и ждите их ответа/подключения
После приобретения терминала/кассы, нужно подключить её к компьютеру и произвести первичную настройку оборудования. С первичной настройкой кассы может помочь производитель терминала/кассового аппарата или можно вызвать специалиста, который сможет с этим помочь.
После подключения устройства к компьютеру на него обязательно нужно установить программное обеспечение(драйвера). По поводу драйверов так же можно уточнить у специалиста который производит подключение кассы.
Кассовый аппарат
1. После того как устройство было подключено к компьютеру и на компьютер было установлено программное обеспечение для него. Необходимо установить расширение для браузера — 🔗kkmserver.admin
Открыть расширение можно в верхней правой панели браузера.
После установки нужно выбрать — «Встроенный сервер» и нажать кнопку — «Настроить»
Галочки рекомендуем выключить, для того чтобы не всплывало лишнее диалоговое окно при проведении операции по кассе.
После нажатия кнопки — «Настроить», появится новая кнопка для установки компонентов.
На компьютер будет скачан exe файл который необходимо будет установить для корректной работы kkmserver. Если кнопка установки компонентов не появляется, то компоненты можно установить с официального сайта 🔗kkmserver.ru
Так же после установки компонентом рекомендуем проверить, установлен ли Framework на вашем компьютере, если - нет, то необходимо установить.
.NET Framework — это технология, которая поддерживает создание и выполнение веб-служб и приложений Windows.
Его можно скачать на официальном сайте 🔗Microsoft
2. Следующем шагов, после установки компонентов снова нужно нажать кнопку — «Настроить», после этого мы попадём в меню настройки kkm.
Для добавления кассового аппарата нужно перейти в раздел — «Настройка оборудования» → «Добавить устройство»
1. Выбираем любой номер устройства;
2. При добавлении кассового аппарата, выбираем — «Фискальный регистратор»;
3. Протокол устройства выбираем исходя из модели и производителя кассового аппарата, так же протокол устройства можно найти в интернете исходя из модели вашей кассы.
Пример: Если у вас касса модели Atol, то нужно выбрать протокол — Atol (Платформа 3/5): ККТ (ФФД 1.2)
После добавления устройства установите дистрибутив устройства
Убедиться в работоспособности оборудования поможет статус — «В работе» и следующие два шага:
1. Перейдите в тест оборудования, левом меню выберите добавленную вами кассу;
2. Нажмите — «Печать тестового чека» или X- отчёт.
3. Теперь после связки устройства с kkm его нужно добавить в ФитБейс
Для этого переходим в раздел — «Настройки» → «Интеграции» → «Кассовые аппараты»
Далее необходимо добавить устройство
В номере устройства ККМ указываем номер, который соответствует номеру устройству в меню настройки kkmserver.
Перейдите в раздел — «Касса» и откройте смену, зелёная точка слева от названия кассы говорит о корректной работе устройства.
Так же можете провести тестовый платёж на один рубль и посмотреть выйдет ли чек. Если чек вышел, то можно приступать к работе.
Если чек не вышел, то нужно перейти в раздел — «Логи команд» и посмотреть какая ошибка возникает при печати чека.
Один кассовый аппарат так же можно подключить к нескольким компьютерам.
Важно! Техническая поддержка не производит подключения кассового аппарат к нескольким компьютерам. Это может осуществить it-специалист который помогал с подключением кассового аппарата.
Ниже будет приведена инструкция для подключения кассового аппарата к нескольким компьютерам:
1. Необходимо на всех ПК установить статический IP адрес;
2. Задайте для ПК где стоит kkmserver - сетевое имя. (через файл C:\Windows\System32\drivers\etc\hosts или через Ваш DNS сервер);
3. Настройте сеть на всех ПК (в том числе и где стоит kkmserver) так, чтобы со всех машин на этот ПК проходил «ping» по этому сетевому имени. (через файл C:\Windows\System32\drivers\etc\hosts или через Ваш DNS сервер);
4. В настройках kkmserver сгенерируйте сертификат на это сетевое имя. На ПК где стоит kkmserver в firewall откройте порты 5893 и 5894. В форме расширения браузера (или если оно не используется - в настройках вашей системы) вместо localhost укажите это имя машины;
5. В расширении kkmserver в первом поле выберите — «Другой сервер» и введите в поле адрес машины, где установлен kkmserver, например: https://<IP машины с kkmserver>:5893 или http://<IP машины с kkmserver>:5893
6. На ПК где стоит kkmserver в firewall откройте порты 5893 и 5894.
Эквайринговый терминал
Подключение терминала схоже с подключением кассового аппарата.
Эквайринговый терминал нельзя подключить к системе без подключенного кассового аппарата.
При выборе самого терминала, его модель не важна.
Главное чтобы терминалом поддерживалась одна из следующих систем эквайринга:
ТТК2, СБРФ, INPAS, UCS, ARCUS-2 — то будет работать.
А так же на терминале должна быть обязательно включена возможность интеграции с другим ПО. Данную информацию можно уточнить у производителя терминала или у банка обслуживающего данный терминал.
1. При добавлении терминала в меню kkmserver, обязательно нужно выбрать правильный протокол терминала, данный протокол можно уточнить у производителя или посмотреть в интернете по модели и производителю кассового аппарата.
Тип устройства при добавлении терминала нужно выбрать — «Эквайринговый терминал»
2. После добавления терминала, в его настройках нужно указать идентификатор терминала, идентификатор терминала можно посмотреть на самом экране эквайрингового терминала. Не у всех терминалов нужно вводить ID терминала при его добавлении.
3. Следующим шагов, терминал необходимо указать в настройках интеграции в ФитБейс — «Настройки» → «Интеграции» → «Кассовые аппараты»
В ранее добавленном кассовом аппарате нужно указать номер терминала из меню kkmserver
После выполнения всех вышеперечисленных настроек, можно провести тестовый платёж с типом оплаты — «Карта»
Если чек вышел, то можно приступать к работе, если чек не вышел, то нужно перейти в раздел — «Логи команд» и посмотреть какая ошибка возникает при печати чека.
Наиболее частые ошибки и их решение
1. При любой проблеме с кассовым аппаратом/терминалом сделайте следующие несколько шагов, в 70% случаем проблема будет решена:
- Перезагрузите кассовый аппарат/терминал
- Переподключите устройство к компьютеру
- Перезагрузите компьютер
- Пересохраните настройки устройства в меню kkmserver
Что-то не получилось? Напишите техподдержке ФитБейс через виджет в правом нижнем углу экрана или в 🔗Telegram — мы поможем разобраться.