Page History

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

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

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

Image RemovedImage Added

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

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

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

Заголовок страницы на 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

• интерфейс подключения USB
• система команд ESC/POS
• прошивка принтера должна содержать кодовую страницу 866 (MS DOS)
• поддержка печати QR кодов

Эта информация может быть получена из self теста принтера и (или) технической документации на устройство.
Self тест для большинства принтеров выполняется следующим образом: выключить принтер, нажать на кнопку «FEED» панели управления принтером, включить принтер и отпустить кнопку «FEED». При этом принтер автоматически напечатает свои характеристики и текущие установки.
Принтер должен быть установлен в системе (его ПО должно быть проинсталлировано) и он должен определяться операционной системой. Имя принтера в системе Windows будет использовано для настройки оборудования программной кассы в ERP.
Важное замечание:
для тестирования подойдет любой чековый принтер, даже не поддерживающий печать QR кодов. Но, для реальной работы нужен принтер, который печатает QR коды, так как это определено законодательно.
См. также документация:
https://tsrv.int.imlab.by/base/printers.html , Очередь печати WIndows

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

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

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

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\.  Но, просмотр этих логов не всегда удобен. Можно вести отдельный лог относительно запросов к кассе и получаемых от нее ответов.
Image Removed
Структурно Имя лог файла и его расположение задается в настройках группы касс.

Image Added

 Структурно в логе отражается дата-время запроса к кассе, условное название операции и запрос от ERP к СКО. Следующей строкой, через строку символов «-» идет содержание ответа от СКО.Если значение ключа type равно send, то запрос был выполнен успешно.
Если значение равно error, то ответ будет содержать код и описание ошибки, которое может несколько отличаться от сообщения на экране, что связано с тем, что некоторые оригинальные сообщения идут на английском языке, также отображение некоторых сообщений может быть отдельно интерпретировано под текущую ситуацию.
Пакет сообщений типа «запрос-ответ» разделяется строкой символов «=».
В приводимой картинке приводиться два запроса

. 1-й запрос «Получение статуса к СКО» имеет статус ошибки. Второй запрос «Открытие сессии» выполнен успешно. Если ошибок не возникло, то ответ будет представлен, как Json

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