| Устаревшая версия Jira | ||||||||
|---|---|---|---|---|---|---|---|---|
|
...
Установка файла плагина (до версии 10.3.2.0)
| Информация |
|---|
Начиная с версии 10.3.2.0 файл плагина включен в состав дистрибутива сервера, а также в патчи обновления сервера и кассы. |
1. Скачайте и скопируйте файл плагина OrangeElephant-1.0.0.jar на сервер и кассы.
...
/var/lib/jboss/plugins
3. На кассе:
Скопируйте файл плагина на кассу в папку /home/tc/storage/crystal-cash/plugins.
Добавление процессинга на сервере
1. На сервере SetRetail/SetCentrum перейдите в раздел Интеграция → Внешние процессинги → кликните .png?version=1&modificationDate=1624190172315&cacheVersion=1&api=v2&width=28){kind=small}
.
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. Перейдите в Кассовый модуль → Шаблоны касс → откройте на редактирование требуемый шаблон.
...
Рекламная акция для работы с плагином Orange Elephant
1. Перейдите в Лояльность → кликните Рекламные акции → кликните .
2. Введите название акции → установите условие Безусловно → установите флажок Всегда суммировать результат... → кликните ДОБАВИТЬ.
...
Скидки SetRetail10.
Скидки Set API.
Округление.
Операционный день
Скидка по программе лояльности Orange Elephant будет отражена в чеке на вкладке ТОВАРНЫЕ ПОЗИЦИИ.
Логика работы
В банковском ПО настраивается прерывание оплаты для всех банковских карт.
В ПО SetRetail10 включается признак “Рассчитывать скидки во время оплаты“.
В момент оплаты на кассе от банковского терминала приходит специальный код ответа (“прерывание оплаты”) и хэш номера банковской карты.
По хэшу плагин проверяет в процессинге, является ли данная карта участником социальной программы Orange Elephant:
карта найдена в процессинге
карта принадлежит физическому лицу
Если карта не подходит под условия программы, продолжается процесс оплаты.
Если карта удовлетворяет условиям программы, отправляется запрос в процессинг на расчет скидок.
Рассчитанные скидки применяются к чеку с учетом ограничений.
После проведения оплаты оплаченный документ отправляется в процессинг.
...
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>
|
Чек продажи при оплате банковской картой юридического лица
| Устаревшая версия Jira | ||||||||
|---|---|---|---|---|---|---|---|---|
|
...
| Статус | ||||
|---|---|---|---|---|
|
Если карта принадлежит Юридическому юридическому лицу, то к информации в чеке добавляется краткое наименование организации, ИНН, КПП и юридический адрес.
...
<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>
...