Фискальные регистраторы и ОФД — Paloma365 Classic (касса для Windows)

Эта статья про Paloma365 Classic — программу-кассу для Windows. Касса работает с онлайн-кассами (фискальными регистраторами, ККМ): при оплате счёта она формирует фискальный чек и передаёт его оператору фискальных данных (ОФД), как требует законодательство вашей страны.

Обзор: что такое фискальный чек и ОФД

Фискальный чек — это чек, зарегистрированный в налоговой службе. ОФД (оператор фискальных данных) — посредник, который принимает данные каждого чека от онлайн-кассы и передаёт их в налоговую. Онлайн-касса — это сервис или аппарат (WebKassa, iKKM и другие), через который Paloma365 Classic пробивает такие чеки. Если фискализация не настроена, касса печатает обычные, нефискальные чеки — в списке чеков они помечаются как «Чек фискальный» / «Чек не фискальный».

Поддерживаемые онлайн-кассы

• Казахстан: WebKassa (Вебкасса), NurKassa, ReKassa, Trinity, GREEnKassa (Гринкасса), UKassa, KaspiKassa (kaspi.kz), а также аппаратная касса iKKM (подключается по сети).
• Узбекистан: UzKassa, EPosKassa, QPosKassa.
• Кыргызстан: NewCas, EKassa.

Отдельно стоят платёжные терминалы Smart POS Terminal и Senim: это не отдельная онлайн-касса, а терминал, который сам пробивает фискальный чек при оплате картой.

Доступность конкретного провайдера в вашей стране уточните у поддержки Paloma365.

Онлайн-кассы — не единственный способ фискализации. В локальных настройках кассы есть выбор «Тип ФР» с режимами «ФР ШТРИХ», «ФР ПОРТ», «ФР АТОЛ», «ФР ЭЛВИС-МИКРО», «ФР iKKM» и «ФР ONLINE»: первые режимы — аппаратные фискальные регистраторы, подключаемые к кассе напрямую, а онлайн-кассы из этой статьи работают в режиме «ФР ONLINE». Подробно аппаратные фискальные регистраторы описаны в статье «Аппаратные фискальные регистраторы».

Онлайн-касса и аппаратный фискальный регистратор одновременно работать не могут. Как только в личном кабинете подключается модуль любой онлайн-кассы, касса автоматически переводит «Тип ФР» в режим «ФР ONLINE», а сам переключатель блокируется — выбрать аппаратный режим нельзя, пока модуль онлайн-кассы включён. Чтобы вернуться к аппаратному фискальному регистратору, сначала отключите модуль онлайн-кассы в личном кабинете и перезапустите кассу.

Как подключить онлайн-кассу: пошагово

Порядок одинаковый для всех провайдеров — WebKassa, NurKassa, ReKassa, Trinity, GREEnKassa (Гринкасса), EKassa, KaspiKassa, UzKassa, EPosKassa, QPosKassa, UKassa, NewCas. Меняется только название и окно ввода данных на последнем шаге.

Подключение состоит из двух частей: сначала онлайн-касса включается в личном кабинете, и только потом настраивается на самом кассовом компьютере.

1. Получите данные у провайдера онлайн-кассы. Заключите с ним договор и зарегистрируйте кассу в налоговой. На руках должны быть логин и пароль (ключ) от кабинета провайдера, а для Казахстана — ещё и номера кассы: «Индивидуальный номер кассы (ИНК)» и «Регистрационный номер кассы (РНК)».
2. Включите модуль в личном кабинете. Откройте «Настройки» → «Модули» (страница «Настройки модулей»), найдите блок «Модули рабочих мест» и подключите нужную онлайн-кассу тому рабочему месту, на котором она будет работать. Модуль платный — стоимость показывается рядом с названием. Если нужного модуля нет в каталоге, напишите нам здесь — подключится специалист.
3. Перезапустите кассу. Список включённых модулей касса получает от сервера при подключении, поэтому изменение применяется после перезапуска программы (или повторного входа). Компьютер кассы должен быть в интернете.
4. Проверьте, что онлайн-касса включилась. Откройте настройки кассы → вкладка «Плагины». Галочка «Использовать <название кассы>» должна стоять. Эта галочка — только индикатор: вручную поставить её нельзя, она включается модулем из личного кабинета (см. ниже «Галочка неактивна»).
5. Введите данные провайдера. Рядом с галочкой появится кнопка «Тест подключения». Нажмите её — откроется окно провайдера, где вводятся логин, пароль и номера кассы. Введите данные из шага 1 и сохраните.
6. Проверьте связь. Там же снимите X-отчёт кнопкой «X/Z Онлайн кассы». Отчёт напечатался — связь есть.
7. Проверьте типы оплат. Фискализируются оплаты наличными и картой; оплата прочими видами оплаты, депозитом или в кредит в ОФД не уходит. Если включена настройка «Использовать правила типов оплат», фискальность вида оплаты задаётся в правилах типов оплат рабочего места. Если ни один из выбранных видов оплаты не фискальный, касса сообщит: «Ни один из выбранных типов оплаты не является фискальным».

