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

SetRetail10 ◾️ Плагин лояльности RightWay

Список работ

CR-6484 - Получение подробных данных проблемы… СТАТУС

SR-5232 - Получение подробных данных проблемы… СТАТУС

SR-5234 - Получение подробных данных проблемы… СТАТУС

SR-5237 - Получение подробных данных проблемы… СТАТУС

SR-5238 - Получение подробных данных проблемы… СТАТУС

SR-5242 - Получение подробных данных проблемы… СТАТУС

SR-5243 - Получение подробных данных проблемы… СТАТУС

SR-5246 - Получение подробных данных проблемы… СТАТУС

SR-5245 - Получение подробных данных проблемы… СТАТУС

SR-5247 - Получение подробных данных проблемы… СТАТУС

SR-5253 - Получение подробных данных проблемы… СТАТУС

SR-5250 - Получение подробных данных проблемы… СТАТУС

SR-5503 - Получение подробных данных проблемы… СТАТУС

10.3.12.0

Описание

Процессинг представляет собой веб-API, предназначенное для проведения основных операций с бонусными картами при совершении покупок. Процессинг предназначен для касс и интернет-магазинов. С его помощью они могут:
  • Получать информацию о состоянии бонусной карты (количество бонусов, статус карты и т.п.)
  • Делать предварительный расчёт покупки с использованием бонусной карты с получением информации о количестве бонусов, которые могут быть списаны или начислены
  • Производить покупку со списанием и/или начислением бонусов на карту
  • Совершать возвраты по покупке с одновременным возвратом или начислением ранее начисленных или списанных бонусов
  • Совершать отмену покупки с полным восстановлением бонусного счёта
  • Замораживать и размораживать бонусы
При расчётах процессинг учитывает все действующие маркетинговые акции, ограничения, скидки и другие обстоятельства, влияющие на начисление или списание бонусов.

В рамках SetRetail10 это плагин интеграции с процессингом RightWay.

Настройка

Настройка плагина на сервере

1. На сервере SetRetail/SetCentrum перейдите в раздел Интеграция → Внешние процессинги → кликните .

2. Введите в строке поиска right → кликните Внешние процессинги лояльности → введите в правую секцию поиска right  установите флажок  Плагин RightWay → кликните .

3. Кликните по процессингу Плагин RightWay.

Список настроек

Произведите настройку процессинга на вкладках → кликните .

Вкладка "ОБЩИЕ"

Настраивается соединение с процессингом.

Название настройкиОписаниеПример значения
URL

Адрес к продуктивному контуру процессинга RightWay.

Указывается в полном формате с протоколом https.

https://rightway-processing.omnichannel.ru/
Ключ аутентификации запросовКлюч для доступа к процессингу.WP8uCYub8pGclePa
Бренд – зарегистрированный в процессинге бренд, выданный ретейлеруЗарегистрированный в процессинге бренд, выданный ретейлеруTESTBRAND
Номер версии процессингаНомер версии процессинга3.1
Тайм-аут соединения, секТаймаут соединения с процессингом в секундах3
Тайм-аут ожидания ответа, секТаймаут ожидания ответа от процессинга в секундах5
 Не начислять бонусы при совершении покупки
Устанавливается запрет на начисление бонусных баллов при совершении покупки
Таймаут ожидания ввода кода подтверждения, сек *Время, которое требуется на ожидание ввода СМС-кода подтверждения операции60
 Автоматически подтверждать номер телефона при регистрации нового покупателя
При выдаче карты лояльности покупателю не запрашивается СМС-подтверждение номера телефона 

Вкладка "ЛОЯЛЬНОСТЬ"

Название настройкиОписание
 Печатать информационный слип лояльности
Устанавливается печать информации о бонусных баллах

 Печатать слип лояльности в составе чека

По умолчанию информация печатается в виде отдельного слипа. При установке флажка слип лояльности печатается внутри чека
 Печатать в чеке информацию об ожидаемых бонусах
