Как подключить Companion и настроить кассу

Тарифы и пакеты настроены, но продавать их пока не через что: нужна точка продаж — пк, с которого администратор оформляет продажи товаров и пакетов. Точкой продаж его делает Gizmo Companion — приложение-мост между сервером Gizmo и кассовым оборудованием: фискальным принтером, терминалом эквайринга, денежным ящиком, сканером штрихкодов. Без Companion продажи не заработают.

Схема такая: на каждую точку продаж устанавливается свой Companion, он подключается к серверу, а затем привязывается к кассе в Gizmo Manager. В одном клубе может быть несколько касс. Кассовый аппарат и терминал эквайринга можно подключить сразу или позже — на настройку Companion и кассы они не влияют. Подробнее о Companion — в статье «Gizmo Companion».

Шаг 1. Создайте компаньон в Gizmo Manager

Один компаньон — на одну точку продаж (пк).

  1. Откройте Настройки → Сервер → Компаньоны и нажмите Создать Companion в правом верхнем углу.

  2. Укажите Имя — понятное, например по расположению точки продаж: «Стойка, 1 этаж».

  3. Сохраните. Компаньон появится в списке.

  4. Дважды нажмите на компаньон — откроется его карточка. Скопируйте токен иконкой копирования в поле Токен: он понадобится в шаге 3.

Подробнее — в статье «Компаньоны».

Шаг 2. Установите Companion на пк точки продаж

  1. Откройте Настройки → Другое → О программе и в блоке Загрузки скачайте установщик Компаньон Gizmo.

  2. Запустите установщик на том пк, с которого будете продавать (обычно это пк администратора), и пройдите все шаги.

Подробнее — в статье «О программе».

Шаг 3. Подключите Companion к серверу

  1. На пк точки продаж откройте интерфейс Companion — ярлыком на рабочем столе или по адресу localhost:8000 в браузере на этом же пк.

  2. В настройках подключения укажите:

    • Протокол;

    • Имя хоста — локальный IP сервера Gizmo;

    • Порт — по умолчанию 80.

  3. Вставьте токен из шага 1, убедитесь, что значение в поле изменилось, и сохраните.

  4. Вернитесь в Gizmo Manager, в Настройки → Сервер → Компаньоны, и проверьте, что в столбце Статус указано Подключено. Если нет — пройдите шаги заново.

Как узнать локальный IP сервера — в инструкции «Доступ к Gizmo по сети».

Шаг 4. Подключите сканер штрихкода и другие POS-устройства

Этот шаг нужен, если к пк точки продаж физически подключены сканер штрихкода, денежный ящик или считыватель смарт-карт.

  1. В интерфейсе Companion, на панели слева, откройте POS устройства.

  2. Укажите COM-порты подключённых устройств: денежного ящика, сканера штрихкода, считывателя смарт-карт.

  3. Сохраните настройки.

Раздел подключения самой кассы в Companion пока не трогайте — о нём в шаге 6.

Сканер штрихкода обязателен, если вы продаёте товары с маркировкой «Честный знак», и просто удобен, чтобы находить товары быстрее, чем вручную. Чтобы товар находился по сканеру, заполните поле Штрихкод в его карточке — см. «Карточка товара». Штрихкод можно задать и пакету времени.

Как подготовить сканер штрихкода

По умолчанию большинство сканеров работают в режиме эмуляции клавиатуры. Для работы с Companion сканер нужно перевести в режим COM-порта:

  1. Подключите сканер к пк точки продаж и установите драйвер виртуального COM-порта для вашей модели — он есть на сайте производителя сканера. Драйвер для сканеров на примере SB2108 Plus: [ССЫЛКА: драйвер виртуального COM-порта].

  2. Переведите сканер в режим эмуляции COM-порта — для этого отсканируйте служебный штрихкод из инструкции к сканеру.

  3. Откройте Диспетчер устройств → Порты (COM и LPT): там появится сканер с номером COM-порта. Этот порт укажите в разделе POS устройства Companion.

  4. Настройте суффикс CRLF (Enter) — сканер передаёт данные в формате <префикс>данные<суффикс>, и без суффикса товар не добавится в корзину автоматически. Суффикс тоже задаётся служебным штрихкодом из инструкции к сканеру.

  5. Для «Честного знака» включите на сканере поддержку GS1 DataMatrix и символику FNC1 — без них коды маркировки не считываются.

