Подарочные карты ЦФТ

Оглавление

  1. 1 Настройка процессинга
    1. 1.1 На сервере
    2. 1.2 На кассе
    3. 1.3 Дополнительная информация
  2. 2 Спасибо от Сбербанка
  3. 3 Устранение возможных проблем:
  4. 4 Использование
    1. 4.1 Продажа на кассе Подарочных карт ЦФТ с фиксированным номиналом
    2. 4.2 Возврата товара
    3. 4.3 Удаление товара "Подарочная карта ЦФТ" из чека
    4. 4.4 Запрет отложенного чека с товаром Подарочная карта ЦФТ
    5. 4.5 Информирование кассира об удалении подарочных карт ЦФТ из повтора чека мягкого чека
    6. 4.6 Аннулирование чека с добавленным товаром Подарочная карта ЦФТ
    7. 4.7 Аннулирование чека с добавленной оплатой по Подарочная карта ЦФТ
    8. 4.8 Оплата Подарочными картами ЦФТ на кассе
    9. 4.9 Возврат товаров, оплаченных подарочной картой ЦФТ
    10. 4.10 Запрос информации по Подарочной карте ЦФТ
  5. 5 Выгрузка в чеке информации об оплате подарочной картой ЦФТ в ERP
  6. 6 Отображение в операционном дне
    1. 6.1 Информация о покупке подарочной карты ЦФТ
    2. 6.2 Информация об оплате подарочной картой ЦФТ



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

На сервере

1."Управление продажами" - "Внешние системы" - "Внешние процессинги" -> Добавить оператора: Подарочные карты - Подарочные карты ЦФТ.
2. После добавления изменить настройки процессинга, обязательно указать префиксы штриховых кодов и префиксы 2-ой дорожки магнитной полосы подарочных карт ЦФТ. 
3. На кассе полученные от сервера настройки процессингов сохраняются в файле \crystal-cash\config\register-external-systems.xml
4. В "Шаблоны касс" - "Процесс торговли": разрешить тип товара "Подарочная карта ЦФТ" и тип оплаты "Подарочная карта ЦФТ".
5. Тип товара и тип оплаты имеют свои настройки, которые можно изменить во вкладке "Общие настройки" - "Типы товаров и оплат".
6. Импортировать товары с типом "Подарочная карта ЦФТ" (пример XML файла: catalog-goods-giftcard-cft.xml)


На кассе

1. "Конфигуратор" - "Внешние процессинги" - включить процессинг "Подарочные карты ЦФТ"
2. скопировать сертификаты в папку на кассе \crystal-cash\modules\cftBridge\cert (файлы для тестового процессинга: CA.pemprv_key.pempassword.txt)
настроить необходимые параметры (connectionString, terminal, location, partnerId) для соединения с процессингом в файле \crystal-cash\config\modules\cftBridge-config.xml в секции CFTGiftCards пример файла cftBridge-config.xml:
<?xml version="1.0" encoding="UTF-8"?>
<moduleConfig xsi:schemaLocation="http://crystals.ru/cash/settings ../../module-config.xsd" description="Лояльность ЦФТ" settingsGroup="service" xmlns="http://crystals.ru/cash/settings" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <property key="sberbankBonuses">
        <property key="enabled" value="true"/>
        <property key="partnerId" value="248598"/>
        <property key="location" value="pc1"/>
        <property key="terminal" value="pc13"/>
        <property key="connectionString" value="https://194.85.126.117:10443/axis.v3/services/CFTLoyaltyPCPoints_SoapPort_term_2.7.6"/>
        <property key="certFilePath" value="/cert/CA.pem"/>
        <property key="keyFilePath" value="/cert/prv_key.pem"/>
        <property key="keyPassword" value="123456"/>
        <property key="enableBkgroundFlush" value="true"/>
        <property key="backgndFlushPeriod" value="300"/>
        <property key="flushTimeout" value="100"/>
        <property key="сonnectTimeout" value="30"/>
        <property key="sendRecvTimeout" value="30"/>
    </property>
    <property key="CFTGiftCards">
        <property key="enabled" value="true"/>
        <property key="partnerId" value="248598"/>
        <property key="location" value="setretail10"/>
        <property key="terminal" value="term1"/>
        <property key="connectionString" value="https://194.85.126.117:10443/axis.v3/services/CFTLoyaltyPCPoints_SoapPort_term_2.7.6"/>
        <property key="certFilePath" value="/cert/CA.pem"/>
        <property key="keyFilePath" value="/cert/prv_key.pem"/>
        <property key="keyPassword" value="123456"/>
        <property key="enableBkgroundFlush" value="true"/>
        <property key="backgndFlushPeriod" value="300"/>
        <property key="flushTimeout" value="100"/>
        <property key="сonnectTimeout" value="30"/>
        <property key="sendRecvTimeout" value="30"/>
    </property>
