Руководство по настройке

Otkucaj, регистровое название «Otkucaj» · версия 1.3.6 · otkucaj.com · Руководство пользователя · Руководство по установке

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

Содержание

• 1.Кто настраивает и что видит
• 2.Порядок настройки
• 3.Тест и рабочая среда
• 4.Режим ПФР
• 5.Аутентификация ЕСИР и ПФР
• 6.Элемент безопасности
• 7.Номер ЕСИР и версия ПО
• 8.Данные плательщика и торговой точки
• 9.Налоговые метки и ставки
• 10.Округление сумм и налога
• 11.Печать
• 12.Способы оплаты
• 13.Пользователи и роли
• 14.Ключи API
• 15.Уведомления
• 16.Журнал работы
• 17.Запуск в рабочую среду
• 18.Контрольный список настройки

1.Кто настраивает и что видит

Настройку выполняет администратор. Только он видит пункт Настройки в боковом меню и только он может менять что-либо из этого документа. Кассир в своём входе этого пункта не видит, не может открыть его адреса и не может менять ни среду, ни режим ПФР, ни сертификат, ни налоговые ставки, ни данные плательщика, ни ширину чека, ни способы оплаты. Кассир работает на Кассе, видит чеки и товары, выдаёт копии и возвраты, и это всё. Это разделение не вопрос оформления: проверка выполняется на сервере, при каждом запросе.

Экран Настроек разделён на девять вкладок, и их порядок повторяет то, с чего действительно начинают. У каждой вкладки свой адрес, поэтому на неё можно сослаться напрямую.

2.Порядок настройки

Шаги ниже идут именно в этом порядке, и ни один не пропускается. У каждого есть условие, по которому видно, что он действительно завершён, а не что кто-то просто что-то вписал. Шаги с 1 по 8 выполняются в тестовой среде; рабочую среду трогают только на шаге 9.

1. Войдите аккаунтом администратора. Готово, когда в боковом меню есть пункт Настройки и когда вы сменили пароль, полученный при установке.
2. Внесите данные плательщика (глава 8). Готово, когда ПИБ, наименование фирмы, название торговой точки и адрес буква в букву соответствуют данным о торговом объекте, которые вы заявили Налоговой администрации.
3. Настройте печать (глава 11). Готово, когда пробный чек выходит целиком, ни одна строка не падает за край бумаги, а QR-код, измеренный линейкой, составляет от 40 до 50 мм.
4. Выберите режим способов оплаты (глава 12). Готово, когда Касса предлагает ровно те способы оплаты, которыми этот плательщик вправе пользоваться, и ни одного лишнего.
5. Задайте режим ПФР для теста (главы 4 и 5). Готово, когда статус связи на вкладке Среда и ПФР сообщает, что ПФР доступен, а не выдаёт ошибку.
6. Установите тестовый элемент безопасности, если работа идёт с В-ПФР (глава 6). Готово, когда сводка рядом с сертификатом указывает, кому он выдан, до какого срока действует и его отпечаток.
7. Внесите номер ЕСИР и версию (глава 7). Готово, когда проверка готовности этой среды больше не сообщает, что номер ЕСИР отсутствует.
8. Загрузите налоговые ставки из ПФР (глава 9). Готово, когда кнопка сообщит, сколько ставок загружено и с какой даты они действуют, а поля в таблице окажутся заблокированы.
9. Выдайте пробные чеки в тесте. Готово, когда через ПФР пройдут Промет Продаја, Промет Рефундација, Копия, Предварительный счёт, Обучение и Аванс, и когда каждый из них будет виден в реестре чеков.

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

3.Тест и рабочая среда

У каждой фирмы в Otkucaj две полностью раздельные среды, и в каждый момент активна ровно одна. Это не два аккаунта, и создавать их не нужно: они существуют с момента установки, а свежеустановленная копия работает в тесте.

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

Что является общим для обеих сред, потому что не зависит от того, с какой системой Налоговой администрации идёт разговор: данные плательщика, ширина бумаги и чека, рекламный текст, режим способов оплаты, пользователи, ключи API и уведомления. Что задаётся отдельно для каждой среды: режим ПФР, адреса Л-ПФР и В-ПФР, ПАК, номер ЕСИР и версия, и сертификат элемента безопасности.

3.1 Проверка готовности

