💱Настройка интеграции и ККМ и подключение кассового аппарата и терминала

Данная интеграция необходима, для связки физического фискального накопителя/эквайрингового терминала с системой. Интеграция осуществляется путём настройки расширения и ПО 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 — мы поможем разобраться.

Какое ещё оборудование можно подключить? ➡️

⬅️ 10 шагов для настройки FitBase