</moduleConfig>

Пути к файлам сертификатов также указываются в этом файле.

Дополнительная информация

1. Префиксы задаются независимо для штриховых кодов и магнитной полосы, при этом может быть задано несколько префиксов, разделенных запятой, например: "777,789,123".


2. Если префиксы карт не указаны, продавать карты ЦФТ, оплачивать картами ЦФТ нельзя.
3. Пример настройки параметров на кассе в файле \crystal-cash\config\modules\cftBridge-config.xml прописано
<property key="partnerId" value="248598"/>
<property key="location" value="setretail10"/>
<property key="terminal" value="term1"/>
<property key="connectionString" value="https://194.85.126.117:10443/axis.v3/services/CFTLoyaltyPCPoints_SoapPort_term_2.7.6"/>
<property key="certFilePath" value="/cert/ca-certs.pem"/>
<property key="keyFilePath" value="/cert/CFT.pem"/>
<property key="keyPassword" value="Ivanov_Iva"/>
Также файлы из папки crystal-cash\modules\cftBridge\cert

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

Возможно использование параллельно бонусной программы "Спасибо от Сбербанка" и "Подарочные карты ЦФТ", для этого важно знать, что: при совпадении значений трех настроек partnerId, location, terminal запросы к ЦФТ будут выполнятся через один коннектор, иначе через разные.
каждый коннектор может иметь свои файлы сертификатов, параметры certFilePat, keyFilePath, keyPassword в файле \crystal-cash\config\modules\cftBridge-config.xml

Устранение возможных проблем:

Если на кассе все правильно настроено, но процессинг всё равно не работает, то возможно не установлены последние обновления для OC Linux кассы.
Логи процессинга можно посмотреть на кассе в папке \var\lib\pcx


Использование

Продажа на кассе Подарочных карт ЦФТ с фиксированным номиналом

1. На кассе должна быть настроена работа с процессингом ЦФТ.
2. Добавьте товар Подарочная карта ЦФТ в чек, касса из данных товара получает номинал данной Подарочной карты и демонстрирует его кассиру, предлагая прокатать карту через карт-ридер.
3. Кассир проводит карту через кардридер, касса проверяет корректность префикса введенной карты.
4. Производится попытка активации карты на сервере процессинга ЦФТ, кассир видит информацию о проведения операции.
5. Если карта не может быть активирована (уже активна, не соответствует номинал, другая ошибка), кассир уведомляется об ошибке. Касса предлагает использовать другую карту или отказаться от покупки карты.
6. После успешной активации на сервере Процессинга товар Подарочная карта добавляется в чек со стоимостью = номиналу карты.
7. Оплачиваю чек любым из доступных типов оплат, кроме бонусов.
Если клиент принимает решение аннулировать чек или удалить покупку карты из чека, или сделать отложенный чек, касса производит отмену операции активации карты
8. Печатается слип.

  • Операция активации карты возможна только в онлайн-режиме
  • Если в момент операции отмены активации карты (аннулирование чека продажи подарочной карты ЦФТ) отсутствует связь с процессингом, операция будет отменена после возобновления связи (cилами PCX утилиты ЦФТ)
  • Запрещена продажа товаров в одном чеке с подарочной картой ЦФТ
  • В одном чеке может быть несколько карт ЦФТ любого номинала, при этом при добавлении каждой ПК ЦФТ касса запросит прокатывание карты через картридер
  • Возврат Подарочных карт через кассу разрешен ( делаются возвраты по операциям оплат)
  • Опциональная возможность запрета расчета скидок для товара подарочная карта ЦФТ
  • при запросе номера карты на кассе запрещены ручной ввод номера карты и сканирование номера карты
  • После активации ПК ЦФТ касса печатает слип (информация для печати слипа берется из ответа ПЦ)
  • Проверка номинала карты производится PCX утилитой ЦФТ
  • данные для слипа формируются ПЦ ЦФТ

Возврата товара

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

Сценарий:
1. При продаже товара подарочная карта ЦФТ статус подарочной карты ЦФТ изменен с неактивной на Активный. 
2. Вызываем функцию возврата и выбираем возврат по чеку. 
3. Регистрируем чек возврата.
4. Статус карты меняется с активной на неактивный.
5. Печатается слип.

