Устаревшая версия Jira

server	System JIRA
columns	key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId	bc8d3685-f9c0-329d-9054-b12aabbcb834
key	CR-3746

Статус

colour	Blue
title	10.2.96.0

Оглавление

Описание

Начиная с версии 10.2.96.0 реализована возможность с помощью специального плагина Mastercard и только для карт данного типа производить выдачу наличных денежных средств на кассе покупателю вместе с транзакцией оплаты покупки.

Настройка

Установка файла плагина (до версии 10.2.97.0)

1. Скачайте и скопируйте файл плагин на сервер и кассы.

...

ОС Linux

\var\lib\jboss\plugins

Добавление процессинга на сервере

1. Перейдите в Интеграция → кликните Внешние процессинги → кликните .

...

8. Все настройки отправятся на кассы. Для применения их применения перезагрузите кассовый модуль.

Особенности настройки добавления товара выдачи наличных на кассе SetTouch

Добавление товара для выдачи наличных на кассе SetTouch производится только двумя способами. В ручную ввод штрихкода услуги товара выдачи наличных невозможен на кассе SetTouch.

Обычное сканирование штрих-кода товара, которы устанавливается в поле Штрихкод услуги в настройке Плагина CashOut-MasterCard,
Также добавление товара-услуги для выдачи наличных можно назначить через меню SetTouch.

...

Кассу перезагружать не нужно. Меню обновиться автоматически.

Операционный день

После процесса продажи чек выдачи наличных и чек продажи товара отображаются в разделе Операционный день → Чеки.

Чек расхода - документ о выдачи наличных с товаром-услугуой.
Чек продажи - документ о продаже обычного товара с банковской транзакцией.

Чек продажи с авторизацией банковской карты

Чек продажи с обычным товаром в операционном дне будет первее чека с товаром-услугой выдачи.

...

При этом общая сумма банковской транзакции будет отображатсья на вкладке ТРАНЗАКЦИИ ОПЛАТЫ именно чека с товарной позицией.

Чек выдачи наличных

Чек продажи с товаром-услугой выдачи наличных в операционном дне будет после чека с товарной позицией.

...

На вкладке ТРАНЗАКЦИИ операция по списанию с карты не отображается в данном типе чека.

Экспорт данных в ERP

Экспорт чеков и Z-отчетов в ERP производится согласно интеграционной документации по выгрузке:

Чек продажи с авторизацией банковской карты

В чеке продажи с обычным товаром производится экспорт данных о транзакции выдачи наличных с плагинным свойством <plugin-property key="cashout.amount" value="100000"/>.

Блок кода

language	xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="123123" userName="Иванова Ксения Ивановна" operationType="true" operDay="2021-03-23+03:00" shop="234" cash="9" shift="79" number="21" saletime="2021-03-23T16:45:15.925+03:00" begintime="2021-03-23T16:44:49.151+03:00" amount="28.8" discountAmount="0.0" inn="7802781104" qrcode="t=20210323T1645&s=28.80&fn=null&i=541&fp=2974060208&n=1">
        <plugin-property key="UID_PURCHASE" value="f22c29e1-d779-42bd-9f8b-680b429b1099"/>
        <positions>
            <position order="1" departNumber="583" goodsCode="45033" barCode="4607141310331" count="1.0" cost="28.8" nds="10.0" ndsSum="2.62" discountValue="0.0" costWithDiscount="28.8" amount="28.8" dateCommit="2021-03-23T16:44:49.161+03:00" insertType="3">
                <plugin-property key="countryName" value="Россия"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="BankCardPaymentEntity" amount="28.8" description="Оплата по банковской карте">
                <plugin-property key="card.hash" value="320CBC12375D73A50F00B5DB36E977B779A5EC70"/>
                <plugin-property key="cash.transaction.id" value="495105"/>
                <plugin-property key="terminal.number" value="00689949"/>
                <plugin-property key="cash.transaction.date" value="2021-03-23 16:45:13.404"/>
                <plugin-property key="bank.id" value="Сбербанк"/>
                <plugin-property key="ref.number" value="161650712390"/>
                <plugin-property key="card.type" value="Mastercard"/>
                <plugin-property key="auth.code" value="06I200"/>
                <plugin-property key="cashout.amount" value="100000"/>
                <plugin-property key="bank.type" value="SBERBANK"/>
                <plugin-property key="card.number" value="************2380"/>
            </payment>
        </payments>
    </purchase>
