...
Panel | |
---|---|
|
Panel | ||
---|---|---|
Начиная с версии 4.6.132 отправка сообщений об операциях с балансом сертификатов будет реализована только через очередь Artix-Queue180 добавлена локальная проверка продажи подарочных сертификатов на кассе. Начиная с версии 4.6.149-5 осуществлен полноценный переход с интерфейса thrift на rest.
|
Системой лояльности Artix предусмотрена возможность оплаты чеков продажи подарочными сертификатами. Подарочный сертификат (подарочная карта) представляет собой обычную пластиковую карту со штрих-кодом или магнитной полосой и несет в себе некоторый эквивалент стоимости в валюте. Многие торговые сети предлагают своим клиентам покупку подарочных карт в качестве альтернативы денежному подарку.
Создание сертификатов осуществляется посредством утилиты администрирования Yuki при подключении к кассовому серверу или в системе лояльности Artix Loyalty Management. Справочник сертификатов должен быть выгружен на кассу. Оплата покупок сертификатом становится возможна после того, как сертификат был продан и на его счет начислена определенная сумма.
Info |
---|
Для отправки сообщений об операциях с балансом сертификатов может быть использован брокер сообщений Qpid или очередь сообщений Artix-Queue. |
Конфигурирование модуля
...
215 добавлена возможность ограничения продажи сертификата в чеке с другими товарами. |
Системой лояльности Artix предусмотрена возможность оплаты чеков продажи подарочными сертификатами. Подарочный сертификат (подарочная карта) представляет собой обычную пластиковую карту со штрих-кодом или магнитной полосой и несет в себе некоторый эквивалент стоимости в валюте. Многие торговые сети предлагают своим клиентам покупку подарочных сертификатов в качестве альтернативы денежному подарку.
Создание сертификатов осуществляется посредством утилиты администрирования Yuki при подключении к кассовому серверу или в системе лояльности Artix Loyalty Management. Справочник сертификатов должен быть выгружен на кассу. Оплата покупок сертификатом становится возможна после того, как сертификат был продан и на его счет начислена определенная сумма.
Info |
---|
Для отправки сообщений об операциях с балансом сертификатов может быть использована очередь сообщений Artix-Queue. |
Конфигурирование модуля
Для подключения модуля сертификатов необходимо в директории /linuxcash/cash/conf/plugins
создать файл с расширением .xml
, в котором необходимо указать идентификатор модуля, размещение плагина и прочие параметры. Например, artix_certificate.xml
.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
id | строковый | ArtixCertificate | Уникальное наименование модуля | |
plugin | строковый | /linuxcash/cash/plugins/libArtixCertificate.so | Полный путь до плагина | |
address | строковый | Список адресов серверов | По умолчанию " | |
connectTimeout | целочисленный | целое положительное число | Таймаут соединения с сервером в миллисекундах | По умолчанию 2 секунды |
recvTimeout | целочисленный | целое положительное число | Таймаут ожидания ответа от сервера в миллисекундах | По умолчанию 10 секунд |
sendTimeout | целочисленный | целое положительное число | Таймаут отправки сообщения на сервер в миллисекундах | По умолчанию 10 секунд |
terminalId | строковый | Идентификатор терминала | Получается автоматически с кассового сервера | |
useCertificateAsDiscount | логический |
| Оплата сертификатом в виде скидки | По умолчанию false |
onlineSaleCertificates | логический |
| Режим продажи сертификатов | По умолчанию true |
sellFullCertificates | логический |
| Продажа сертификата, у которого баланс равен номиналу | По умолчанию false |
checkCertificateStatus | логический |
| Проверка статуса сертификата | По умолчанию |
user | строковый | Имя пользователя для авторизации на бонусном сервере | ||
password | строковый | Пароль для авторизации на бонусном сервере |
Panel |
---|
Начиная с версии 4.6-42 задание параметра terminalId не является обязательным при настройке модуля "Подарочные сертификаты". |
Данные об идентификаторе терминала задаются на кассовом сервере и передаются на кассу. При продаже или оплате подарочным сертификатом наличие идентификатора терминала в первую очередь проверяется в файле artix_certificate.xml
, а при отсутствии terminalId
в данном файле его значение получается из параметра cash.code
конфигурационного файла /linuxcash/cash/sync/properties/cash.ini
. Настройки файла cash.ini
получаются автоматически с кассового сервера, изменение данных вручную не рекомендуется, т.к. при следующем получении настроек с кассового сервера данные будут перезаписаны.
В случае невозможности получить идентификатор сертификат не может быть продан или использован при оплате, на экран кассира выводится сообщение "Терминал не найден".
Code Block | ||||
---|---|---|---|---|
| ||||
<objects> <object id="ArtixCertificate" plugin="/linuxcash/cash/plugins/libArtixCertificate.so" > <property name="address"> <map> <entry> <key>localhost</key> <value>8080</value> </entry> </map> </property> <property name="connectTimeout"> <value>2000</value> </property> <property name="recvTimeout"> <value>10000</value> </property> <property name="sendTimeout"> <value>10000</value> </property> <property name="terminalId"> <value>6</value> </property> <property name="useCertificateAsDiscount"> <value>true</value> </property> <property name="onlineSaleCertificates"> <value>true</value> </property> <property name="sellFullCertificates"> <value>false</value> </property> <property name="checkCertificateStatus"> <value>false</value> </property> <property name="user"> <value></value> </property> <property name="password"> <value></value> </property> </object> </objects> |
...
Кассовое ПО Artix позволяет продавать подарочные карты сертификаты как самостоятельный товар. Режим продажи сертификатов определяется параметром параметром onlineSaleCertificates
в файле /linuxcash/cash/conf/plugins/artix_certificate.xml
:
...
Возврат сертификатов производится аналогично продаже. Возврат сертификата возможен только в том случае, если он не был использован. В случае, если
Сертификаты, которые были использованы, невозможно вернуть по чеку продажи, на экран будет выведено соответствующее предупреждение, сертификаты будут удалены из чека.
- Если бонусы на подарочном сертификате потрачены полностью
...
- , то его возврат запрещен, на экран будет выведено
...
- предупреждение "Сертификат уже использован
...
- или истек срок его годности".
- Если бонусы на подарочном сертификате потрачены частично, то его возврат запрещен, на экран будет выведено предупреждение "Сертификат уже использован".
Оплата сертификатов разрешена любым типом валюты, кроме бонусных баллов. При попытке оплатить сертификат бонусами на экран кассира выводится сообщение "Невозможно потратить баллы". К позиции с подарочным сертификатом не применяются скидки, но разрешено начисление бонусов на карту клиента.
...
- Значение параметра
true
используется для продажи сертификатов с предварительно начисленным балансом. В этом случае, если:- баланс равен номиналу, то сертификат продается без начисления баланса;,
- баланс не равен
0
или номиналу, то сертификат не может быть продан;, - баланс равен
0
, то сертификат продается, на карту выполняется начисление в размере баланса;номинала,
- Значение параметра
false
применяется при продаже сертификатов без начисленного баланса. При продаже выполняется начисление на карту.
...
При добавлении сертификата в чек программа запрашивает ввод номера сертификата в диалоговое окно. При добавлении сертификата в чек проверяется разрешен ли ввод номера сертификата с текущего устройства (сканер штрих-кода, ридер карт, вручную).
При распознавании номера карты данные обрабатываются следующим образом:
...
Товарная позиция | Сертификат |
---|---|
Код | Код товара или код группы сертификатов, если поле "код товара" не заполнено |
Штрих-код | Номер |
Наименование | Наименование группы сертификатов |
Цена | Номинал |
Код операции |
|
Дополнительные данные | Идентификатор операции |
Отдел | Отдел, в который будет записана продажа сертификата |
Налог | Налог |
...
Info |
---|
При использовании нескольких ФР на кассе сертификат может быть продан только в том случае, если для него задан отдел и для этого отдела настроено соотнесение отделов с одним из ФР. В противном случае сертификат в чек не будет добавлен, на экран будет выведена ошибка "Товару не назначена ККМ". |
Продажа сертификатов со свободным номиналом
Кассовое ПО Artix позволяет продавать сертификаты, указывая их номинал при добавлении сертификата в чек. В случае, когда номинал равен 0 или не указан, кассиру будет предложено ввести сумму вручную.
Для ввода суммы сертификата могут быть заданы следующие ограничения:
- Кратность - число, которому должна быть кратна вводимая сумма. Если кратность не указана или равна 1, то проверка кратности не производится.
- Максимальная сумма - сумма, которую не должен превышать номинал сертификата. Если критерий не указан, то пороговое значение не производится.
- Минимальная сумма - сумма, меньше которой номинал сертификата не может быть задан. Если значение не указано, то пороговое значение равно 1.
Ограничения задаются при выгрузке справочников сертификатов на кассу или при помощи утилиты администрирования Yuki в разделе "Карты и группы" - "Сертификаты".
Продажа сертификата в соответствии с ФЗ-54
При продаже сертификата в соответствии с ФЗ-54 необходимо указывать признак предмета расчета: в БД Dictionaries
в таблице certificate
в поле paymentobject
указать значение 10.
Info |
---|
Если поле не заполнено, в качестве признака предмета расчета по умолчанию устанавливается 10. |
При продаже в позицию документа в БД Documents
в таблицу Goodsitem
записываются значения:
- признак предмета расчета
paymentobject
= 10 (предоплата), - признак способа расчета
paymentmethod
= 3 (аванс).
Оплата сертификатом
Panel |
---|
Начиная с версии 4.6.125 реализована возможность ограничить оплату чека сертификатом в рамках одного магазина. Получение настроек происходит автоматически с бонусного сервера. Начиная с версии 4.6.141 реализована возможность запрашивать ПИН-код при оплате чека сертификатом. |
Использование подарочного сертификата фиксируется в чеке как оплата. Оплата подарочным сертификатом может быть выполнена только при наличии связи с бонусным сервером независимо от режима работы кассы, так как невозможно проверить баланс сертификата. На экран будет выведена ошибка "Нет связи с сервером".
Для использования сертификата как способа оплаты необходимо, чтобы данный сертификат был активирован и его баланс не был равен 0. Чтобы настроить оплату сертификатом, необходимо в утилите Yuki добавить валюту с типом операции "Оплата сертификатом". Для оплаты сертификатами необходимо использовать тип оплаты "чек".
Настройками кассового ПО Artix может быть предусмотрен запрос ПИН-кода сертификата при оплате им чека продажи. Запрос ПИН-кода определяется параметром usePincode
В кассовом ПО Artix предусмотрена возможность указывать количество смен, в диапазоне которых будет осуществляться локальная проверка, был ли продан сертификат. Количество смен задаётся параметром soldChekDepth
в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/artixcertificate.ini
в секции [ArtixCertificate].
Если сертификат был продан в смене, входящей в диапазон, то при добавлении сертификата в чек будет выведено предупреждение "Сертификат уже был продан".
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
soldChekDepth | числовой | Количество смен, в которых осуществляется проверка, был ли продан сертификат | По умолчанию 0 – текущая смена |
Code Block | ||||
---|---|---|---|---|
| ||||
[ArtixCertificate]
; Настройки системы сертификатов Артикс
...
; Количество смен, в которых осуществляется проверка, был ли продан сертификат
; по умолчанию 0 - текущая смена
;soldCheckDepth = 0 |
В кассовом ПО Artix реализована возможность ограничения продажи сертификата в чеке с другими товарами, задается параметром separateCertificateSale
в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/artixcertificate.ini
в секции [ArtixCertificate]
:
- при значении
true
запрещена продажа сертификатов в чеке с другими товарами:- при попытке добавить сертификат в чек, содержащий товары, на экран будет выведено сообщение "Продажа сертификата разрешена только отдельным чеком",
- при попытке добавить товары в чек, содержащий сертификат, на экран будет выведено сообщение "Запрещено добавление товаров в чек с сертификатом".
- при значении
false
разрешена продажа сертификатов в чеке с другими товарами.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
separateCertificateSale | логический |
| Продажа сертификата только отдельным чеком | По умолчанию false |
Code Block | ||||
---|---|---|---|---|
| ||||
[ArtixCertificate]
; Настройки системы сертификатов Артикс
...
; Продажа сертификата только отдельным чеком
; по умолчанию false
; separateCertificateSale = false |
Продажа сертификатов со свободным номиналом
Кассовое ПО Artix позволяет продавать сертификаты, указывая их номинал при добавлении сертификата в чек. В случае, когда номинал равен 0 или не указан, кассиру будет предложено ввести сумму вручную.
Для ввода суммы сертификата могут быть заданы следующие ограничения:
- Кратность – число, которому должна быть кратна вводимая сумма. Если кратность не указана или равна
1
, то проверка кратности не производится. - Максимальная сумма – сумма, которую не должен превышать номинал сертификата. Если критерий не указан, то пороговое значение не производится.
- Минимальная сумма – сумма, меньше которой номинал сертификата не может быть задан. Если значение не указано, то пороговое значение равно
1
.
Ограничения задаются при выгрузке справочников сертификатов на кассу или при помощи утилиты администрирования Yuki в разделе "Карты и группы" – "Сертификаты".
Продажа сертификата в соответствии с ФЗ-54
При продаже сертификата в соответствии с ФЗ-54 необходимо указывать признак предмета расчета: в БД Dictionaries
в таблице Certificate
в поле paymentobject
указать значение 10
.
Info |
---|
Если поле не заполнено, в качестве признака предмета расчета по умолчанию устанавливается 10 . |
При продаже в позицию документа в БД Documents
в таблицу Goodsitem
записываются значения:
- признак предмета расчета
paymentobject = 10
(предоплата); - признак способа расчета
paymentmethod = 3
(аванс).
Возврат подарочных сертификатов
Настройками кассового ПО Artix может быть запрещен возврат ранее проданных сертификатов. Данное поведение определяется параметром forbidBackCertificate
в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/artixcertificate.ini
в секции [ArtixCertificate]
:
- при значении
true
возврат сертификатов запрещен:- при попытке добавить сертификат в чек возврата на экран будет выведено предупреждение "Возврат сертификатов запрещен",
- при попытке добавить сертификат в чек возврата по чеку продажи на экран будет выведено предупреждение "Товары, запрещенные для возврата, удалены из чека",
- при значении
false
возврат сертификатов разрешен.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
forbidBackCertificate | логический |
| Запрет возврата сертификатов | По умолчанию false |
Code Block | ||||
---|---|---|---|---|
| ||||
[ArtixCertificate]
; Настройки системы сертификатов Артикс
...
; Запрет возврата сертификатов
; по умолчанию false
;forbidBackCertificate = false |
Оплата сертификатом
Panel |
---|
Начиная с версии 4.6.125 реализована возможность ограничить оплату чека сертификатом в рамках одного магазина. Получение настроек происходит автоматически с бонусного сервера. Начиная с версии 4.6.141 реализована возможность запрашивать ПИН-код при оплате чека сертификатом. Начиная с версии 4.6.208 реализована возможность частичной оплаты чека подарочным сертификатом. |
Использование подарочного сертификата фиксируется в чеке как оплата. Оплата подарочным сертификатом может быть выполнена только при наличии связи с бонусным сервером независимо от режима работы кассы, так как невозможно проверить баланс сертификата. На экран будет выведена ошибка "Нет связи с сервером".
Для использования сертификата как способа оплаты необходимо, чтобы данный сертификат был активирован и его баланс не был равен 0
. Чтобы настроить оплату сертификатом, необходимо в утилите Yuki добавить валюту с типом операции "Оплата сертификатом". Для оплаты сертификатами необходимо использовать тип оплаты "Предварительная оплата (аванс)".
Настройками кассового ПО Artix может быть предусмотрен запрос ПИН-кода сертификата при оплате им чека продажи. Запрос ПИН-кода определяется параметром usePincode
в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/artixcertificate.ini
в секции [ArtixCertificate]
:
- при значении
true
при оплате сертификатом будет запрошен ПИН-код сертификата, - при значении
false
оплата сертификатом осуществляется без запроса ПИН-кода.
Warning |
---|
Для корректной работы настройка "Запрос ПИН-кода" должна быть включена на кассе и на сервере сертификатов. |
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
usePincode | логический |
| Запрашивать ПИН-код при оплате сертификатом | По умолчанию false |
Code Block | ||||
---|---|---|---|---|
| ||||
[ArtixCertificate]
; Настройки системы сертификатов Артикс
; Запрашивать ПИН-код при оплате сертификатом
; по умолчанию false
;usePincode = false |
Сертификатом возможно оплачивать только на необходимую сумму. Если сумма чека превышает баланс сертификата, то после оплаты сертификатом сумма чека уменьшится на стоимость сертификата. Оставшуюся сумму можно доплатить любым другим способом.
Panel | ||
---|---|---|
| ||
Пусть имеется чек на сумму 1200 рублей. После оплаты чека сертификатом на сумму 500 рублей сумма чека уменьшается до 700 рублей. Остаток можно оплатить наличными или банковской картой. |
Оплата валютой/скидкой
Оплата сертификатом может быть применена в чеке как оплата валютой или как скидка. Способ оплаты определяется параметром useCertificateAsDiscount
в плагине сертификатов /linuxcash/cash/conf/plugins/artix_certificate.xml
:
- при значении параметра
true
оплата сертификатом применяется в виде скидки, - при значении параметра
false
оплата сертификатом проводится в качестве оплаты валютой.
Оплата – частичное/полное списание
Для сертификатов может быть строго определен способ списания средств с его счета. Метод списания указывается при создании группы сертификатов в утилите администрирования Yuki или в системе Loyalty Management.
Если параметр полного списания не установлен, то возможно выполнить частичное списание средств с подарочного сертификата. Частичное списание позволяет оплачивать одним сертификатом необходимое число покупок, до тех пор пока сумма на нем не иссякнет.
Panel | ||
---|---|---|
| ||
Сертификатом, для которого не установлен параметр полного списания, возможно оплатить несколько покупок, пока денежные средства с сертификата не будут списаны полностью. Например: сертификатом на 1000 руб. возможно оплатить два чека: чек на 400 руб. и чек на 600 руб. |
В кассовом ПО Artix при оплате сертификатом может быть предусмотрено отображение остатка на балансе сертификата, данное поведение определяется параметром showCertificateBalance
в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/artixcertificategui.ini
в секции [ArtixCertificateGUI.CertificatePaymentProcessing]
:
- при значении
true
при оплате сертификатом будет запрошен ПИН-код сертификата на экран будет выведено сообщение "На балансе сертификата имеется остаток равный<баланс_сертификата>
. Верните сертификат покупателю". Значение по умолчанию, - при значении
false
оплата сертификатом осуществляется без запроса ПИН-кода.
...
- на экран будет выведено сообщение "На балансе сертификата имеется остаток. Верните сертификат покупателю".
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
usePincodeshowCertificateBalance | логический |
| Запрашивать ПИН-код при оплате сертификатом | По умолчанию false |
...
Отображать баланс сертификата в диалоге при наличии остатка после оплаты | По умолчанию true |
Code Block | ||||
---|---|---|---|---|
| ||||
[ArtixCertificateGUI.CertificatePaymentProcessing] ; Настройки системы сертификатов Артикс ; Запрашивать ПИН-код при оплате сертификатом ; по умолчанию false ;usePincode = false |
Сертификатом возможно оплачивать только на необходимую сумму. Если сумма чека превышает баланс сертификата, то после оплаты сертификатом сумма чека уменьшится на стоимость сертификата. Оставшуюся сумму можно доплатить любым другим способом.
Panel | ||
---|---|---|
| ||
Пусть имеется чек на сумму 1200 рублей. После оплаты чека сертификатом на сумму 500 рублей сумма чека уменьшается до 700 рублей. Остаток можно оплатить наличными или банковской картой. |
Оплата валютой/скидкой
...
Отображать баланс сертификата в диалоге при наличии остатка после оплаты
; По умолчанию true
;showCertificateBalance = true |
Если параметр полного списания установлен, то независимо от суммы чека будет списываться вся сумма сертификата. После того, как остаток средств на сертификате будет равен 0
, на экран будет выведено сообщение "Сертификат успешно использован. Необходимо его изъять".
Panel | ||
---|---|---|
| ||
Сертификатом, для которого установлен параметр полного списания, возможно оплатить только одну покупку. При первой покупке с сертификата спишется вся сумма, вне зависимости от суммы чека. Например: при оплате чека на 600 руб. сертификатом с номиналом 1000 руб. с сертификата спишется вся сумма. |
В кассовом ПО Artix при оплате сертификатом с полным списанием может быть установлен запрет на оплату, если баланс сертификата превышает сумму чека. Запрет оплаты с полным списанием задается параметром forbidPartialSpend
в конфигурационном файле /linuxcash/cash/conf/plugins/artix_certificate.xmlncash.ini.d/artixcertificate.ini
в секции [ArtixCertificate]
:
- при значении параметра
true
оплата сертификатом применяется в виде скидки, - при значении параметра
false
оплата сертификатом проводится в качестве оплаты валютой.
Оплата частично/полной суммой
Для сертификатов может быть строго определен способ списания средств с его счета. Метод списания указывается при создании группы сертификатов в утилите администрирования Yuki или в системе LM.
Если параметр полного списания не установлен, то возможно выполнить частичную оплату сертификатом. Частичная оплата позволяет оплачивать одним сертификатом необходимое число покупок, до тех пор пока сумма на нем не иссякнет.
Panel | ||
---|---|---|
| ||
При выборе параметра частичной оплаты сертификатом номиналом 1000р. возможно оплатить несколько покупок, пока сумма сертификата не будет погашена (равна 0). Например: сертификатом на 1000р. возможно оплатить два чека: чек на 400р. и чек на 600р. |
Если параметр полного списания установлен, то независимо от суммы чека будет списываться вся сумма сертификата. Если после оплаты баланс сертификата равен 0, на экран выводится сообщение, что сертификат потрачен и его необходимо изъять.
Panel | ||
---|---|---|
| ||
При выборе параметра оплаты полной суммой сертификатом номиналом 1000р. возможно оплатить только одну покупку, при первой покупке с сертификата спишется вся сумма, вне зависимости от суммы чека. Например: при оплате чека на 600р. сертификатом с номиналом 1000р. с сертификата спишется вся сумма. |
Если на сервере сертификатов активирована настройка оплаты чека сертификатом только в том магазине, где была произведена первая оплата, то при попытке отплатить чек сертификатом в другом магазине на экран выводится ошибка. Контроль оплаты проверяется бонусным сервисом.
...
-
true
:- если сумма оплаты меньше баланса сертификата, то на экран будет выведена ошибка "Сумма оплаты меньше баланса сертификата",
- если сумма оплаты равна или больше баланса сертификата, то на экран будет выведено сообщение "Сертификат успешно использован. Необходимо его изъять",
- при значении
false
и любой сумме оплаты сертификатом на экран будет выведено сообщение "Сертификат успешно использован. Необходимо его изъять".
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
forbidPartialSpend | логический |
| Запрет частичной оплаты сертификатом с полным списанием | По умолчанию false |
Code Block | ||||
---|---|---|---|---|
| ||||
[ArtixCertificate]
...
; Запрет частичной оплаты сертификатом с полным списанием
; по умолчанию false
;forbidPartialSpend = false |
Если на сервере сертификатов активирована настройка оплаты чека сертификатом только в том магазине, где была произведена первая оплата, то при попытке отплатить чек сертификатом в другом магазине на экран будет выведена ошибка. Контроль оплаты проверяется бонусным сервисом.
Частичная оплата чека подарочным сертификатом
В кассовом ПО Artix реализована возможность частичной оплаты чека подарочным сертификатом, определяется параметром allowPartialCertificateSpend
в конфигурационном файле /linuxcash/cash/conf/ncash.ini
в секции [Check]
:
- при значении
true
частичная оплата чека подарочным сертификатом разрешена, - при значении
false
частичная оплата чека подарочным сертификатом запрещена, на экран будет выведена ошибка "Допускается только требуемая сумма".
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
allowPartialCertificateSpend | логический |
| Разрешить использовать часть cуммы с сертификата при оплате | По умолчанию false |
Code Block | ||||
---|---|---|---|---|
| ||||
[Check]
...
; Разрешить использовать часть cуммы с сертификата при оплате
; По умолчанию false
;allowPartialCertificateSpend = false |
Сгорание остатков баланса сертификата при полном списании
Warning |
---|
Для корректной работы функционала необходимо использовать модели ФР, оборудованные ФН. |
Согласно требованиям ФЗ-54 сертификат используется как самостоятельный тип оплаты. Чтобы в чеке оплата сертификатом фиксировалась как предварительная оплата (аванс), тип оплаты должен быть установлен в значение 3
(в Yuki тип оплаты - чектип оплаты – "Предварительная оплата (аванс)").
Если при оплате одноразовым сертификатом (способ списания средств - полной суммой– полное списание) происходит оплата товара, стоимость которого меньше номинала сертификата, то данные о сгоревшем остатке должны быть отражены в чеке.
...
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
name | строковый | Наименование позиции, в которую будет записана разница между номиналом сертификата и стоимостью товара в чеке | |
dept | целочисленный | Номер логического отдела (в кассовой программе), к которому будет привязана позиция | При подключении нескольких ФР позиция будет создана для того ФР, к которому привязан логический отдел |
vatcode | целочисленный | Код налога, который будет начислен на позицию | |
code | строковый | Код позиции, с которым она будет добавлена в чек | |
barcode | строковый | Штрих-код позиции, с которым она будет добавлена в чек |
Code Block | ||||
---|---|---|---|---|
| ||||
[CertificateBurnedAmountPosition] ; Параметры позиции, которая будет создана при превышении номинальной стоимости подарочной карты ; название позиции ;name = "Превышение номинальной стоимости подарочной карты над продажной ценой товара" ; номер логического отдела ;dept = 1 ; код налога ;vatcode = 1 ; код для позиции ;code = "999999999" ; штрих-код для позиции ;barcode = "999999999" |
...
Panel | ||
---|---|---|
| ||
По условиям работы кассы баланс сертификата списывается полностью, остаток не возвращается, сдача не выдается (у группы сертификатов указан признак "оплата полной суммойпараметр "полное списание"). В чеке продажи имеется товар - – Внешний аккумулятор. Стоимость товара 890 р. Чек оплачивается одноразовым сертификатом с номиналом 1000 р. Так как гашение сертификата производится полностью независимо от суммы покупки, то на разницу между номиналом сертификата и стоимостью товара в чеке создается позиция. Чек в ФР будет выглядеть следующим образом:
Сумма по чеку предоплатой 1000 р. |
...
Для вывода информации о балансе сертификата необходимо настроить клавишу "Вывод информации о сертификате" с действием на основе команды COMMAND_CERTIFICATE_INFO
с параметром display
, который может принимать следующие значения:
- 1 - – информация о балансе сертификата будет выведена на экран,
- 2 - – информация о балансе печатается на квитанции,
- 3 - – информация о балансе выводится на экран и печатается на квитанции,
- другие значения - – информация о балансе выводится на экран.
...
При выводе информации о балансе сертификата на экран доступен для просмотра статус сертификата:
- EARN_ONLY - – Сертификат еще не продан,
- PAY_ONLY - – Сертификат принимается к оплате,
- EARN_PAY - – Оплата сертификатом запрещена,
- NO_OPERATION - – Сертификат уже использован или выводится дополнительный статус при его наличииистек срок его годности.
Запросить информацию о балансе сертификата можно только в режиме формирования товарной части документа.
...
Info |
---|
Для работы с сертификатами могут быть заданы только статусы EARN_ONLY, PAY_ONLY, EARN_PAY и NO_OPERATION. Другие значения считаются некорректными. |
Продажа сертификата
Статус | Условия продажи сертификата | при продажеУсловия продажи | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
сертификата | Баланс сертификата равен 0 | Баланс сертификата > 0 | Отсутствие связи с сервером onlineSaleCertificates = false | |||||||||||
при продаже | checkCertificateStatus = true (статус сертификата проверяется) | checkCertificateStatus = false (статус сертификата не проверяется) | checkCertificateStatus = true sellFullCertificates = false (статус сертификата проверяется, продавать можно только сертификаты с нулевым балансом) | checkCertificateStatus = false sellFullCertificates = false (статус сертификата не проверяется, продавать можно сертификаты с нулевым балансом) | checkCertificateStatus = true/false sellFullCertificates = true (разрешена продажа сертификатов с ненулевым балансом) | |||||||||
EARN_ONLY | Сертификат продан. Баланс начислен на карту. Присвоен статус PAY_ONLY. | Сертификат продан. Баланс начислен на карту. Присвоен статус PAY_ONLY. | На экран выводится сообщение "Сертификат уже продан". Статус сертификата не изменяется. | На экран выводится сообщение "Сертификат уже продан". Статус сертификата не изменяется. | Сертификат продан. Статус сертификата сохраняет свое значение. | Сертификат продан. Статус сертификата сохраняет свое значение. Начисление средств происходит только в том случае, когда статус разрешает выполнить начисление (EARN_ONLY или EARN_PAY). | ||||||||
PAY_ONLY | На экран выводится предупреждение "Сертификат уже продан". Статус сертификата не изменяется. | На экран выводится предупреждение "На карту запрещено начислять средства". Статус сертификата не изменяется. | На экран выводится сообщение "Сертификат уже продан". Статус сертификата не изменяется. | |||||||||||
EARN_PAY | На экран выводится предупреждение "Продажа сертификата запрещена". Статус сертификата не изменяется. Начисления не происходит. | Сертификат продан. Баланс начислен на карту. Присвоен статус PAY_ONLY. | На экран выводится предупреждение "Продажа сертификата запрещена". Статус сертификата не изменяется. Начисления не происходит. | |||||||||||
NO_OPERATION | На экран выводится сообщение "Сертификат уже использован". Статус сертификата не изменяется. Если в свойствах сертификата на кассовом сервере имеется дополнительный статус, то на экран выводится его значение. | На экран выводится сообщение "Карта заблокирована". Статус сертификата не изменяется. | На экран выводится сообщение "Сертификат уже использован". Статус сертификата не изменяется. Если в свойствах сертификата на кассовом сервере имеется дополнительный статус, то на экран выводится его значение. |
Возврат сертификата
Статус | Условия возврата сертификата | при возвратеУсловия возврата | ||||||
---|---|---|---|---|---|---|---|---|
сертификата | Баланс сертификата равен 0 | Баланс сертификата > 0 | ||||||
при возврате | checkCertificateStatus = true (статус сертификата проверяется) | checkCertificateStatus = false (статус сертификата не проверяется) | checkCertificateStatus = true (статус сертификата проверяется) | checkCertificateStatus = false (статус сертификата не проверяется) | ||||
EARN_ONLY | На экран выводится предупреждение "Сертификат еще не продан". Статус сертификата не изменяется. | На экран выводится предупреждение "Сертификат был использован". Статус сертификата не изменяется. | На экран выводится предупреждение "Сертификат еще не продан". Статус сертификата не изменяется. | Сертификат возвращен. Средства списаны. Статус сертификата изменен на EARN_ONLY. | ||||
PAY_ONLY | На экран выводится предупреждение "Сертификат был использован". Статус сертификата не изменяется. | Сертификат возвращен. Средства списаны. Статус сертификата изменен на EARN_ONLY. | ||||||
EARN_PAY | На экран выводится предупреждение "Возврат сертификата запрещен". Статус сертификата не изменяется. | На экран выводится предупреждение "Возврат сертификата запрещен". Статус сертификата не изменяется. | ||||||
NO_OPERATION | На экран выводится сообщение предупреждение "Сертификат уже использован или истек срок его годности". Статус сертификата не изменяется. Если в свойствах сертификата на кассовом сервере имеется дополнительный статус, то на экран выводится его значение. | На экран выводится сообщение предупреждение "Сертификат уже использован". Статус сертификата не изменяется. Если в свойствах сертификата на кассовом сервере имеется дополнительный статус, то на экран выводится его значение. | На экран выводится предупреждение "Карта заблокирована". Статус сертификата не изменяется. |
Возврат сертификата по чеку продажи
Статус сертификата | Условия возврата сертификата | ||||
---|---|---|---|---|---|
при возврате | Баланс сертификата равен 0 | Баланс сертификата > 0 | |||
продажи | checkCertificateStatus = true (статус сертификата проверяется) | checkCertificateStatus = false (статус сертификата не проверяется) | checkCertificateStatus = true (статус сертификата проверяется) | checkCertificateStatus = false (статус сертификата не проверяется) | |
EARN_ONLY | При формировании документа возврата на экран выводится сообщение "Сертификат будет удален из чека. Сертификат еще не продан". Сертификат не возвращается, статус сертификата не изменяется. | При формировании документа возврата на экран выводится сообщение "Сертификат будет удален из чека. Сертификат был использован". Сертификат не возвращается, статус сертификата не изменяется. | При формировании документа возврата на экран выводится сообщение "Сертификат будет удален из чека. Сертификат еще не продан". Сертификат не возвращается, статус сертификата не изменяется. | Сертификат возвращен. С сертификата списываются средства. Статус сертификата изменяется на EARN_ONLY. Если сумма средств сертификата меньше, чем была при продаже (например, была выполнена частичная оплатабыло выполнено частичное списание), то при формировании документа возврата на экран выводится сообщение "Сертификат будет удален из чека. Сертификат был использован". Сертификат не возвращается, статус сертификата не изменяется. | |
PAY_ONLY | При формировании документа возврата на экран выводится сообщение "Сертификат будет удален из чека. Сертификат был использован". Сертификат не возвращается, статус сертификата не изменяется. | Сертификат возвращен. С сертификата списываются средства. Статус сертификата изменяется на EARN_ONLY. Если сумма средств сертификата меньше, чем была при продаже (например, была выполнена частичная оплатабыло выполнено частичное списание), то при формировании документа возврата на экран выводится сообщение "Сертификат будет удален из чека. Сертификат был использован". Сертификат не возвращается, статус сертификата не изменяется. | |||
EARN_PAY | При формировании документа возврата на экран выводится сообщение "Сертификат будет удален из чека. Возврат сертификата запрещен". Сертификат не возвращается, статус сертификата не изменяется. | При формировании документа возврата на экран выводится сообщение "Сертификат будет удален из чека. Возврат сертификата запрещен". Сертификат не возвращается, статус сертификата не изменяется. | |||
NO_OPERATION | При формировании документа возврата на экран выводится сообщение предупреждение "Сертификат '<название_сертификата>' будет удален из чека. Сертификат уже использован или истек срок его годности". Сертификат не возвращается, статус сертификата не изменяется. Если в свойствах сертификата на кассовом сервере имеется дополнительный статус, то на экран выводится его значение. | При формировании документа возврата на экран выводится сообщение предупреждение "Сертификат '<название_сертификата>' будет удален из чека. Сертификат уже использован или истек срок его годности". Если в свойствах сертификата на кассовом сервере имеется дополнительный статус, то на экран выводится его значение. Сертификат не возвращается, статус сертификата не изменяется. | При формировании документа возврата на экран выводится сообщение "Сертификат будет удален из чека. Карта заблокирована". Если сумма средств сертификата меньше, чем была при продаже (например, была выполнена частичная оплатабыло выполнено частичное списание), то при формировании документа возврата на экран выводится сообщение "Сертификат будет удален из чека. Сертификат был использован". Сертификат не возвращается, статус сертификата не изменяется. |
Оплата сертификатом
Статус | сертификата при оплатеУсловия оплаты сертификатом | ||||
---|---|---|---|---|---|
сертификата | Баланс сертификата равен 0 | Баланс сертификата > 0 | |||
при оплате | checkCertificateStatus = true (статус сертификата проверяется) | checkCertificateStatus = false (статус сертификата не проверяется) | checkCertificateStatus = true (статус сертификата проверяется) | checkCertificateStatus = false (статус сертификата не проверяется) | |
EARN_ONLY | При попытке оплатить товар на экран выводится ошибка "Сертификат еще не продан". Оплатить покупку нельзя, статус сертификата не изменяется. | При попытке оплатить товар на экран выводится ошибка "Нет средств для оплаты". Оплатить покупку нельзя, статус сертификата не изменяется. | При попытке оплатить товар на экран выводится ошибка "Сертификат еще не продан". Оплатить покупку нельзя, статус сертификата не изменяется. | При попытке оплатить товар на экран выводится ошибка "Невозможно осуществить покупку на анонимную карту". Оплатить покупку нельзя, статус сертификата не изменяется. | |
PAY_ONLY | При попытке оплатить товар на экран выводится ошибка "Нет средств для оплаты". Оплатить покупку нельзя, статус сертификата не изменяется. | Покупка оплачивается. Средства списываются с сертификата. Статус сертификата изменяется на NO_OPERATION. В случае полного списания средств на экран выводится сообщение "Сертификат использован. Его необходимо изъять". | Покупка оплачивается. Средства списываются с сертификата. Статус сертификата изменяется на NO_OPERATION. В случае полного списания средств на экран выводится сообщение "Сертификат использован. Его необходимо изъять". | ||
EARN_PAY | При попытке оплатить товар на экран выводится ошибка "Оплата сертификатом запрещена". Оплатить покупку нельзя, статус сертификата не изменяется. | При попытке оплатить товар на экран выводится ошибка "Оплата сертификатом запрещена". Оплатить покупку нельзя, статус сертификата не изменяется. | |||
NO_OPERATION | При попытке оплатить товар на экран выводится ошибка "Сертификат уже использован или истек срок его годности". Оплатить покупку нельзя, статус сертификата не изменяется. Если в свойствах сертификата на кассовом сервере имеется дополнительный статус, то на экран выводится его значение. | При попытке оплатить товар на экран выводится ошибка "Сертификат уже использован или истек срок его годности". Оплатить покупку нельзя, статус сертификата не изменяется. | При попытке оплатить товар на экран выводится ошибка "Карта заблокирована". Оплатить покупку нельзя, статус сертификата не изменяется. |
...