Печатается информация об ожидаемых к начислению бонусах, а также дата, когда бонусы будут доступны
 Печатать в чеке информацию об экспресс-бонусах
Печатается информация об экспресс-бонусах, а также о дате сгорания бонусов

 Печатать в чеке информацию о статусе клиента

Печатается информация о статусе, процентах начисления, скидки и списания, а также дополнительные привилегии

Вкладка "КАРТЫ"

Название настройкиОписаниеПример значения
Префиксы и длины карт (перечень комбинаций карт лояльности (через точку с запятой): префикс - длина номера карты лояльности (например, “123-13;125-11”) *

Настраиваются длины и префиксы категорий карт, которые будут запрашиваться с кассы из процессинга RightWay.

Заведение категорий карт в SetRetail10 не требуется.

222-13

Префикс (первые 3 цифры) 587, длина номера карты 13 символов

Префиксы и длины промокодов (перечень комбинаций промокодов (через точку с запятой): префикс - длина промокода (например, “ABC-13;999-11”)

Настраиваются префиксы промокодов, которые будут запрашиваться с кассы из процессинга RightWay.

999-11

Префикс 999, длина промокода 11 символов

 При отображении информации по карте, брать карту из текущего чека

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


Рекламная акция для работы с бонусами RightWay

1. Перейдите в Лояльность → кликните Рекламные акции → кликните .

2. Введите название рекламной акции → установите срок действия  акции → установите зону охвата → установите условие Безусловно → установите результат Скидка → Внешняя система лояльности → выберите Лояльность RightWay → кликните .

3. Запустите рекламную акцию.

Настройки шаблонов касс

Перейдите в Кассовый модуль  Шаблоны касс → откройте на редактирование требуемый шаблон.

Для любого типа кассы (Клавиатурная/SetTouch), если требуется сообщать кассиру о доступной сумме списываемых бонусов, тогда установите флажок Информирование кассира о возможности списать бонусы.

3. Перейдите на вкладку НАСТРОЙКА МЕНЮ → кликните .

Добавьте действие Списание бонусов.

Для кассы SetTouch кнопка СПИСАТЬ БОНУСЫ появится, если связь плагина с внешней системой есть и доступно списание баллов. Отдельных настроек в шаблоне кассы SetTouch производить не требуется.

Для просмотра информации по карте добавьте функцию меню:

Для кассы SetTouch кнопка Инфо по карте есть по умолчанию.

Для возможности добавления карты по номеру телефона добавьте соответствующий пункт меню.

Для выполнения таких операций, как выдача или замена карты добавьте пункт меню Продажа/замена карты.

5. Кликните .

Настройка привилегий кассира

1. Если кассиру будет предоставлено право редактирования суммы списания бонусов, тогда перейдите в Персонал → Роли кассиров → кликните .

2. Добавьте к кассовой роли привилегию Редактирование суммы списания бонусов.

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

Взаимодействие преференций процессинга RightWay и Set10

Чтобы процессинг не предоставлял свои скидки в дополнение к скидкам Set10 необходимо настроить следующий порядок применения провайдеров лояльности (инструкция по настройке API Set10 ◾️ Настройка порядка применения провайдеров лояльности ):

  1. Конкурирующие акции Set10
  2. Суммирующиеся акции Set10
  3. Set API
  4. Округление

Данные о продажах

Чек

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

Данные о продажах в чеке из раздела операционного дня будут отражены на вкладке ТОВАРНЫЕ ПОЗИЦИИ.

Также начисление и списание бонусов через процессинг RightWay будут отражены на вкладке КАРТЫ.

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

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

1. Кассир добавляет на кассе карту лояльности RightWay.

2. Карта успешно найдена в процессинге, отобразился значок и бонусный баланс.

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

4. Кассир нажимает кнопку РАСЧЕТ → в случае установленного флажка Информирование кассира о возможности списать бонусы появляется сообщение → кассир выбирает Подтвердить и нажимает клавишу ВВОД.

Также кассир может перейти в меню кассы и выбрать пункт Списание бонусов.

5. Кассир редактирует сумму бонусов, если разрешено → нажимает клавишу ВВОД для подтверждения списания.

Списывается сумма баллов.

6. Кассир вводит оставшуюся сумму и нажимает клавишу ВВОД для подтверждения.

Печатается чек.

Экспорт в ERP

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

Оплата бонусными баллами дисконтной картой

  • <purchase ...> 
    • <plugin-property key="PURCHASE_DATA_KEY" value="JSON-BODY"> - в параметре value содержатся данные для процессинга RightWay по операции с бонусной картой в формате JSON.
      • UID_PURCHASE - уникальный идентификатор чека. 
    • card type="EXTERNAL" number="2222201400009" guid="2222201400009" addedBy="HAND" - тип бонусной карты с номером и идентификатором GUID, а также способом добавления карты в чек.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="99999" userName="Иванова Мария Васильевна" operationType="true" cashOperation="INCOME" operDay="2022-06-28+03:00" shop="1" cash="61" shift="4" number="2" saletime="2022-06-28T14:01:05.273+03:00" begintime="2022-06-28T13:47:04.684+03:00" amount="59.95" discountAmount="39.66" inn="7802781104" qrcode="t=20220628T1401&s=59.95&fn=4033788975150565&i=13&fp=0&n=1" fiscalDocNum="13;2" status="REGISTERED">
        <plugin-property key="FISCAL_DOC_ID" value="13"/>
        <plugin-property key="RIGHT_WAY_PURCHASE_DATA_KEY" value="{"brand":"TESTBRANDRW","shopNumber":1,"cashNumber":61,"cardNumber":"2222201400009","promocodeNumber":null,"cardIdentityType":"CARD_NUMBER","cardOperationType":"СПИСАНИЕ_И_НАЧИСЛЕНИЕ","discountBonuses":33.00,"orderNumber":"TESTBRANDRW_1_4_61_2_2222201400009_20220628","saleOrderNum":null,"saleDate":null,"date":1656413224684,"lineItems":[{"number":1,"barcode":"4600001000007","marking":"00001","name":"Кефир малиновый сладкий (Россия)","quantity":7.000,"rightWayBonusSum":0,"rightWayDiscount":0,"sumWithoutBonusDiscount":99.61,"minPrice":0.00,"appliedDiscountAction":null,"writeOffAllowed":true,"accrueBonusAllowed":true,"gift":false}]}"/>
        <plugin-property key="UID_PURCHASE" value="474951ed-43de-40b8-b7c3-ebbc2f4bebb2"/>
        <positions>
            <position order="2" departNumber="1" goodsCode="00001" barCode="4600001000007" count="3.000" cost="14.23" nds="20.0" ndsSum="4.29" discountValue="16.98" costWithDiscount="8.57" amount="25.71" dateCommit="2022-06-28T14:00:48.120+03:00" insertType="1">
                <plugin-property key="SET10_ACTION_KEY" value="111806"/>
                <plugin-property key="countryName" value="Бельгия"/>
                <plugin-property key="salesTax" value="0"/>
            </position>
            <position order="1" departNumber="1" goodsCode="00001" barCode="4600001000007" count="4.000" cost="14.23" nds="20.0" ndsSum="5.71" discountValue="22.68" costWithDiscount="8.56" amount="34.24" dateCommit="2022-06-28T14:00:48.120+03:00" insertType="1">
                <plugin-property key="SET10_ACTION_KEY" value="111806"/>
                <plugin-property key="countryName" value="Бельгия"/>
                <plugin-property key="salesTax" value="0"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="CashChangePaymentEntity" amount="0.05" description=""/>
            <payment typeClass="CashPaymentEntity" amount="60.00" description="Оплата наличными"/>
        </payments>
        <discountCards>
            <discountCard>2222201400009</discountCard>
        </discountCards>
        <card type="EXTERNAL" number="2222201400009" guid="2222201400009" addedBy="HAND"/>
    </purchase>
</purchases>


© 1994-2023, ООО «Кристалл Сервис Интеграция».
Все права защищены..

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