На вкладке Среда и ПФР обе карточки стоят рядом: какая активна, в каком она режиме, у какой есть номер ЕСИР и есть ли сертификат. Под каждой находится проверка готовности, в виде списка того, чего ещё не хватает. Это тот же самый список, который приложение использует, когда отказывается выдать чек, поэтому сообщение на экране и фактическое поведение разойтись не могут.

Среда считается готовой, когда выполнены все условия ниже:

1. режим Л-ПФР или В-ПФР, ни в коем случае не демо; демо фискальных чеков не выдаёт, поэтому в рабочей среде оно противоречит само себе;
2. номер ЕСИР является числом, то есть учётным номером, присвоенным Налоговой администрацией, а не текстом;
3. для В-ПФР: сертификат установлен;
4. для В-ПФР: ПАК введён, потому что без него В-ПФР отклоняет запрос;
5. для В-ПФР: адрес соответствует этой среде, то есть тестовый адрес в тесте и рабочий в рабочей;
6. сертификат в этой среде отличается от сертификата в другой.

Пока хоть что-то из этого не выполнено, кнопка Переключиться сюда выключена, а под ней стоит обоснование. Если установка уже работает в среде, которая условиям не отвечает, выдача останавливается, а причины выписываются над корзиной на Кассе, до того как кассир наберёт чек.

3.2 Две ошибки, которых приложение не допустит

Один и тот же сертификат в обеих средах. У теста и рабочей среды должны быть разные элементы безопасности. При установке сертификат хешируется (SHA-256), и отпечаток запоминается, поэтому один и тот же сертификат нельзя поставить и в одну, и в другую среду: вторая попытка отклоняется с сообщением. Если один и тот же отпечаток всё же окажется в обеих, выдача останавливается до исправления. Это единственная ошибка конфигурации, которая производит чеки, которые никто не может исправить, поэтому она проверяется дважды.

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

Кроме того, адрес В-ПФР обязан начинаться с https://. Ввод с обычным HTTP отклоняется при сохранении: клиентский сертификат передаётся только по защищённому соединению, поэтому по HTTP разговор с Налоговой администрацией шёл бы вообще без элемента безопасности.

4.Режим ПФР

У каждой среды свой режим работы, который выбирается на вкладке Среда и ПФР и меняется без переустановки.

Порт Л-ПФР даёт его поставщик, и его не угадывают. Если Л-ПФР работает на другом компьютере в сети заведения, вместо localhost вводится адрес того компьютера, а сеть между ними должна пропускать этот порт.

Под полями стоит статус связи, и он считывается в реальном времени, при каждом открытии главной страницы и Настроек. Сообщение, которое вернул ПФР, показывается так, как пришло, потому что это единственные сведения, которые помогают: «карта не вставлена» и «ПАК неверен» решаются в двух совершенно разных местах.

Смена режима не трогает ни один уже выданный чек. Каждый чек помнит режим, в котором он был выдан, поэтому и после перехода с демо на настоящий ПФР в реестре ясно видно, какие чеки были демо.

5.Аутентификация ЕСИР и ПФР

ЕСИР и ПФР узнают друг друга прежде, чем хоть какие-то данные о чеке перейдут из рук в руки, и не один раз при подключении, а при каждом обращении.

В-ПФР. Соединение идёт по HTTPS. Otkucaj представляется клиентским сертификатом, а это элемент безопасности в виде файла, и с каждым запросом отправляет заголовок с ПАК. В том же рукопожатии он проверяет и сертификат В-ПФР, то есть его издателя и имя хоста; эта проверка включена, и настройки, которая бы её отключала, не существует. Если сертификат не установлен, если пароль не открывает файл или если ПАК не принят, В-ПФР отклоняет запрос, чек не выдаётся, а сообщение показывается кассиру.

Л-ПФР. Соединение идёт по HTTP в локальной сети, и клиентский сертификат по нему не отправляется, потому что в этом соединении для него нет места. Перед элементом безопасности аутентифицируется сам Л-ПФР, через считыватель смарт-карт и PIN. Otkucaj к карте не обращается.

Когда проверка выполняется и что происходит при сбое. При открытии главной страницы и Настроек, при загрузке налоговых ставок и при каждой выдаче чека. Сбой не превращается в полу-чек: кнопка Выдать чек выключена ещё до того, как кассир наберёт всю корзину, а причина стоит над корзиной. Если связь пропадёт в сам момент выдачи, чек попадает в локальную очередь и не является выданным, пока не пройдёт через ПФР. Как мы понимаем ст. 6 п. 1 Закона о фискализации, пока чек ждёт, продажа не завершается.

