Для работы с программной кассой необходимо:

Оглавление

Настройка кассы в lsFusion ERP

1. Добавить модель программной кассы.

На форме Оборудование - Модели касс  нажать кнопку Добавить (рис. 1) и в новом окне (рис. 2)  ввести:

Наименование - произвольное название модели касс

Код - код для модели программной кассы Vial обязательно должен быть "titanPOS" 

Рис. 1 Создание новой модели касс

Рис. 2 Настройка модели программной кассы Vial (TitanPOS) 

2.  Настроить группу касс

На форме Оборудование - Группы касс  нажать кнопку Добавить (рис. 3) и в новом окне (рис. 4)  установить настройки группы касс: в поле Модель  указать настроенную модель для кассы Vial.   

Рис. 3 Создание новой группы касс

Рис. 4 Настройка параметров группы касс

Далее, в блоке Касса нажать кнопку Добавить и установить настройки для кассы (рис. 5).  Красным  цветом выделены обязательные для заполнения свойства, зеленым цветом выделены необязательные для заполнения свойства.

Рис. 5 Настройка кассы

Особенности работы кассы

  1. При работе с программной кассой закрытие  Z-отчета требует обязательного изъятия наличных из кассы.
  2. Открытие смены сопровождается печатью документа , при этом на документе, в том числе печатается информация о переданных документах и событиях, а также возможные проблемы, связанные с обновлением СОС (список отозванных сертификатов). Если связь с интернетом существует, то количество документов и событий должно быть 0 и должна отсутствовать информация о проблемах обновления СОС. Если нет связи (отсутствует интернет) в течение более 7 дней, то СКО будет заблокировано для работы. Вычислить критический период неотправленных документов и не обновленных СОС можно по датам документов на открытие смен. 
  3. Для выдачи сдачи необходимо наличие определенной суммы денег в кассе, покрываемых из суммы внесения и принятых оплат наличными от покупателей. Пример: стоимость покупки 30 рублей, в кассе 0 рублей, покупатель дал 50 рублей. При попытке проведения чека будет ошибка:
  4. Есть  3 операции печати копии документа:
  5. В процессе работы могут появляться инфо сообщения или сообщения об ошибках, связанные с работой СКО.  Как правило, если возникла ошибка, то в сообщении указывается Операция, которая вызвала ошибку, текст ошибки, а также код ошибки. Код ошибки может оказаться полезным для получения дополнительной информации или рекомендаций.


Информация для администратора

Программная касса работает с модулем "Управление продажами". Для подключения программной кассы в логике проекта в топ файле прописать вызов управляющего модуля программной кассы FiscalTitanPOS. Например:


