Интеграция с r keeper 7

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

Введение

Скачать дистрибутив можно на FTP-сервере по адресу: ftp://ftp.ucs.ru/rk7/shcr/
Для синхронизации баз данных R-Keeper 7 и StoreHouse реализована утилита DataCollector. При проведении действий (продаж) при помощи RK7 информация о  перечне и количестве проданных блюд и услуг, местах реализации и т. д. поступает в SQL -  таблицы. В свою очередь информация об изменениях на складе (в StoreHouse) также поступает в таблицы SQL, при помощи SHCR.
 
 
Рис. 1 - Схема связи SH и RK7
 
Т.е. в отличии от утилиты ImportRK, данные запрашиваются не у сервера справочников, а непосредственно из SQL базы.
 
Состав комплекта:
 
1. DataCollector.exe - непосредственно утилита, которая производит импорт справочников и продаж из RK7 в SH4. Может запускаться в режиме Desktop (обычный запуск exe-файла без параметров), либо в режиме службы-windows, для этого достаточно 1 раз запустить файл с ключом /install 
2. Settings.exe - утилита настройки импорта. Именно в ней настриваются параметры подключения к базе SH4, а также все параметры импорта. Важно!!!! Все произведенные настройки сохраняются непосредственно в базе SQL, поэтому не важно с какого рабочего места вы запускаете утилиту, считаются именно те настройки, которые вы производили последний раз. Т.е. для изменения настроек достаточно иметь утилиту, корректный udl-файл и доступ к базе SQL.
2. Scheduler.exe - планировщик задач. С помощью данной утилиты можно настроить расписание и периодичность импорта, а также посмотреть журнал выполнения задач.

1 Настройки SHCR

1.1 Настройка связи с БД RK7 под управлением SQL Server 

Для  работы утилиты SHCR необходимо настроить  файл подключения "test.udl" (при отсутствии файла необходимо создать новый). Файл содержит строку подключения к БД SQL, которая используется сервером справочников/отчетов в РК7 (рис.1а) для хранения накопительных данных смен..
 
Рис. 1а
 
Настроить значения в файле можно как простым редактированием в блокноте, так и стандартной утилитой "Средство канала передачи данных".
 
В Меню «Поставщик данных»  выбираем поставщика "Microsoft OLE DB Provider for SQL Server" (см. рис. 2)
 
 
Рис.2 – Выбор поставщика данных.
 
Во вкладке «Соединение» вносим имя SQL-сервера (вводим адрес сервера, на котором расположена необходимая база данных), имя пользователя, пароль, базу данных (вводим имя БД, которое будет использоваться для присоединенного файла БД SQL), проверяем соединение кнопкой "Проверить соединение" (см. рис. 3).
 

Рис. 3 – Настройка параметров соединения
Примечание. Если не выбрать базу данных в настройках, то вы увидите такую ошибку:

1.2 Settings.exe  - основные параметры

После создания файла test.udl запускаем файл "Settings.exe". При первичном запуске создаются таблицы в БД (назначение таблиц  см. в приложении 1).

В открывшемся окне проверяем, верно ли указан путь к udl, указываем дату старта и частоту происходящих синхронизаций R-Keeper v7 и StoreHouse 4 (см. рис. 4 - вкладка "Основные параметры"). Нажимаем кнопку «Тест соединения». В том случае, если все настройки введены верно, появится подтверждающее окно (см. рис. 5). 
 
 
 
Рис. 4 – Вкладка «Основные параметры»
soedinenie_ustanovleno.png

Рис. 5 – Подтверждение того, что соединение с сервером БД установлено

Описание настроек:

1. Путь к UDL-файлу - полный путь до файла настройки связи с SQL-базой

2. Пароль к БД - пароль для пользователя sa к базе SQL

3. Автовыгрузка с - дата с которой будут выгружены данные при первом запуске DataCollector, если параметр отключен и выгрузка данных не производилась - будут выгружены все данные имеющиеся в базе. 