6.Элемент безопасности

На вкладке Элемент безопасности стоят две отдельные рамки, одна для теста и одна для рабочей среды. В каждую идёт свой сертификат (.pfx или .p12) и свой пароль. Файл записывается вне каталога, который отдаёт веб-сервер, с правами 0600, и посетителям никогда не отдаётся; пароль хранится зашифрованным (AES-256-GCM), ключом этой установки, поэтому копия базы сама по себе ничего не раскрывает.

Загрузка принимается только тогда, когда файл действительно открывается введённым паролем. Неверный пароль нельзя сохранить и обнаружить его на первом настоящем чеке: он отклоняется сразу. Принимаются файлы до 512 КБ, что многократно больше размера сертификата. Если вы меняете только пароль, поле файла оставьте пустым; если меняете только файл, оставьте пустым поле пароля, и прежний останется в силе.

Рядом с каждым установленным сертификатом показывается, кому он выдан, до какого срока действует и первые шестнадцать знаков отпечатка. Рамка окрашивается и предупреждает за тридцать дней до истечения, и отдельно тогда, когда срок уже истёк. Отпечаток служит и доказательством того, что тест и рабочая среда не делят один элемент (глава 3.2), поэтому его стоит записать вместе с документацией установки.

Хранилище Windows. Если Otkucaj установлен локально на компьютере с Windows, вместо загрузки файла можно использовать сертификат, уже установленный на этом компьютере: выбирается хранилище (Текущий пользователь или Локальный компьютер) и вводится отпечаток сертификата, без пробелов. Тогда приложение не хранит ни файла, ни пароля. Эта возможность показывается только там, где она действительно работает; на otkucaj.com её нет и быть не может, потому что сервер не видит хранилище сертификатов вашего компьютера, так что загрузка файла остаётся единственным путём.

7.Номер ЕСИР и версия ПО

Номер ЕСИР: это учётный номер, под которым ЕСИР внесён в реестр одобренных элементов электронной фискализации. Его присваивает Налоговая администрация при одобрении, и никакого другого значения он иметь не должен. Вводится на вкладке Среда и ПФР, отдельно для каждой среды, и с этого момента печатается на каждом виде чека и при каждом типе транзакции.

На чеке он стоит соединённым с версией ПО через косую черту: ЕСИР број: 123/1.0. Поле Версия содержит эту вторую половину. Тестовая среда принимает и зарезервированное значение 000, которое служило до одобрения, и проверка готовности не позволит перейти в рабочую среду, пока номер ЕСИР там не станет числом. Если в рабочей среде останется 000, чеки просто не выдаются, и это лучше, чем чек с неверным номером: расхождение между напечатанным номером и присвоенным учётным номером является известной причиной отказа по заявке.

Серийный номер установки: это нечто другое, и его не путают с номером ЕСИР. Он имеет вид OTK-XXXXXXXXXXXX, присваивается автоматически при установке, уникален для этой копии программы и не меняется ни после обновления, ни после восстановления резервной копии. Вместе с производителем и версией ПО он стоит в разделе О приложении, на вкладке Данные плательщика; его указывают при обращении по проблеме и при проверке.

8.Данные плательщика и торговой точки

ПИБ, наименование фирмы, название торговой точки, адрес и город вносятся на вкладке Данные плательщика и одинаковы в обеих средах. Они обязаны буква в букву совпадать с данными о торговом объекте, которые вы заявили Налоговой администрации. У свежеустановленной копии они пусты, и это намеренно: продукт переносимый, и первый чек не должен нести имя фирмы, которой не существует.

Эти данные не являются тем, что печатается в шапке фискального чека. Шапку формирует ПФР при фискализации и возвращает её ЕСИР, а Otkucaj выводит её так, как получил. Если то, что вы вписали, отличается от того, что выводит ПФР, эта разница признак того, что регистрация в Налоговой администрации не такая, как вы думаете, и решается она там, а не правкой текста в приложении.

9.Налоговые метки и ставки

