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

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

Данная технология предназначена для конфигураций, в которых требуется передача информации по совершенным продажам в 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 - удаление установленного сервиса