После этого при каждой оплате касса будет отправлять чек в онлайн-кассу автоматически.

Галочка «Использовать …» неактивна (серая) — так и должно быть

Галочки онлайн-касс на вкладке «Плагины» намеренно недоступны для нажатия. Онлайн-касса включается не на кассовом компьютере, а в личном кабинете — модулем для конкретного рабочего места (шаг 2). Так сделано, чтобы кассир не мог случайно отключить фискализацию.

Если галочка не появилась после включения модуля, проверьте по порядку:

1. Модуль подключён именно тому рабочему месту, за которым вы сидите (а не другому или другой точке).
2. Касса перезапущена после включения модуля.
3. На кассе есть интернет — без связи с сервером список модулей не обновится.

При запуске касса просит обновить модули

Каждая онлайн-касса работает через свой файл-модуль, который поставляется вместе с программой. Если файл старый или отсутствует, при запуске появится сообщение вида «Входе проверки было выявленно, что: … - версия …, меньше минимально необходимой: …», затем «Необходимо выполнить обновление указанных модулей» и вопрос «Всё равно продолжить запуск программы?».

Решение — обновить кассу: настройки → вкладка «Настройки аккаунта» → кнопка «Обновить программу» (подробнее в статье «Установка и обновление»). Запускать программу «всё равно» с устаревшим модулем не стоит: фискализация может не работать.

Как работает фискализация

1. Кассир оплачивает счёт обычным способом.
2. Касса отправляет чек в сервис онлайн-кассы, тот регистрирует его в ОФД и возвращает фискальные данные — они печатаются на чеке.
3. X/Z-отчёты по онлайн-кассе снимаются из настроек кнопкой «X/Z Онлайн кассы» (подробнее про закрытие смены — в статье «Закрытие смены и Z-отчёт»).

Важные особенности:

• Фискализируются только фискальные типы оплаты — наличные и карта, а при включённой настройке «Использовать правила типов оплат» — виды оплаты, отмеченные фискальными в правилах. Если ни один из выбранных типов оплаты не фискальный, касса сообщит: «Ни один из выбранных типов оплаты не является фискальным».
• Оплата депозитом или в кредит, а также счета с итоговой суммой 0 не фискализируются.
• В карточке товара есть поле «Национальный код» (его часто называют НТИН или НКТ) — этот код передаётся в фискальный чек по каждой позиции. Если налоговая или ОФД требует код по товару, заполните его в карточке.
• Часть реквизитов позиции касса берёт из карточки товара: для ReKassa — ставку НДС по каждой позиции, для WebKassa — единицу измерения, для KaspiKassa — признак «товар» или «услуга». Если в чеке не та ставка, единица или признак — проверьте карточку товара.
• Возврат оформляется как обычный возврат счёта. Если в локальных настройках включена галочка «Запрашивать данные чека основания», при возврате появится окно «Введите информацию из оригинального чека» с пятью полями: «Фискальный признак», «Дата и время», «Общая сумма», «Регистрационный номер кассы (ККМ КГД)» и «Признак автономности чека»; при выключенной галочке окно не показывается. Для UzKassa действует правило: «Фискальный возврат для UZKassa необходимо выполнить на терминале!»

Нефискальные типы оплаты

Если счёт оплачен депозитом, в кредит или прочим видом оплаты (не наличными и не картой; при выключенной настройке «Использовать правила типов оплат»), касса печатает обычный чек и не отправляет его в ОФД — даже при включённой онлайн-кассе или фискальном регистраторе. Отдельного сообщения об этом касса не показывает. Это не ошибка, а штатное поведение для нефискального вида оплаты. Если чек должен был попасть в ОФД — оплатите счёт наличными или картой либо задайте фискальность вида оплаты в правилах типов оплат.

