Инструкция для площадок, где фискализация выполняется через облачную кассу Orange Data. Чеки уходят в сервис Orange Data по интернету с подписью запроса; на рабочем месте рецепции не нужны USB- или COM-подключение кассы и служба ФР.
Не путайте с локальным ФР: для кассы, подключённой к компьютеру по кабелю, выбирайте соответствующий тип в списке (АТОЛ, ШТРИХ и т.д.). Для Orange Data в списке фискальных регистраторов выбирайте Orange Data.
¶ Что понадобится
- Договор и личный кабинет Orange Data с зарегистрированной облачной кассой.
- Компьютер с модулем Рецепция и доступом в интернет до
api.orangedata.ru(исходящие HTTPS-запросы не должны блокироваться межсетевым экраном). - Windows-компьютер для однократной генерации ключей и сертификата (утилита Nebula.KeysGenerator; пути в инструкции даны для Windows, каталог можно выбрать другой, но удобно хранить все файлы в одной папке).
- В ClubIS для юр. лица заполнен ИНН в справочнике организаций.
- Настроены налоговые группы и при необходимости секции ФР — см. настройки налогов.
Для маркированных товаров касса в Orange Data должна поддерживать ФФД 1.2; в ClubIS — настройки ТС ПИоТ и маркировки.
¶ Подготовка ключей и сертификата в личном кабинете Orange Data
Ниже — пошаговая настройка прямого подключения (интеграция по API с подписью запросов). Скриншоты соответствуют личному кабинету Orange Data; названия пунктов могут незначительно отличаться.
1. Зайдите в личный кабинет Orange Data, на вкладке «Интеграция» выберите «Прямое подключение» (или перейдите по ссылке https://lk.orangedata.ru/lk/integrations/direct).
Нажмите «Перейти к подключению» и скачайте программу для генерации ключей Nebula.KeysGenerator.
2. Создайте папку C:\ORANGE. Запустите программу Nebula.KeysGenerator и сгенерируйте ключи в папку C:\ORANGE.
В результате получатся 2 XML-файла — приватный и публичный ключ.
3. Также в программе Nebula.KeysGenerator сконвертируйте приватный ключ в формат PEM.
В результате появится файл rsa_2048_private_key.pem:
4. Загрузите публичную часть ключа в личный кабинет Orange Data:
5. Сгенерируйте сертификат. Если на этапе 4 был добавлен новый ключ, сертификат нужно сгенерировать заново.
Если ключ уже был зарегистрирован ранее и нужно только скачать сертификат, нажмите «Запросить сертификат».
Распакуйте скачанный сертификат в C:\ORANGE.
После подготовки в папке должны лежать файлы для подключения ClubIS (имена могут совпадать с примером ниже):
| Файл в папке | Назначение |
|---|---|
client.pem |
Клиентский сертификат из архива Orange Data |
key.pem |
Приватный ключ в формате PEM (для TLS-соединения) |
rsa_2048_private_key.pem |
Приватный ключ для подписи тела запроса |
¶ Настройка в ClubIS
6. Откройте Рецепция → Настройки → Оборудование → Фискальные регистраторы, выберите юр. лицо и откройте свойства ФР.
- В поле Фискальный регистратор выберите Orange Data.
- В блоке Сертификат укажите полные пути к файлам (как на скриншоте):
- client.pem — клиентский сертификат;
- key.pem — приватный ключ PEM;
- private_key.pem — файл
rsa_2048_private_key.pemиз папки с ключами; - Пароль — пароль к приватному ключу, если задавали при генерации; иначе оставьте пустым;
- Группа — имя группы устройств в личном кабинете Orange Data (если не заполнено, ClubIS использует значение
Main); - Задержка между запросами (мс) — при необходимости увеличьте, если Orange Data отклоняет частые запросы подряд (по умолчанию 0).
-
На вкладке Основное при необходимости включите Касса и выберите кассу из справочника.
-
На вкладке Секции ФР задайте секции и ставки НДС или используйте глобальные настройки — см. локальные настройки ФР и настройки налогов.
Важно: код налогообложения и налоговые группы не должны быть равны 0, иначе чеки не пробьются.
-
На вкладке Кассир рекомендуется включить фиксированного кассира и указать:
- ИНН — ИНН организации (тот же, под которым зарегистрированы ключи в Orange Data);
- ФИО — произвольная подпись, например «Автоматическое устройство».
Если фиксированный кассир не задан, в чек передаются ИНН и ФИО сотрудника, под которым выполнен вход в ClubIS — они должны соответствовать настройкам в личном кабинете Orange Data.
-
Сохраните настройки.
Поле Пароль с галочкой на вкладке «Основное» (пароль доступа к классической ККМ) для Orange Data не используется.
¶ Как пробиваются чеки
При оплате с фискализацией ClubIS формирует JSON-документ чека, подписывает его приватным ключом и отправляет в Orange Data по защищённому соединению. При успешной регистрации сервис возвращает подтверждение (HTTP 201).
Поддерживаются типичные сценарии рецепции:
- продажа и возврат;
- оплата наличными, безналом, авансом (зачёт предоплаты) и другими способами из ClubIS;
- передача e-mail или телефона клиента для электронного чека (если указаны при оплате);
- маркированные товары при кассе на ФФД 1.2.
Бумажный чек на принтере рецепции не печатается — фискальный документ формируется в облаке. Реквизиты чека (признак предмета расчёта, способ расчёта, НДС) задаются в ClubIS — см. ФФД 1.05.
¶ Проверка
- Выполните пробную оплату с фискализацией (если на площадке принят такой порядок).
- Убедитесь, что оплата в ClubIS завершилась без ошибки фискализации.
- Проверьте чек в личном кабинете Orange Data или в кабинете ОФД.
- Для маркированного товара убедитесь, что код маркировки принят без отказа.
¶ Если чек не пробивается
| Симптом | Что проверить |
|---|---|
Ошибка открытия client.pem, key.pem или private_key.pem |
Пути к файлам существуют и доступны пользователю Windows, под которым запущена Рецепция; нет опечаток в имени файла |
| Ошибка подписи, SSL, сертификата | Публичный ключ загружен в кабинет Orange Data; сертификат сгенерирован после загрузки ключа; key.pem и client.pem из актуального комплекта |
| Неверный пароль ключа | Поле Пароль в блоке «Сертификат» совпадает с паролем при генерации PEM |
| Ошибка группы касс | Поле Группа совпадает с именем группы устройств в кабинете Orange Data |
| Ошибки по НДС, налогообложению | Настройки налогов: код и группы не равны 0; на вкладке «Основное» включена нужная система налогообложения |
| Ошибки по ИНН | ИНН на вкладке «Кассир» или у вошедшего сотрудника совпадает с ИНН, для которого выпущены ключи в Orange Data |
| Таймаут, нет связи | Интернет на ПК рецепции; доступ к api.orangedata.ru; firewall |
| Слишком частые запросы | Увеличьте задержку между запросами (мс) в настройках ФР |
| Ошибки маркировки | Касса на ФФД 1.2; настройки ТС ПИоТ |
Текст ошибки при оплате обычно приходит от Orange Data — передайте его в поддержку Orange Data или интегратору.
Журналы работы ККМ на компьютере рецепции — см. где хранятся логи ККМ.
При смене ключей в личном кабинете Orange Data повторите генерацию сертификата и обновите пути к файлам в ClubIS.
¶ См. также
- Оборудование — раздел по ККМ
- АТОЛ Онлайн — другая облачная касса в ClubIS
- АТОЛ — локальный фискальный регистратор
- Настройка оборудования — общий список инструкций по ФР
- Локальные настройки ФР — касса, секции, кассир
- Настройки налогов — налоговые группы и ставки НДС
- ФФД 1.05 — реквизиты чеков
- Работа с ККМ — смены и типовые операции