Системой лояльности Artix предусмотрена возможность оплаты чеков продажи подарочными сертификатами. Подарочный сертификат (подарочная карта) представляет собой обычную пластиковую карту со штрих-кодом или магнитной полосой и несет в себе некоторый эквивалент стоимости в валюте. Многие торговые сети предлагают своим клиентам покупку подарочных сертификатов в качестве альтернативы денежному подарку. 

Создание сертификатов осуществляется посредством утилиты администрирования Yuki при подключении к кассовому серверу или в системе лояльности Artix Loyalty Management. Справочник сертификатов должен быть выгружен на кассу. Оплата покупок сертификатом становится возможна после того, как сертификат был продан и на его счет начислена определенная сумма.

Конфигурирование модуля

Для подключения модуля сертификатов необходимо в директории /linuxcash/cash/conf/plugins создать файл с расширением .xml, в котором необходимо указать идентификатор модуля, размещение плагина и прочие параметры. Например, artix_certificate.xml.

Данные об идентификаторе терминала задаются на кассовом сервере и передаются на кассу. При продаже или оплате подарочным сертификатом наличие идентификатора терминала в первую очередь проверяется в файле artix_certificate.xml, а при отсутствии terminalId в данном файле его значение получается из параметра cash.code конфигурационного файла /linuxcash/cash/sync/properties/cash.ini. Настройки файла cash.ini получаются автоматически с кассового сервера, изменение данных вручную не рекомендуется, т.к. при следующем получении настроек с кассового сервера данные будут перезаписаны.

В случае невозможности получить идентификатор сертификат не может быть продан или использован при оплате, на экран кассира выводится сообщение "Терминал не найден".

<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 используется online-режим продажи сертификатов. В этом случае добавление сертификата в чек в качестве товарной позиции возможно только при наличии связи с бонусным сервером, на который отправляется запрос для проверки баланса сертификата. При значении баланса равном 0 сертификат будет добавлен в чек, баллы будут зарезервированы на бонусном сервере. Если при проверке обнаружится, что баланс сертификата не равен 0, то на экран будет выведено сообщение "Сертификат уже продан", сертификат нельзя добавить в чек. Начисление бонусов осуществляется после закрытия чека продажи при наличии связи с сервером. 
  Если связь с сервером исчезла после добавления сертификата в чек, то сертификат будет продан, зарезервированные бонусы будут начислены на сертификат после восстановления связи.
• при значении false используется offline-режим продажи сертификатов и проверка баланса сертификата не осуществляется. После закрытия чека бонусные баллы помещаются в очередь и начисляются на сертификат при наличии связи с бонусным сервером. 

При сторнировании подарочных сертификатов из чека резервирование бонусных баллов отменяется.

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

Сертификаты, которые были использованы, невозможно вернуть по чеку продажи, на экран будет выведено соответствующее предупреждение, сертификаты будут удалены из чека.

• Если бонусы на подарочном сертификате потрачены полностью, то его возврат запрещен, на экран будет выведено предупреждение "Сертификат уже использован или истек срок его годности".
• Если бонусы на подарочном сертификате потрачены частично, то его возврат запрещен, на экран будет выведено предупреждение "Сертификат уже использован".

Оплата сертификатов разрешена любым типом валюты, кроме бонусных баллов. При попытке оплатить сертификат бонусами на экран кассира выводится сообщение "Невозможно потратить баллы". К позиции с подарочным сертификатом не применяются скидки, но разрешено начисление бонусов на карту клиента.

Начисление баланса на подарочный сертификат может быть выполнено предварительно или в момент продажи. Необходимость начисления баланса на подарочный сертификат определяется параметром sellFullCertificates в файле /linuxcash/cash/conf/plugins/artix_certificate.xml. 

• Значение параметра true используется для продажи сертификатов с предварительно начисленным балансом. В этом случае, если:
  • баланс равен номиналу, то сертификат продается без начисления,
  • баланс не равен 0 или номиналу, то сертификат не может быть продан,
  • баланс равен 0, то сертификат продается, на карту выполняется начисление в размере номинала,
• Значение параметра false применяется при продаже сертификатов без начисленного баланса. При продаже выполняется начисление на карту.