На вкладке Налоги стоит таблица действующих меток и ставок. Определяющим является ПФР, а не эта таблица. Пока подключён Л-ПФР или В-ПФР, поля нельзя менять вручную: они заблокированы, а кнопка Загрузить ставки из ПФР обновляет их из источника и сообщает, сколько ставок загружено и с какой даты они действуют. Так приложение не может посчитать налог по ставке, которую кто-то набрал руками. В демо-режиме нет ПФР, из которого можно было бы взять ставки, поэтому они остаются редактируемыми и действуют сербские ставки по умолчанию.

Загрузка заменяет всю локальную таблицу той, которую вернул ПФР, метку за меткой, включая и название налоговой категории для каждой. Поэтому набор меток не встроен в программу: если Налоговая администрация введёт новую метку, изменит ставку или отзовёт существующую, это появится при первой же следующей загрузке и сразу начнёт печататься на чеке, без изменения приложения и без новой версии. Число меток не ограничено четырьмя; в тестовой системе Налоговой администрации их, например, девять.

10.Округление сумм и налога

Округление не является настройкой, и поля, которым его можно было бы изменить, нет; оно описано здесь потому, что конфигурация обязана его назвать. Все денежные суммы ведутся и показываются с двумя десятичными знаками, а количество с тремя. Округление идёт так: второй десятичный знак увеличивается, если следующая цифра 5 или больше, и остаётся прежним, если она меньше 5: 1,005 становится 1,01, а 1,004 становится 1,00. Так получаются сумма позиции (количество умножить на цену за единицу, со скидкой, если она есть), общая сумма чека, сумма каждой оплаты и сдача. Количество идёт с тремя знаками потому, что товар продаётся и на вес, поэтому 0,375 кг остаётся 0,375; лишние нули на чеке не печатаются.

Суммы налога приложение не считает. Их рассчитывает ПФР по ставкам, действующим в этот момент, и возвращает в ответе с двумя десятичными знаками, а Otkucaj показывает и печатает их ровно так, как получил, без собственного округления. По той же причине и налог по меткам, и итоговый налог на чеке приходят от ПФР.

11.Печать

На вкладке Печать и оплата настраиваются четыре вещи: ширина бумаги, ширина чека в знаках, рекламный текст по умолчанию и режим способов оплаты (глава 12).

Ширина бумаги выбирается из A4, рулона 80 мм и рулона 58 мм и должна соответствовать бумаге, которая реально стоит в принтере. Она определяет размер страницы при печати; без неё браузер предполагает A4 и своей подгонкой незаметно меняет физический размер QR-кода, а он обязан оставаться между 40 и 50 мм. Наименьший поддерживаемый рулон 58 мм; уже 57 мм не поддерживается, потому что журнал в предписанной вёрстке не помещается в меньшее число знаков в строке.

Ширина чека в знаках: это число знаков в строке журнала: обычно 40 для рулона 80 мм и 32 для рулона 58 мм, а допустимый диапазон от 32 до 64. Из этого числа выводится размер шрифта, потому что ширина оттиска фиксирована: 46 мм на рулоне 58 мм и 68 мм на рулоне 80 мм, что соответствует ширине, которую термальная головка реально печатает. Если чек не помещается на бумагу, уменьшают число знаков, а никогда не масштаб печати: масштаб меняет и размер QR-кода.

QR-код печатается 41 мм на рулоне 58 мм и 45 мм на рулоне 80 мм и на A4. Оба значения внутри предписанных 40-50 мм. Изображение создаёт сам ПФР, и печатается именно его; собственное приложение рисует только в демо-режиме, где ПФР нет.

Рекламный текст по умолчанию печатается на каждом чеке под строкой КРАЈ ФИСКАЛНОГ РАЧУНА, то есть вне фискальной части, и его длина не превышает 500 знаков. Кассир на Кассе может изменить или удалить его для отдельного чека. В диалоге печати браузера остаётся один раз на устройство поставить поля «без полей», масштаб 100% и отключить колонтитулы.

12.Способы оплаты

Otkucaj поддерживает все семь способов оплаты, предусмотренных ст. 6 Правилника о видах фискальных чеков, и каждый в запросе к ПФР несёт свой числовой код из Технического руководства:

Стандартный режим предлагает все семь способов. Режим по ст. 6 п. 2 Правилника о видах фискальных чеков, как мы понимаем эту статью, обязателен для устройства, через которое учитывается подача еды и напитков для потребления на месте или продажа еды и напитков в пекарне: он отключает платёжную карту, чек и мгновенный платёж, которые кассир тогда вносит как наличные, поэтому остаются коды 0, 1, 4 и 5. Отключённые способы на Кассе не предлагаются, а запрос, который их содержит, отклоняется и через API, с пояснением; проверка выполняется на сервере, а не только во внешнем виде экрана.