4. Частота обновления - периодичность с которой будет запускаться DataCollector - не рекомендуем выставлять слишком маленькие значения.

5. Сортировка списков - настройка сортировки серверов SH4(если их несколько)

6. Таймаут выполнения запроса - время ожидания выполнения запросов к SQL-серверу

1.3 Параметры StoreHouse и r keeper 7

Первым делом обязательно пропишите путь к библиотеке сервера ShServ.dll  в файле shserver.ini. Если сервер расположен на удаленной машине, то прописываем полный путь к файлу shserv.dll на удаленной машине без IP-адреса. Если не указать путь к DLL, то продажи в SH не импортируются. 

Рис. 7 - Путь к библиотеке ShServ.dll
Для настроек импорта переходим во вкладку «Параметры SH и RK». Выбираем в окне выбора/создания сервера необходимый нам сервер (см. рис. 6) (для создания нового сервера щелкаем по окну правой кнопкой мыши, нажимаем «Добавить»,  вводим все необходимые параметры – имя, адрес, порт, имя пользователя, пароль).
Важно: у вас не должно быть запущенных экземпляров Sh.exe или Sdbman.exe. Клиентские приложения требуют лицензию и если она будет занята, DataCollector не сможет подключиться к серверу и будет выдавать ошибку подключения.
Обращайте внимание на логин и пароль — в них важен регистр!
 

Рис. 6 – Настройки импорта

Флаг «Активен» - определяет использование выделенного сервера для импорта/экспорта.

Флаг «Импорт в SH» - при наличии данного флага для данного сервера возможен импорт данных из R-Keeper V7 в StoreHouse V4.

Область «Основные параметры»

В области «Основные параметры» отображается информация выбранного сервера: имя сервера (то, что будет отображено слева в "Списке серверов StoreHouse"), ip-адрес, порт для подключения, имя пользователя (StoreHouse), пароль (к БД StoreHouse).

Область «Параметры импорта»

Вид закладки «Параметры импорта» зависит от выбранного принципа выгрузки документов в StoreHouse: по ресторанам или по концепциям.

Если используется выгрузка по концепциям, то в менеджерской РК7 должны быть заведены соответствующие концепции и связаны с ресторанами (рис.6а).

В версии SHCR  ver. 7.5.23.0 добавлен новый фильтр меню по расписанию (список доступности).

Работает только для выбранного конкретного ресторана.
При выборе всех ресторанов или концепции, данный фильтр не работает.

Особенность:
Блюдо не выгружается, если у выбранного ресторана задан период, в котором нет детализаций.
В Остальных случаях, если период не выбран или у периода есть хоть 1 детализация, блюдо выгружается.

 

Рис.6а

Вид области «Параметры импорта» при выгрузке по ресторанам представлен на Рис. 6 – Настройки импорта.

  • Ресторан – ресторан, продажи которого будут выгружаться в выбранную базу данных StoreHouse. При выборе конкретного ресторана, обязательно в свойствах ресторана в RK7 указывать цену SH4.
  • Категория заказа – реализация только с указанной категории заказа будет импортирована в StoreHouse.
  • Тип группировки – тип группировки документов расхода.
  • Товарная группа – корневая вершина из словаря «Список товаров», в которую будет выгружаться меню из R-Keeper V7.
  • Флаг «Импортировать меню» - выставляется только в том случае, если не используется StoreHouse Head Office.
  • Торговая группа – в словари StoreHouse выгрузятся блюда только указанной торговой группы.
  • Флаг «Создавать пустые группы» - при наличии флага в данном поле в словаре StoreHouse будут созданы пустые группы, для тех групп меню блюда из которых не выгружены из-за ограничения по торговым группам. Если флаг не установлен, нужно внимательно относиться к фильтрам выбора импортируемой информации, чтобы не потерять необходимые данные.
  • Флаг «Добавлять элементы с незаданной ценой» - при выставленном флаге в данном поле в StoreHouse выгружаются блюда, у которых в поле цена указано «не задано».
  • Расчет НДС – в данном поле необходимо выбрать правило расчета НДС: по R-Keeper (будет взята из RK7) или по StoreHouse (в этом случае ставка налога берется из карточки товара SH4). Рекомендовано использовать правило "По StoreHouse".