</purchases>

Чек выдачи наличных

В чеке выдачи наличных производится стандартный экспорт данных, но со значением тега о выдачи суммы goodsCode="CASHOUT".

Блок кода

language	xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="123123" userName="Иванова Ксения Ивановна" operationType="true" operDay="2021-03-23+03:00" shop="234" cash="9" shift="79" number="22" saletime="2021-03-23T16:45:22.276+03:00" begintime="2021-03-23T16:44:49.151+03:00" amount="1000.0" discountAmount="0.0" inn="7802781104" qrcode="t=20210323T1645&s=1000.00&fn=null&i=542&fp=1932320400&n=6">
        <plugin-property key="UID_PURCHASE" value="f22c29e1-d779-42bd-9f8b-680b429b1099"/>
        <positions>
            <position order="1" departNumber="1" goodsCode="CASHOUT" barCode="999777" count="1.0" cost="1000.0" nds="-1.0" ndsSum="0.0" discountValue="0.0" costWithDiscount="1000.0" amount="1000.0" dateCommit="2021-03-23T16:44:54.247+03:00" insertType="2">
                <plugin-property key="cashOutPosition" value="true"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="CashPaymentEntity" amount="1000.0" description="Оплата наличными"/>
        </payments>
    </purchase>
</purchases>

Z-отчет

Устаревшая версия Jira

server	System JIRA
columns	key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId	bc8d3685-f9c0-329d-9054-b12aabbcb834
key	SRTS-26

...

Блок кода

language	xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<reports count="1">
    <zreport>
        <reportType>ZReport</reportType>
        <shiftNumber>79</shiftNumber>
        <shopNumber>234</shopNumber>
        <docNumber>26</docNumber>
        <cashNumber>9</cashNumber>
        <serialCashNumber>0000000000029350</serialCashNumber>
        <userTabNumber>123123</userTabNumber>
        <userName>Иванова Ксения Ивановна</userName>
        <dateOperDay>2021-03-23+03:00</dateOperDay>
        <dateShiftClose>2021-03-23T17:31:28.475</dateShiftClose>
        <dateShiftOpen>2021-03-23T13:33:44.592</dateShiftOpen>
        <countCashPurchase>0</countCashPurchase>
        <countCashlessPurchase>8</countCashlessPurchase>
        <countPurchase>8</countPurchase>
        <countCashReturn>0</countCashReturn>
        <countCashlessReturn>0</countCashlessReturn>
        <countReturn>0</countReturn>
        <counterIncoming>4</counterIncoming>
        <counterWithdrawal>1</counterWithdrawal>
        <amountByCashPurchase>0.00</amountByCashPurchase>
        <amountByCashlessPurchase>230.40</amountByCashlessPurchase>
        <amountByPurchaseFiscal>230.40</amountByPurchaseFiscal>
        <amountByCashReturn>0.00</amountByCashReturn>
        <amountByCashlessReturn>0.00</amountByCashlessReturn>
        <amountByReturnFiscal>0.00</amountByReturnFiscal>
        <amountCashIn>23.00</amountCashIn>
        <amountCashOut>1500000.00</amountCashOut>
        <amountCashDiscount>0.00</amountCashDiscount>
        <returnDiscountCashPay>0.00</returnDiscountCashPay>
        <incresentTotalStart>155449995</incresentTotalStart>
        <incresentTotalFinish>155473035</incresentTotalFinish>
        <incresentTotalReturnStart>664452</incresentTotalReturnStart>
        <incresentTotalReturnFinish>664452</incresentTotalReturnFinish>
        <factoryCashNumber>0128061140</factoryCashNumber>
        <cashName>Пирит 2Ф</cashName>
        <inn>7802781104</inn>
        <payments>
            <payment typeClass="CashPaymentEntity" amountExpense="11028.80"/>
            <payment typeClass="BankCardPaymentEntity" amountPurchase="230.40"/>
        </payments>
        <reversals>
            <reversal operation="STORNO" amount="0.000" sum="0.00"/>
        </reversals>
        <countExpenseReceipt>8</countExpenseReceipt>
        <countCashExpenseReceipt>8</countCashExpenseReceipt>
        <countCashlessExpenseReceipt>0</countCashlessExpenseReceipt>
        <amountByExpenseReceipt>11028.80</amountByExpenseReceipt>
        <amountByExpenseReceiptFiscal>11028.80</amountByExpenseReceiptFiscal>
        <amountByCashExpenseReceipt>11028.80</amountByCashExpenseReceipt>
        <amountByCashlessExpenseReceipt>0.00</amountByCashlessExpenseReceipt>
        <incresentTotalExpenseStart>18710000</incresentTotalExpenseStart>
        <incresentTotalExpenseFinish>19812880</incresentTotalExpenseFinish>
        <countReturnExpenseReceipt>0</countReturnExpenseReceipt>
        <countCashReturnExpenseReceipt>0</countCashReturnExpenseReceipt>
        <countCashlessReturnExpenseReceipt>0</countCashlessReturnExpenseReceipt>
        <amountByReturnExpenseReceipt>0.00</amountByReturnExpenseReceipt>
        <amountByReturnExpenseReceiptFiscal>0.00</amountByReturnExpenseReceiptFiscal>
        <amountByCashReturnExpenseReceipt>0.00</amountByCashReturnExpenseReceipt>
        <amountByCashlessReturnExpenseReceipt>0.00</amountByCashlessReturnExpenseReceipt>
        <incresentTotalReturnExpenseStart>6560000</incresentTotalReturnExpenseStart>
        <incresentTotalReturnExpenseFinish>6560000</incresentTotalReturnExpenseFinish>
    </zreport>
