Касса и чеки¶
Продукт пробивает фискальные чеки сам: продажи бара и магазина, пополнения баланса, тарифы, онлайн-оплаты, возвраты. Кассир ничего не вводит в кассу руками — чек уходит при операции в админке.
Какая касса подойдёт¶
Кассу добавляют в админке: Система → Касса → «Устройства» → «Добавить устройство», поле «Тип устройства». Когда вы выбираете тип, форма сама показывает, что эта касса умеет и чего не умеет в продукте. Ниже — то же самое одной таблицей.
| АТОЛ (локальная касса) | Штрих-М через KKM Server | Облачная касса АТОЛ-совместимая | CloudKassir (облако) | Эвотор (облако) — скоро | |
|---|---|---|---|---|---|
| Где стоит | у стойки, USB к кассовому ПК | у стойки, к кассовому ПК | в облаке, кассового ПК нет | в облаке, кассового ПК нет | — |
| Что нужно | драйвер АТОЛ и наш мост кассы | платная программа KKM Server на кассовом ПК | договор с облачной кассой (АТОЛ Онлайн, ОФД.ru Ferma или Первый ОФД) | договор с CloudKassir, электронная подпись | — |
| Чек продажи и возврата | да | да | да | да | скоро |
| Смена | открытие и закрытие из админки | открытие и закрытие из админки | облако ведёт само | облако ведёт само | — |
| X-отчёт, внесение и выемка, денежный ящик, обмен с ОФД | да | нет | нет | нет | — |
| Чек коррекции | нет — исправление на самой кассе | да | да | да | — |
| Чек онлайн-оплаты вашей кассой | да (нужна прошивка ККТ 5.16 или новее) | нет — выберите «ЮKassa» | да | да | — |
| Чек покупателю на почту или телефон | при онлайн-оплате | нет | да | да | — |
| Маркированный товар | через ТС ПИоТ, шаг 8 | коды передаются в чек, проверку ведёт KKM Server | коды передаются в чек — живьём не проверено | коды передаются в чек — живьём не проверено | — |
| Подробно | эта страница, ниже | Штрих-М через KKM Server | Облачные кассы | Облачные кассы | Облачные кассы |
Эвотор — скоро
В списке типов касс «Эвотор (облако) — скоро» серый: выбрать его пока нельзя. Подробнее — Облачные кассы.
Что выбрать. Касса уже стоит или покупаете новую — АТОЛ: это основной, проверенный вариант, всё ниже на этой странице — про него. Уже есть Штрих-М — через KKM Server. Не хотите держать кассу у стойки — облачная касса.
АТОЛ — настройка по шагам¶
Как устроена связь «админка → касса», простыми словами — на странице Мост кассы. Прочитайте её сначала: дальше всё станет понятнее.
graph LR
A["Админка<br/>(сервер клуба)"] --> B["Мост<br/>(кассовый ПК)"]
B --> C["Касса АТОЛ (USB)"]
C --> D["ОФД → налоговая"]Какие кассы АТОЛ подходят
Модели из совместимости драйвера АТОЛ: 1Ф, 11Ф, 15Ф, 20Ф, 22Ф, 22v2Ф, 25Ф, 27Ф, 30Ф, 35Ф, 42ФС, 47ФА, 50Ф, 55Ф, 77Ф, 91Ф, 92Ф, СТ-5Ф, «Казначей ФА» — модель драйвер определяет сам. В работе проверена 50Ф. Касса нужна с фискальным накопителем и подключается по USB к кассовому ПК.
Порядок важен
Шаги 1–3 — юридические, их делают до подключения к системе: незарегистрированная касса чеки не пробьёт.
Шаг 0. Решите заранее¶
| Вопрос | Что выбрать | Где потом указать |
|---|---|---|
| Кто пробивает чеки онлайн-оплат (приложение игрока, ЮKassa) | ваша касса (рекомендуем — все чеки в одном месте) или сама ЮKassa | Настройки → «Оплата и кредиты» → «Кто пробивает чеки онлайн-оплат» |
| Продаёте ли маркированное (вода, энергетики, снеки с DataMatrix) | нет — продажа просто закрыта; да — нужен ТС ПИоТ (шаг 8) | Настройки → Фискализация / ККМ |
| Система налогообложения и НДС | уточните у бухгалтера (часто «УСН доход», без НДС) | карточка кассы в админке |
| Банковский терминал | работает отдельно: сумму вводит кассир, в админке выбирается «Карта» | — |
Шаг 1. Касса, ФН и ОФД¶
- Купите или арендуйте кассу АТОЛ и фискальный накопитель (ФН) — срок 15 или 36 месяцев, подскажет бухгалтер.
- Заключите договор с ОФД (оператор фискальных данных).
Шаг 2. Регистрация в налоговой¶
Зарегистрируйте кассу в ФНС — через личный кабинет налогоплательщика или сервисный центр:
- формат документов ФФД 1.2;
- если будете продавать маркированное — сразу с признаком «торговля маркированными товарами» (перерегистрация потом — отдельная процедура);
- в кассе указан адрес ОФД; часы кассы — по местному времени.
Шаг 3. Кассовый ПК¶
Обычный Windows-ПК у стойки администратора. Касса — к нему по USB.
- Драйвер АТОЛ (ДТО) 10.10 — с сайта АТОЛ. Если планируете маркированное — сразу версию 10.10.8.23 или новее с компонентами для ЕСМ.
- Закрепите за ПК постоянный IP в роутере — по нему сервер клуба находит мост.
Шаг 4. Мост кассы¶
- Скачайте
kkm-bridge-setup.exe(комплект на портале лицензий) и запустите на кассовом ПК — Windows спросит права администратора. Python не нужен. -
Мастер сам проверит драйвер АТОЛ, уберёт прежний мост, откроет порт 16733 в брандмауэре (только для локальной сети), поставит службу Windows и ярлыки «Страница моста кассы» и «Перезапустить мост кассы» на рабочий стол. В конце он покажет:
- токен моста — для админки;
- код установки — чтобы задать пароль страницы моста;
- IP этого ПК — для админки (или там же кнопка «Найти в сети»).
Токен и код сохраните (в менеджере паролей, не на бумажке у кассы). 3. Открыть на кассовом ПК в браузере
http://127.0.0.1:16733/ui/, задать пароль страницы. 4. Вкладка «Подключение» → «Касса АТОЛ»: мастер проверит драйвер, кабель, порт, прошивку, часы, токен и связь с админкой. Исправляйте то, что красное, и жмите «Проверить всё заново», пока важные шаги не станут зелёными.
«Порт занят»
Чаще всего кассу держит штатная программа драйвера АТОЛ (его веб-сервер). На странице моста: «Касса» → «Освободить порт ККТ». После каждого обновления драйвера АТОЛ это может повториться.
Шаг 5. Касса в админке¶
- Админка → Система → Касса → вкладка «Устройства» → «Добавить устройство».
- «Тип устройства» — «АТОЛ ККМ (локальная касса)». Заполните:
- «IP кассового ПК» — или кнопка «Найти в сети» под полем: админка сама найдёт мост в сети клуба, останется нажать «Подставить». «Порт» — 16733, не меняйте;
- «Токен моста» — из шага 4;
- «ФИО кассира (тег 1021)» — печатается в каждом чеке, обязательно; «ИНН кассира (тег 1203)» — можно не заполнять;
- «ИНН» (организации), «Система налогообложения», «Тип НДС».
- В строке кассы — значок «Проверить соединение» (название видно при наведении мыши) — касса должна стать «В сети».
Закрепите адрес кассового ПК
Если роутер раздаёт адреса сам (DHCP), после перезагрузки кассовый ПК может получить новый IP — и касса «пропадёт». Закрепите за ним постоянный адрес в настройках роутера. Если адрес всё же сменился: «Касса» → «Адрес моста…» → «Найти в сети» → «Подставить».
- Админка → Система → Настройки → Фискализация / ККМ → «Чеки включены».
На вкладке «Касса» теперь видно здоровье кассы: смена, ФН, обмен с ОФД, бумага, версии и чек-лист ТС ПИоТ. В шапке админки — бейдж кассы: персонал сразу видит, если касса отвалилась.
Шаг 6. Первая смена и пробный чек — вместе с поставщиком¶
- «Открыть смену» — номер смены берётся у самой кассы.
- «Тестовый чек» — продажа и возврат на 1 ₽ наличными. Оба чека — «успешно».
- В личном кабинете ОФД виден чек; на вкладке «Касса» в блоке «ФН и ОФД» — «Всё передано».
- Вечером — «Закрыть смену» (Z-отчёт). Можно включить автозакрытие смены по времени в Настройки → Фискализация / ККМ.
Смена кассы живёт 24 часа
Если смену не закрыть, через 24 часа касса перестанет пробивать чеки. Закройте смену (админка или страница моста) и откройте новую.
Шаг 7. Онлайн-оплаты (ЮKassa)¶
Выберите один источник чеков для онлайн-оплат — Настройки → «Оплата и кредиты» → «Кто пробивает чеки онлайн-оплат» — и сделайте так же в кабинете ЮKassa:
- «Наша касса» → в кабинете ЮKassa «Чеки от ЮKassa» выключены;
- «ЮKassa» → в кабинете чеки включены, ваша касса эти оплаты не пробивает.
Если настройка и кабинет разойдутся, продукт пришлёт предупреждение в Telegram. Подробнее — Платежи.
Шаг 8. Маркированные товары (если продаёте)¶
С 01.10.2026 маркированное продаётся только через ТС ПИоТ — старая проверка кодов на кассе отключена. Что нужно:
- Регистрация в «Честном ЗНАКе» (ГИС МТ) с электронной подписью, приёмка товара по ЭДО.
- Заявка в АО «ЕСП» на модуль ЕСМ (это и есть ТС ПИоТ на кассовом ПК).
- Прошивка кассы 5.17 или новее (обновление прошивки АТОЛ — платное, через партнёра АТОЛ) и драйвер 10.10.8.23+ с компонентами ЕСМ.
- 2D-сканер DataMatrix на кассу.
- У маркированных товаров в магазине — отметка «маркированный», GTIN и товарная группа.
Готовность видна в двух местах: шаг «ТС ПИоТ» в мастере моста и чек-лист под переключателем «Продавать маркированный товар (ТС ПИоТ)» в настройках. Пока там не всё зелёное, продажа маркированного закрыта: гость видит товар недоступным, касса — причину, мост сам откажет в таком чеке. Это защита от штрафа, а не поломка.
Шаг 9. Возвраты — проверьте на малых суммах¶
| Что возвращаем | Как уходят деньги | Чек |
|---|---|---|
| Баланс гостя — наличными | из кассы | сразу |
| Баланс гостя — на карту через терминал | кассир делает «Возврат» на терминале и вводит RRN с чека терминала — без него возврат не проводится | сразу |
| Баланс гостя — через ЮKassa | автоматически на карту/СБП, с которых гость пополнял (1–3 дня) | когда ЮKassa подтвердит |
| Заказ бара, оплаченный онлайн, до выдачи | удержание денег просто отменяется | не нужен — продажи не было |
| Заказ после выдачи | через ЮKassa / терминал / на баланс | повторяет позиции чека продажи |
Если ЮKassa или терминал отказали, возврат не проводится и баланс не списывается: админка покажет причину, вам придёт уведомление в Telegram.
Перед открытием — итоговая проверка¶
- [ ] Мастер «Подключение» на странице моста — важные шаги зелёные.
- [ ] Бейдж кассы в админке зелёный, смена открывается и закрывается.
- [ ] Тестовые продажа и возврат прошли и видны в ОФД.
- [ ] Пополнение через приложение игрока — чек ровно один (вашей кассой или ЮKassa).
- [ ] Возвраты из шага 9 проверены.
- [ ] В разделе «Чеки» нет чеков с ошибкой.
- [ ] Уведомления о кассе приходят вам в Telegram.
- [ ] Маркированное: либо выключено, либо ТС ПИоТ проверен живым кодом.
Ежедневная работа¶
- Открытие и закрытие смены в админке — это и смена на кассе.
- Касса выключена или зависла — продажи не останавливаются: чеки копятся в очереди и допробиваются сами, когда касса вернётся (до 5 попыток за 48 часов).
- Вручную «заново продажей» чек не пробивайте — получится дубль.
- Если в «Чеках» есть дубль (одна оплата — два чека) — «Аннулировать» (пароль и причина): он не будет пробит никогда.
- Чеки, которые сами уже не пробьются, раз в сутки приходят сводкой в Telegram.
Если чеки не пробиваются¶
- Бейдж кассы красный? Кассовый ПК включён, кабель на месте?
- На кассовом ПК откройте страницу моста
http://127.0.0.1:16733/ui/— «Подключение» покажет, что именно не так. - Не помогло — «Касса» → «Переподключить кассу» → «Освободить порт ККТ» → «Перезапустить
мост» (или запустите
C:\kkm-bridge\restart-bridge.bat). - Ошибка самой кассы (бумага, ФН заполнен или истёк) — по инструкции АТОЛ; замена ФН — плановая процедура раз в 15/36 месяцев.
Ещё подробнее — таблица «Частые ситуации» на странице Мост кассы.