Флаг «Категории заказа по использованию» - при наличии данного флага в БД StoreHouse будут выгружаться документы расхода с категориями заказа (местами реализации), котрые определены в использовании (см. руководство по R-Keeper V7)

Для сопоставления типов валют R-Keeper V7 и Типов оплат StoreHouse необходимо нажать клавишу «Маппинг способов оплаты» (см. рис. 8). Если напротив способов оплат R-Keeper V7 не будет установлен соответствующий тип оплат StoreHouse, в базе StoreHouse создадутся новые типы оплат (в соответствии с типами оплат R-Keeper).

3.png
Рис. 8 – Меню «Маппинг способов оплаты»

Настройка «Доп. Фильтры» позволяет выбирать, по какой валюте/типу оплат выгружать расходы в StoreHouse. Из-за этой настройки сумма расхода за день в R-keeper может не соответствовать сумме расхода в StoreHouse. При группировке по причинам удаления кнопка «Доп. фильтры» неактивна. 
В этом разделе можно поставить флаг  «По нулевой цене» , который позволяет выгружать товары из R-keeper с нулевой ценой. Это полезно, например, для корректного учёта продаж за бонусы Plazius в StoreHouse.

 

В StoreHouse в документе расхода назначается Категория расхода, соответствующая способу группировки при загрузке данных. В пункте «Разбивка по складам» определяются настройки позволяющие разделять документы расхода по выбранному типу группировки и одновременно по складам списания.

Пример окна «Разбивка по складам» представлен на Рис. 9.

Рис. 9

Для добавления новой строки необходимо выбрать пункт «Добавить» из контекстного меню, затем в открывшемся окне (см. Рис. 10) необходимо заполнить поля.

Рис. 10

Склад - склад списания товара;

Заменяемая Категория - категория расхода, определяемая «по умолчанию» при импорте данных их R-Keeper.

Заменяющая Категория - категория расхода, которая будет присвоена документу расхода в StoreHouse в зависимости от склада списания товаров.

  • Список Замещающих категорий необходимо сформировать в словаре Категории расхода (см. Руководство пользователя по StoreHouse)
  • Для товаров с установленным типом Услуга необходимо сделать отдельное назначение
  • Если для какой-либо пары: Склад и Категория расхода не сделать назначение, то при импорте Расхода блюд с такими параметрами, будет создан документ расхода с категорией Реализация (по умолчанию)
  • Если у разных пар (Склад – Категория расхода) была выбрана одна и та же замещающая категория, то в StoreHouse будет сформирован один документ расхода с указанной замещающей категорией.

Для экспорта информации в SQL-базу (то есть выгрузка данных из StoreHouse (накладные и товары) в таблицы SQL), необходимо установить флаг «Экспорт в SQL».

Для выгрузки в таблицы SQL фудкоста, рассчитанного в StoreHouse, необходимо установить флаг «Обрабатывать фудкост».

Для расчета фудкоста обязательно выбрать группы для внутренних корреспондентов и группы корреспондентов для списания боя/порчи (перечень зависит от настроек StoreHouse). Более подробно ознакомиться с расчетом фудкоста можно в руководстве по StoreHouse.

Если требуется передавать информацию о прейскурантах в таблицы SQL, необходимо установить флаг «Обрабатывать прейскуранты».

 Если требуется передавать информацию о свойствах товаров в таблицы SQL, необходимо установить флаг «Обрабатывать свойства товаров».

Примечание: для того чтобы не выгружать из RK7 в SH4 наценку, которая определена для механизма импорта предоплаченных заказов из EDI в RK7, в настройках появился параметр "Не учитывать предоплаты". Поддержано в  SHCR ver. 7.5.19.1+.