</reports>

Логика работы

Описание процесса

"Наличные с покупкой", составная операция, состоящая из двух частей: приход и расход.

...

Доплата может быть выполнена любым типом платежа, в том числе и "банковская карта (сбербанк)", но без выдачи наличных.

Процесс работы плагина

Информация
На текущий момент банковский процессинг Сбербанка не поддерживает функцию частичного одобрения транзакции (только оплата), поэтому текущей реализации эта функциональность не реализована.

...

Касса вызывает плагин оплат (для Сбербанка) и передает ему чек.
Плагин оплат обращается к эквайринговому терминалу (sb_pilot) и передает ему запрос на выдачу наличных с покупкой:
- если транзакция оплаты одобрена банком:
  1. Плагин оплат передает кассе информацию об одобрении банком транзакции оплаты.
  2. Касса создает дополнительный чек расхода и переносит в него услугу "Наличные с покупкой" из чека прихода (продажа).
  3. Транзакция оплаты привязывается к чеку прихода (продажи). В транзакции указана полная сумма списания денежных средств со счета банковской карты покупателя.
- если транзакция оплаты не одобрена банком полностью:
  1. Плагин оплат сообщает кассиру об ошибке/отказе в проведении транзакции оплаты.
  2. При ошибке связи кассир может повторить попытку оплаты. При ошибке недостаточности средств на счете - удалить услугу "Наличные с покупкой", уменьшить сумму выдачи наличных, уменьшить сумму приобретаемых товаров (удалить позиции, изменить количества). Касса возвращается в режим добавления товаров.
Фискализация после совершения оплаты с выдачей наличных, касса автоматически создает чек расхода и переносит в него услугу "Наличные с покупкой" из чека прихода (продажи) с сохранением всех свойств и атрибутов:
1. Касса фискализует чек прихода (продажи).
2. Касса фискализует чек расхода (выдача наличных)
3. Покупателю передается два фискальных чека и один банковский слип. В слипе содержится сумма совершенной покупки, сумма выданной наличности, общая сумма (слип формируется Сбербанк sb_pilot).

Ограничения

Услуга, "Наличные с покупкой" в чеке может быть только одна (одна позиция, количество - 1шт).
Выдача наличных может быть осуществлена только совместно с покупкой.
Редактирование количества услуги "выдача наличных" запрещено. Количество всегда равно - 1.
Выдача наличных возможна только при одновременной оплате той же оплате банковской картой суммы, минимальный размер которой - 0,01р. (константа. величина не настраиваемая).
При оплате чека с услугой "Наличные с покупкой", первой должна быть применена карта, с которой будет осуществляться выдача наличных. Доплаты, при их наличии, могут быть выполнены любым типом оплаты и любыми картами.

Возвраты

Выполняется в двух вариантах:

Возврат по чеку (полный или частичный).
Произвольный возврат.

Ограничения при возврате наличных

