Введение

Реализовано несколько видов взаимодействия r_keeper 7 и Storehouse 4:

  • Синхронизация с помощью DataCollector.exe (http://support.ucs.ru/ru/node/6952) - рекомендуемый способ обмена данными
  • Экспорт товаров и продаж из r_keeper 7 в StoreHouse 4
  • Импорт себестоимости из StoreHouse 4 в r_keeper_7
  • Экспорт онлайн-остатков из r_keeper 7 в StoreHouse 4

Экспорт товаров и продаж из r_keeper в StoreHouse

  1. В папку клиента StoreHouse 4, например \SH4\Client\, в которой лежит ImportRK.exe, скопируйте содержимое папки \RK7\bin\sh4tr:
  • rk7tosh4.dll – библиотеку связи с r_keeper_7; 
  • rk7tosh4.ini – файл с настройками;
  • shtr.dll – библиотеку импорта для закачки меню и продаж. Обязательно скачайте её с FTP по ссылке и замените: ftp://ftp.ucs.ru/storehouse/sh4/shtr.dll/RK7/2.6.0.7/id/
  • netkern.dll, errors32.dll, thread32.dll, dllman.dll, tcpsoc.dll.
  1. Запустите программу IRKSetup
  2. В поле Путь укажите путь к базам r_keeper_7
  3. В разделе Словари, укажите Тип источника Paradox
  4. В разделе Расход, укажите Тип источника UDB
  5. В поле Тип группировки выберите один из трех вариантов группировки:
    1. Группировка По причинам удаления предполагает, что реализованные блюда будут сгруппированы в отдельный документ по расходу блюд. Нереализованные блюда из удаленных чеков и блюда, на которые были сделаны отказы, будут сгруппированы по причинам удаления. Это означает, что для каждой причины удаления будет создан отдельный документ, в котором будут представлены все блюда, удаленные в этот день.
    2. Группировка По валютам означает, что для каждой валюты будет создан отдельный документ о расходе блюда
    3. Группировка По типам оплат также означает отдельный документ для расхода блюд
  6. Укажите Код ресторана. Его можно посмотреть в менеджерской станции:
  7. В менеджерской станции перейдите в раздел Меню > Типы цен. Откройте свойства нужной валюты и проставьте галочку Цена StoreHouse 4.
  1. Отредактируйте файл rk7tosh4.ini. Описание файла ниже:
[REFSERVER7]
ServerName = TEST_RK7SRV                     ; Укажите здесь имя сервера справочников или сервера отчетов r_keeper_7.
ClientName = SH4cli                          ; Имя клиента. Должно быть уникальным!
NetworkTimeout = 3600000                     ; Таймаут - 1 час
ImportMode=0                                 ; Режим импорта: 0 – по сети с сервера, 1 – из файлов. 
ImportPath=                                  ; Путь к файлам данных. Если режим импорта 1 (импорт из файлов), то указывается либо путь к каталогу с файлами данных (получаемыми из менеджерской), либо путь вида: HKLM\SOFTWARE\UCS\SHTrans\MYSERV\Settings\2.
 В таком случае путь будет взят из значения ключа srcPath в реестре по адресу, заданному ImportPath. (Корневая ветка – всегда HKEY_LOCAL_MACHINE).

RestaurantCode=0                             ; Здесь можно указать Код ресторана. Это необязательная настройка, она позволяет загрузить продажи только из одного ресторана с этим кодом, если импорт по сети (ImportMode=0). Со значением 0, загружаются данные по всем ресторанам. Элементы меню и модификаторы будут закачиваться те, что в торговой группе, заданной в свойствах этого ресторана и те, что продавались в этом ресторане. Остальные справочники, кроме черновиков всегда закачиваются полностью.
[NETKERN]
PROTOCOLS = tcpsoc.DLL
;NODISCONNECTEVENTS = 1

[TCPSOC]
listen = 0 ;!!!

[TCPDNS]
;TEST_RK7SRV=127.0.0.1:3639

Подробнее о настройке читайте в руководстве пользователя https://docs.ucs.ru/uploads/StoreHouse.pdf

Экспорт/импорт данных о продажах через файл

В менеджерской: меню Сервис – Экспорт Данных – Экспорт Данных StoreHouse. Необходимо указать даты экспорта (с, по), тип группировки (если тип группировки не совпадет с типом, указанным в IrkSetup – будет ошибка), каталог для сохранения файлов.
В файле rk7tosh4.ini необходимо указать режим импорта (из файлов) и каталог, либо ветвь реестра, откуда следует взять путь к файлам для импорта.

Автоматическая передача данных из r keeper в StoreHouse

Примечание: данный механизм не поддерживается с версий 7.5.7.65. Рекомендуется использовать DataCollector.

Настройки в менеджерской станции

  1. В настройках сервера отчетов, в поле «Интервал ожидания данных», указывается временной интервал от закрытия общей смены на кассовом сервере RK7 до начала автоматической передачи данных в SH4. (Формат чч:мм)
  2. В настройках сервера отчетов, в поле «ExecuteData», указываются различные параметры для запуска автоматического импорта

Возможные параметры свойства ExecuteData (параметры разделяются "точкой с запятой"):

  1.  "path=C:\some.bat" - полный путь к запускаемому bat-файлу
  2.  "hide=1" - если есть любое "hide=", то окно запуска bat-файла (консоли) будет скрыто
  3.  "wait=15000" - ожидать завершения работы файла (значение указывается в мс, например 15000 =15 сек.)
  4.  "date=-1" - можно принудительно указать значение передаваемого параметра (%1) в bat-файл (количество дней с 01.01.1980)

Пример содержимого свойства ExecuteData:

  1. path=C:\some.bat;hide=1- выполнить some.bat, не показывать окно
  2. path=C:\some.bat;wait=60000, выполнить some.bat, подождать минуту до завершения

Формат командной строки ImportRK.exe:

ImportRK.exe <ИмяСервераСклада> <КодРесторана> %1 <ПризнакАвтоматическогоСписания>

где <ИмяСервераСклада> - имя, по которому определяются параметры подключения к серверу склада

Важно: параметр <ИмяСервераСклада> должен в точности соответствовать имени сервера, прописанного в разделе реестре HKEY_LOCAL_MACHINE\SOFTWARE\UCS\SHTrans (или HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\UCS\SHTrans для 64-х битных ОС).

Например, если в реестре параметры для нашего сервера прописаны в разделе HKEY_LOCAL_MACHINE\SOFTWARE\UCS\SHTrans\192.168.0.1, параметр <ИмяСервераСклада> должен быть 192.168.0.1

<КодРесторана> - уникальный код ресторана (для)

%1 - начальная дата импорта; данный параметр передается в bat-файл внешней обработкой (то есть, при запуске bat-файла значение %1 будет заменено на фактическое)

<ПризнакАвтоматическогоСписания> - 0 - списывать расход автоматически, <любое значение, отличное от нуля> - не списывать автоматически

Пример содержимого файла Some.bat:

сls
cd c:\ucs\sh4\
ImportRK.exe SDBSERV 17 %1 0
Pause

Где

cd c:\ucs\sh4\ - расположение файла ImportRK.exe

SDBSERV - имя SH4

17 - внешний код ресторана

%1 - параметр

0- признак необходимости списания расхода

Настройки в StoreHouse

Для корректной работы ImportRK.exe необходимо настроить параметры импорта через IRkSetup.exe.

Обязательно указать:

  • Пути импорта (поле должно быть заполнено).
  • Код ресторана (внешний код ресторана)
  • Имя и пароль пользователя SH4

Настройка импорта себестоимости

Описана в отдельной статье: https://support.ucs.ru/ru/node/9653