Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Оглавление

Список работ

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keyCR-6484

...

Статус
colourBlue
title10.3.12.0

Описание

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

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

Настройка

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

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

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

Image Modified

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

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

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

Image Modified

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

...

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

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

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

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

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

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

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

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

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

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

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

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

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

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

222-13

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

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

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

999-11

Префикс 999, длина

купона

промокода 11 символов

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

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


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

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

Image Modified

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

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

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

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

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

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

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

Информация

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

Image Modified

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

Информация

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

Image Modified

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

Image Modified

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

Image Modified

5. Кликните Image Modified.

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

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

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

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

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

...

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

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

Чек

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

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

Image Modified

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

Image Modified

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

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

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

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

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

Image Modified

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

Image Modified

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

Image Modified

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

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

Image Modified

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, а также способом добавления карты в чек.
Блок кода
languagexml
<?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>

...