Возврат наличных только по чеку (произвольный недопустим)
должен открываться денежный ящик для приема возвращаемых покупателем наличных
активируется банковский платежный терминал (Сбербанк) для применения банковской карты покупателем
Возврат наличных может быть выполнен только:
- на ту карту, с которой наличные выдавались.
- в той же торговой точке, в которой выдавались наличные
- в той же торговой точке и в том же операционном дне, в которых выдавались наличные
При возврате оформляются возвратные фискальные документы на оба чека (продажа и наличные) в полном объеме. Чек продажи необходимо формировать вновь.

Возврат чека расхода (выдача наличных)

Возврат производится только с помощью команд sb_pilot.

...

В текущей банковской смене есть запись об оплате по предьявленной карте/устройству.
Сумма равна или меньше операции исходной оплаты.
Если выполняются оба условия, то терминал автоматически произведёт операцию «Отмена» (даже если была запущена функция возврата).

Аннулирование чека

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

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

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

Пример работы

Клавиатурная касса

1. Кассир добавляет товар-услугу вводом штрих-кода.

...

14. В случае успешного ответа, на пин-паде появляется положительный статус.

15. Печатаются чековые документы:

Чек 1 - фискальный чек с товаром-услугой выдачи наличных.
Чек 2 - фискальный чек в обычной товарной позицией.
Банковские слипы.

...

17. Кассир закрывает денежный ящик и продолжает работу.

SetTouch

1. Кассир добавляет обычный товар в чек.

...

13. В случае успешного ответа, на пин-паде появляется положительный статус.

11. Печатаются чековые документы:

Чек 1 - фискальный чек с товаром-услугой выдачи наличных.
Чек 2 - фискальный чек в обычной товарной позицией.
Банковские слипы.

...

13. Кассир закрывает денежный ящик и продолжает работу.

Примеры чеков

Вид печатных документов

Якорь

	receipt_example
	receipt_example

Чек расхода - выдача наличных.
Чек продажи - продажа обычноготовара.
Банковский слип.

Чеки в ОФД

<Письмо> ФНС России от 13.11.2018 N ЕД-4-20/22064 "О направлении методических указаний"

...

Признаки расчета записываются во второй чек продажи обычного товара.

Видеодемонстрация

Клавиатурная касса

Коннектор виджета

width	800
url	https://www.youtube.com/watch?v=l5oR3dpU9QI
height	600

SetTouch

Коннектор виджета

width	800
url	https://www.youtube.com/watch?v=OVCxAh7AQ44
height	600

Дополнительная информация

Пример проведения операции возврата с помощью sb_pilot

Якорь

	sb_pilot_return
	sb_pilot_return

...

Сравнение версий

Старая версия 22

Новая версия 23

Ключ

Описание

Настройка

Установка файла плагина (до версии 10.2.97.0)

Добавление процессинга на сервере

Особенности настройки добавления товара выдачи наличных на кассе SetTouch

Операционный день

Чек продажи с авторизацией банковской карты

Чек выдачи наличных

Экспорт данных в ERP

Чек продажи с авторизацией банковской карты

Чек выдачи наличных

Z-отчет

Логика работы

Описание процесса

Процесс работы плагина

Ограничения

Возвраты

Ограничения при возврате наличных

Возврат чека расхода (выдача наличных)

Аннулирование чека

Пример работы

Клавиатурная касса

SetTouch

Примеры чеков

Вид печатных документов

Чеки в ОФД

Видеодемонстрация

Клавиатурная касса

SetTouch

Дополнительная информация

Пример проведения операции возврата с помощью sb_pilot

Сравнение страниц

Сравнение версий

Старая версия 22

Новая версия 23

Ключ

Описание

Настройка

Установка файла плагина (до версии 10.2.97.0)

Добавление процессинга на сервере

Особенности настройки добавления товара выдачи наличных на кассе SetTouch

Операционный день

Чек продажи с авторизацией банковской карты

Чек выдачи наличных

Экспорт данных в ERP

Чек продажи с авторизацией банковской карты

Чек выдачи наличных

Z-отчет

Логика работы

Описание процесса

Процесс работы плагина

Ограничения

Возвраты

Ограничения при возврате наличных

Возврат чека расхода (выдача наличных)

Аннулирование чека

Пример работы

Клавиатурная касса

SetTouch

Примеры чеков

Вид печатных документов

Чеки в ОФД

Видеодемонстрация

Клавиатурная касса

SetTouch

Дополнительная информация

Пример проведения операции возврата с помощью sb_pilot