Публичное пространство

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.

Порядок применения провайдеров лояльности:

  1. Скидки SetRetail10.

  2. Скидки Set API.

  3. Округление.

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

Скидка по программе лояльности Orange Elephant будет отражена в чеке на вкладке ТОВАРНЫЕ ПОЗИЦИИ.

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

  1. В банковском ПО настраивается прерывание оплаты для всех банковских карт.

  2. В ПО SetRetail10 включается признак “Рассчитывать скидки во время оплаты“.

  3. В момент оплаты на кассе от банковского терминала приходит специальный код ответа (“прерывание оплаты”) и хэш номера банковской карты.

  4. По хэшу плагин проверяет в процессинге, является ли данная карта участником социальной программы Orange Elephant:

    • карта найдена в процессинге

    • карта принадлежит физическому лицу

  5. Если карта не подходит под условия программы, продолжается процесс оплаты.

  6. Если карта удовлетворяет условиям программы, отправляется запрос в процессинг на расчет скидок.

  7. Рассчитанные скидки применяются к чеку с учетом ограничений.

  8. После проведения оплаты оплаченный документ отправляется в процессинг.

Ограничения

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

  2. Если в чек уже добавлена любая оплата, скидка к чеку не применяется.

  3. Скидки применяются в размере, возможном до значения минимальной розничной цены (МРЦ). МРЦ загружается в SetRetail10 ритейлером, исходя из требований законодательства, а также собственной бизнес-стратегии.

  4. Скидки применяются только к товарам, на которые настройками, заданными ритейлером, разрешено применение скидок.

  5. Применение скидок производится в соответствии с 54-ФЗ.

  6. Акционная механика процессинга должна всегда суммироваться с другими акциями. Механики, применяющиеся до и во время оплаты, не могут быть конкурирующими.

  7. Технические ограничения ПО Сбербанка. Если выполнялась оплата по бесконтактной карте, терминал попросит повторно приложить карту в следующих случаях:

    • если выполнялась оплата по бесконтактной карте, и сумма чека превышает CVM лимит карты;

    • если выполнялась оплата по бесконтактной карте, и карта не преднастроена;

    • если повторного применения карты на пин-пад не произведено, операция оплаты не завершается банком.

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

1. Кассир добавляет товары, участвующие в социальной программе, в чек.

2. Кассир выбирает оплату банковской картой Сбербанк.

3. Кассир нажимает ВВОД.

4. Покупатель прикладывает к пин-паду банковскую карту, которая участвует в социальной программе Orange Elephant.

5. Касса отправляет запрос в процессинг для проверки карты и расчета скидок.

6. Процессинг возвращает чек со скидкой для товара. Касса применяет полученную скидку, учитывая товарные ограничения.

На экране кассы отображается сообщение о предоставлении дополнительной скидки.

7. Кассир нажимает ВВОД или ОТМЕНА. Покупатель повторно прикладывает карту к терминалу, если это необходимо.

8. Кассир завершает оплату. Печатается чек.

Интеграция

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

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

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

  • <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-2023, ООО «Кристалл Сервис Интеграция».
Все права защищены..

Политика обработки персональных данных