Настройка передачи данных по оплатам онлайн

Общая информация

Данная технология предназначена для конфигураций, в которых требуется передача информации по совершенным продажам в online-режиме. Передача данных производится во внешнюю (стороннюю) систему по HTTPS.

Данные передаются в XML-формате, формат данных согласовывается с Заказчиком услуги.

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

Состав дистрибутива

В состав дистрибутива входят следующие модули:

ExportXML_SVC.exe - основной исполняемый модуль
sqlite3.dll - библиотека для работы с локальной СУБД SQLite
RK7XML.dll - интерфейсная библиотека для взаимодействия с кассовым сервером R-Keeper v7 посредством XML-интерфейса
Monlib.dll и RNBOPEN.DLL - интерфейсная и транспортная библиотеки соотв. для для взаимодействия с кассовым сервером R-Keeper v6
Monlib.ini - конфигурационный файл для библиотеки Monlib.dll

Важно: Для использования библиотеки Monlib.dll требуется программный лицензионный ключ Monlib.key - подробности в разделе "Лицензирование"

Расположение дистрибутива на FTP-сервере ftp://ftp.ucs.ru/r-keeper/Tools/ExportXML/

Лицензирование

R-Keeper v7

На момент последней редакции статьи, для использования совместно с R-Keeper v7, модуль не требовал лицензирования, но "время жизни" основного исполняемого файла ExportXML_SVC.exe ограничено датой 18.03.2015 - после указанной даты модуль перестанет функционировать. В будущем планируется внедрение общей системы лицензирования.

Настройка

Основные настройки

Важно: Актуальные параметры для подключения к внешней информационной системе необходимо запрашивать у Заказчика услуги!

Для входа в режим настройки необходимо запустить ExportXML_SVC и нажать кнопку "Настройки":

Основные параметры задаются на закладке "Основное":

Выгрузка чеков
- WSDL - адрес для доступа к внешнему сервису через интерфейс WDSL, например https://dex.pulkovo-airport.com:7047/Airport/WS/Codeunit/CheckInfo
- URL - адрес для доступа к внешнему сервису через интерфейс SOAP, например https://srvr-127.local.newpulkovo.ru:7047/Airport/WS/ReplaceWithAPercentEncodedCompanyName/Codeunit/CheckInfo
- Service - имя сервиса, например CheckInfo - актуальное значение уточнять у Заказчика услуги
- Port - имя порта, например CheckInfo_Port - актуальное значение уточнять у Заказчика услуги
- Логин - имя пользователя для доступа к сервису, предоставляется Заказчиком услуги
- Пароль - пароль для доступа к сервису, предоставляется Заказчиком услуги
Часовой пояс - текущий часовой пояс, требуется для корректной работы с внешним сервисом
Подобный лог - запись подробного лога работы
Сохранять XML - сохранение на жестком диске XML-файлов, отправленных на внешний сервис
Неактуальные данные - параметры управления накопленной информацией в БД:
- Число дней - период в днях, за который необходимо хранить накопленные данные
- Время удаления - время суток, когда происходит проверка и очистка данных

Примечание: Все параметры хранятся в базе данных db.db, которая автоматически создается при первом запуске приложения

Настройка оплат

Для корректного формирования данных необходимо настроить соответствие типов оплат (валют) между R-Keeper и внешней системой:

запустить ExportXML_SVC.exe, войти в настройки и переключиться на закладку R-Keeper
в разделе "Оплаты по чеку" по правому клику мыши вызвать меню и выбрать пункт "Добавить"
заполнить параметры:
- Название валюты RK - наименование валюты, как заведена в редакторе (RK6) или менеджерской (RK7)
- Currency - соответствующее название валюты во внешней системе, возможные значения уточнять у Заказчика услуги
- Method - метод оплаты для валюты, возможные значения уточнять у Заказчика услуги
в разделе "Умолчания для оплат" заполнить значения параметров Currency и Method , которые будут использоваться по умолчанию для валют, для которых не будет найдено соответствие из раздела "Оплаты по чеку" либо если оплата по чеку отсутствовала
для сохранения параметров нажать кнопку "OК" и перезапустить ExportXML_SVC

r_keeper_7

Для настройки ExportXML_SVC для совместной работы с RK7 необходимо:

в менеджерской добавить XML-интерфейс на кассовый сервер, задать порт и при необходимости ключ шифрования (CryptKey)
запустить ExportXML_SVC.exe, войти в настройки и переключиться на закладку R-Keeper
в разделе "Кассовая система" выбрать пункт "R-Keeper 7" и заполнить параметры подключения к XML-интерфейсу кассового сервера - IP-адрес, порт и ключ шифрования (CryptKey), если такой параметр установлен на стороне кассового сервера
заполнить соотв. оплат
при необходимости изменить значение параметра "Частота опроса кассы"
заполнить параметры VendorID (идентификатор организации) и ObjectID (идентификатор торговой площадки), значение необходимо получить у Заказчика услуги
для сохранения параметров нажать кнопку "OК" и перезапустить ExportXML_SVC

Запуск приложения

Приложение можно запустить в следующих режимах:

запуск без параметра - используется для настройки параметров и/или ручного запуска сбора данных
с параметром /autostart - запуск в качестве приложения (desktop) и автоматический запуск сбора данных
с параметром /install - установка приложения в качестве сервиса, после старта сервиса сбор данных запускается автоматически
с параметром /uninstall - удаление установленного сервиса