Если непонятно, какие данные передаёт сканер, воспользуйтесь утилитой ScannerTest — [ССЫЛКА: ScannerTest]. Запустите её, выберите COM-порт сканера, нажмите Запустить и отсканируйте товар: утилита покажет вывод сканера в ASCII и HEX. Перед запуском закройте другие программы, которые используют этот COM-порт.

Шаг 5. Привяжите Companion к кассе

  1. Откройте Настройки → Финансовый → Кассы. Здесь уже могут быть кассы — это имена всех пк, которые когда-либо подключались к серверу.

  2. Откройте кассу пк точки продаж. Если её нет, нажмите Создать кассу.

  3. Заполните поля:

    • Филиал — обязательное поле;

    • Компаньон — компаньон из шага 1;

    • Номер — порядковый номер кассы среди всех точек продаж;

    • Имя — любое удобное название, обязательное поле;

    • Наличных на начало смены — оставьте 0 или укажите сумму, если в начале смены в кассе уже должны числиться наличные.

  4. Если точка продаж в клубе одна, включите Касса по умолчанию для филиала.

  5. Поля с номерами терминала, принтеров и QR-дисплея пока не трогайте — они нужны только для подключения кассового аппарата и терминала эквайринга.

  6. Сохраните изменения.

Ненужные кассы можно удалить и оставить только реальные точки продаж — так раздел будет проще читать.

Все поля кассы — в статье «Карточка кассы».

Шаг 6. Подключите кассовый аппарат и терминал эквайринга

Только для клубов, которые подключают к Gizmo ККТ или терминал эквайринга.

Техническое подключение кассового аппарата и терминала — отдельный процесс, с ним помогает поддержка удалённо. Со стороны Gizmo Manager сделайте следующее:

  1. В Настройки → Финансовый → Кассы откройте кассу точки продаж и укажите Номер принтера фискальных чеков (ККТ) и/или Номер платежного терминала — нумерация указана в KKMServer.

  2. В Настройки → Организация → Налоги и валюта укажите валюту и заполните Настройки налогов — эти параметры используются при печати чеков. Если у филиалов разные юридические лица, налоги для них переназначаются в разделе «Филиалы». Подробнее — в статье «Налоги и валюта».

  3. Сохраните изменения.

Подготовка ККТ и терминала (драйверы, ККМ-сервер), остальные настройки Gizmo Manager и особенности работы в фискальном режиме — в статье «Фискализация чеков в РФ». Если продаёте маркированные товары, настройте также ТС ПИоТ.

Если Companion не видит фискальный принтер, проверьте:

  • касса включена и готова к работе;

  • кабель USB или Ethernet надёжно подключён и не повреждён;

  • на пк установлен драйвер кассы;

  • Companion запущен с правами администратора;

  • в настройках Companion правильно указан адрес сервера Gizmo;

  • в разделе Фискальный принтер Companion в поле Тип принтера выбрано ККМ.

Подробности об ошибках — в логах Companion: папка установки Companion, подпапка Logs.

Если интеграцию с ККМ-сервером ранее настраивали наши специалисты, обратитесь в чат поддержки — мы подскажем нужные данные для ввода.

Чтобы оплата картой проходила через терминал, включите его в способах оплаты — см. инструкцию «Как настроить способы оплаты».

Результат

  • Пк администратора стал точкой продаж: Companion подключён к серверу и привязан к кассе.

  • Продажи товаров и пакетов проходят через эту кассу.

  • Если подключён сканер, товары находятся по штрихкоду.

  • Если подключены ККТ и терминал эквайринга, Companion передаёт им команды на печать чеков и оплату картой.

Работа с кассой в течение смены — в статье «Касса».