dev@localhost:~/archive/2023$ [ ⌘K ] greplogin

$ cat oformlenie-fiskalnogo-cheka.md

Оформление фискального чека

· Android

В приложении Агент добавлена поддержка работы с сервисами фискализации чеков. Введенный заказ можно зарегистрировать как фискальный чек и сразу получить на телефоне копию чека. В текущей версии реализована работа с Checkbox, в будущем возможна интеграция и других сервисов, имеющих возможность интеграции через АПИ.

Работа с сервисом фискализации на телефоне напоминает работу с кассовым аппаратом в базе 1С - в отдельной форме собраны команды управления РРО: вход кассира, открытие смены, служебные внос и вынос и так далее. В документе Заказ включение регистрации чека происходит при выборе типа расчетов, если для типа расчетов указан фискальный режим, при сохранении заказа выполнится фискализация.

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

Немного технических подробностей. При обмене, от сервера, Агент должен получить в составе опций новые параметры:

  • fiscalNumber - фискальный номер, для Чекбокса это номер лицензии кассы с которой будет работать телефон
  • fiscalCashier - номер кассира, для Чекбокса - пин код кассира
  • fiscalDeviceId - идентификатор устройства, должен быть уникальным для каждой кассы
  • fiscalProvider - идентификатор сервиса фискализации, в текущей версии возможено только значение "Checkbox"

Кроме этих параметров добавлен новый набор данных - paymen_types, он содержит записи с доступными для пользователя типами оплаты. Тип оплаты это объект со следующими полями:

  • payment_type - код типа оплаты, для наличного расчета должен начинаться с "CASH", все другие будут считаться безналичными при регистации чека
  • is_fiscal - 1 или 0, признак необходимости регистрации фискального чека
  • is_default - 1 или 0, тип оплаты по умолчанию для нового документа
  • description - строковое представление для пользователя

При оформлении заказа пользователь выбирает тип оплаты и если для него установлен признак фискальный, при сохранении заказа происходит попытка регистрации фискального чека. В заказе при сохранении также устанавливается признак is_fiscal=1, этот признак передается в данных заказа на сервер.

Формируемые чеки и отчеты запрашиваются из сервиса в виде файлов изображений PNG и при получении выводятся на просмотр стандартными средствами телефона, например через Галерею Google фото.

# агент, android

cd ..

ls · cd · cat · grep · theme · help — или просто кликайте

↑↓ выбор · Enter открыть · ⌘Enter в новой вкладке · Esc закрыть показать все →