Для работы программной кассы необходимо устройство СКО, программное обеспечение для СКО, чековый принтер  и обязательное наличие сети Интернет.

            СКО представляет собой USB устройство, размер менее 5 см. С задней стороны корпуса нанесена служебная информация: СКО, СККО и серийный номер. СКО – это Средство Контроля Оператора. СККО – это Система Контроля Кассового Оборудования.

            ПО СКО решает несколько задач, в том числе управление печатью на чековом принтере. При этом чековый принтер должен поддерживать кодовую страницу 1251 или 866, а также иметь или не иметь в своей прошивке поддержку QR кодов. Выбор осуществляется настройками в конфигурационном файле. Базовая настройка конфигурационного файла предполагает, что чековый принтер поддерживает QR коды и кодовую страницу 1251.   

             Официальные актуальные версии ПО и документации находятся по адресу https://github.com/titanbel/TitanPosSDK_Releases не в общем доступе. Для получения доступа необходимо выслать свой логин от github в техническую службу программной кассы «Виал», после чего они пришлют приглашение для подключения к их ресурсу на гитхабе.

           Отдельно информация по программной кассе с документацией и сопутствующим программным обеспечением находятся на внутреннем сервере по адресу e:\InstLux\!Programm_KSA\TitanPos\. В папке Install и Insall\New находиться инсталляционный пакет TitanPosSDK_x86-64_1_5_9_*.exe (версия 1.5.9. В этой же папке находиться документация на программную кассу в формате PDF документов:


  1. TitanPOS Платформа - Интерфейс API. Содержит описание протокола обмена
  2. TitanPOS Платформа - Руководство по установке и администрированию
  3. TitanPOS Платформа - Функциональные возможности

1.2 Установка программной кассы

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

Для настройки на тестовую зону (работа с тестовым сервером) необходимо поставить галочку. Более подробно «Руководство по установке и администрированию».

1.3 Настройки программной кассы

Основные настройки программной кассы регламентируются конфигурационным файлом и настройками в «Оборудование – Группы касс».
Настройки конфигурационного файла решают задачи по конфигурированию работы программной кассы, чекового принтера, настройки НДС, видов оплат, управление денежным ящиком. Более подробно «Руководство по установке и администрированию», страницы 3-8.

Отдельный момент конфигурирования программной кассы, связан с вариантами запуска приложения. Возможны 4 варианта старта приложения:

1. Пользователь стартует со значка «TitanPOS», который уже в свою очередь запускает основное приложение (ERP), прописанное в конфигурации. Когда основное приложение закрывается, то вместе с ним закрывается программная касса. То есть "тандем приложений" стартует со значка «TitanPOS».
2. Второй вариант похож на 1-й, только вместо основного приложения «TitanPOS» стартует приложение-пустышку, с целью показать пользователю что "что-то запущено". Окно приложения пустышки отражается в панели задач.
3. «TitanPOS» ни чего не запускает и висит с невидимым окном.
4. «TitanPOS» может стартовать, как сервис.

Для реализации вариантов задействуется объект "Application" в конфигурационном файле.
Для вариантов 1 и 2 в параметре «Name» прописывается имя программы, которую запускает приложение TitanPos.exe. Отдельно в массиве «Params» могут быть заданы параметры запуска основного приложения (не TitanPos).
Для варианта 3 и 4 в параметр «Name» записывается значение «NULLAPP».
Для варианта 4, кроме того, воспользоваться сторонним средством nssm, которое идет в комплекте с инсталлятором и устанавливается в папку C:\Program Files\TitanPOS\service. Файл service_install.cmd – это установка сервиса.

Примечание:
• При разработке интеграции программной кассы с ERP использовался 2-й вариант, для чего запускался файл-заглушка DummyWFapp.exe (внутренний сервер, папка e:\InstLux\!Programm_KSA\TitanPos\Install).

Строка в конфигурационном файле:

"Application": { "Name": "C:\\ProgramData\\.TitanPOS\\DummyWFapp.exe"}

1.4 Личный кабинет

Программная касса имеет личный кабинет. Для работы с личным кабинетом, располагается по адресу https://ecrs.by/, необходим ЭЦП (электронная цифровая подпись) и IE версии 11, а также дополнительные настройки операционной системы.

1.5 Особенности некоторых настроек конфигурационного файла

Содержание конфигурационного файла, использованного для написания стыковки с ERP, находится на внутреннем сервере по адресу e:\InstLux\!Programm_KSA\TitanPos\Install.

Чековый принтер. Так как при разработке изначально использовался «старый» чековый принтер без поддержки кодовой страницы 1251 (только 866) и без поддержки QR кодов, то были использованы дополнительно следующие настройки (по рекомендациям службы технической поддержки).

Для печати на русском:
"EscPosSubstituteCharset1251" : 17
"DefaultCharsetName": "IBM 866"

Для печати QR кодов:
"EscPosQrMode" : 2

Ставки НДС. В конфигурационном файле установлены 2 ставки НДС 10 и 20 %. Значение ID привязано к программной обработке.

"Taxes": [
{ "Id": 1, "Name": "НДС 20%", "Value": 0.20 },
{ "Id": 2, "Name": "НДС 10%", "Value": 0.10 }
]
Виды оплат. Виды оплат в конфигурационном файле не определялись, так как по своим ID соответствуют видам оплат в ERP: 1 – НАЛИЧНЫЕ, 2 – КАРТА, 3 – СЕРТИФИКАТ.


            Устройство СКО совместно со своим программным обеспечением ведет свои лог файлы, расположенные в каталоге c:\ProgramData\.TitanPOS\logs\.  Но, просмотр этих логов не всегда удобен. Можно вести отдельный лог относительно запросов к кассе и получаемых от нее ответов. Имя лог файла и его расположение задается в настройках группы касс.

 Структурно в логе отражается дата-время запроса к кассе, условное название операции и запрос от ERP к СКО. Следующей строкой, через строку символов «-» идет содержание ответа от СКО.

 Если ошибок не возникло, то ответ будет представлен, как Json

 Так как все ошибки привязаны к ошибкам HTTP то, как правило, ответ от СКО в логе будет представлен в виде текстовой строки, где отображаются: Номер ошибки WEB, Текст ошибки, Значение статуса (ключ «Status»), текст ошибки (ключ «Error»)