Вводная информация

Интеграция с системой лояльности "Gifty" использует стандартный ретранслятор карт Farcards для взаимодействия с сервисом "Gifty" (www.Rewalon.com)

Посредством Farcards cистема передает данные (содержимое заказа, код скидки) и возвращает скидку с максимальным значением, возможным для данного подарочного кода.

Также система проверяет наличие в заказе как минимум одного блюда/услуги в случае, если этого требует подарочный код

Важно: Система интеграции с сервисом "Gifty" использует расширенный протокол Farcards версии 29

 

Установка системы

Для установки системы необходимо:

  1. Установить на компьютер, где будет развернут Farcards, пакет Microsoft .NET Framework 3.5 SP1 (требуется для работы компонентов, поставляемых компанией "Gifty")
  2. Скопировать готовую сборку Farcards(Gifty) на рабочий компьютер
  3. Отредактировать файл Gifty.config - указать параметры SellerCode и код скидки (DiscountCode)
<?xml version="1.0"?>
<configuration>
  <Gifty.Settings>
    .............
    <setting name="SellerCode">
     <value>0000</value>
    </setting>

    <setting name="DiscountCode">
      <value>98</value>
    </setting>
    ...........
  </Gifty.Settings>
</configuration>
Порядок предоставления параметра SellerCode следующий:
  • Компания "Rewalon" получает список всех точек, затем вводит их у себя в систему
  • Каждая точка получают уникальный код продавца (SellerCode)
  • Cписок точек и их кодов передается компании UCS для последующей конфигурации касс

После успешного запуска Farcards должны соформироваться несколько лог файлов:

WEBcards.log
2014.08.11 15:23:21:593. ProcessID: 8488;10416. Library version: 4.6.0.38
WEBTranslator XXXXXX XXXXXX.log
****** Starting 11.08.2014 15:23:23 ******
14.08.11 15:23:23 T[01] INFO:   [WEBTranslator] Library (ver.6.14.408.10 Release build) loaded at 2014-08-11T15:23:23
14.08.11 15:23:23 T[01] INFO:   [WEBTranslator] Current user: UCS
14.08.11 15:23:23 T[01] INFO:   [WEBTranslator] Use Tiketa service: False
14.08.11 15:23:23 T[01] INFO:   [WEBTranslator] Use Maxima service: False
14.08.11 15:23:23 T[01] INFO:   [WEBTranslator] Use Epay.lt service: False
14.08.11 15:23:23 T[01] INFO:   [WEBTranslator] Use OneGo service: False
14.08.11 15:23:23 T[01] INFO:   [WEBTranslator] Use MokiPay service: False
14.08.11 15:23:23 T[01] INFO:   [WEBTranslator] Use Gifty service: True
14.08.11 15:23:23 T[01] INFO:   [WEBTranslator] ClearTXPeriod: 1h
14.08.11 15:23:23 T[01] INFO:   [DB::BarcodeMap]Jet 4.0 version: 4.00.9756.0
14.08.11 15:23:23 T[01] INFO:   [DB::BarcodeMap]Database loaded: .\WEBTranslator.mdb
14.08.11 15:23:23 T[01] INFO:   [DB::BarcodeMap]Handle base: 0
14.08.11 15:23:23 T[01] INFO:   [Gifty]Simplified:True, endpoint: http://ru.rewalon.com/
14.08.11 15:23:23 T[01] INFO:   [UDPListener]Port listen:0, Port send:0
14.08.11 15:23:23 T[03] INFO:   [UDPListener]Listener started.
14.08.11 15:23:39 T[05] INFO:     [DB::ClearTX]Removed 0 old TXData transactions.
14.08.11 15:23:39 T[05] INFO:     [DB::ClearTX]Removed 0 old TXKind1Data transactions.
14.08.11 15:23:39 T[05] INFO:     [DB::ClearTX]Removed 0 old Barcodes handles.
14.08.11 15:23:39 T[05] INFO:     [DB::ClearTX]Removed 0 old GiftyResponses.
Если в файле WEBTranslator XXXXXX XXXXXX.log есть ошибки, связанные с OLE, это обозначает, что не установлен пакет Microsoft .NET Framework 3.5 SP1 :
2013.03.21 10:38:32:434. ProcessID: 4196;8056.   Init: Creating WEBTranslator...
2013.03.21 10:38:32:437. ProcessID: 4196;8056.    CreateNETObject: 80131700
2013.03.21 10:38:32:440. ProcessID: 4196;8056.   Init[EXCEPTION: OLE error 80131700]
2013.03.21 10:38:32:442. ProcessID: 4196;8056.   Init[EXCEPTION: More information can be found in Windows Event Log]

