Касса и KKMServer

Beex передаёт кассовые операции в KKMServer. Для каждой точки выбирается подключение через расширение браузера или прямое подключение. При обращении сначала выясните, какой способ используется и к какой точке относится заказ.

Что такое KKMServer

KKMServer связывает рабочее место с кассой, принтерами и эквайринговым терминалом. Выполнение зависит от оборудования, его драйверов, фискального накопителя, оператора фискальных данных и связи на точке. Поддерживаемые устройства и условия установки перечислены на официальном сайте KKMServer.

Справочные инструкции:

• База знаний KKMServer
• Настройки программы
• Подключение АТОЛ
• Подключение Штрих-М
• Проверка связи с оператором фискальных данных
• Журнал ошибок операций

При диагностике фиксируйте модель кассы, версию KKMServer и драйвера. Для установки используйте инструкцию к фактической модели оборудования.

Подключение рабочего места

Управляющий открывает настройки точки → «Чеки и ККМ». Способ подключения, Адрес кассового сервера, Касса и Терминал сохраняются для точки, а не для отдельной вкладки браузера.

Через расширение. Установите и включите расширение KKMServer. Ранее настроенные рабочие места сохраняют этот способ после обновления Beex. Если расширение недоступно, может открыться обычная страница чека; это не подтверждает регистрацию фискального документа на кассе.

Напрямую. Укажите адрес KKMServer и при необходимости логин и пароль. Нажмите «Проверить подключение», явно выберите кассу и сохраните настройки. Для отдельных операций эквайринга выберите терминал. Если браузер запрашивает разрешение на локальную сеть, разрешите соединение по правилам рабочего места. KKMServer должен оставаться запущенным.

«Проверить подключение» получает список оборудования и не печатает чек. Первая найденная касса не выбирается автоматически. Кухонные принтеры сохраняют отдельные назначения.

Пароль подключения не показывается в форме. При изменении адреса сервера или логина задайте пароль заново либо явно удалите его. Если Beex недоступен, новая команда прямой печати не отправляется. Ошибка не переключает печать автоматически на другую кассу или другой способ подключения.

Данные кассира

При прямом подключении оператор открывает шестерёнку «Кассир и ККМ» в верхней части рабочего экрана. Она доступна для активной точки.

ФИО кассира и ИНН кассира сохраняются в профиле сотрудника. ФИО обязательно, допускается до 70 символов. ИНН можно оставить пустым; заполненный ИНН должен содержать 12 цифр. Сначала сохраните изменения, затем выполняйте кассовые операции.

Сохранённые личные данные имеют приоритет при прямой печати. При отсутствии личного ФИО используются сведения, уже переданные для чека, а при их отсутствии — прежние настройки точки. Расширение сохраняет прежний порядок получения кассира.

Операции в кабинете

Beex поддерживает печать фискального чека и пречека, кухонную печать, открытие и закрытие смены, отчёт без закрытия, внесение и изъятие наличных, сверку и отчёты терминала.

В окне «Кассир и ККМ»:

• «Открыть смену» начинает кассовую смену;
• закрытие с итоговым отчётом завершает кассовую смену;
• отчёт без закрытия показывает промежуточный результат;
• внесение и изъятие принимают положительную сумму с точностью до двух знаков после запятой.

Закрытие смены и операции с наличными требуют подтверждения в интерфейсе. Дождитесь результата оборудования.

Если для точки выбран терминал, доступна вкладка «Эквайринг». Выберите «Просмотреть» или «Напечатать на ККМ», затем «Сверка итогов», «Краткий отчёт» или «Полный отчёт».

Сверка итогов закрывает смену эквайринга и требует подтверждения. Краткий и полный отчёты её не закрывают. Печать на ККМ создаёт нефискальную копию полученного текста; терминал может дополнительно печатать по настройкам банка.

Если текст не вернулся, не повторяйте банковскую операцию только ради печати. При ошибке печати копии текст остаётся доступен для просмотра и повторной печати копии до закрытия окна или смены точки.

Базовая схема печати