При аннулировании возврата чека с картой - карта деактивируется - это ограничения процессинга ЦФТ.

Удаление товара "Подарочная карта ЦФТ" из чека

1. Кассир добавляет (активирует) несколько ПК ЦФТ в чек.
2. Старший кассир под своей учетной записью удаляет позицию ПК ЦФТ из чека.
3. В меню администратора выбирает редактирование чека и удаляет одну из позиций ПК ЦФТ.
4. На экране продажи с помощью стрелок на клавиатуре выбирает товарную позицию ПК ЦФТ для удаления.
5. Нажимает кнопку "забой" для удаления ПК ЦФТ и подтверждает удаление в диалоговом окне.
6. Выполняем оплату.
7. Проверяем, что в чеке отсутствует удаленная подарочная карта.

Запрет отложенного чека с товаром Подарочная карта ЦФТ

1. Кассир добавляет в чек товар ПК ЦФТ с фиксированным номиналом.
2. Кассир прокатывает подарочную карту ЦФТ для её активации.
3. Карта активируется в ПЦ ЦФТ.
4. Кассир выбирает функцию меню "отложить чек".
5. Чек НЕ откладывается. На кассе сообщение кассиру "В чеке присутствуют товары запрещенные для функции откладывания чека".
6. Кассир продолжает работу с чеком.


Информирование кассира об удалении подарочных карт ЦФТ из повтора чека мягкого чека

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

При повторе чека, поднятия из мягкого чека, ПК ЦФТ автоматически будут удалены. При этом кассир может ошибочно думать, что все позиции из чека-оригинала, включая ПК, были перенесены в чек повтора, что может привести к передаче покупателю неоплаченных им ПК. Необходимо, чтобы при повторе чека содержащего ПК, на экран выводилось уведомление, что содержавшиеся в чеке-оригинале ПК были удалены из чека-повтора.
1. На кассе добавляем в чек товары и несколько подарочных карт ЦФТ.
2. Добавляем оплату и регистрируем чек.
3. Вызываем функцию "Повтор чека" и вводим № чека.
4. Проверяем, что касса выдала список подарочных карт ЦФТ, содержавшихся в чеке-оригинале и уведомление: "Следующие товары запрещены в повторе чека и были удалены".
5. Подтверждаем удаление подарочных карт ЦФТ из чека-повтора.
6. Проверяем, что в сформировавшимся чеке отсутствуют подарочные карты ЦФТ, которые были в оригинальном чеке продажи.

Аннулирование чека с добавленным товаром Подарочная карта ЦФТ

Функциональность позволяет возвращать средства покупателю при аннулировании чека с активированной подарочной картой ЦФТ в качестве товара для того, чтобы исключить потери денежных средств покупателя при проблемах с ПЦ ЦФТ

1. Кассир производит операцию аннулирования чека
2. Если в чеке выполнялась операция активации ПК ЦФТ , то выполняется ее отмена.
3. Чек аннулируется.
4. Печатается слип.

Описание слипа
1. Данные для слипа формируются PCX библиотекой
Слип по отмене операции
№ Строки Текст Комментарий
1. ОТМЕНА ТРАНЗАКЦИИ
2. КАРТА 7770000140226875651 PAN карты на трек2
3. Терминал term1 Идентификатор Terminal
4. Дата и время отмененной операции:
5. 15.08.2014 15:37:05 DateTime отмененной операции
6. Сумма отмененной операции: 1000.00 р. Сумма операции

2. Если в момент аннулирования чека (операции отмены активации карты) отсутствует связь с процессингом, операция будет отменена после возобновления связи (cилами PCX утилиты ЦФТ)

Аннулирование чека с добавленной оплатой по Подарочная карта ЦФТ

Функциональность позволяет кассиру хочу возвращать средства на ПК ЦТФ при аннулировании чека для того, чтобы исключить потерю номинала покупателями и исключить вероятность мошенничества.

1. Кассир производит операцию аннулирования чека;
2. Если в чеке выполнялась оплата по подарочной карте ЦФТ или операция возврата средств на ПК ЦФТ, выполняется её отмена.
3. Выполняется отмена оплат, если они проводились;
4. Чек аннулируется.
5. Печатается слип отмены операции по карте ПК ЦФТ

