Импорт данных через ImportRK

Введение

Реализовано несколько видов взаимодействия 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

Выбор транспортной библиотеки SHTR.DLL

Введение

Для импорта справочников и расхода блюд из системы R-Keeper v7 (далее RK7) в систему StoreHouse v4 (далее SH4) совместно с параметрами IRkSetup.exe и прочими настройками, используется транспортная библиотека SHTR.DLL. Библиотека отвечает за загрузку данных в SH – SHTR.DLL описание (Incl.D). Стандартная библиотека выгружает: Группы станций, Товарные группы, Категории расхода (причины удаления), Категории расхода (валюты), Категории расхода (типы оплат), Товары, Расход блюд (за период указанный при импорте)

Расход блюд выгружается с учетом всех скидок/наценок. НДС в документ расхода проставляется из карточек товаров SH. НДС для товаров проставляется вручную в словаре товаров. Тип группировки (причины удаления, валюты, типы оплат, загрузка по складам списания) документов расхода задается в приложении IRKSETUP.EXE

Для использования библиотеки она должна быть скопирована в рабочую директорию \SH4.

Загрузить различные версии библиотеки можно с FTP-сервера ftp://ftp.ucs.ru/storehouse/sh4/shtr.dll/RK7

Примечание: Для определения версии и описания библиотеки необходимо открыть свойства файла SHTR.DLL в проводнике Windows.

Версии

  • Использование модифицированных (2.6.0.7) версий библиотеки SHTR.DLL актуально для версий SH 4.85 и выше.
  • RK7.5.2.x и выше.

Стандартная версия SHTR.DLL

№ п.п.

Описание библиотеки

Описание

 0

Incl.D

Импортирует:

  • Группы станций 
  • Товарные группы
  • Категории расхода (причины удаления)
  • Категории расхода (валюты)
  • Категории расхода (типы оплат
  • Товары
  • Расход блюд (за период указанный при импорте)

Особенности:

  • Расход блюд импортируется с учетом всех скидок/наценок
  • НДС в документ расхода проставляется из карточек товаров SH4.
  • НДС для товаров проставляется вручную в словаре товаров.
  • Тип группировки (причины удаления, валюты, типы оплат, загрузка по складам списания) документов расхода задается в приложении IRkSetup.exe

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Специальные модификации SHTR.DLL

Кроме стандартной существуют специальные модификации библиотеки SHTR.DLL, которые влияют на внутреннее содержимое документов расхода, суммы и т.д., формируемые в процессе импорта документов.

Основные настройки импорта производятся в приложении IRkSetup.exe и аналогичны настройкам при использовании стандартной библиотеки SHTR.DLL
 

№ п.п.

 Описание библиотеки

Описание

1

  Empty.DL, Incl.D

Используется для загрузки документов расхода в локальный склад, когда сеть предприятий работает со StoreHouse HeadOffice (далее SHHO).

Данная библиотека не импортирует меню, так как меню рассылается из системы SHHO, документы расхода импортируются как при работе со стандартной библиотекой SHTR.DLL

2

  Excl.D

Библиотека для импорта документов расхода без учета скидок/наценок, то есть документы расхода по отпускным ценам. Все остальные функции аналогичны стандартной библиотеке SHTR.DLL

3

  Empty.DL, Excl.D

Модификация библиотеки, описанной в п.3, для работы с SHHO

4

  Incl.D, Tr.Tax 

Библиотека для импорта документов расхода с группировкой блюд по ставкам НДС в документе расхода.

Если ставка налога в одной налоговой группе RK7 отличается в зависимости от заданных условий (категории, тип заказа), то при использовании данной библиотеки одно и то же блюдо импортируется несколькими строками согласно реализованным ставкам НДС (пример: тип заказа «в зале» – НДС 18%; тип заказа «на вынос» - НДС 10%. Если реализовали одно блюдо и так и так, то данная позиция будет в документе расхода двумя строками)

Ставки НДС будут проставлены в документ расхода, но на карточки товаров данная ставка назначена не будет - отпускной НДС на карточки товаров нужно назначать вручную!

5

  Empty DL,Incl.D,Tr.Tax

Модификация библиотеки, описанной в п.5, для работы с SHHO

6

  Excl.D,Tr.Tax

Библиотека для импорта документов расхода без учета скидок/наценок и с группировкой блюд по ставкам НДС в документе расхода.

Данная библиотека совмещает в себе функционал библиотеки из п.2 и п.3. Если ведется разделение ставок НДС в одной налоговой группе, например в зависимости от типа заказа или от категории, то при использовании данной библиотеки товары будут разделены согласно реализованным ставкам НДС.

7

  Empty DL,Excl.D,Tr.Tax 

Модификация библиотеки, описанной в п.7, для работы с SHHO