Смешанная оплата и фискализация

Не все онлайн-кассы умеют фискализировать счёт, оплаченный несколькими видами оплаты сразу:

• UzKassa, EKassa и QPos смешанную оплату не поддерживают — при подключённой кассе этих провайдеров кнопка разделения оплаты недоступна.
• Смешанная оплата также отключается при подключённом модуле лотереи Satty (см. ниже).
• При активном фискальном регистраторе в окне смешанной оплаты остаются только виды «Наличными», «Картой» и «Депозит». Если включена настройка «Использовать правила типов оплат», вместо этого доступны виды оплаты, отмеченные фискальными в правилах типов оплат рабочего места.

Фискальные внесение и изъятие наличных

Внесение и изъятие денег тоже можно проводить через фискальный регистратор или онлайн-кассу. В окне внесения/изъятия наличных (экран «Касса» → операции с деньгами) есть переключатель «Фискальная операция»:

• при включённом переключателе операция отправляется в фискальный регистратор/онлайн-кассу как официальное внесение или изъятие наличных;
• положение переключателя запоминается до следующей операции;
• сумма фискальной операции округляется до целого числа;
• фискализируются только операции по кассе — внесение и расход по банку через фискальный регистратор не проводятся;
• для EPosKassa и QPosKassa фискальные внесения/изъятия недоступны — переключатель выключен и заблокирован.

Если фискальная операция завершилась ошибкой, внесение/изъятие не сохраняется — сначала устраните проблему связи с кассой.

Дубликат фискального чека

Копия чека печатается с экрана «Касса»: выберите закрытый счёт → «Опции» → печать копии чека (операция «Копия чека» может быть защищена паролем из настроек точки). Обычная копия доступна всегда — после печати касса сообщает «Дубликат счета распечатан!».

Фискальный дубликат — повторная печать чека с фискальными реквизитами — доступен только при подключённой WebKassa: в окне печати копии появляется отдельный переключатель фискального дубликата. После успешной печати касса сообщает «Дубликат фискального счета распечатан!». У остальных онлайн-касс и аппаратных фискальных регистраторов фискальный дубликат из кассы недоступен — при необходимости используйте кабинет провайдера.

Коды ошибок iKKM

Аппаратная касса iKKM отвечает числовыми кодами. Касса показывает их с расшифровкой (префикс «iKKM:»):

Код	Сообщение кассы
−1	«Неверный web-api ключ! Нужно настроить новый ключ для iKKM. Для настройки выключите web-кассу на iKKM, после выключения, в верхней части настроек Web-кассы отобразится "Web-api ключ", впишите этот ключ в поле API-ключ.»
−2	«Происходит регистрация повторите запрос позже!»
−3	«Смена привысила 24 часа! Необходимо закрыть смену! (выполняется на iKKM)»
−4	«Оффлайн период более 72 часов! Нужно решить проблему связи и разблокировать ккм»
−5	«Низкий заряд батареи ккм! Нужно зарядить ккм.»
−6	«Принтер не готов! Нужно проверить бумагу.»
−7	«Ошибка запроса проверьте передаваемые параметры»
−8	«Ошибка метода! Только /api или /apicheck»
−9	«Ошибка значений параметров! Передавать только цифры (кроме параметра print)»
−10	«Значение cash меньше sale (buy…) проверьте логику работы с API»
−11	«Смена открыта другим кассиром закрыть смену»
−12	«Значение cash меньше чем расчетная итоговая сумма может возникнуть если налог насчитывается поверх суммы»
−17	«Ошибка обработки JSON запроса в itemdata, проверьте логику работы с API»
от −100 до −199	«Ккм заблокирован ОФД см документацию ОФД (отнять100)» — отнимите 100 от кода и найдите его в документации ОФД
−99	«Ошибка iKKM смотрите журнал событий на iKKM»
−200	«Не удается установить соединение с сервером iKKM» — касса не видит устройство iKKM по сети

