База знаний сервиса Rent in Hand
Интеграции

Интеграция с онлайн-кассой через KKM-сервер

Подключение онлайн-кассы АТОЛ

После настройки вы сможете пробивать фискальные чеки прямо из RentInHand — при оформлении и оплате аренды.

Что понадобится

  • Онлайн-касса АТОЛ с активным фискальным накопителем. Для проверки без «живой» кассы подойдёт встроенный эмулятор.
  • Данные для регистрации кассы: система налогообложения, имя кассира и его ИНН.

Как это работает

RentInHand не связывается с кассой напрямую. Между сайтом и кассой работают две программы: локальная «ККМ Сервер» и расширение для Chrome.
RentInHand → расширение Chrome «ККМ Сервер» → программа «ККМ Сервер» → касса АТОЛ
Программа «ККМ Сервер», расширение Chrome и открытый сайт RentInHand должны быть на одном компьютере — том, к которому подключена касса.

Шаг 1. Установите программу «ККМ Сервер»

  1. Откройте сайт kkmserver.ru.
  2. Скачайте программу «ККМ Сервер».
  3. Запустите установщик, выберите папку установки и завершите установку.
  4. После установки появится иконка «ККМ Сервер» — запустите программу.

Шаг 2. Установите расширение для Chrome или другого доступного браузера

  1. Установите расширение «ККМ Сервер 1» (ссылку на него даёт сайт kkmserver.ru или магазин расширений Chrome).
  2. Закрепите расширение на панели браузера, чтобы оно было под рукой. Настроим его чуть позже — сначала подключим кассу.

Шаг 3. Добавьте кассу в «ККМ Сервер»

  1. В запущенной программе «ККМ Сервер» откройте Настройки — откроется страница localhost:5893.
  2. Перейдите в Настройка оборудования → Добавить устройство.
  3. Укажите:
  • Номер устройства — обычно 1, если касса одна;
  • Тип устройства — модель вашей кассы АТОЛ (или Эмулятор для теста);
  • Протокол устройства — соответствующий модели.
Нажмите Добавить устройство.

Шаг 4. Зарегистрируйте кассу

  1. Выберите в списке только что добавленное устройство.
  2. Выберите команду Регистрация и заполните настройки:
  • Система налогообложения — по которой вы работаете. Запомните выбор — его нужно будет повторить в настройках RentInHand.
  • «Расчёты только в интернете» — поставьте галочку по желанию.
  • Имя кассира и его ИНН.
Нажмите Зарегистрировать ККМ.
Если всё заполнено верно — появится статус OK. Касса готова к работе.

Шаг 5. Настройте расширение Chrome

  1. Откройте расширение «ККМ Сервер» на панели браузера.
  2. Выберите режим работы:
  • Эмулятор — для проверки без реальной печати;
  • Реальное устройство — для боевой работы (касса из Шага 4).
По желанию включите две дополнительные галочки (показ результата операции) и сохраните настройки.

Шаг 6. Включите интеграцию в RentInHand

  1. Откройте RentInHand в том же браузере Chrome и обновите страницу — чтобы сервис «увидел» установленное расширение.
  2. Перейдите в Настройки → Интеграции.
  3. Найдите «Онлайн-касса АТОЛ» и нажмите Подключить.
  4. Укажите:
  • Вид НДС — ставку НДС для позиций чека;
  • Систему налогообложения — ту же, что задали при регистрации кассы (Шаг 4).
Нажмите Сохранить.
Система налогообложения и вид НДС в RentInHand должны совпадать с регистрацией кассы. Иначе касса отклонит чек.
Готово — интеграция с онлайн-кассой АТОЛ подключена. Теперь чеки пробиваются прямо из RentInHand.

Частые вопросы

RentInHand «не видит» кассу, кнопки печати нет.
Проверьте, что расширение «ККМ Сервер» установлено и включено, а страницу RentInHand обновили после его установки.
Появилась ошибка при печати чека
Текст ошибки во всплывающем окне возвращает сама касса — прочитайте его дословно, он подсказывает причину (чаще всего — несовпадение налоговых настроек или реквизитов).
Касса отклоняет чек
Сверьте систему налогообложения и вид НДС в настройках интеграции RentInHand с тем, что указано при регистрации кассы.
Не открывается страница настроек ККМ Сервера
Убедитесь, что программа «ККМ Сервер» запущена, и откройте localhost:5893. Проверить саму кассу можно в Настройках сервера → Тест оборудования.
Не получилось подключить? Напишите в поддержку RentInHand — поможем настроить.
2023-07-03 17:18