Касса «Экспертиза учета»: инструкция администратора

Решение готовится к проверке функциональной совместимости с ТС ПИоТ в «Честном знаке» и к пилотному запуску. Снимки экрана сделаны в учебном режиме, данные товаров и комитента вымышленные.

Установка и настройка рабочего места кассира:

• моноблок POSCenter Atlas 15″ на Linux;
• дисплей покупателя POSCenter Vision 7;
• регистратор АТОЛ, ТС ПИоТ, терминал Сбербанка, сканер;
• связь с 1С.

Настройка самой 1С описана отдельно, в «Инструкции по настройке и работе в 1С».

1. Состав рабочего места

Цены и наличие на маркетплейсах меняются, ссылки ведут на карточки товаров.

На моноблоке одновременно работают касса, драйвер АТОЛ, модуль ЕСМ-1АЛ и локальный модуль «Честного знака». Если есть возможность, поставьте 8 ГБ памяти вместо 4 ГБ.

2. Подключение оборудования

1. Регистратор АТОЛ, сканер и терминал Сбербанка подключите к USB моноблока.
2. Денежный ящик подключите к разъёму денежного ящика на регистраторе.
3. Дисплей покупателя POSCenter Vision 7 подключите к выходу HDMI моноблока, при его отсутствии — к VGA. Поверните дисплей к покупателю.
4. На экране входа в Ubuntu выберите сеанс «Ubuntu on Xorg» (значок шестерёнки под паролем). В этом сеансе касса сама выводит окно покупателя на второй экран, и работает привязка сенсора из пункта 6.
5. В «Настройки → Дисплеи» выберите режим «Объединить дисплеи». Основным сделайте экран моноблока, для Vision 7 задайте разрешение 1024×600. При запуске касса откроет на втором экране окно покупателя без рамки, на весь экран.
6. Если касания на моноблоке попадают не туда, привяжите сенсор к экрану моноблока: xinput list # имя сенсорного экрана xrandr --listmonitors # имя выхода моноблока, например eDP-1 xinput map-to-output "<имя сенсора>" eDP-1 Добавьте последнюю команду в автозапуск сеанса.

3. Установка программы кассы

Пакет собирается на Ubuntu из исходников (kassa/app):

./gradlew :desktop:packageDeb
sudo apt install ./desktop/build/compose/binaries/main/deb/ekspertisa-kassa_1.0.0-1_amd64.deb

Пакет ставится в /opt/ekspertisa-kassa, ярлык «Касса» появляется в меню. Java в пакет уже включена.

4. Регистратор АТОЛ

1. Установите драйвер ККТ АТОЛ 10 для Linux (пакеты deb из центра загрузки АТОЛ: раздел «Программное обеспечение → ДТО → 10.x»). Версия драйвера должна совпадать с указанной в реестре ТС ПИоТ.
2. Дайте пользователю кассы доступ к USB регистратора: правило udev и группа dialout.
3. Включите веб-сервер драйвера: страница http://127.0.0.1:16732/settings → «активировать сервер».

4. Закройте порт 16732 брандмауэром. У веб-сервера нет пароля, обращаться к нему может только сам моноблок: sudo ufw deny in 16732

5. В утилите драйвера проверьте связь с регистратором. Включите ФФД 1.2 и признак «Торговля маркированными товарами».

6. Денежный ящик открывает регистратор. В утилите драйвера проверьте настройку открытия денежного ящика при закрытии чека.

5. ТС ПИоТ и локальный модуль «Честного знака»

