Публичное пространство
SetRetail10 ◾️ Плагин лояльности Orange Elephant
- SR-4791Получение подробных данных проблемы… СТАТУС
- SR-4792Получение подробных данных проблемы… СТАТУС
- CR-4979Получение подробных данных проблемы… СТАТУС
10.2.99.0
Описание
Orange Elephant - социальная программа, при которой покупателю, клиенту Сбербанка, попадающему под условия программы, предоставляются скидки на определенные товары в ограниченном количестве.
В рамках SetRetail10 - это внешняя система лояльности.
Настройка
Установка файла плагина
Начиная с версии 10.3.2.0 файл плагина включен в состав дистрибутива сервера, а также в патчи обновления сервера и кассы. Отдельная установка не требуется.
Добавление процессинга на сервере
1. На сервере SetRetail/SetCentrum перейдите в раздел Интеграция → Внешние процессинги → кликните .
2. Введите в строке поиска orange → кликните Внешние процессинги лояльности → установите флажок Социальная программа Orange Elephant → кликните .
3. Кликните по процессингу Социальная программа Orange Elephant.
4. Установите настройки на вкладке ОБЩИЕ → кликните .
Настройки | Описание | Пример |
---|---|---|
URL основной * | Основной адрес сервиса в формате http://XXX.XXX.XXX.XXX:порт | http://176.53.180.165:5046 |
URL резервный | Резервный адрес сервиса в формате http://XXX.XXX.XXX.XXX:порт | http://176.53.180.16:5046 |
Идентификатор торговой точки * | Идентификатор торговой точки. Предоставляется сервисом Orange Elephant | DEV-SETRETAIL |
Таймаут соединения (миллисекунды) * | Таймаут соединения с сервисом в миллисекундах | 3000 |
Таймаут ожидания ответа (миллисекунды) * | Таймаут ожидания ответа от сервиса в миллисекундах | 5000 |
Отображать сообщения о предоставлении доп. скидки по социальной карте | Кассиру будет выведено уведомление о предоставлении скидки |
5. Перейдите в Кассовый модуль → Шаблоны касс → откройте на редактирование требуемый шаблон.
6. На вкладке ПРОЦЕСС ТОРГОВЛИ установите флажок
Рассчитывать скидки во время оплаты → кликните .Рекламная акция для работы с плагином Orange Elephant
1. Перейдите в Лояльность → кликните Рекламные акции → кликните .
2. Введите название акции → установите условие Безусловно → установите флажок
Всегда суммировать результат... → кликните ДОБАВИТЬ.3. Установите результат акции Скидка → Внешняя система лояльности → выберите Плагин лояльности Orange Elephant → кликните
.4. Запустите акцию.
Настройка порядка применения провайдеров лояльности
Данные работы выполняются только инженерами CSI
Настраивается согласно /wiki/spaces/SR10DEV/pages/1032880180.
Порядок применения провайдеров лояльности:
Скидки SetRetail10.
Скидки Set API.
Округление.
Операционный день
Скидка по программе лояльности Orange Elephant будет отражена в чеке на вкладке ТОВАРНЫЕ ПОЗИЦИИ.
Логика работы
В банковском ПО настраивается прерывание оплаты для всех банковских карт.
В ПО SetRetail10 включается признак “Рассчитывать скидки во время оплаты“.
В момент оплаты на кассе от банковского терминала приходит специальный код ответа (“прерывание оплаты”) и хэш номера банковской карты.
По хэшу плагин проверяет в процессинге, является ли данная карта участником социальной программы Orange Elephant:
карта найдена в процессинге
карта принадлежит физическому лицу
Если карта не подходит под условия программы, продолжается процесс оплаты.
Если карта удовлетворяет условиям программы, отправляется запрос в процессинг на расчет скидок.
Рассчитанные скидки применяются к чеку с учетом ограничений.
После проведения оплаты оплаченный документ отправляется в процессинг.
Ограничения
Применение банковской скидки к чеку возможно только при добавлении первой оплаты в чеке.
Если в чек уже добавлена любая оплата, скидка к чеку не применяется.
Скидки применяются в размере, возможном до значения минимальной розничной цены (МРЦ). МРЦ загружается в SetRetail10 ритейлером, исходя из требований законодательства, а также собственной бизнес-стратегии.
Скидки применяются только к товарам, на которые настройками, заданными ритейлером, разрешено применение скидок.
Применение скидок производится в соответствии с 54-ФЗ.
Акционная механика процессинга должна всегда суммироваться с другими акциями. Механики, применяющиеся до и во время оплаты, не могут быть конкурирующими.
Технические ограничения ПО Сбербанка. Если выполнялась оплата по бесконтактной карте, терминал попросит повторно приложить карту в следующих случаях:
если выполнялась оплата по бесконтактной карте, и сумма чека превышает CVM лимит карты;
если выполнялась оплата по бесконтактной карте, и карта не преднастроена;
если повторного применения карты на пин-пад не произведено, операция оплаты не завершается банком.
Пример работы
1. Кассир добавляет товары, участвующие в социальной программе, в чек.
2. Кассир выбирает оплату банковской картой Сбербанк.
3. Кассир нажимает ВВОД.
4. Покупатель прикладывает к пин-паду банковскую карту, которая участвует в социальной программе Orange Elephant.
5. Касса отправляет запрос в процессинг для проверки карты и расчета скидок.
6. Процессинг возвращает чек со скидкой для товара. Касса применяет полученную скидку, учитывая товарные ограничения.
На экране кассы отображается сообщение о предоставлении дополнительной скидки.
7. Кассир нажимает ВВОД или ОТМЕНА. Покупатель повторно прикладывает карту к терминалу, если это необходимо.
8. Кассир завершает оплату. Печатается чек.
Интеграция
Экспорт данных в ERP
Экспорт чеков в ERP производится согласно интеграционной документации по выгрузке:
- Экспорт чеков из SetRetail10 в ERP (веб-сервис на стороне ERP)
- Экспорт чеков из SetRetail10 в ERP (веб-сервис на стороне SetRetail10)
Чек продажи при оплате банковской картой
<purchase ...>
<plugin-property key="orange.elephant.transaction" value="
JSON-BODY"/>
- в параметреvalue
содержатся данные для процессинга Orange Elephant по продаже в формате JSON.UID_PURCHASE
- уникальный идентификатор чека.
<payments>
<payment>
loyalty.program.code
- код банковской программы лояльности.card.number.hash
- хэш-код номера банковской карты.
</payment>
</payments>
</purchase>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="21323" userName="Иванова Мария Александровна" operationType="true" cashOperation="INCOME" operDay="2021-07-16+03:00" shop="234" cash="3" shift="48" number="1" saletime="2021-07-16T12:43:16.729+03:00" begintime="2021-07-16T12:42:12.366+03:00" amount="81.00" discountAmount="9.00" inn="7801784589" fiscalDocNum="150;1" status="REGISTERED"> <plugin-property key="orange.elephant.transaction" value="{"StartTime":"16.07.2021 12:42:12.366","TransactionNumber":1,"TransactionId":"0023400003000481626428532366","ItemCount":1,"Items":[{"Index":1,"ProductIndex":"10013","ProductName":"Товар 2","BarCode":"0000000610013","ProductGroupName":"Товар-спонсор","TaxRate":20000,"QuantityUnitName":"шт","PriceUnitName":"шт","Preset":{"Mode":1,"Price":9000,"Quantity":1,"Amount":9000,"TaxInAmount":1500},"Price":{"Mode":1,"Price":8100,"Quantity":1,"Amount":8100,"TaxInAmount":1350,"DiscountRate":0,"DiscountPrice":900,"DiscountAmount":900,"ErrorCode":0,"ErrorDescription":"","QuantityLimit":1}}],"TotalAmount":8100,"TotalDiscountAmount":900,"TotalTax":1350,"CardInfo":{"CardType":1,"CardHashNumber":"BBB5936DB62ABAA7B4CCCD34180A348A81BA61A5"}}"/> <plugin-property key="UID_PURCHASE" value="53f3dc77-1d4e-434d-9572-2a33fbf48496"/> <positions> <position order="1" departNumber="1" goodsCode="10013" barCode="0000000610013" count="1.000" cost="90.00" nds="20.0" ndsSum="13.50" discountValue="9.00" costWithDiscount="81.00" amount="81.00" dateCommit="2021-07-16T12:42:12.395+03:00" insertType="1"> <plugin-property key="countryName" value="Бельгия"/> </position> </positions> <payments> <payment typeClass="BankCardPaymentEntity" amount="81.00" description="Оплата по банковской карте"> <plugin-property key="card.hash"/> <plugin-property key="cash.transaction.id" value="340005"/> <plugin-property key="bank.id" value="Сбербанк"/> <plugin-property key="ref.number" value="222"/> <plugin-property key="loyalty.program.code" value="2"/> <plugin-property key="card.type" value="MasterCard"/> <plugin-property key="auth.code" value="1111111"/> <plugin-property key="bank.type" value="UNKNOWN"/> <plugin-property key="card.number" value="************5432"/> <plugin-property key="terminal.number" value="666"/> <plugin-property key="cash.transaction.date" value="2021-07-16 12:43:13.169"/> <plugin-property key="bank.slip" value="ICAgINCe0JDQniAi0JHQsNC90LogINCX0J7QntCf0JDQoNCaIgogICAgINGD0LsuINCc0LDQutCw0LrQuNC90LAsINC0LjI3CtCi0LXRgNC80LjQvdCw0LsgICAgICAgICAgICAgRW11bGF0b3IKMTYuMDcuMjAyMSAxMjo0MzoxMwogICAgICAgINCe0J/Qm9CQ0KLQkCDQn9Ce0JrQo9Cf0JrQmAo4MS4wMCBSVUIK0JrQvtC0INC+0YLQstC10YLQsCAgICAgICAgICAgICAgIDAwMTEK0JrQvtC0INCw0LLRgtC+0YDQuNC30LDRhtC40LggICAgICAgIDk4NzYxNQrQmtCw0YDRgtCwICAgICAgICAqKioqKioqKioqKjU0MzIKTWFzdGVyQ2FyZCAgICAgICAgICAgICAwMS8xNwoKCl9fX19fX19fX19fX19fX19fX19fX19fX19fX18KICAgICAgICAgICAo0J/QvtC00L/QuNGB0Ywg0LrQu9C40LXQvdGC0LAp"/> <plugin-property key="card.number.hash" value="BBB5936DB62ABAA7B4CCCD34180A348A81BA61A5"/> </payment> </payments> </purchase> </purchases>
Чек продажи при оплате банковской картой юридического лица
- SR-5766Получение подробных данных проблемы… СТАТУС
- CR-4979Получение подробных данных проблемы… СТАТУС
10.3.17.0
Если карта принадлежит юридическому лицу, то к информации в чеке добавляется краткое наименование организации, ИНН, КПП и юридический адрес.
Дополнительно в ОФД передаются следующие реквизиты:
- Краткое наименование организации
- ИНН
- Адрес организации
<purchase ...>
<plugin-property key="orange.elephant.transaction" value="
JSON-BODY"/>
- в параметреvalue
содержатся данные для процессинга Orange Elephant по продаже в формате JSON.UID_PURCHASE
- уникальный идентификатор чека.KPP
- КПП магазина.orange.elephant.owner.info
- информация о владельце карты юридического лица в формате JSON.
<payments>
<payment>
loyalty.program.code
- код банковской программы лояльности.card.number.hash
- хэш-код номера банковской карты.
</payment>
</payments>
</purchase>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="1" userName="Администраторов Администратор Администраторович" operationType="true" cashOperation="INCOME" operDay="2022-11-24+03:00" shop="9170" cash="12" shift="3" number="2" saletime="2022-11-24T13:57:24.236+03:00" begintime="2022-11-24T13:56:53.955+03:00" amount="100.00" discountAmount="0.00" factorynum="0128018259" inn="7802781104" kpp="780201001" qrcode="t=20221124T1357&s=100.00&fn=9999078902014260&i=23&fp=3796702128&n=1" fiscalDocNum="23;2" status="REGISTERED" cashType="POS" fiscalnum="0000000000007501"> <plugin-property key="orange.elephant.transaction" value="{"StartTime":"24.11.2022 13:56:53.955","TransactionNumber":2,"TransactionId":"0917000012000031669287413955","ItemCount":1,"Items":[{"Index":1,"ProductIndex":"10010","ProductName":"tovar 0","BarCode":"10010","ProductGroupName":"Товар-спонсор","TaxRate":20000,"QuantityUnitName":"шт","PriceUnitName":"шт","Preset":{"Mode":1,"Price":10000,"Quantity":1,"Amount":10000,"TaxInAmount":1667},"Price":{"Mode":1,"Price":0,"Quantity":0,"Amount":0,"TaxInAmount":0,"DiscountRate":0,"DiscountPrice":10000,"DiscountAmount":10000,"ErrorCode":100,"ErrorDescription":" - Продажа неизвестного товара \"tovar 0\" запрещена","QuantityLimit":0}}],"TotalAmount":0,"TotalDiscountAmount":10000,"TotalTax":0,"CardInfo":{"CardType":1,"CardHashNumber":"3FBC89EBD040320C43BBEE3440351B52F692318F"}}"/> <plugin-property key="externalSystemId" value="91700121669287437072"/> <plugin-property key="FISCAL_DOC_ID" value="23"/> <plugin-property key="UID_PURCHASE" value="c2512fea-e33b-4e52-ac19-4aced56c9280"/> <plugin-property key="KPP" value="780201001"/> <plugin-property key="orange.elephant.owner.info" value="{"isCompany":1,"shortname":"Общество с ограниченной ответственностью Ромашка","inn":"7715818446","kpp":"770701001","regAddress":"127051, г.Москва, ул. Садовая-Каретная, д.20, стр.2"}"/> <positions> <position order="1" departNumber="1" goodsCode="10010" barCode="10010" count="1.000" cost="100.00" nds="20.0" ndsSum="16.67" discountValue="0.00" costWithDiscount="100.00" amount="100.00" dateCommit="2022-11-24T13:56:54.012+03:00" insertType="1"> <plugin-property key="countryName" value="Бельгия"/> <plugin-property key="salesTax" value="0"/> </position> </positions> <payments> <payment typeClass="BankCardPaymentEntity" amount="100.00" description="Оплата по банковской карте"> <plugin-property key="card.hash"/> <plugin-property key="cash.transaction.id" value="115010"/> <plugin-property key="terminal.number" value="666"/> <plugin-property key="cash.transaction.date" value="2022-11-24 13:57:17.507"/> <plugin-property key="bank.id" value="Сбербанк"/> <plugin-property key="ref.number" value="6056208438126525"/> <plugin-property key="loyalty.program.code" value="2"/> <plugin-property key="card.number.hash" value="3FBC89EBD040320C43BBEE3440351B52F692318F"/> <plugin-property key="card.type" value="MasterCard"/> <plugin-property key="auth.code" value="00669769"/> <plugin-property key="bank.type" value="UNKNOWN"/> <plugin-property key="card.number" value="************5432"/> </payment> </payments> </purchase> </purchases>
© 1994-2024, ООО «Кристалл Сервис Интеграция».
Все права защищены..