Инструкция для площадок в Республике Казахстан, где фискализация выполняется через облачный сервис Webkassa.kz. Чеки уходят в Webkassa по интернету; на рабочем месте рецепции не нужны USB- или COM-подключение кассы и служба ФР.
В списке фискальных регистраторов ClubIS выбирайте Webkassa.kz (не локальный АТОЛ, ШТРИХ и т.п.).
SWK…, присваивается кассе в Webkassa.api.webkassa.kz (исходящие HTTPS-запросы не должны блокироваться firewall).Для товаров с GTIN и NTIN коды указываются в карточке товара в прайсе — см. GTIN и NTIN (Казахстан). Коды маркировки передаются в чек при настройке маркировки в ClubIS.
Точные названия пунктов меню зависят от версии кабинета. Общий порядок:
Ключ интеграции X-API-KEY для ClubIS задаётся в программе автоматически — в настройках рецепции его указывать не нужно.
Откройте Рецепция → Настройки → Оборудование → Фискальные регистраторы.
Выберите юр. лицо и откройте свойства фискального регистратора.
В поле Фискальный регистратор выберите Webkassa.kz.
В блоке Параметры облака укажите:
SWK…).Поле Хост для Webkassa в ClubIS не используется.
На вкладке Основное:
На вкладке Секции ФР задайте секции и налоговые группы для позиций прайса или используйте глобальные настройки — см. настройки налогов.
На вкладке Кассир при необходимости укажите фиксированного кассира (ФИО и ИИН).
Сохраните настройки.
Поле Пароль с галочкой на вкладке «Основное» (пароль доступа к классической ККМ) для Webkassa не используется.
При оплате с фискализацией ClubIS отправляет чек в Webkassa по API v4. Сервис регистрирует документ на указанной кассе; в ClubIS сохраняется ссылка на электронный чек.
Поддерживаются типичные сценарии рецепции:
Бумажный чек на принтере рецепции не печатается — фискальный документ формируется в Webkassa. Ссылку на чек можно показать клиенту с экрана или отправить по контактам из анкеты.
Через Webkassa в ClubIS также доступны X-отчёт, Z-отчёт (закрытие смены), внесение и изъятие наличных — см. Работа с ККМ.
| Симптом | Что проверить |
|---|---|
| Ошибка авторизации, неверный логин/пароль | Пользователь и Пароль в блоке «Параметры облака»; учётная запись активна в Webkassa |
| Касса не найдена, неверный номер | Код группы = уникальный номер кассы SWK… из кабинета Webkassa |
| Смена закрыта | Откройте смену в Webkassa или через Работа с ККМ в ClubIS |
| Ошибки по НДС, секциям | Настройки налогов и локальные настройки ФР: секции и ставки для Казахстана |
| Таймаут, нет связи | Интернет на ПК рецепции; доступ к api.webkassa.kz; firewall |
| Ошибки GTIN/NTIN | Формат кодов в прайсе — GTIN и NTIN (Казахстан) |
| «Функция не поддерживается» | Через этот тип ФР доступны операции, реализованные в протоколе Webkassa; нестандартные сценарии уточняйте у поддержки |
Текст ошибки при оплате обычно приходит от Webkassa — передайте его в поддержку Webkassa или интегратору.
Журналы на компьютере рецепции — см. где хранятся логи ККМ.