1. Установите локальный модуль ЧЗ 2.6 для Ubuntu 22.04: пакет ubuntu22_regime_2.6.1-…_amd64.deb со страницы честныйзнак.рф/local-module/. При инициализации укажите адрес https://rsapi.crpt.ru.
2. Купите лицензию ТС ПИоТ в кабинете ЕСП (https://lk.ao-esp.ru) и установите модуль ЕСМ-1АЛ.
3. Зарегистрируйте модуль. Для этого смена на регистраторе должна быть открыта не дольше 24 часов, ФФД 1.2 включён, признак маркировки включён.
4. Откройте доступ в интернет к адресам из белого списка ЕСП: ts-reg.crpt.ru:19100, cdn*.crpt.ru:19101, api.ao-esp.ru и stats.ao-esp.ru:443.
5. Без интернета проверка идёт через локальный модуль, но выходить в сеть ему нужно хотя бы раз в 10 дней.

6. Терминал Сбербанка

1. Скопируйте программу банка sb_pilot (UPOS для Linux x86_64) в /opt/sbrf. Её выдаёт банк вместе с терминалом.
2. Подключите терминал по USB и проверьте sb_pilot по инструкции банка.
3. Коды операций (оплата, возврат, отмена, сверка) и кодировку файлов ответа сверьте с описанием банка. При отличии их можно изменить в программе.

Оплата по QR (СБП) в этой версии работает только в учебном режиме. С настоящим регистратором кнопка «QR / СБП» выключена, чтобы чек не пробился без реальной оплаты.

7. Сканер

1. Переведите сканер в режим USB-COM (CDC) служебным штрихкодом из его руководства. Добавьте суффикс CR.
2. Сканер появится как /dev/ttyACM0. Добавьте пользователя кассы в группу dialout.
3. Если сканер можно использовать только как клавиатуру, настройте в нём замену символа GS на редкий символ, например ~. Этот символ укажите в настройке scanner.gsSubstitute. Без этого коды маркировки ломаются.

8. Настройки кассы

Файл ~/.config/ekspertisa-kassa/kassa.properties:

GUID склада и вида цен проще всего взять из ответа 1С по адресу <onec.url>/hs/ekspertiza/ping. Откройте его в браузере под пользователем касс. В ответе есть список складов (stores) и видов цен (priceTypes) с их GUID. У склада указан его розничный вид цен (priceType).

Пример:

shop.name=Автозапчасти на Ленина
onec.url=https://1c.example.ru/unf
onec.login=kassa
onec.password=********
onec.store=00000000-0000-0000-0000-000000000000
onec.priceType=00000000-0000-0000-0000-000000000000
cashier.name=Иванова А.
fiscal.mode=atol-web
fiscal.taxationType=usnIncome
marking.mode=tspiot
card.mode=sbpilot
scanner.port=/dev/ttyACM0

9. Связь с 1С

Настройка базы описана в «Инструкции по настройке и работе в 1С». Кратко:

• расширение с HTTP-сервисом ekspertiza, версия 12.4 и новее;
• публикация базы по HTTPS;
• пользователь для касс с ролями «Шлюз касс Экспертиза (пользователь касс)» и «Чтение сервер лояльности»;
• в карточках номенклатуры заполнены вид маркировки, вид продукции ИС, штрихкоды, а у товаров комитентов — комитент.

Касса загружает товары при запуске и по кнопке «Товары из 1С». Вместе с товарами приходят:

• цена по виду цен;
• признак маркировки;
• единица измерения;
• данные комитента.

Пробитые чеки уходят в 1С сразу. Если связь пропала, чеки остаются в очереди и досылаются каждые 5 минут.

10. Обучение кассиров

Запустите кассу с fiscal.mode=emulator, marking.mode=emulator, card.mode=emulator и qr.mode=emulator. Касса будет работать без оборудования. Чеки при этом не фискализируются: задания для регистратора пишутся в журнал fiscal-emulator.log.

Если 1С не настроена, касса сама заполнит справочник учебными товарами автомагазина:

В эмуляторе проверки маркировки результат зависит от начала серийного номера в коде:

• SOLD — товар уже продан;
• BLK — товар заблокирован;
• NF — код не найден;
• PACK — упаковка из 10 единиц.

11. Диагностика

Инструкция кассира Настройка 1С ← К новостям