Мост кассы — простыми словами¶

Касса АТОЛ подключается проводом к одному компьютеру — кассовому ПК у стойки администратора. А админка клуба работает на сервере. Чтобы сервер мог «нажимать кнопки» кассы, на кассовом ПК стоит небольшая программа — мост кассы (kkm-bridge).

graph LR
    A["Админка<br/>(сервер клуба)"] -- "сеть, порт 16733" --> B["Мост<br/>(кассовый ПК)"]
    B -- "USB" --> C["Касса АТОЛ"]
    C -- "интернет" --> D["ОФД → налоговая"]

Мост — это переводчик: админка говорит ему «пробей чек на 300 ₽», мост передаёт это кассе на её языке (через драйвер АТОЛ) и возвращает ответ «пробито, чек № 15» или «не пробито, кончилась бумага».

Что важно запомнить¶


Где живёт	на кассовом ПК, папка `C:\kkm-bridge`
Запускается	сам, при входе в Windows; сторож раз в 5 минут поднимает его, если он упал
Своя страница	на кассовом ПК в браузере: `http://127.0.0.1:16733/ui/` — с других компьютеров не открывается
Токен моста	«пароль» между админкой и мостом: без него чужой компьютер в сети не пробьёт чек
Пароль страницы	отдельный, для кнопок на странице моста; задаётся один раз кодом установки

Мост ≠ касса

Мост может работать, а касса — нет (выключена, нет бумаги, отошёл кабель). Поэтому в админке два признака: «мост на связи» и «ККТ на связи». Смотрите на оба.

Если касса не работает — работа не встаёт¶

Пока мост или касса недоступны, продажи и пополнения продолжаются: чеки встают в очередь и допробиваются сами, когда связь вернётся. Вручную пробивать их не нужно — получится второй чек на ту же оплату.

Страница моста¶

Откройте на кассовом ПК http://127.0.0.1:16733/ui/. Там две вкладки:

«Подключение» — мастер-проверка, пароль не нужен. Выбираете устройство («Касса АТОЛ»), и мост сам по шагам проверяет:

установлен ли драйвер АТОЛ и какой версии;
видит ли Windows кассу по USB;
не занят ли порт кассы другой программой;
видит ли мост саму кассу и какая у неё прошивка;
совпадают ли часы кассы с точным временем;
закрыт ли мост токеном и есть ли связь с админкой;
готовность к ТС ПИоТ (нужна только для маркированного товара — см. ниже).

Каждый шаг — зелёный ✓, красный ✗ с подсказкой, что сделать, или «?», если проверить нельзя. Цель — все важные шаги зелёные.

«Касса» (нужен пароль страницы):

Здоровье кассы — смена, ФН, обмен с ОФД, бумага, часы;
Мост — «Переподключить кассу», «Освободить порт ККТ», «Перезапустить мост»;
Операции — X-отчёт, открыть/закрыть смену, «Подвести часы ККТ к ПК» (только при закрытой смене), проверка связи с ОФД и другие сервисные действия;
Журнал операций — что приходило из админки и что нажимали на странице.

Деньги в кассу (внесение/выдача) — только в админке: там они учитываются в смене.

Частые ситуации¶

Что видите	Что это значит	Что делать
В админке «Мост кассового ПК недоступен»	кассовый ПК выключен, нет сети, мост не запущен или у ПК сменился IP	включить ПК; на кассовом ПК запустить `C:\kkm-bridge\restart-bridge.bat`. Не помогло — «Адрес моста…» → «Найти в сети»
«Не задан IP кассового ПК»	в настройках кассы пустой адрес	«Адрес моста…» → вписать IP или «Найти в сети»
«ККТ не отвечает», мост на связи	касса выключена, кабель, бумага	проверить кассу и кабель (тип подключения написан в подсказке); на странице моста — «Переподключить кассу». Пока ККТ молчит, кнопки операций в «Кассе» серые
«Порт занят»	кассу держит штатная программа АТОЛ (веб-сервер драйвера)	страница моста → «Касса» → «Освободить порт ККТ». Бывает после обновления драйвера АТОЛ
«Смена истекла (24 часа)»	смену не закрыли вовремя	закрыть смену (Z-отчёт) в админке или на странице моста, затем открыть новую
«Мост принимает операции без токена»	мост поставлен без токена	запустить `kkm-bridge-setup.exe` ещё раз и вписать токен в админке
Чек «не пробит» в разделе «Чеки»	очередь пробовала, не вышло	подождать — повторится сам; если это дубль — «Аннулировать», не пробивать заново

Маркированный товар и ТС ПИоТ¶

Вода, энергетики и снеки с кодом DataMatrix с 01.10.2026 продаются только через ТС ПИоТ — отдельный модуль «Честного ЗНАКа» на кассовом ПК. Для него нужны прошивка кассы не ниже 5.17, драйвер АТОЛ 10.10.8.23 или новее со службой ЕСМ и сам модуль от АО «ЕСП». Пока на шаге «ТС ПИоТ» в мастере не всё зелёное, мост сам откажет в продаже маркированного — это защита от штрафа, а не поломка. Обычные товары и возвраты пробиваются как всегда.

Установка (делает поставщик вместе с вами)¶

Запустить на кассовом ПК kkm-bridge-setup.exe (Windows спросит права администратора). Python не нужен; брандмауэр, служба и ярлыки — сами.
Мастер покажет токен моста, код установки и IP этого ПК — сохраните. При обновлении токен прежний — в админке ничего менять не нужно.
Открыть страницу моста (ярлык на рабочем столе), задать пароль кодом установки.
Пройти мастер «Подключение» до зелёных шагов.
В админке: Касса → Устройства → касса → «Токен моста» и «IP кассового ПК» (или «Найти в сети»).

Обновление — тот же kkm-bridge-setup.exe поверх: токен, пароль и журнал сохраняются. Забыли пароль страницы — командная строка от администратора: C:\kkm-bridge\kkm-bridge.exe --reset-password → новый код установки.

Подробно, со всеми шагами по кассе, — Касса и чеки.