Для активации и продажи сертификата необходимо выполнить добавление сертификата в чек продажи. Для добавления сертификата в чек в утилите администрирования Yuki необходимо на клавишу настроить действие "Сертификат" с командой COMMAND_CERTIFICATE. О настройке действий подробнее можно прочитать в разделе "Настройка действий". 

При добавлении сертификата в чек программа запрашивает ввод номера сертификата в диалоговое окно. При добавлении сертификата в чек проверяется разрешен ли ввод номера сертификата с текущего устройства (сканер штрих-кода, ридер карт, вручную).

При распознавании номера данные обрабатываются следующим образом:

• введенные вручную данные не преобразуются,
• при вводе со сканера выводятся все символы (если не установлена настройка "Пропускать последний символ в номере, который вводится со сканера штрих-кодов"),
• при вводе с ридера карт удаляются все символы кроме цифр.

Сертификат добавляется в чек как товарная позиция и отображается в списке товаров. Атрибуты товарной позиции устанавливаются следующим образом:

В кассовом ПО Artix предусмотрена возможность указывать количество смен, в диапазоне которых будет осуществляться локальная проверка, был ли продан сертификат. Количество смен задаётся параметром soldChekDepth в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/artixcertificate.ini в секции [ArtixCertificate].

Если сертификат был продан в смене, входящей в диапазон, то при добавлении сертификата в чек будет выведено предупреждение "Сертификат уже был продан".

[ArtixCertificate]
; Настройки системы сертификатов Артикс
...
; Количество смен, в которых осуществляется проверка, был ли продан сертификат
; по умолчанию 0 - текущая смена
;soldCheckDepth = 0

В кассовом ПО Artix реализована возможность ограничения продажи сертификата в чеке с другими товарами, задается параметром separateCertificateSale в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/artixcertificate.ini в секции [ArtixCertificate]:

• при значении true запрещена продажа сертификатов в чеке с другими товарами:
  • при попытке добавить сертификат в чек, содержащий товары, на экран будет выведено сообщение "Продажа сертификата разрешена только отдельным чеком",
  • при попытке добавить товары в чек, содержащий сертификат, на экран будет выведено сообщение "Запрещено добавление товаров в чек с сертификатом".
• при значении false разрешена продажа сертификатов в чеке с другими товарами.

[ArtixCertificate]
; Настройки системы сертификатов Артикс
...
; Продажа сертификата только отдельным чеком
; по умолчанию false
; separateCertificateSale = false

Продажа сертификатов со свободным номиналом

Кассовое ПО Artix позволяет продавать сертификаты, указывая их номинал при добавлении сертификата в чек. В случае, когда номинал равен 0 или не указан, кассиру будет предложено ввести сумму вручную.

Для ввода суммы сертификата могут быть заданы следующие ограничения:

• Кратность – число, которому должна быть кратна вводимая сумма. Если кратность не указана или равна 1, то проверка кратности не производится.
• Максимальная сумма – сумма, которую не должен превышать номинал сертификата. Если критерий не указан, то пороговое значение не производится.
• Минимальная сумма – сумма, меньше которой номинал сертификата не может быть задан. Если значение не указано, то пороговое значение равно 1.

Ограничения задаются при выгрузке справочников сертификатов на кассу или при помощи утилиты администрирования Yuki в разделе "Карты и группы" – "Сертификаты".

Продажа сертификата в соответствии с ФЗ-54

При продаже сертификата в соответствии с ФЗ-54 необходимо указывать признак предмета расчета: в БД Dictionaries в таблице Certificate в поле paymentobject  указать значение 10.

При продаже в позицию документа в БД Documents в таблицу Goodsitem записываются значения:

• признак предмета расчета paymentobject = 10 (предоплата);
• признак способа расчета paymentmethod = 3 (аванс).

Возврат подарочных сертификатов

Настройками кассового ПО Artix может быть запрещен возврат ранее проданных сертификатов. Данное поведение определяется параметром forbidBackCertificate в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/artixcertificate.ini в секции [ArtixCertificate]:

• при значении true возврат сертификатов запрещен:
  • при попытке добавить сертификат в чек возврата на экран будет выведено предупреждение "Возврат сертификатов запрещен",
  • при попытке добавить сертификат в чек возврата по чеку продажи на экран будет выведено предупреждение "Товары, запрещенные для возврата, удалены из чека",
• при значении false возврат сертификатов разрешен.

[ArtixCertificate]
; Настройки системы сертификатов Артикс
...
; Запрет возврата сертификатов
; по умолчанию  false
;forbidBackCertificate = false

Оплата сертификатом

Использование подарочного сертификата фиксируется в чеке как оплата. Оплата подарочным сертификатом может быть выполнена только при наличии связи с бонусным сервером независимо от режима работы кассы, так как невозможно проверить баланс сертификата. На экран будет выведена ошибка "Нет связи с сервером".

Для использования сертификата как способа оплаты необходимо, чтобы данный сертификат был активирован и его баланс не был равен 0. Чтобы настроить оплату сертификатом, необходимо в утилите Yuki добавить валюту с типом операции "Оплата сертификатом". Для оплаты сертификатами необходимо использовать тип оплаты "Предварительная оплата (аванс)".

Настройками кассового ПО Artix может быть предусмотрен запрос ПИН-кода сертификата при оплате им чека продажи. Запрос ПИН-кода определяется параметром usePincode в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/artixcertificate.ini в секции [ArtixCertificate]:

• при значении true при оплате сертификатом будет запрошен ПИН-код сертификата,
• при значении false  оплата сертификатом осуществляется без запроса ПИН-кода.

[ArtixCertificate]
; Настройки системы сертификатов Артикс

; Запрашивать ПИН-код при оплате сертификатом
; по умолчанию false
;usePincode = false

Сертификатом возможно оплачивать только на необходимую сумму. Если сумма чека превышает баланс сертификата, то после оплаты сертификатом сумма чека уменьшится на стоимость сертификата. Оставшуюся сумму можно доплатить любым другим способом.

Оплата валютой/скидкой

Оплата сертификатом может быть применена в чеке как оплата валютой или как скидка. Способ оплаты определяется параметром useCertificateAsDiscount в плагине сертификатов /linuxcash/cash/conf/plugins/artix_certificate.xml:

• при значении параметра true оплата сертификатом применяется в виде скидки,
• при значении параметра false оплата сертификатом проводится в качестве оплаты валютой.

Оплата – частичное/полное списание

Для сертификатов может быть строго определен способ списания средств с его счета. Метод списания указывается при создании группы сертификатов в утилите администрирования Yuki или в системе Loyalty Management.

Если параметр полного списания не установлен, то возможно выполнить частичное списание средств с подарочного сертификата. Частичное списание позволяет оплачивать одним сертификатом необходимое число покупок, до тех пор пока сумма на нем не иссякнет.

В кассовом ПО Artix при оплате сертификатом может быть предусмотрено отображение остатка на балансе сертификата, данное поведение определяется параметром showCertificateBalance в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/gui.ini в секции [GUI.CertificatePaymentProcessing]:

• при значении true на экран будет выведено сообщение "На балансе сертификата имеется остаток равный <баланс_сертификата>. Верните сертификат покупателю". Значение по умолчанию,
• при значении false на экран будет выведено сообщение "На балансе сертификата имеется остаток. Верните сертификат покупателю".

[GUI.CertificatePaymentProcessing]
; Отображать баланс сертификата в диалоге при наличии остатка после оплаты
; По умолчанию true
;showCertificateBalance = true

Если параметр полного списания установлен, то независимо от суммы чека будет списываться вся сумма сертификата. После того, как остаток средств на сертификате будет равен 0, на экран будет выведено сообщение "Сертификат успешно использован. Необходимо его изъять".

В кассовом ПО Artix при оплате сертификатом с полным списанием может быть установлен запрет на оплату, если баланс сертификата превышает сумму чека. Запрет оплаты с полным списанием задается параметром forbidPartialSpend в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/artixcertificate.ini в секции [ArtixCertificate]:

• при значении true:
  • если сумма оплаты меньше баланса сертификата, то на экран будет выведена ошибка "Сумма оплаты меньше баланса сертификата",
  • если сумма оплаты равна или больше баланса сертификата, то на экран будет выведено сообщение "Сертификат успешно использован. Необходимо его изъять",
• при значении false и любой сумме оплаты сертификатом на экран будет выведено сообщение "Сертификат успешно использован. Необходимо его изъять".

[ArtixCertificate]
...
; Запрет частичной оплаты сертификатом с полным списанием
; по умолчанию false
;forbidPartialSpend = false

Если на сервере сертификатов активирована настройка оплаты чека сертификатом только в том магазине, где была произведена первая оплата, то при попытке отплатить чек сертификатом в другом магазине на экран будет выведена ошибка. Контроль оплаты проверяется бонусным сервисом.

Частичная оплата чека подарочным сертификатом

В кассовом ПО Artix реализована возможность частичной оплаты чека подарочным сертификатом, определяется параметром allowPartialCertificateSpend в конфигурационном файле /linuxcash/cash/conf/ncash.ini в секции [Check]:

• при значении true частичная оплата чека подарочным сертификатом разрешена,
• при значении false частичная оплата чека подарочным сертификатом запрещена, на экран будет выведена ошибка "Допускается только требуемая сумма".

[Check]
...
; Разрешить использовать часть cуммы с сертификата при оплате
; По умолчанию false
;allowPartialCertificateSpend = false

Сгорание остатков баланса сертификата при полном списании

Согласно требованиям ФЗ-54 сертификат используется как самостоятельный тип оплаты. Чтобы в чеке оплата сертификатом фиксировалась как предварительная оплата (аванс), тип оплаты должен быть установлен в значение 3 (в Yuki тип оплаты – "Предварительная оплата (аванс)"). 

Если при оплате одноразовым сертификатом (способ списания средств – полное списание) происходит оплата товара, стоимость которого меньше номинала сертификата, то данные о сгоревшем остатке должны быть отражены в чеке.

Параметры для обозначения позиции, в которой будет указан остаток сертификата, задаются в конфигурационном файле /linuxcash/cash/conf/ncash.ini в секции [CertificateBurnedAmountPosition].

[CertificateBurnedAmountPosition]
; Параметры позиции, которая будет создана при превышении номинальной стоимости подарочной карты
; название позиции
;name = "Превышение номинальной стоимости подарочной карты над продажной ценой товара" 
; номер логического отдела
;dept = 1
; код налога
;vatcode = 1
; код для позиции
;code = "999999999" 
; штрих-код для позиции
;barcode = "999999999" 

Позиция чека, отражающая разницу между номиналом сертификата и стоимостью товара, отображается:

• на экране кассира,
• при просмотре чека из архива кассы,
• на печатном чеке.

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

Возврат товара, оплаченного сертификатом

При возврате товара, оплаченного сертификатом, производится возврат наличными.

Просмотр баланса сертификата

Для вывода информации о балансе сертификата необходимо настроить клавишу "Вывод информации о сертификате" с действием на основе команды COMMAND_CERTIFICATE_INFO с параметром display, который может принимать следующие значения:

• 1 – информация о балансе сертификата будет выведена на экран,
• 2 – информация о балансе печатается на квитанции,
• 3 – информация о балансе выводится на экран и печатается на квитанции,
• другие значения – информация о балансе выводится на экран.

О настройке действий подробнее можно прочитать в разделе "Настройка действий". 

По нажатию клавиши на экран кассира выводится диалоговое окно для ввода номера сертификата. После указания номера сертификата и нажатия клавиши "ОК" информация о балансе будет выведена на экран и/или напечатана в зависимости от параметра команды.

При выводе информации о балансе сертификата на экран доступен для просмотра статус сертификата:

• EARN_ONLY – Сертификат еще не продан,
• PAY_ONLY – Сертификат принимается к оплате,
• EARN_PAY – Оплата сертификатом запрещена,
• NO_OPERATION – Сертификат уже использован или истек срок его годности.

Запросить информацию о балансе сертификата можно только в режиме формирования товарной части документа.

Статус сертификата

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

Продажа сертификата

Возврат сертификата

Возврат сертификата по чеку продажи

Оплата сертификатом