Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Panel

Table of Contents


Panel

Начиная с версии 4.6.132 отправка сообщений об операциях с балансом сертификатов будет реализована только через очередь Artix-Queue180 добавлена локальная проверка продажи подарочных сертификатов на кассе.

Начиная с версии 4.6.149-5 осуществлен полноценный переход с интерфейса thrift на rest.

Tip

Сейчас по интерфейсу thrift осуществляется работа с бонусами, сертификатами и купонами, что будет изменено после обновления.
Миграция настроек при обновлении кассы происходить не будет. Вместо этого порт 7791 будет заменён на 8080 при запросе к бонусному серверу, серверу сертификатов и купонному серверу. Это же касается и сообщений взятых из очереди.

Таким образом, чтобы исключить проблемы после обновления касс на новый релиз, для последующей работы с бонусным сервером, сервером сертификатов, купонным сервером, необходимо на соответствующих серверах установить пакет artix-accounting-rest.

Также рекомендуется обновить ваш бонусный сервер, сервер сертификатов и купонный сервер до версии #284.

Системой лояльности 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строковый
Список адресов серверов

По умолчанию "key=localhost", "value=8080".

connectTimeoutцелочисленныйцелое положительное числоТаймаут соединения с сервером в миллисекундахПо умолчанию 2 секунды
recvTimeoutцелочисленныйцелое положительное числоТаймаут ожидания ответа от сервера в миллисекундахПо умолчанию 10 секунд
sendTimeoutцелочисленныйцелое положительное числоТаймаут отправки сообщения на сервер в миллисекундахПо умолчанию 10 секунд
terminalIdстроковый
Идентификатор терминалаПолучается автоматически с кассового сервера
useCertificateAsDiscountлогический
  • true
  • false
Оплата сертификатом в виде скидкиПо умолчанию false
onlineSaleCertificatesлогический
  • true
  • false
Режим продажи сертификатовПо умолчанию true
sellFullCertificatesлогический
  • true
  • false
Продажа сертификата, у которого баланс равен номиналуПо умолчанию false

checkCertificateStatus

логический
  • true
  • false
Проверка статуса сертификата

По умолчанию false

user

строковый
Имя пользователя для авторизации на бонусном сервере

password

строковый
Пароль для авторизации на бонусном сервере
Panel
Начиная с версии 4.6-42 задание параметра terminalId не является обязательным при настройке модуля "Подарочные сертификаты".

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

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

Code Block
languagetext
titleПример настройки
<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 применяется при продаже сертификатов без начисленного баланса. При продаже выполняется начисление на карту.

...

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

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

...

Товарная позицияСертификат
КодКод товара или код группы сертификатов, если поле "код товара" не заполнено
Штрих-кодНомер
НаименованиеНаименование группы сертификатов
ЦенаНоминал
Код операции
  • 63 - продажа сертификата
  • 64 - возврат сертификата
Дополнительные данныеИдентификатор операции
ОтделОтдел, в который будет записана продажа сертификата
НалогНалог

...

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
languagetext
titleПример настройки
[ArtixCertificate]
; Настройки системы сертификатов Артикс
...
; Количество смен, в которых осуществляется проверка, был ли продан сертификат
; по умолчанию 0 - текущая смена
;soldCheckDepth = 0

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

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


Code Block
languagetext
titleПример настройки
[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

логический
  • true
  • false
Запрет возврата сертификатов По умолчанию false


Code Block
languagetext
titleПример настройки
[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

логический
  • true
  • false
Запрашивать ПИН-код при оплате сертификатом По умолчанию false


Code Block
languagetext
titleПример настройки
[ArtixCertificate]
; Настройки системы сертификатов Артикс

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

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

Panel
titleПример

Пусть имеется чек на сумму 1200 рублей.

После оплаты чека сертификатом на сумму 500 рублей сумма чека уменьшается до 700 рублей. Остаток можно оплатить наличными или банковской картой.

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

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

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

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

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

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

Panel
titleПример

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

Например: сертификатом на 1000 руб. возможно оплатить два чека: чек на 400 руб. и чек на 600 руб.

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

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

...

  • на экран будет выведено сообщение "На балансе сертификата имеется остаток. Верните сертификат покупателю".
НаименованиеТип данныхВозможные значенияОписаниеПримечания

usePincodeshowCertificateBalance

логический
  • true
  • false
Запрашивать ПИН-код при оплате сертификатом По умолчанию false

...

Отображать баланс сертификата в диалоге при наличии остатка после оплатыПо умолчанию true


Code Block
languagetext
titleПример настройки
[ArtixCertificateGUI.CertificatePaymentProcessing]
; Настройки системы сертификатов Артикс

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

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

Panel
titleПример

Пусть имеется чек на сумму 1200 рублей.

После оплаты чека сертификатом на сумму 500 рублей сумма чека уменьшается до 700 рублей. Остаток можно оплатить наличными или банковской картой.

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

...

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

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

Panel
titleПример

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

Например: при оплате чека на 600 руб. сертификатом с номиналом 1000 руб. с сертификата спишется вся сумма.

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

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

Оплата частично/полной суммой

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

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

Panel
titleПример

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

Например: сертификатом на 1000р. возможно оплатить два чека: чек на 400р. и чек на 600р.

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

Panel
titleПример

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

Например: при оплате чека на 600р. сертификатом с номиналом 1000р. с сертификата спишется вся сумма.

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

...

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

forbidPartialSpend

логический
  • true
  • false
Запрет частичной оплаты сертификатом с полным списаниемПо умолчанию false


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

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

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

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

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

allowPartialCertificateSpend

логический
  • true
  • false
Разрешить использовать часть cуммы с сертификата при оплатеПо умолчанию false


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

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

Warning

Для корректной работы функционала необходимо использовать модели ФР, оборудованные ФН.

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

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

...

НаименованиеТип данныхОписаниеПримечания

name

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

dept

целочисленныйНомер логического отдела (в кассовой программе), к которому будет привязана позицияПри подключении нескольких ФР позиция будет создана для того ФР, к которому привязан логический отдел

vatcode

целочисленныйКод налога, который будет начислен на позицию

code

строковыйКод позиции, с которым она будет добавлена в чек

barcode

строковыйШтрих-код позиции, с которым она будет добавлена в чек


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

...

Panel
titleПример

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

В чеке продажи имеется товар - Внешний аккумулятор. Стоимость товара 890 р.

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

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

Чек в ФР будет выглядеть следующим образом:

  1. Внешний аккумулятор 890 р
    • Признак способа расчета paymentmethod = 4 (полный расчет)
    • Признак предмета расчета paymentobject = 1 (товар)
  2. Превышение номинальной стоимости подарочной карты над продажной ценой товара 110 р
    • Признак способа расчет paymentmethod = 4 (полный расчет)
    • Признак предмета расчета paymentobject = 13 (иной предмет расчета)

Сумма по чеку предоплатой 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

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

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

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

...