Описание слипа
1. Данные для слипа формируются PCX библиотекой
Слип по отмене операции
№ Строки Текст Комментарий
1. ОТМЕНА ТРАНЗАКЦИИ
2. КАРТА 7770000140226875651 PAN карты на трек2
3. Терминал term1 Идентификатор Terminal
4. Дата и время отмененной операции:
5. 15.08.2014 15:37:05 DateTime отмененной операции
6. Сумма отмененной операции: 1000.00 р. Сумма операции

2. Если в момент аннулирования чека отсутствует связь с процессингом, операция будет отменена после возобновления связи (cилами PCX утилиты ЦФТ)

Оплата Подарочными картами ЦФТ на кассе

Сценарий:
1. На кассе настроена работа с процессингом ЦФТ
2. Добавляю товары в чек, перехожу к оплатам и выбираю в меню тип оплаты Подарочная карта ЦФТ
3. Кассир проводит карту через кардридер, касса проверяет корректность префикса введенной карты
1. Если введена неверная карта, кассир уведомляется об ошибке. Касса предлагает использовать другую карту или отказаться от оплаты картой.
4. Производится запрос информации по карте на сервере процессинга ЦФТ, касса предоставляет информацию об остатке средств на карте и статусе карты
1. Если карта не может быть использована в качестве оплаты (не активна, остаток на счете = 0, другая ошибка), кассир уведомляется о невозможности оплаты этой картой. Касса предлагает использовать другую карту или отказаться от применения карты для оплаты.
5. Кассир вводит сумму к списанию с Подарочной карты, касса производит списание средств с карты на сервере Процессинга
1. В случае отсутствия связи операция не может быть выполнена, касса предлагает повторить попытку списания или отказаться от применения карты для оплаты
6. Оплата по Подарочной карте добавляется в чек. Если оплаты не хватило, чтобы целиком закрыть чек, кассир добавляет оплату любым доступным типом оплат, в том числе другими Подарочными картами
1. Если клиент принимает решение аннулировать чек, касса производит отмену операции списания денег с карты
7. Печатается слип

Дополнительно:
1. Оплатить чек можно несколькими подарочными картами
2. Операция списания денег с карты возможна только в онлайн-режиме
3. Оплата Подарочными картами является фискальной оплатой
4. Возврат оплат Подарочными картами через кассу при возврате по чеку производится на подарочную карту, примененную в чеке оплаты 
5. Данные для слипа формируются ПЦ ЦФТ

Возврат товаров, оплаченных подарочной картой ЦФТ

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

Сценарий:
1. На кассе настроена работа с процессингом ЦФТ
2. Осуществляем продажу по подарочной карте ЦФТ и банковской карте
3. Выбираем полный возврат по чеку
4. Касса должна предлагает вернуть, оплаченную по карте ЦФТ на баланс ПК ЦФТ, примененную в чеке оплаты, а по банковской карте - на банковскую карту
5. Производится возврат
6. Печатается слип

Дополнительно:
1. Возврат по чеку, оплаченному подарочной картой возможен только на ПК ЦФТ
2. Операция списания денег с карты возможна только в онлайн-режиме
3. Реализовать возможность частичного возврата чека, с оплатой по ПК ЦФТ. При частичном возврате сумма возврата на ПК ЦФТ не больше суммы возвращаемых позиций и не больше номинала карты ЦФТ
4. Данные для слипа формируются ПЦ ЦФТ

Запрос информации по Подарочной карте ЦФТ

Сценарий:
1. Кассир вызывает на кассе пункт меню "Инфо по карте ЦФТ"
2. Касса запрашивает "Введите номер карты"
3. Кассир прокатывает через карт ридер карту ЦФТ, по которой необходимо предоставить информацию
4. После получения информации по ПК с сервера процессинга ЦФТ данные о статусе карты, остатке средств на карте и дате окончания срока действия карты демонстрируются на экране кассира.
5. Кассир может дополнительно распечатать на кассовом принтере нефискальный документ с информацией по ПК ЦФТ
6. В документе отражена информация о номере карты, текущем статусе карты, дате активации, дате окончания срока действия, текущем остатке карты
7. Карта в чеке не сохраняется. Возможны повторные запросы с другими номерами карт

Дополнительно:
1. Получить доступ к получению информации по ПК можно только при открытой смене
2. Номер карты возможно ввести только прокатыванием карты через карт-ридер
3. Получить доступ к получению информации по ПК можно даже в процессе работы с чеком продажи или возврата
4. В случае отсутствия связи с процессинговым центром ЦФТ на кассе получение информации по подарочной карте ЦФТ невозможно
5. При выводе информации на экран кассира и на печать в слипе номер карты маскируется

Выгрузка в чеке информации об оплате подарочной картой ЦФТ в ERP