Одна установка работает исключительно в одном из этих двух режимов. Режим выбирает администратор, и он действует для всех кассиров и для всех интеграций. Если у плательщика несколько торговых точек с разными режимами, это разные установки.

13.Пользователи и роли

На вкладке Пользователи открываются аккаунты, назначается роль (администратор или кассир), сбрасывается пароль и отключается кассир, который больше не работает. Пароль содержит не менее 10 знаков. Имя пользователя выводится и печатается на каждом чеке, который он выдал, как идентификация кассира (Техническое руководство, 16.П3). Достаточно обозначения, которое однозначно идентифицирует кассира, например имени или внутреннего кода сотрудника; полное имя не обязательно, и ради защиты персональных данных мы рекомендуем минимально достаточное.

Здесь же подтверждаются аккаунты, пришедшие со страницы регистрации. Такой аккаунт открывается неактивным, и вход с ним невозможен, пока администратор его не активирует. Отключение аккаунта, смена пароля и кнопка Выйти на всех устройствах прерывают и постоянный вход на всех устройствах этого пользователя, а не только текущую сессию.

14.Ключи API

Ключи служат внешним программам: интернет-магазину, ERP, плагину для WooCommerce. Они создаются и отзываются на вкладке Ключи API, каждому даётся название, по которому понятно, кому он принадлежит, а ограничение составляет 240 запросов в минуту на ключ.

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

15.Уведомления

Вкладка Уведомления отправляет сообщение в Telegram по каждому выданному чеку: вид чека, сумму, способы оплаты, номер ПФР, счётчик и ссылку для проверки. Настройка необязательна, но полезна в магазинах, подключённых через API, где владелец иначе не видит чек в момент выдачи.

1. Токен бота: в Telegram откройте @BotFather, командой /newbot создайте бота и скопируйте токен.
2. Chat ID: номер разговора, проще всего через бота @userinfobot. Это может быть и ID группы, если уведомления должны видеть несколько человек; тогда добавьте бота в группу.
3. Включите переключатели для чеков через API и/или с Кассы, в зависимости от того, что хотите отслеживать.
4. Нажмите Отправить тестовое сообщение. Готово, когда сообщение действительно придёт в Telegram; если оно не пришло, значит и всё остальное не настроено.

На тот же адрес приходит и уведомление о каждой новой регистрации аккаунта, ожидающей подтверждения (глава 13).

16.Журнал работы

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

На вкладке Журнал работы показываются последние 200 действий. Более старые остаются в базе и выходят из неё вместе с резервной копией (глава 6 Руководства по установке), и при проверке им там и место: журнал помогает установить, кто что сделал, но реестр чеков он не заменяет.

17.Запуск в рабочую среду

Рабочая среда заполняется только тогда, когда у плательщика есть элемент безопасности, то есть ПАК, и когда у ЕСИР есть учётный номер Налоговой администрации. До тех пор вписывать нечего, и попытка перехода отклоняется, что правильно.

1. На вкладке Среда и ПФР выберите карточку рабочей среды и заполните её настоящими данными: режим Л-ПФР или В-ПФР, рабочий адрес, ПАК и учётный номер ЕСИР.
2. На вкладке Элемент безопасности установите настоящий сертификат в рамку рабочей среды. Он обязан отличаться от тестового; одинаковый отклоняется.
3. Убедитесь, что проверка готовности рабочей среды ни на что не жалуется.
4. Нажмите Переключиться сюда и подтвердите вопрос. С этого момента каждый чек вида Промет или Аванс является фискальным; Копия, Предварительный счёт и Обучение нет.
5. Загрузите налоговые ставки заново (глава 9) и просмотрите справочник товаров, потому что у рабочей системы может быть иной набор меток, чем у тестовой.
6. Выдайте один чек вида Обучение и напечатайте его: он проходит весь путь как настоящий, но в оборот не входит. Проверьте шапку, номер ЕСИР, QR-код и печать.
7. И только тогда выдавайте первый настоящий чек.

18.Контрольный список настройки

Настройка завершена, когда подтверждена каждая строка. Строки с 1 по 8 относятся к той среде, в которой идёт работа; строка 9 и далее только к переходу в рабочую среду.