Кроме кодов, iKKM может отказать в оплате из-за вида оплаты: «iKKM: Нельзя оплатить счет другим типом оплаты» (допускаются только «Наличными», «Картой» и «Депозит») и «iKKM: Нельзя оплатить счет смешанным типом оплаты с активированным банковским модулем» (при включённой галочке «Внешний банковский модуль» смешанная оплата запрещена). Настройка iKKM описана в статье «Аппаратные фискальные регистраторы».

Продажа лотереи Satty

Модуль Satty позволяет продавать лотерейные билеты прямо на кассе. Он включается прямо на кассе: в настройках на вкладке «Плагины» поставьте галочку «Использовать Satty» — после этого появятся поле «ID Товара-лотереи» и кнопка «Тест подключения». В поле «ID Товара-лотереи» указывается код товара, который на кассе будет означать продажу лотереи.

Как это работает:

• Кассир добавляет в счёт товар-лотерею — открывается окно с выбором «Игра» (Лото 6/49, Телебинго, Лото 5/36) и «Ставки» (количество ставок с фиксированной ценой), поле «Штрих-код:» и кнопки «Выбрать» / «Отмена». Выбранная ставка добавляется в счёт по цене игры.
• В одном счёте может быть только одна лотерея — при попытке добавить вторую касса сообщит: «В счете уже есть позиция - лотерея!»
• Счёт с лотереей нельзя отложить/переключить на другую вкладку отложенных счетов: «В счете имеется позиция - ЛОТЕРЕЯ, оплатите счет или удалите позицию» — сначала оплатите счёт или удалите лотерею.
• При подключённом модуле Satty смешанная оплата недоступна.
• Билет печатается при оплате счёта. Если печать не удалась, касса сообщит: «Не удалось распечатать лотерею в счете» — проверьте связь и повторите печать/оплату.

Отложенная фискализация

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

• Включается в локальных настройках, раздел окна оплаты — галочка «Отложенная фискализация». После этого в окне оплаты появляется переключатель «Отложенная фискализация»: если он включён, счёт сохраняется со статусом «фискализация ожидается», если выключен — чек уходит в ОФД сразу.
• В журнале счетов (экран «Касса») появляется кнопка «Фискализация». По нажатию касса предложит выполнить групповую фискализацию всех счетов активного раздела, для которых это требуется, либо фискализировать только текущий счёт. Результат: «Фискализация выполнена!», «Фискализация выполнена не для всех счетов!» или «Фискализация не выполнена!».
• В фильтре журнала счета отбираются по статусу: «Фискализация не требуется», «Фискализация выполнена», «Фискализация ожидается».
• Важно: отправить отложенные чеки нужно до закрытия смены. Иначе касса предупредит: «В текущей смене есть счета с отложенной фискализацией. После закрытия смены их уже нельзя будет фискализировать!»

Частые проблемы

• «Не удалось отменить чек.» и «Не удалось закрыть чек.» — это ответы тестовых кнопок в настройках фискального регистратора: команда до ККМ не дошла или та её отклонила. При удачном выполнении вместо них показывается подтверждение. Если чек не выходит и касса показывает ошибку с номером — начните с «Касса не печатает чек: коды ошибок Webkassa и ОФД». Первое, что там проверяется, — оплачены ли услуги ОФД и лицензия онлайн-кассы: они оплачиваются отдельно от Paloma365, и при неоплате касса перестаёт печатать чеки (коды 94 и 17).

• Нет связи с онлайн-кассой. Если онлайн-касса не приняла чек при оплате, касса показывает «Произошла ошибка при оплате!» или «Ошибка оплаты счёта!» с текстом ошибки ниже; для iKKM — «Не удается установить соединение с сервером iKKM». Частая причина — проблема с интернетом или с самим устройством/сервисом. Проверьте связь и повторите оплату; при длительном сбое используйте отложенную фискализацию.

• Чек не фискализировался. Проверьте, что тип оплаты фискальный, а в фильтре журнала — нет ли счёта со статусом «Фискализация ожидается». Такой счёт отправьте кнопкой «Фискализация».

• Смена длиннее 24 часов (ФР «ШТРИХ», WebKassa, KaspiKassa). Если оплата не прошла из-за того, что фискальная смена идёт больше 24 часов, касса сама предложит снять Z-отчёт: «Смена на ФР превысила 24 часа. Снять отчёт с гашением (Z-отчёт)?» — после него повторите оплату. Предложение видит только сотрудник с правом на X/Z-отчёты. Подробнее — «Закрытие смены и Z-отчёт».