Сценарий:
1. На кассе настроен процессинг ПК ЦФТ, имеется активированная подарочная карта ЦФТ, касса подключена к серверу магазина или Centrum, и настроена файловая выгрузка чеков
2. Осуществляем продажу по подарочной карте
3. Проверяем, что в выгруженном чеке в оплатной позиции есть информация по оплате подарочной картой ЦФТ:
- внешний идентификатор (deactivationTransactionId либо activationTransactionId)
- дата и время транзакции с точностью до секунды (deactivationDateTime либо activationDateTime),
- режим выполнения транзакции (online, true – online; false – offline)
- сумма операции (transactionAmount)
- идентификатор карты в транзакции (clientID)
- тип идентификатора карты в транзакции (clientIDType 2 – track2; 4 – barcode)
- идентификатор терминала (terminal)
- идентификатор точки (location)
- идентификатор партнера (partnerId)

Пример файла выгрузки
<payment typeClass="CFTGiftCardPaymentEntity" amount="67.53" description="Оплата по подарочной карте ЦФТ">
                <plugin-property key="deactivationDateTime"/>
                <plugin-property key="balance" value="78847"/>
                <plugin-property key="transactionAmount" value="6753"/>
                <plugin-property key="activationTransactionId" value="20160722153021994XF42F8993DD8C4116"/>
                <plugin-property key="deactivationTransactionId"/>
                <plugin-property key="terminal" value="term1"/>
                <plugin-property key="clientIDType" value="2"/>
                <plugin-property key="location" value="setretail10"/>
                <plugin-property key="clientID" value="7760006046330193193=21067221190000000"/>
                <plugin-property key="partnerId" value="248598"/>
                <plugin-property key="activationDateTime" value="22.07.2016 15:30:21"/>
                <plugin-property key="online" value="false"/>
            </payment>


Отображение в операционном дне

Информация о покупке подарочной карты ЦФТ

Сценарий:
1. На кассе настроен процессинг ЦФТ, касса подключена к серверу магазина
2. На кассе осуществляем продажу подарочной картой ЦФТ
3. В операционном дне на сервере магазина проверяем, что подарочная карта ЦФТ есть в списке товаров чека:
4. Проверяем, что в закладке "Карты" есть информация об активированной карте, ID транзакции, сумме
5. При наведении должна отображаться полная информация о транзакции:
- Внешний идентификатор (transactionId)
- дата и время транзакции с точностью до секунды (dateTime),
- сумма операции (transactionAmount)
- идентификатор карты в транзакции (clientID)
- тип идентификатора карты в транзакции (clientIDType 2 – track2; 4 – barcode)
- идентификатор терминала (terminal)
- идентификатор точки (location)
- идентификатор партнера (partnerId)

Пример отчета:

Продажа подарочной карты ЦФТ


Продажа подарочной карты ЦФТ - Состав чека:


Информация об оплате подарочной картой ЦФТ

Сценарий:
1. На кассе настроен процессинг ЦФТ, касса подключена к серверу магазина
2. На кассе осуществляем продажу подарочной картой ЦФТ
3. В операционном дне на сервере магазина проверяем, что подарочная карта ЦФТ есть в списке оплат чека:
4. Проверяем, что в закладке "Карты" есть информация об активированной карте (номер карт), ID транзакции, сумме
5. При наведении должна отображаться полная информация о транзакции:
6. Внешний идентификатор (transactionId)
- дата и время транзакции с точностью до секунды (dateTime),
*сумма операции (transactionAmount)
- идентификатор карты в транзакции (clientID)
- тип идентификатора карты в транзакции (clientIDType 2 – track2; 4 – barcode)
- идентификатор терминала (terminal)
- идентификатор точки (location)
- идентификатор партнера (partnerId)

Пример отчета:


ċ
CFT.pem
(5k)
Парень Александр,
24 авг. 2016 г., 7:00
ċ
Ivanov_Ivan_Ivanovich.pfx
(4k)
Парень Александр,
24 авг. 2016 г., 7:00
ċ
ca-certs.pem
(6k)
Парень Александр,
24 авг. 2016 г., 7:00
ċ
catalog-goods-giftcard-cft.xml
(3k)
Тырнов Андрей,
7 нояб. 2013 г., 5:55
ċ
cftBridge-config.xml
(2k)
Тырнов Андрей,
7 нояб. 2013 г., 3:35
ċ
pcx_1_11_2230-linux.7z
(6607k)
Парень Александр,
24 авг. 2016 г., 7:01
Comments