Настройка R-Keeper v6

Важно: Версия кассы должна быть 6.105.6 или выше. Возможна работа с сервисом "Gifty" на более ранних версиях кассы в упрощенном режиме (передача только кода скидки, без детализации содержимого чека).

Менеджерская RK6 (E_Rest32)

В модуле "Редактор" необходимо добавить скидку для использования с сервисом "Gifty" (Rewalon).

Параметры скидки:

  • Вид скидки - скидка на чек
  • Размер скидки - 100%
  • Тип магнитной карты - 98 или любой другой идентификатор, согласованный с заказчиком и прописанный в Gifty.config

 

Кассовый сервер (Rkserver)

В конфигурационном файле кассового сервера RKEEPER6.INI необходимо прописать параметр ApServer1 (ApServer2, ApServer3 и т.д.) с указанием диапазона карт "Gift":

APserver1=990000000-999999999,GIFTY

- где:

  • 990000000-999999999 - диапазон номер карт "Gifty", определенный для использования для точек, расположенных на территории России (99<семь_цифр>).
  • GIFTY - NetBIOS-имя сервера Farcards.

- либо, вариант с использованием подключения по протоколу TCP/IP: 

APserver1=99000000-99999999,AAA.BBB.CCC.DDD:NNNN

- где:

  • AAA.BBB.CCC.DDD - IP-адрес комьютера, где развернут сервер Farcards
  • NNNN - входящий порт для подключений, определенный в параметрах Farcards

 

Примечание: С версии кассы 6.102.2 для подключение к серверу карт (CARDSERV) и серверу Farcards рекомендуется всегда использовать протокол TCP/IP - это исключает проблемы с "зависанием" связи в случае установки серверов на 64-х битные ОС.

 

Кассовый клиент (Rkclient)

В конфигурационном файле кассового клиента RKEEPER6.INI необходимо прописать следующие параметры.

Возможность ручного ввода номеров карт и ограничение диапазона карт "Gifty" (990000000-999999999):

CanManualDiscInput = ON
ManualDiscInterval=990000000-999999999

Включение механизма контроля ограничения скидок:

PDSMaxDiscControl=ON

Примечание: С кассовой версии 6.105.6 параметр PDSMaxDiscControl по-умолчанию принимает значение ON/

Дополнительные параметры:

PdsXML=ON
ExtendedPDSXML=ON
PdsLog=OFF

 

Варианты использования подарочных кодов

Возможны три варианта использования подарочных кодов:

  1. В заказ добавляется скидка на определённую сумму, которая равна величине суммы подарка.
  2. В заказ добавляется скидка на сумму конкретного блюда, который указан в коде подарка  "Gifty", но величина скидки не превышает суммы самого подарка.
  3. В заказ добавляется скидка на сумму одного блюда из набора блюд которые указаны в коде подарка "Gifty", но величина скидки не превышает суммы самого подарка. Если в заказе будет несколько блюд из указанных в подарке, система подберёт блюдо наибольшей стоимости и применит скидку только к этому блюду.

 

Работа в упрощенном режиме

В упрощенном режиме сервис "Gifty" не обрабатывает данные о содержимом чека, а только передает информацию о размере скидки.

Для включения упрощенного режима необходимо в файле Gifty.config установить параметр Simplified в значение 1:

<?xml version="1.0"?>
<configuration>
  <Gifty.Settings>
    ...
    <setting name="Simplified">
      <value>1</value>
    </setting>
    ...
  </Gifty.Settings>
</configuration>
Примечание: Для отключения передачи расширенной информации по содержимому чека на кассовой станции можно использовать параметр PDSProtocol=23 (доступен с версии 6.104). На версиях кассы ниже 6.104 поддержка протокола 29 не реализована.
 

Приложение

Для тестирования интеграции с сервисом "Gifty" можно использовать следующие номера карт:

Номер карты Сообщение/действие на кассе после применения подарочного кода
990123451 или 123451 Подарочный код уже использован
990123452 или 123452 Срок действия подарочного кода закончился
900123455 или 123455 Подарочный код не существует
900123456 или 123456 Скидка на сумму ХХ для всего заказа
900123450 или 123450 Скидка на сумму ХХ для блюда "Тест ..." с кодом 1234
900123455 или 123454 Скидка на сумму ХХ для одного из блюд с кодом 1234, 4321, 5678

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

  • Параметр SellerCode в конфигурационном файле Gifty.config должен быть равен 0000.
  • Если используется "короткий" вариант номера (без 900 в начале), для параметра APserver (APserver1, APserver1 и т.д.) и ManualDiscInterval должны быть изменены диапазоны карт для поддержки тестовых номеров.