1. Оператор сохраняет или подтверждает заказ, затем запускается выбранная печать.
2. Beex передаёт состав, суммы, тип документа, кассира и оплату оборудованию выбранной точки.
3. Индикатор печати показывает ожидание, не закрывая остальной кабинет.
4. Повторный запуск той же печати во время ожидания блокируется.
5. Только окончательный успешный ответ отмечает чек как напечатанный.

Ошибка печати не отменяет уже подтверждённый заказ. Повторное сохранение после ошибки не должно создавать заказ заново или самостоятельно повторять печать.

Результат операции неизвестен

Потеря связи не доказывает, что оборудование ничего не выполнило. Beex уточняет результат отправленной операции, но не должен автоматически создавать второй чек. Сначала проверьте кассу и журнал KKMServer; затем решайте, нужна ли повторная печать через «Чек» или «Пречек».

Фискальный чек и пречек

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

Для заказов агрегаторов кабинет формирует нефискальный документ. Налоговые параметры и требуемый порядок оформления согласуйте с ответственным за кассу у клиента.

Типы оплаты

Оплата заказа	Поведение печати Beex
Онлайн	Передаётся как безналичная оплата в размере оплаченной суммы; повторное списание через терминал не запускается.
Терминал и QR-код	Передаются как безналичная оплата; проведение через терминал зависит от настройки точки.
Наличные и Банковский перевод	В текущей реализации используют наличный способ передачи суммы в кассу. Если указана полученная сумма, в пречеке отображается сдача.

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

Проведение оплаты через терминал запускает эквайринговую операцию. Включение этой настройки при неверно выбранном или недоступном терминале приводит к ошибке либо ожиданию ответа.

Выбор терминала

Для прямого подключения используется терминал, явно выбранный в настройках точки. Универсального номера для всех точек нет.

В прежнем сценарии закрытия дня через расширение сохранён номер устройства 2. Если ошибка возникает именно там, сверяйте номер терминала в KKMServer с этим сценарием; не переносите его автоматически в настройки прямого подключения.

При ошибке сверки проверьте наличие терминала, его выбор для точки, связь, настройку проведения оплаты и журнал последней операции.

Настройка перед запуском точки

1. Установите KKMServer и подключите кассу по инструкции производителя.
2. Установите необходимые драйверы и проверьте соединение с кассой.
3. Убедитесь, что KKMServer видит оборудование.
4. Выберите способ подключения в Beex; для расширения проверьте его установку, для прямого режима — кассу и терминал.
5. Сохраните данные кассира.
6. На согласованном тестовом оборудовании проверьте чек, возврат, пречек, кухонную печать и нужные операции смены.
7. Проверьте связь с оператором фискальных данных.
8. После перезапуска KKMServer повторно проверьте назначение устройств.
9. Перед началом работы убедитесь, что результаты операций отражаются в заказах Beex.

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

Для ошибки печати соберите:

• бренд, город, точку и номер заказа;
• способ оплаты и вид документа;
• время и полный текст ошибки;
• способ подключения, модель и состояние кассы;
• снимок окна KKMServer без паролей;
• журнал конкретной операции;
• сведения о неотправленных фискальных документах и дате первого из них.

АТОЛ и Штрих-М

Для АТОЛ проверьте совместимый драйвер, выбранный способ соединения, состояние кассы и фискального накопителя. Для Штрих-М также проверьте параметры соединения и выполните проверку состояния устройства в KKMServer. Сверяйте параметры с официальной инструкцией для конкретной модели.

Ошибки, которые нужно эскалировать

Передайте обращение разработчикам или старшей поддержке, если:

• касса подтвердила успешную печать, а заказ остаётся без отметки Чек напечатан;
• повторяется ошибка округления суммы;
• способ оплаты определяется неверно;
• возврат запускается в неподходящем сценарии;
• агрегаторный заказ печатается как фискальный;
• подтверждённый заказ создаётся повторно после ошибки печати;
• результат операции остаётся неизвестным после проверки оборудования.

В обращении отделяйте подтверждённый результат кассы от того, что показывает кабинет.