К таким наценкам могут относиться например наценки, которые используется в случае оплаты заказа баллами из какой-либо внешней системы лояльности.

Если в r_keeper_7 заведено более двух налогов, то необходимо правильно передавать суммы в документы расхода.
Для назначения ставки налогов в карточку товара StoreHouse_4

  • НДС - считать первый в списке налог без флага "Добавить к цене". Если данный налог не используется на блюде r_keeper_7 (пустое значение или 0), то в StoreHouse назначать ставку 0%
  • НСП - считать первый в списке налог с флагом "Добавить к цене". Если данный налог не используется на блюде r_keeper_7 (пустое значение или 0), то в StoreHouse назначать ставку 0%
  • Если в списке нет налога с флагом "Добавить к цене", то в НСП карточки товара StoreHouse_4 назначать ставку 0%

Если используется более 2х налогов в r_keeper_7, то импорт налоговых сумм в расход StoreHouse_4 проводить только по r_keeper_7 (по StoreHouse нецелесообразно, т.к. нет возможности определить все ставки, для правильных расчетов сумм)

  • Суммы всех налогов БЕЗ ФЛАГА "Добавить к цене" - выгружать в поле НДС StoreHouse_4
  • Суммы всех налогов С ФЛАГОМ "Добавить к цене" - выгружать в поле НСП StoreHouse_4
  • Сумма б/н StoreHouse_4 = сумме без ВСЕХ налогов r_keeper_7
  • Сумма в/н StoreHouse_4 = сумме с учетом ВСЕХ налогов r_keeper_7

1.4 DataCollector.exe

Для экспорта/импорта запускаем файл "DataCollector.exe", жмем «Старт» (см. рис. 11)
 
Рис. 11 – Импорт/экспорт
При запуске DataCollector проверяет - есть ли не обработанные смены до текущей даты:
а) если есть - то производится импорт справочников и продаж до текущей даты.
б) если не обработанных смен - нет, то будет выполнен повторный импорт последней обработанной смены. Сделано специально для больших объектов, когда данные о продажах могут приходить в течение суток и необходима корректировка по продажам. 
 
При повторном импорте - пересоздание документов расхода в SH4 осуществляется только если документы расхода за эти даты не проведены.

2 Scheduler (Планировщик)

Пользовательский интерфейс планировщика представлен на рис. 12.
 
planirovshchik.png
Рис. 12 – Планировщик задач

2.1 Просмотр задач

Для просмотра существующих задач нажимаем кнопку «Просмотр задач» (см.  рис. 13).

6.png

Рис. 13 – Просмотр задач для выбранного сервера

Для просмотра сведений о задачах, например, выполненных с ошибкой, необходимо щелкнуть правой кнопкой мыши по интересующей задаче, нажать «Сведения» (см. рис. 14).

5.png

Рис. 14– Сведения о задаче

2.2 Мастер создания задачи

В стартовом окне мастера создания задачи необходимо выбрать сервер StoreHouse (см. Рис. 15) и нажать «Далее».

vybor_servera_0.png

Рис. 15 – Выбор сервера SH4

В открывшемся окне выбираем категорию нового задания, нажимаем «Далее» (см. рис. 16)

vybor_zadaniya_0.png

Рис. 16 – Выбор задания

В следующем окне выбираем начальную и конечную даты периода, за который хотим получить отчет (см. рис. 17), нажимаем «Далее».

period_1.png

Рис. 17 – Выбор периода желаемого отчета

