Начиная с версии 4.6.221 для формирования чеков продажи используется шаблон Начиная с версии 4.6.221 переводы фискальных признаков задаются в шаблонах |
Начиная с версии 4.6.223 пакет Начиная с версии 4.6.223 реализована передача номера телефона в чек при оплате через ClickPass. |
Начиная с версии 4.6.226 добавлена поддержка авансовых и кредитных чеков. |
Передача данных на сервер ОФД Узбекистана обеспечивается сервисом fiscaldriveapi
(Программное обеспечение виртуальной кассы ARTIX версии 4.6.228-5349, Узбекистан).
Для обеспечения передачи данных на сервер ОФД Узбекистана необходимо установить пакет fiscaldriveapi
с помощью команды:
aptitude install fiscaldriveapi |
Для подключения фискального модуля необходимо:
Получить список подключенных USB-устройств, выполнив команду:
lsusb |
Найти в списке подключенных USB-устройств токен Feitian
:
Скопировать значения VID:PID и наименование: "VID=096e, PID=080f, наименование – Feitian Technologies, Inc".
/usr/lib/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist
:[ifdVendorID]
добавить значение VID,[ifdProductID]
добавить значение PID,[ifdFriendlyName]
добавить наименование токена.Параметры подключения к серверу ОФД Узбекистана настраиваются в конфигурационном файле /linuxcash/cash/fiscaldriveapi/config.ini
в секции [smartcard]
:
Секция | Наименование | Тип данных | Описание |
---|---|---|---|
smartcard | factory_id | числовой | Идентификатор фискального модуля (ФМ) |
Для параметра
необходимо указать значение. Для определения значения перейдите в директорию установки factory_id
fiscaldriveapi
и выполните команду:
./fiscal-drive-api -op list |
Результат выполнения команды является значением для параметра
, необходимо записать его в конфигурационный файл:factory_id
[smartcard] factory_id= ... |
Подключение драйвера "Программное обеспечение виртуальной кассы ARTIX версии 4.6.228-5349, Узбекистан" возможно только при наличии принтера чеков. |
Для настройки драйвера "Программное обеспечение виртуальной кассы ARTIX версии 4.6.228-5349, Узбекистан" в Сервисном меню через Менеджер оборудования необходимо:
Адрес – адрес сервера ОФД. Указывается значение вида http://<ip>:<port>/rpc/api
, где ip
и port
берутся из конфигурационного файла /linuxcash/cash/fiscaldriveapi/config.ini
секции [api]
.
5
.Пароль сертификата – пароль сертификата.
cash
.Частота запроса последнего чека – частота запроса последнего зарегистрированного чека из ФМ.
Длительность запроса последнего чека – длительность запроса последнего зарегистрированного чека из ФМ.
Если при указании адреса сервера ОФД используется соединение |
Запуск сервиса fiscaldriveapi
осуществляется двумя способами:
service
.Для запуска сервиса fiscaldriveapi
при помощи утилиты service
необходимо в консоли кассы выполнить команду:
service fiscaldriveapi start |
Если все настройки заданы верно, то после закрытия документа на чеке могут быть напечатаны "Номер версии ВК", "Серийный номер ФМ", "Номер чека", "Фискальный признак", "Дата и время" и QR-код для просмотра чека на сайте ОФД. Текст для печати можно задать в шаблонах. |
Для корректной работы драйвера "Программное обеспечение виртуальной кассы ARTIX версии 4.6.228-5349, Узбекистан" должны быть заданы настройки для соотнесения отделов и типов оплат в конфигурационном файле |
В драйвере "Программное обеспечение виртуальной кассы ARTIX версии 4.6.228-5349, Узбекистан" используются следующие типы оплаты:
1
– оплата наличными,2
– оплата электронными деньгами (безналичная),3
– предварительная оплата (аванс),4
– последующая оплата (кредит).Для использования типа оплаты в утилите администрирования Yuki должна быть добавлена как минимум одна валюта с соответствующим типом оплаты.
При добавлении валюты для работы с авансовыми или кредитными чеками необходимо:
Для поля "Типы оплаты в программе" установить тип "Электронные".
Оплата по авансовому и кредитному чеку производится только на основе типа "Электронные". |
Подробнее о добавлении валют можно прочитать в разделе "Валюты".
Для печати авансовых и кредитных чеков используется шаблон uzofd_sale.xml
без заполнения фискальных данных.
Блокировка кассовой программы при работе с сервером ОФД может быть произведена в следующих случаях:
при отсутствии связи с сервисом fiscaldriveapi
,
При отсутствии связи с ОФД сервис Состояние ФМ проверяется при попытке открыть смену, открыть чек в ФМ или закрыть смену. |
При закрытии чека продажи в ОФД передаются следующие данные о товарных позициях: количество товара, товарный код, код упаковки, скидка, наименование товара или услуги, общая сумма позиции без учета скидок, НДС сумма и прочие (оплата по страховке и др.).
{ "Amount":100, "Barcode":"4600605000984", "CommissionTIN":null, "Discount":0, "Label":"", "Name":"МОЛОЧНЫЙ ДЕСЕРТ ДАНОН ДАНИССИМО ВИШНЯ", "OwnerType":3, "Other":0, "Price":2490, "SPIC":"y7", "Units":41, "VAT":226, "VATPercent":10, "PackageCode":"12345" } |
ntin
), передается в поле SPIC
.
OwnerType
, может быть задан в БД Dictionaries
таблицы Tmc
.Units
, может быть задан:Dictionaries
таблице Units
в поле
frunit
,в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/fr.ini
в секции [HW.FR.UnitsMapping]
:
;[HW.FR.UnitsMapping] ; ; Соотнесение единиц измерения товара и меры количества предмета расчета ; <Код единицы измерения товара> = <Мера количества предмета расчета> ; Мера количества предмета расчета: ; 0 – штуки, единицы; ; 10 – грамм; ; 11 – килограмм; ; 22 – метр; ; 41 – литр; ; соотнесение единиц измерения товара ;1=0 ;2=11 |
При закрытии чека сначала запрашивается |
packagecode
:Dictionaries
таблицы Tmc
,Dictionaries
таблицы Barcodes
(используется, если необходимо задать собственный код упаковки для каждого штрих-кода одного и того же товара).Для реализации маркированных товаров необходимо:
markedgoods
в конфигурационном файле /linuxcash/cash/conf/ncash.
ini.d/markedgoods.ini
в секции [plugins]
.Data
Matrix
. Подробнее об этом можно прочитать в разделе "Реализация маркированных товаров".При передаче данных в ОФД в поле Label
будет записан код маркировки:
{ "Amount": 1000, "Barcode": "4607032140207", "CommissionTIN": null, "Discount": 0, "Label": "0460703214020701234567891236666", "Name": "МОЛОКО БМК 1.5% 1Л П/П", "Other": 0, "Price": 1520, "SPIC": "", "Units": 0, "VAT": 0, "VATPercent": 0 } |
Пример чека в ОФД:
Начиная с версии 4.6.204 в кассовом ПО Artix реализован возврат с учетом фискальных данных чека продажи. Возврат товаров в обычном режиме невозможен. |
В кассовом ПО Artix реализована возможность получения и сохранения фискальных данных чека в БД Documents
в таблице Document
поле frdoccopy
:
frdoccopy='{"DateTime":"20220331175529","FiscalSign":"395306020034","ReceiptSeq":"3513","TerminalID":"UZ191211502346"}' |
Для возврата по чеку продажи необходимо в утилите администрирования Yuki на клавишу настроить действие "Возврат по чеку продажи" с командой COMMAND_BACKBYSALE
и параметром requireParams = true
. Подробнее о настройке действий можно прочитать в разделе "Настройка действий".
При выполнении операции возврата осуществляется проверка на наличие в БД сохраненных фискальных данных чека продажи:
frdoccopy
заполнено, то чек возврата успешно закрывается. Ручной ввод фискальных данных чека продажи не требуется:frdoccopy
не заполнено, то при формировании чека возврата на экран будет выведен диалог ввода фискальных данных чека продажи:Начиная с версии 4.6.218-4 в кассовом ПО Artix реализована передача фискальных данных в процессинг PaymeGO. Начиная с версии 4.6.219 в кассовом ПО Artix реализована передача фискальных данных в процессинг ClickPass. |
В кассовом ПО Artix реализована возможность сохранения фискальных данных и их передачи в процессинги PaymeGO и ClickPass. После закрытия чека в ФР сервер ОФД возвращает номер и URL-адрес чека. Сообщение с URL-адресом и другими данными, необходимыми для конкретного процессинга, помещается в очередь Artix-Queue. После закрытия чека полученные из сообщения данные передаются на сервер процессинга, сообщение удаляется из очереди.
При оплате/отмене оплаты сервер процессинга ClickPass возвращает номер телефона покупателя в поле phone_number
, сервер процессинга PaymeGo – в поле phone
. При закрытии в ФР чека продажи/возврата по чеку продажи полученное значение записывается в поле ExtraInfo.PhoneNumber
и отправляется на сервер ОФД.
При отмене оплаты ClickPass и PaymeGO могут завершить операцию с неизвестным статусом, сообщение об отмене оплаты помещается в очередь Artix-Queue. При этом номер телефона покупателя и идентификатор (RRN) транзакции отмены не заполняются. Объект |
{ ... "params": { "Receipt": { "ExtraInfo": { "PhoneNumber": "+79999999999" }, "Items": [ { "Amount": 1000, "Barcode": "4607032140207", "CommissionTIN": null, "Discount": 0, "Label": "", "Name": "МОЛОКО БМК 1.5% 1Л П/П", "Other": 0, "Price": 1520, "SPIC": "", "Units": 11, "VAT": 0, "VATPercent": 0 } ], "ReceivedCard": 1520, "ReceivedCash": 0, "Time": "2022-11-08 14:45:43" } } } |
Если связь с ОФД отсутствует, то на экран будет выведена ошибка:
|
|
Если ФМ был извлечен из USB-порта, то на экран будет выведена ошибка:
|
|
Если в ФМ количество неотправленных чеков или смен в ОФД достигло максимума, то на экран будет выведена ошибка:
Чек не может быть закрыт.
Если при формировании чека возврата были введены неверные фискальные данные чека продажи, то на экран будет выведена одна из ошибок:
Чек возврата не может быть закрыт.
При закрытии чека возврата без ввода фискальных данных (обычный режим возврата или возврат по чеку продажи, если параметр requireParams = false
) на экран будет выведена ошибка:
Чек возврата не может быть закрыт.
В случае, когда нет возможности закрыть смену в fiscaldriveApi
на кассе, можно воспользоваться ПО POS-SIM.
С инструкцией по установке и работе данного ПО можно ознакомиться здесь. Ссылка для скачивания установочного файла находится здесь.
POS-SIM может работать в ОС Windows (i386 x64) и в ОС Linux (i386 x64):
Рекомендуется запускать POS-SIM на устройстве, которое имеет доступ к кассе, на которой необходимо закрыть смену. Перед запуском необходимо:
|