Versions Compared

Key

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

...

Status
colourBlue
title10.2.96.0

Table of Contents

Описание

Начиная с версии 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"/>.

Code Block
languagexml
<?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".

Code Block
languagexml
<?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
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySRTS-26

...

Code Block
languagexml
<?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>

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

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

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

...

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

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


Info

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

...

  1. Касса вызывает плагин оплат (для Сбербанка) и передает ему чек.

  2. Плагин оплат обращается к эквайринговому терминалу (sb_pilot) и передает ему запрос на выдачу наличных с покупкой:

    • если транзакция оплаты одобрена банком:

      1. Плагин оплат передает кассе информацию об одобрении банком транзакции оплаты.

      2. Касса создает дополнительный чек расхода и переносит в него услугу "Наличные с покупкой" из чека прихода (продажа).

      3. Транзакция оплаты привязывается к чеку прихода (продажи). В транзакции указана полная сумма списания денежных средств со счета банковской карты покупателя.

    • если транзакция оплаты не одобрена банком полностью:

      1. Плагин оплат сообщает кассиру об ошибке/отказе в проведении транзакции оплаты.

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

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

Ограничения

  • Услуга, "Наличные с покупкой" в чеке может быть только одна (одна позиция, количество - 1шт).

  • Выдача наличных может быть осуществлена только совместно с покупкой.

  • Редактирование количества услуги "выдача наличных" запрещено. Количество всегда равно - 1.

  • Выдача наличных возможна только при одновременной оплате той же оплате банковской картой суммы, минимальный размер которой - 0,01р. (константа. величина не настраиваемая).

  • При оплате чека с услугой "Наличные с покупкой", первой должна быть применена карта, с которой будет осуществляться выдача наличных. Доплаты, при их наличии, могут быть выполнены любым типом оплаты и любыми картами.

Возвраты

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

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

  • Произвольный возврат.

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

  • Возврат наличных только по чеку (произвольный недопустим)

  • должен открываться денежный ящик для приема возвращаемых покупателем наличных

  • активируется банковский платежный терминал (Сбербанк) для применения банковской карты покупателем

  • Возврат наличных может быть выполнен только:

    • на ту карту, с которой наличные выдавались.

    • в той же торговой точке, в которой выдавались наличные

    • в той же торговой точке и в том же операционном дне, в которых выдавались наличные

  • При возврате оформляются возвратные фискальные документы на оба чека (продажа и наличные) в полном объеме. Чек продажи необходимо формировать вновь.

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

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

...

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

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

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

...

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

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

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

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

...

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

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

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

...

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

SetTouch

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

...

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

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

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

...

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

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

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

Anchor
receipt_example
receipt_example

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

Чеки в ОФД

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

...

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

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

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

Widget Connector
width800
urlhttps://www.youtube.com/watch?v=l5oR3dpU9QI
height600

SetTouch

Widget Connector
width800
urlhttps://www.youtube.com/watch?v=OVCxAh7AQ44
height600

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

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

Anchor
sb_pilot_return
sb_pilot_return

...