В следующем окне назначаем время запуска задания (задачу можно выполнить немедленно, либо в заданное время и дату (см. рис. 18). Т.е. запуск "немедленно" используется для одноразовых задач "прямо сейчас", запуск по времени уточняет время запуска задачи, галочка "повторять каждый день" позволяет сделать задачу "ежедневной", при этом будут импорироваться все необработанные смены, т.е. если служба не запускалась неделю(а продажи за это время были) то при запуске импортируются данные о продажах за весь этот период.. Нажимаем «Далее». После этого появится окно со сведениями о созданном. Просматриваем, все ли верно, нажимаем «Сохранить».

Рис. 18 – Выбор времени запуска задания

Затем в открывшемся окне будут отображены данные о сформированном расписании. Пример представлен на Рис. 19Для сохранения настроек необходимо нажать клавишу «Сохранить».

Рис.19

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

  • Если документы были импортированы за определенный интервал дат, при повторной выгрузке данных из R-Keeper в StoreHouse документы за текущую дату будут обновлены(если эти документы не проведены). Т.е. если данные в БД R-Keeper по закрытым сменам изменились, данные в документах расхода также изменятся.
  • При выгрузке данных с разбивкой по складам списания, если у какого-то из товаров (группы товаров) не определен склад списания, то такой товар (группа товаров) будут помещены в отдельный документ расхода с категорией расхода Реализация (по умолчанию).
  • Если на кассе R-Keeper продано блюдо с модификаторами, а в StoreHouse для данного товара определен тип «услуга», то в документ расхода такой товар будет выгружен без модификаторов. Если необходимо прогрузить модификаторы, то необходимо удалить документы расхода с данным товаром, изменить тип на «товар» и импортировать данные еще раз.

Приложение 1 

Таблица 1 - Назначение SQL - таблиц

Наименование таблицы
Содержимое таблиц

data_shcr_CatFoodCost 

 Фудкост

data_shcr_cmprotocol 

 Протокол комплектов

data_shcr_cm 

 Шапка комплектов

data_shcr_cm_atributes 

 Атрибуты комплектов

data_shcr_cm_detail 

Компоненты комплектов

data_shcr_cm_tech 

Технология сборки комплкетов

data_shcr_cm_version 

 Версии комплектов

data_shcr_CorrTree 

 Дерево корреспондентов

data_shcr_CorrFullList 

 Корреспонденты

data_shcr_docprotocol 

 Протокол накладных

data_shcr_doc 

 Шапка накладных

data_shcr_doc_attrs 

 Атрибуты накладных

data_shcr_doc_lines 

 Товары накладных

data_shcr_expdocprotocol 

 Протокол документов расхода

data_shcr_expdoc 

Шапка документов расхода

data_shcr_expdoc_lines 

 Товары документов расхода

data_shcr_expdoc_lines_details 

 детализация товаров (модификаторы)

data_shcr_GoodsTree 

 Дерево товаров

data_shcr_Goods 

 Товары

data_shcr_GoodsBaseAttrs 

 Атрибуты из карточки товаров

data_shcr_GoodsBaseCompl 

 Комплекты из карточки товаров

data_shcr_GoodsBaseMain 

 Заголовок из карточки товаров

data_shcr_GoodsBaseMeasures

Единицы измерения из карточки товаров

data_shcr_GoodsBaseStore 

 Запас из карточки товаров

data_shcr_GoodsBaseWrite_Off 

 Списание из карточки товаров

data_shcr_GoodsCtg 

 Осн.категории товаров

data_shcr_GoodsCtg2 

 Бух.категории товаров

data_shcr_idocprotocol 

 Протокол счет-фактур

data_shcr_idoc 

 Шапка счет-фактур

data_shcr_idoc_lines 

 Товары в счет-фактур

data_shcr_MGroups 

 Группы единиц измерения

data_shcr_MUnits 

 Единицы измерения

data_shcr_OwnAttrs

Собственные реквизиты

data_shcr_TDoc 

 Шапка шаблона накладных

data_shcr_TDoc_details

Товары шаблона накладных

data_shcr_PLDoc 

 Шапка прейскурантов

data_shcr_PLDoc_details 

Товары 

 

Импорт данных в r keeper 7 через Feature Server

Введение

Из StoreHouse 4 в r_keeper_7 можно импортировать данные в режиме онлайн. Для этого необходим Feature Server, идущий в комплекте с интерактивными отчетами. Соответственно, перед настройкой импорта, у вас должно быть установлены и запущены:

i_Guid={D54BA83D-EA0F-4ADC-834D-70C336259F6D}
instance_name=171848
MasterServer=1

Описание импорта

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

  • Себестоимость блюд
  • Приходные накладные
  • Акты реализации.

Обновление Feature Server

Если у вас установлена старая версия плагина интерактивных отчетов и Feature Server, их лучше обновить. В ранних версиях FS есть требование о необходимости установки FS и SQL на одном компьютере, но с версии 1.36 это не актуально.

Для обновления Feature Server и плагина:

  1. Скачайте последнюю версию с FTP-сервера ftp://ftp.ucs.ru/rk7/other/IR_reports/
  2. Распакуйте архив в удобное место. Скопируйте с заменой все файлы в папку установленного FS. Файла настроек в архиве нет, поэтому существующие настройки не потеряются. 
  3. Закройте менеджерскую станцию и скопируйте содержимое архива из папки plugins в одноименную папку менеджерской станции
  4. Запустите FS и менеджерскую станцию.

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

Для работы импорта необходима настроенная связь с MS SQL и интерактивных отчётов. 

Запустите Сервер справочников, Common Server, Feature Server.

  1. Откройте менеджерскую станцию и перейдите в меню Расширения > База данных.
    1. Если видите ошибку Недопустимое имя объекта PLG_OBJECTS
    2. Откройте обозреватель MS SQL и выполните скрипт:
    3. CREATE VIEW [dbo].[PLG_OBJECTS] AS
      SELECT
      GUIDSTRING
      ,CODE
      ,NAME
      ,ALTNAME
      ,STATUS
      FROM dbo.RESTAURANTS
      WHERE (STATUS = 3)
    4. Ошибка должна исчезнуть.
  2. Нажмите правой кнопкой мыши на раздел Все и выберите пункт Создать новую группу баз данных. Переименуйте её по желанию.
  3. Подобным образом нажмите на группу и создайте новую базу данных
  4. Находясь в меню группы, выберите базу данных в правом меню и заполните поля:
    1. Название
    2. В разделе Основное укажите данные для подключения к серверу StoreHouse 4:
      1. Имя пользователя StoreHouse
      2. Пароль пользователя StoreHouse. Важно! У пользователя StoreHouse обязательно должен быть пароль.
      3. Строку соединения, в формате IP:PORT, например: 127.0.0.1:3334
        Это означает, что для работы импорта, StoreHouse должен быть настроен на подключение по TCP/IP.
    3. В разделе Другое:
      1. ​Поставьте галочки напротив SH4
      2. Заполните поля Параметр Начальная дата и Параметр Конечная дата
    4. В разделе Настройки импорта StoreHouse
      1. ​В полях Валюта и Группа товаров укажите параметры для импорта данных.
        Примечание: валюта и группа товаров доступны для выбора только при удачном подключении к серверу StoreHouse
      2. Поле Место реализации заполнять не нужно
      3. Если в StoreHouse производится спец учет, поставьте галочки в зоне полях Специальный учет и Рассчитывать в ед. изм. "для расхода"
    5. Нажмите сохранить 
  5. Подключение настроено, теперь его необходимо проверить. Нажмите правой кнопкой мыши на базу данных в меню слева и выберите пункт Проверка соединения с БД...
    • Если подключение настроено верно, появится сообщение:
    • Если соединение настроено неверно, то появится сообщение:
  6. Теперь необходимо привязать объект к созданной базе данных в списке слева. Для этого нажмите правой кнопкой мыши на поле справа и выберите пункт Добавить новый объект

    Нажмите Добавить и сохраните изменения.
  7. Откройте StoreHouse 4 и убедитесь, что в корреспондентах есть хотя бы 1 склад. 

    Если склада нет — создайте.
  8. Перейдите в Меню > Классификации блюд и скопируйте GUID классификации, которую планируете использовать. В классификации обязательно должны быть вложенные категории.

    1. Остановите Feature Server и откройте его файл настроек — IRReportsFSPrj.ini
    2. Добавьте в блок [FS_ADDITIONAL] строчку:
    3. SH4_Class={71B5617A-00D7-48EE-91A4-4A82C4F62642}
    4. Где после знака "=" вставьте скопированный GUID классификации. Если секция [FS_ADDITIONAL] отсутствует, добавьте.
    5. Сохраните файл и запустите Feature Server
  9. Перейдите в меню Настройки > Центральный офис > Рестораны, и нажмите правой кнопкой мыши на ресторане, который необходимо связать со StoreHouse. Выберите пункт Действия > Редактор связи со складом
  10. Выберите необходимые категории. В их поле Store House 4 их свойств склад, с которого будет производиться выгрузка
     
  11. Если классификации появились, но выбор склада пустой, то  проверьте:
    • Заведены ли в базе StoreHouse 4 склады? Нужен, хотя бы 1
    • Если склады в StoreHouse есть, то в базе данных SQL имя_базы_STAT_SH4_SHIFTS_FOODCOST в таблице dbo.STAT_SH4_SHIFTS_CORR должен быть список складов. Поле TYPECORR у склада должно быть равно 0
    • Если в SQL нет записей с TYPECORR=0, то проверьте наличие заполненного полей реализация и группа товаров. Если они пусты — заполните и попробуйте еще раз. 
      Если не помогло — очистите папку с логами Feature Server, измените название подключения к базе StoreHouse из пункта 4 и нажмите кнопку сохранить. FS должен повторно запросить данные у StoreHouse 4.
  12. Сохраните и закройте менеджерскую станцию.
  13. ​В конфигурационный файл плагина интерактивных отчётов RK7MAN\plugins\SchRepPluginClient\SchRepPluginClient.ini добавьте текст в конец файла:
    • [PLG_ACC]
      use_accounts = 1
      [PLG_PLAN]
      use_plan_params = 1
      [PLG_SH]
      use_sh_params = 1
  14. Сохраните и запустите менеджерскую станцию.

Регистрация библиотек

Для работа импорта на компьютере необходимо зарегистрировать библиотеку SH4ole.dll. Для этого есть специальная утилита RegOle. Скачайте ее по ссылке: ftp://ftp.ucs.ru/storehouse/sh4/sh4ole/shOLE_4_45_66.7z

  1. Распакуйте содержимое архива в корневую папке установки StoreHouse 4. Запустите от имени администратора файл RegOle.exe.

  2. Убедитесь, что в папке есть библиотеки:
    • DoMan.dll
    • RTL60.BPL
    • SdbCli.dll
    • SdbVcl.dll
    • Midas.dll
  3. Нажмите кнопку RegisterServer. Если всё хорошо, то программа зарегистрирует библиотеку:
     
  4. Если появилось сообщение Ok, значит, библиотека успешно зарегистрирована.
  5. Регистрацию можно проверить через приложение TestOle.exe, идущее в комплекте.
    1. Запустите приложение и нажмите кнопку Login в левом верхнем углу. Укажите логин и пароль и подключитесь к базе StoreHouse
    2. Выберите процедуру в выпадающем списке Procedure и нажмите кнопку Start Query
    3. Сообщение внизу должно стать OK. Для уверенности попробуйте разные процедуры.

Запуск импорта

Запустите серверы:

  • UCS Common
  • Feature
  • StoreHouse 4

И откройте менеджерскую станцию.

Если все настройки правильные, Feature Server начнёт загружать данные из StoreHouse 4 в r_keeper_7 за выбранный период:

Если в логе Feature Server есть строчки Date... Invoice load, значит всё работет правильно.

Пересчитать данные StoreHouse можно зайдя в Интерактивные Отчеты (ИО) > Отчеты по безопасности > Системные операции > Пересчитать данные SH.

Импорт себестоимостей из SH4 в RK7

Введение

Из StoreHouse 4 можно импортировать себестоимость товаров в r_keeper_7. 

Для настройки импорта себестоимостей необходимо скопировать DLL-файлы из папки StoreHouse, а затем сделать настройки в менеджерской станции. Не забудьте настроить себестомости в StoreHouse, чтобы было что импортировать. 

Копирование библиотек

  1. Укажите ИНН в Собственных реквизитах, если он не указан
  2. Скопируйте из папки \StoreHouse_4\Client файлы:
    • SdbVcl.dll
    • DoMan.dll
    • SdbCli.dll
    • RTL60.BPL
  3. В папку сервера справовочников. Обычно это \Rk7Reference или \bin\win

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

  1. Запустите менеджерскую станцию
  2. Создайте новую связку для базы данных SH4 в разделе Сервис > Экспорт данных > Конфигурации баз данных SH4
  3. В настройках укажите:
    1. Имя пользователя, например Admin
    2. Строчку подключения к серверу StoreHouse. Указывать точно так, как в StoreHouse
      Например:127.0.0.1:pTa3333
    3. Пароль пользователя
    4. Версию StoreHouse в выпадающем меню
  4. Создайте новую себестоимость в Меню > Тип себестоимостей 
    1. Укажите код товарной группы StoreHouse. Посмотреть его можно в свойствах группы StoreHouse:
    2. В поле настройкиStoreHouse выберите ту настройку, которую до этого создали в Конфигурации баз данных.
    3. В настройках поставьте галочки напротив:
      1. Использовать в отчетах
      2. Разрешить переопределения
    4. Укажите Код склада. Его можно посмотреть в Корреспонденты > Список корреспондентов. По умолчанию складов нет, поэтому создайте хотя бы один.
    5. По необходимости поставьте галочку Импорт из Спец. Учета
  5. Сохраните настройки.

Запуск импорта

Импорт можно запускать 2-мя способами. Непосредственно из меню и через импорт данных. 

  1. В менеджерской станции перейдите в Сервис > Импорт данных > Импорт себестоимостей из StoreHouse
  2. Выберите Тип себестоимости, который создали в пункте 4
  3. Выберите Элементы справочника
  4. Укажите Код склада
  5. Если нужно указать товарную группу, укажите её руками в кавычках, точно как в StoreHouse. Можно перечислить несколько товарных групп через пробел или запятую, которые являются разделителями товарных групп в этом поле. 
  6. По желанию выберите Дату, Тип элемента, Элементы справочника и Метод вычисления
  7. Нажмите ОК
  8. Нажмите ОК.
  9. Если появляется ошибка "Exception running function REFIMPORTSH4COSTTYPE on RK7: Exception:Db exception # 129. Неизвестное исключение процедуры сервера 129", это означает отсутствие лицензий. Скорее всего, запущенный StoreHouse 4 занимает единственную лицензию и его следует закрыть для проведения импорта.
  10. Для корректного импорта, себестоимость должна быть в StoreHouse 4. Это означает, что:
    1. Для блюда r_keeper_7 должен быть создан комплект;
    2. На складе должны быть составляющие этого комлекта с ценой выше нуля. Если составляющих, то есть, остатков, нет — их необходимо оприходовать на склад.
  11. После выполнения предыдущего пункта и успешного импорта, цена появится в r_keeper_7:

    Если появилась — всё сделано правильно.

Чтобы быстро импортировать только нужную группу меню, импорт можно запускать непосредственно из меню. Для этого:

  1. В менеджерской станции перейдите в Меню > Меню
  2. Нажмите правой кнопкой мыши на нужную группу меню
  3. Выберите Действия > Импорт себестоимости из StoreHouse
  4. Настройте детали импорта, как описано выше и запустите.

Импорт данных через 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