• Подсказки KaspiKassa. При ошибке KaspiKassa касса добавляет к тексту ошибки подсказку, что делать: «Kaspi: истёк токен интеграции. Откройте настройки плагина KaspiKassa и выполните регистрацию интеграции.», «Kaspi: смена открыта больше 24 часов. Снимите Z-отчёт и повторите операцию.», «Kaspi: открытой смены нет — она откроется первым чеком.», «Kaspi: не заполнены настройки плагина. Откройте настройки плагина KaspiKassa.». Особая — «Kaspi: ответ по статусу чека не получен. Чек МОГ БЫТЬ фискализирован — не пробивайте его повторно…»: сначала проверьте чек в кабинете Kaspi и только потом решайте, повторять ли оплату.

• Смена в фискальнике не закрыта. iKKM сообщает: «Смена привысила 24 часа! Необходимо закрыть смену!» — фискальную смену нужно закрыть на самом аппарате. Возможен и вариант «Смена открыта другим кассиром» — сначала закройте чужую смену.

• ККМ заблокирован ОФД. При офлайн-периоде более 72 часов касса блокируется («Оффлайн период более 72 часов! Нужно решить проблему связи и разблокировать ккм»). Восстановите интернет и разблокируйте кассу по инструкции провайдера.

• «Ошибка печати фискального чека» / «Не выбран фискальный принтер для работы!» — проверьте настройки фискального принтера, бумагу и подключение.

• Чек не фискализировался, оплата «прочим» видом оплаты. Без правил типов оплат оплата прочими видами оплаты (не наличными и не картой) не фискализируется, и отдельного сообщения об этом касса не показывает — см. раздел «Нефискальные типы оплаты».

• Ошибка внутри окна провайдера. Окна входа и настроек онлайн-касс (WebKassa, NurKassa и других) — это отдельные модули самих провайдеров: тексты их внутренних ошибок формирует провайдер, а не Paloma365. Если ошибка появляется внутри такого окна (неверный логин, ошибка кассы, ошибка смены), разбирайтесь в личном кабинете провайдера или с его поддержкой. Сообщение «Плагин не загружен» означает, что файл модуля отсутствует или устарел — обновите программу.

• Онлайн-касса вообще не появилась в кассе. Галочки на вкладке «Плагины» нет или она серая и пустая — модуль не подключён в личном кабинете либо касса не перезапущена. См. раздел «Как подключить онлайн-кассу».

FAQ

Как подключить GREEnKassa (Гринкассу)?

Так же, как любую другую онлайн-кассу — по шагам из раздела «Как подключить онлайн-кассу». Коротко:

1. Получите логин, пароль и номера кассы у GREEnKassa (сервис GREEnKassa.KZ).
2. В личном кабинете: «Настройки» → «Модули» → «Модули рабочих мест» — подключите модуль GREEnKassa нужному рабочему месту.
3. Перезапустите кассу.
4. Настройки кассы → вкладка «Плагины» → галочка «Использовать GREEnKassa» встанет сама, рядом появится кнопка «Тест подключения».
5. Нажмите «Тест подключения» и введите данные из шага 1.

Сама галочка «Использовать GREEnKassa» серая и не нажимается — это нормально: онлайн-касса включается модулем из личного кабинета, а не на кассе.

Как понять, что фискализация настроена?

В настройках включена одна из онлайн-касс и введены её данные, а на чеке после оплаты печатаются фискальные реквизиты. Дополнительно можно снять X-отчёт кнопкой «X/Z Онлайн кассы» — если отчёт печатается, связь с кассой есть.

Касса спрашивает про «устаревшую систему формирования фискальных чеков». Что делать?

Это предложение перейти на актуальную схему работы с фискальными чеками: «Внимание! Активна устаревшая система формирования фискальных чеков! Активировать актуальную систему фискальных чеков?» Вопрос появляется при запуске программы, если на этой кассе ещё выключен режим печати полного чека (действует устаревшая схема). Ответ «Да» включает актуальную схему — печать полного фискального чека. Согласуйте переход с поддержкой и подтвердите.

Что будет, если закрыть смену с неотправленными чеками?

После закрытия смены отложенные счета уже нельзя фискализировать. Всегда нажимайте «Фискализация» в журнале до закрытия смены.