Установка и настройка StoreHouse 4

Введение

Система автоматизации складского учета StoreHouse 4 позволяет полностью контролировать процесс управления производством в ресторанах, кафе и ресторанах быстрого обслуживания, работающих на системе управления R-Keeper.

С помощью StoreHouse 4 можно:

Состав системы

Система состоит из серверной и клиентской частей.

К серверной части относятся следующие приложения:

К клиентской части относятся следующие приложения:

Блок-схема взаимосвязи основных модулей

Системные требования

Серверная часть

Клиентская часть

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

StoreHouse 4 поставляется с аппаратным ключом защиты Guardant Stealth II. Ключ защиты устанавливается только на сервере склада - при подключении клиентов сервер проверяет ограничения лицензии, записанной в ключ. 

Лицензия, записанная в аппаратный ключ, содержит ограничения по следующим параметрам:

Если ключ не установлен или неправильно настроен, клиент при подключении получит сообщение Ошибка чтения ключа защиты.
Если лицензия ограничена по дате или по количеству возможных подключений (определяется приобретенной лицензией), клиент получит сообщение Превышено допустимое количество соединений.

Обратите внимание, что при настройке интеграции с r_keeper_7, лицензия тоже используется. Поэтому, закройте клиентские подключения перед настройкой — иначе DataCollector не сможет подключиться.

Дополнительные подключения

Если вы хотите докупить лицензии на SH4, воспользуйтесь утилитой SHKey.exe. Утилита по-умолчанию находится в подкаталоге \SDBCli.
При работе с утилитой SHKey.exe рекомендуется подключать только один ключ защиты, предназначенный для склада.

Чтобы получить дополнительную лицензию:

Рис. Рабочее окно утилиты SHKey.exe для версии склада ниже 4.80

Рис. Рабочее окно утилиты SHKey.exe для версий склада выше 4.80

Важно: После попытки 7 (семь) раз сохранить некорректную лицензию, ключ будет заблокирован! Разблокировать ключ можно только в офисе компании UCS.

Установка серверной части

Для установки серверной части рекомендуется использовать ОС из семейства Windows NT:  Windows 2000\XP\7\8\2003 Server и выше.

Для установки серверной части необходимо:

Примечание: Версия сервера склада определяется версией библиотеки \SDBSrv\ShServ.dll

Возможные варианты установки:

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

Создание сервера

Для создания нового сервера или изменения конфигурации имеющегося используется приложение SdbsConf.exe. Оно по-умолчанию находится в папке \SDBCli

Для создания сервера необходимо:

После выбора сервера установленные параметры автоматически отображаются в соответствующих полях:

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

Важно: Сервер всегда хранит только одну резервную копию базы данных в сутки. Если в каталоге хранения резервных копий уже есть файл бекапа за текущие сутки (например, сделанный вручную), сервер не будет создавать новую резервную копию, независимо от установленного параметра автоматического резервного копирования.

Важно: Крайне рекомендуется всегда включать режим автоматического резервного копирования с опциями "Backup time" и "Stop server on error" - отсутствие актуальных резервных копий самая частая причина невозможности оперативно восстановить работу системы в случае поломки БД!

Примечание: Подробная информация о резервном копировании и обслуживании БД StoreHouse 4 описана в этой статье.

20.05.2005 20:40:15- Server started
version=1.15
subkey=SDBSERV
def working set size min=204800, max=1413120
max cache memory=1024 pages (4096 K)

Возможны три варианта:

Возможные режима запуска:

Рекомендуется использовать режим запуска в качестве системной службы (Service).

Важно: Рекомендуется всегда включать параметр Automatic recovery.

На закладке Settings (Настройки) содержится единственный параметр Root directory:

Важно: После изменения любых настроек их необходимо сохранить с помощью кнопки Save.

Запуск сервера

Сервер склада может быть запущен в трех режимах:

В случае запуска в качестве сервиса состояние сервера можно проверить через стандартную оснастку Windows  «Пуск» \ «Настройка» \ «Панель управления» \ «Администрирование» \ «Службы».

Убедитесь, что соответствующий сервер (Sdb server : <имя сервера>) находится в состоянии «Работает» и тип запуска установлен в «Авто»:


Если служба не запущена, запустите её. 

В случае ручного или автоматического запуска в системном трее должна появиться иконка сервера:

Если в системе несколько серверов и используется ручной режим запуска (Manual), сервер необходимо запускать с ключом /n<ИмяСервера>

Например, есть два сервера с именами SDBSERV01 и SDBSERV01 - для ручного запуска необходимо выполнить следующие команды:

Sdbserv.exe /nSDB01SERV
Sdbserv.exe /nSDB02SERV

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

Установка клиентской части

Для установки клиентской части необходимо:

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

После установки клиентской части необходимо настроить параметры подключения к серверу(ам) и другие сервисные параметры.
Для настройки параметров клиента используется приложение SHSetup.exe (по-умолчанию находится в директории \SH4):

В верхней части окна SHSetup.exe отображается список серверов (баз данных), которые будут доступны для подлючения на данном рабочем месте (по-умолчанию список пуст).

Для добавления нового сервера необходимо:

После добавления сервера необходимо настроить параметры подключения в разделе "Параметры подключения":

С помощью операций «Добавить сервер» \ «Удалить сервер» можно добавить и удалить строки для добавления дополнительных серверов - операция также доступна по правому нажатию кнопки мыши в верхнем окне.

Далее расположен раздел "Прочие параметры":

Примечание: Дополнительная информация о значениях кеша есть здесь - https://support.ucs.ru/ru/node/9578. Рекомендуется ознакомиться.

Важно: После настройки всех параметров необходимо сохранить конфигурацию нажав кнопку «Сохранить».

Создание базы данных

В дистрибутиве StoreHouse 4 не поставляется пустая база данных.

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

Для создания БД используется приложение Sdbman.exe (находится в директории \SH4)

Примечание: Для создания и обслуживания БД рекомендуется установить на сервер клиентскую часть и использовать локальное подключение (Local) к серверу

Для создания базы данных необходимо выполнить следующие действия:

127.0.0.1:pTa3333

где

Если сервер слушает все порты, можно указать строку вида 127.0.0.1:pT, т.е. без указания порта.

Важно: Предельный размер базы данных StoreHouse v4 примерно 1,8Гб (точно - 1792 Мб или 458752 страниц)

После входа в приложение на экране отобразится два сообщения с ошибками -  необходимо проигнорировать эти сообщения и войти в приложение:

После выполнения запроса в нижнем части окна появится сообщение о результате:

Восстановление базы данных

Для восстановления необходимо иметь файл резервной копии базы данных (*.bkp) - допускается восстановление резервных копий, выполненных на более младших версиях сервера (например, при обновления ПО StoreHouse 4).

Для создания резервной копии базы данных необходимо:

Примечание: Создание резервной копии базы данных также можно выполнить с помощью приложения \SH4\Shc.exe - операция «Инструменты» ⇒ «Резервное копирование»

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

Рекомендуется использовать локальное (Local) подключение при восстановлении базы данных, если используется подключение по протоколу TCP/IP, в качестве имени сервера необходимо указать строку вида:

127.0.0.1:pTa3333

где

Если сервер "слушает" все порты, можно указать строку вида 127.0.0.1:pT, т.е. без указания порта.

Примечание: При восстановлении базы данных рекомендуется устанавливать размер файла базы данных примерно в три раза больше, чем размер файла резервной копии - в дальнейшем размер базы данных можно изменить с помощью приложения Sdbman.exe

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

Обновление

Процесс обновление ПО StoreHouse 4 фактически состит из удаления текущей версии, установки требуемой версии и восстановлении резервной копии текущей рабочей базы данных.

Процесс обновления можно разделить на два этапа:

Обновление сервера

Перед обновления серверной части необходимо выполнить следующие действия:

Дальнейший процесс обновления соотв. процессу установки серверной части:

Если новая версия StoreHouse требует перезаписи ключа защиты (см. историю изменений в файле ftp://ftp.ucs.ru/storehouse/sh4/Ver4.txt), выполните процедуру, описанную в разделе "Дополнительные подключения"

Далее необходимо восстановить параметры и базы данных серверов:

Обновление клиента

Перед обновления клиентской части необходимо выполнить следующие действия:

Дальнейший процесс обновления соотв. процессу установки клиентской части:

Далее необходимо восстановить конфигурацию клиентской части:

Отдельно стоит уделить внимание макетам печатных форм:

Примечание: При отсутствии информации какие формы были модицированы, рекомендуется скопировать все формы из сохраненной резервной копии предыдущей рабочей директории \SH4\RPT

Примечание: В файле \SH4\SH.RPT хранится сопоставление макетов печатных форм и соответствующих им отчетов или документов - если не использовать ранее сохраненную копию файла SH.RPT, необходимо будет заново вручную подключать дополнительные отчеты в SH4

После завершения восстановления конфигурации, необходимо проверить наличие ярлыков и работоспособность всех используемых клиентских приложений.

Интеграция с 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

 
 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Интеграция с 1С

Настройка интеграции SH4 с 1С

Описание интеграции

Складскую систему "Store House 4" можно связать с бухгалтерской системой - "1С Бухгалтерия". Данный функционал (обработка) приобретается отдельно и защищен лицензионным ключом Guardant. Ниже будут рассмотрены варианты поддерживаемого связкой ПО, общие требования и рекомендации, а также информация по установке и настройке. 

Важно! Перед установкой обработки необходимо знать заранее, какая версия SH4 и какая редакция, платформа, конфигурация 1С установлены на объекте, так как не все версии программных комплексов можно связать между собой!
Важно - 2. Выгружать проводки без указания номенклатурной группы нельзя и дорабатываться этот функционал не будет. 

Таблица версионности ПО и отдельных модулей используемых для выгрузки в "1С", каталоги дистрибутивов (на 25.03.2014)

Версия SH4 Редация 1С, каталог на ФТП Платформа 1С, каталог на ФТП Конфигурация 1С sh4book.dll Версия обработки Файл keys.num

минимум - SH 4.70.172 и выше

(рекомендуется 4.95  и выше)

 

1.6 ftp://.../storehouse/sh4/1C/Buh 1.6 8.1 .../Buh 1.6/Platform_8_1/ "1С Бухгалтерия"  не ниже 4.5.6.0 3.02 не используется
8.2 .../Buh 1.6/Platform_8_2/
2.0 ftp://.../storehouse/sh4/1C/Buh 2.0 8.1 .../Buh 2.0/Platform_8_1/ "Бухгалтерия предприятия КОРП" не ниже 4.19.10.0 5.01 используется
8.2
 
.../Buh 2.0/Platform_8_2/ "Бухгалтерия предприятия" 5.03
"Бухгалтерия предприятия КОРП"
8.2.15 и выше
 
.../Buh 2.0/Platform_8_3/ "Бухгалтерия предприятия"
"Бухгалтерия предприятия КОРП"
3.0 ftp://.../storehouse/sh4/1C/Buh 3.0 8.2.17 и выше .../Buh 3.0/Platform_8_2/ "Бухгалтерия предприятия" не ниже 4.15.16.0 6.08 и выше не используется
8.3.3 и выше .../Buh 3.0/Platform_8_3/

Установка обработки

Установка складывается из распаковки дистрибутива и копирования файлов в нужные каталоги. Также, в дистрибутиве обработки, как правило идет win-инсталлятор, которым чаще всего пользуются если и 1С и SH4 вместе со своими базами находятся локально на одном ПК.

Сама связка представлена в виде нескольких файлов:

  1. Интерфейсная библиотека - SH4book.dll - копируется в каталог с клиентом \SH4\Client
  2. После копирования, ее необходимо зарегистрировать в системе. Запустите от администратора:
"Пуск"\"Выполнить" в окне набрать: "regsvr32 <папка в которой установлен клиент Store House>\Sh4book.dll" 
  1. Так же необходимо зарегистрировать бибилиотеку midas.dll, которая есть в папке клиента после установки:
"Пуск"\"Выполнить" в окне набрать: "regsvr32 <папка в которой установлен клиент Store House>\Midas.dll" 
  1. Файл обработки для 1С - SHto1C.epf  - обычно копируется в каталог установленного клиента 1С или куда угодно, например, в тот же каталог \SH4 или  \SH4\1C, лишь бы путь был покороче, что бы проще было найти и открыть этот файл через 1С. открывается непосредственно через 1С:

Примечание: если при открытии внешней обработки, появляется сообщение "Нарушение прав доступа", то выполните действия пункта ниже.

  1. Файл settings.ini - формируется автоматически при первом запуске обработки, в том же каталоге, где находится и SHto1C.epf. В нем будут содержаться настройки используемых при работе с обработкой фильтров и среды.
  2. Файл keys.num - использовался только на 1С редакции 2.0, должен в обязательном порядке находиться там же, где и запускаемый через 1С файл SHto1C.epf. В этот файл вписывается уникальный код соответсвия документов базы SH4 выгруженным документам в базе 1С. Пример содержимого файла:
Документы: 0       ; Код соответствия документов SH4 выгруженным документам в 1С. Заполняется при использовании нискольких баз SH4.
Справочники: 0     ; Этот код, не используется. Править его не нужно, т.к. этот функционал остался на стадии разработки.
  •  В случае, использования нескольких баз SH4 с одной общей базой 1С, заполнение этого кода - принципиально. Можно вписать любое циферно-буквенное обозначение но, не более 37-ми символов, причем использовать желательно латинские буквы и цифры (спец.сиволы и прочее не использовать). Это значение будет в дальнейшем отображаться в реквизитах каждого выгруженного документа в 1С.

Важно! по этим реквизитам документов, в случае если например, рабочий файл keys.num утерян/удален можно вяснить этот код и вписать его в новый keys.num. Если на рабочей и настроенной связке заменить keys.num на некорректный, то соответсвие документов в базах будет нарушено!

Разрешение открытия внешней обработки

Если при открытии внешней обработки или отчёта через меню Файл->Открыть

появляется ошибка "Нарушение прав доступа": "Нарушение прав доступа",

то сделайте следующее:

  1. Зайдите в конфигуратор базы:
  2. Выполните команду меню "Администрирование" > "Пользователи":
  3. Двойным щелчком откройте своего пользователя:
  4. Перейдите на закладку "Прочие", установите галку "Интерактивное открытие внешних отчетов и обработок" и нажмите "ОК":
  5. Теперь закройте конфигуратор и базу (если она у вас была открыта).
  6. Вновь зайдите в базу и попытайтесь открыть отчёт через меню "Файл"->"Открыть".

Несколько баз SH в одну базу 1С - версии выгрузки до 6.18

  • Если выгрузка идет из нескольких баз SH4 в общую базу 1С (или из нескольких баз SH в несколько баз 1С), необходимо создать несколько отдельных каталогов, с отдельными наборами файлов SHto1C.epf, keys.num, settings.ini для каждого отдельного соединения. Пример:
\SH4\1C\SH4_Base1\
  SHto1C.epf
  keys.num:
        Документы: sh1
  settings.ini

 - первый экземпляр. 

\SH4\1C\SH4_Base2\
  SHto1C.epf
  keys.num:
        Документы: sh2
  settings.ini

 - второй экземпляр и т.д. 

Важно! Если, выгрузку необходимо обновить, то файлы keys.num и settings.ini должны быть сохранены, т.е. обновляется только sh4book.dll и epf-файл!

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

Библиотека SH4book.dll защищена ключем Gurdant. Для использования выгрузки нужно получить физический ключ. На сервере лицензирования лицензия называется R-Keeper модуль Выгрузка из SHV4 в 1CV8 ПО.

Обработка будет запускаться и работать только компьютере, к которому подключен лицензионный ключ. 

Изменения в установке обработки для 1С, редакция 3.0

  1. С версии обработки 6.08 для 1С редакции 3.0, файлы keys.num и settings.ini более не требуются. Как уже писалось выше, в одну базу 1С можно выгружать данные из нескольких баз SH4 (по организациям).
  2. Для каждой базы SH будут созданы и сохранены отдельные настройки, что позволит избежать "перезатирания" данных. Для этих целей при первом запуске загрузки в базах (и 1C и SH4) прописываются дополнительные реквизиты сопоставления.
  3. Так как необходимо вносить изменения в настройки 1С, то предварительно нужно включить разрешение на изменение параметров:
  4. далее:
  5. Выставьте флаг и нажмите [ОК] для сохранения настроек 1С. В открывшемся окне введите код базы SH, который будет использоваться в дальнейшем для синхронизации баз данных SH и 1С. Код может содержать как буквы так и цифры (описывалось выше при пояснении назначения файла keys.num). 
    Примечание: указываемый код базы в этом поле - не более двух символов!
  6. Нажмите [Сохранить] для сохранения введенных настроек. Для отказа от сохранения настроек нажмите [Закрыть без сохранения]:

Важно! Если в дальнейшем будет использоваться обрезание базы данных SH (любым способом) - после КАЖДОЙ обрезки необходимо в SH ЗАЧИСТИТЬ старый "код базы" 1С ("Сервис"\"Собственные реквизиты"), а в настройках "1С" прописать НОВЫЙ код 1С. Иначе произойдет РАССИНХРОНИЗАЦИЯ баз данных! Подробнее в статье об обрезке БД SH здесь - http://support.ucs.ru/ru/node/6701.

  • После сохранения данных настроек в базе SH будет создан "Дополнительный атрибут корреспондентов". И в пункте "Сервис"\"Собственные реквизиты" будет определен код для сопоставления элементов:

- а так же:

Важно! Атрибут создается только для собственных реквизитов, в отличие от предыдущих версий выгрузки данных (атрибут создавался для словарей). Данный код будет определяющим для связи баз Store House и 1С. Если данный код будет удален из базы Store House, синхронизацию нужно будет провести заново.

  • Следующим шагом, необходимо сопоставить валюты.
  • Выберите валюту из базы 1С, сопоставив ее с валютой SH4.
  • Для сохранения внесенных изменений нажмите кнопку [Сохранить и закрыть]. 
  • Если необходимо отказаться от сохранения внесенных настроек, нажмите кнопку [Закрыть без сохранения]:

  • Остальные настройки выполняется самим пользователем, согласно прилагаемому руководству пользователя.

Примечание: если при попытке работы с выгрузкой появляется сообщение:

То необходимо отключить запрет открытия модальных окон в настройках самой 1С.

Интеграция с ЕГАИС

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

Документ содержит общую техническую информацию и информацию по установке и настройке ПО, пользовательская документация по модулю "Алкогольная декларации" доступна на FTP ftp://ftp.ucs.ru/books/alc_declaration_user_manual.pdf

ЕГАИС - Единая государственная автоматизированная информационная система учета объема производства и оборота этилового спирта, алкогольной и спиртсодержащей продукции. Система предназначена для осуществления государственного контроля за рынком алкогольной продукции на территории РФ.

Для розничной торговли внедрение системы разбито на два этапа:

  • с 01.01.2016 требуется обеспечить подтверждение закупок алкогольной продукции через ЕГАИС
  • с 01.07.2016 требуется подтверждение факта розничной продажи каждой единицы алкогольной продукции

Исключение составляет торговля пивом и общепит - эти сферы ограничиваются только подтверждением закупок.

На предприятиях общественного питания алкоголь может быть реализован только на розлив (реализация алкоголя в закрытой таре на вынос является нарушением), т.е. розничной продажи алкоголя в предприятиях общепита нет и подтверждать требуется только факт закупки.

ПО StoreHouse v4 было доработано для возможности работы с системой ЕГАИС начиная с версии 4.101.332. Основное приложение в составе StoreHouse v4 для взаимодействия с системой ЕГАИС - Sh4decl.exe ("Алкогольная декларация")

Функции, реализованные в StoreHouse v4 в рамках взаимодействия с ЕГАИС:

  • получение списка документов с сервера ЕГАИС
  • сопоставление справочников ЕГАИС со справочниками StoreHouse v4

Используемые термины

ФСРАР

Федеральная служба по регулированию алкогольного рынка РФ, Росалкогольрегулирование - http://fsrar.ru

PKI

Public Key Infrastructure - инфраструктура открытых ключей в криптографии, набор средств (технических, материальных, людских и т. д.), распределённых служб и компонентов, в совокупности используемых для поддержки криптозадач на основе закрытого и открытого ключей; система, позволяющая удостоверится, что открытый ключ принадлежит именно тому лицу, за которое оно себя выдаёт - использует для этого центры сертификации (Certificate Authority , CA)

RSA

Криптографический алгоритм асимметричного шифрования (asymmetric cipher) с открытыми ключами, основывающийся на вычислительной сложности задачи факторизации больших целых чисел. Назван по фамилиям авторов: Rivest - Shamir - Adleman (Рон Райвест, Ади Шамир и Леонард Адлеман), разработавших эту схему шифрования в 1978 г. Криптосистема RSAi стала первой системой, пригодной и для шифрования, и для цифровой подписи. Алгоритм используется в большом числе криптографических приложений, включая PGP, S/MIME, TLS/SSL, IPSEC/IKE и других.

JaCarta PKI/ГОСТ/SE

JaCarta - производное от названия современной смарт-карточной технологии Java Card, собственная разработка российской компании "Аладдин Р.Д." http://www.aladdin-rd.ru

Специальное устройство с защищенным микропроцессором и операционной системой, контролирующей устройство, доступ к оперативной и долговременной памяти. Устройство одновременно является сертифицированным средством ЭП и средством доступа к защищаемым информационнымресурсам специализированных систем (в данном случае — ЕГАИС), а также является защищенным хранилищем ключей программных средств криптографической защиты информации (далее – СКЗИ) в целом и средств ЭП в частности.

JaCarta включает в себя: средства аутентификации и ЭП: смарт-карты, модули (чипы) для производства смарт-карт, USB-, MicroUSB- и Secure MicroSD-токеныс встроенным в них чипом смарт-карты, SIM-карты с ЭП "на борту".

Полный FAQ по устройствам JaCarta на оф. сайте производителя http://www.aladdin-rd.ru/catalog/jacarta/faq.php?sphrase_id=584925

УТМ

Универсальный транспортный модуль - программное обеспечение, устанавливаемое на рабочее место для взаимодействия с сервером ЕГАИС; предоставляется бесплатно в личном кабинете ЕГАИС.

КЭП

Квалифицированная электронная подпись - усиленная квалифицированная электронная подпись, выданная в Удостоверяющем Центре ОАО «ИнфоТеКС Интернет Траст», которая предназначена для юридически значимой подписи документов передаваемых от УТМ на сервер ЕГАИС.

КЭП в УЦ "ИИТ" генерируется сразу на носитель (секция ГОСТ) на устройстве «JaCarta PKI/ГОСТ/SE» и не может быть извлечена/скопирована.

FSRAR_ID

Идентификатор организации в ФСРАР.

FSRAR_ID представлен в качестве значения реквизита «CN» RSA-сертификата на аппаратном носителе JaCarta. Чтобы узнать свой FSRAR_ID, подключите к ПК носитель с КЭП, откройте утилиту для работы с аппаратными носителями и перейдите во вкладку «Ключи и сертификаты» - при этом потребуется ввести пароль пользователя RSA-ключа.

КПП

Код причины постановки на учет.

Для организаций в дополнение к ИНН в связи с постановкой на учет в налоговых органах по основаниям, предусмотренным Налоговым кодексом Российской Федерации, присваивается код причины постановки на учет (КПП).

Структура КПП представляет собой девятизначный код: NNNNPPXXX.

Схема взаимодействия

Рис. Схема взаимодействия StoreHouse v4 и ЕГАИС

Крипто-ключ JaCarta PKI/ГОСТ/SE

Крипто-ключ JaCarta PKI/ГОСТ/SE содержит две секции:

  • PKI - секция для хранения транспортного ключа с RSA сертификатом, который предназначен для защиты соединения между автоматизированным рабочим местом с программным обеспечением УТМ - RSA сертификат выдается непосредственно в личном кабинете ЕГАИС
  • ГОСТ - секция для хранения сгенерированой усиленной квалифицированной электронной подписи (далее – КЭП), которая предназначена для юридически значимой подписи документов, передаваемых от УТМ на сервер ЕГАИС

Как правило, КЭП выдается при покупке крипто-ключа в любом сертифицированном Удостоверяющем Центре. 

Важно: Генереция RSA-сертификатов (секция PKI) выполняется только после получения и записи КЭП (секция ГОСТ) в крипто-ключ

Примечание: Если при покупке крипто-ключа сразу не получена КЭП  на время настройки и проверки можно использовать тестовую КЭП http://egais.ru/testkey/innkpp

Установка единого клиента JaCarta 

Крипто-ключ JaCarta содержит в себе два хранилища PKI и ГОСТ - для работы с каждым из них требуется свое ПО, которое можно скачать и установить по отдельности, но удобнее использовать Единый Клиент, который объединяет все необходимые инструменты.

Загрузить дистрибутив Единого Клиента JaCarta можно с оф. сайта прозводителя крипто-ключей http://www.aladdin-rd.ru/support/downloads/jacarta/

Рис. Страница загрузки единого клиента JaCarta на оф. сайте http://www.aladdin-rd.ru/support/downloads/jacarta/

Для установки Единого Клиента JaCarta на компьютере должна быть установлена одна из нижеперечисленных операционных систем:

  • Windows 10 (32/64-бит)
  • Windows 8.1 (32/64-бит)
  • Windows 8 (32/64-бит)
  • Windows 7 (32/64-бит)
  • Windows Vista SP2 (32/64-бит)
  • Windows XP SP3
  • Windows Server 2012 R2
  • Windows Server 2012 (64-бит)
  • Windows Server 2008 R2
  • Windows Server 2008 (32/64-бит)

Важно: Единый Клиент JaCarta версии 2.7 НЕ ПОДДЕРЖИВАЕТ работу с Microsoft Windows 10. Для работы с токенами JaCarta в Microsoft Windows 10 необходимо использовать версию Единого Клиента JaCarta 2.8

Установка Единого Клиента производится стандартным образом. После окончания мастера установки подключаем к компьютеру крипто-ключ JaCarta - система обнаружит новое устройство и установит драйвера ключа.

После установки Единого Клиента JaCarta в системе будет доступна сервисная утилита для проверки крипто-ключа:

  • на закладке "Информация о токене" отображается техническая информация о крипто-ключе:

  • на закладке "PKI" отображается информация об установленном RSA-сертификате (ФСРАР ИД):

Примечание: На только что приобретенных крипто-ключах отсутствуют RSA-сертификаты (секция PKI)

  • на закладке "ГОСТ" отображается информация об установленной КЭП:

Примечание: Если после запуска сервисной утилиты "Единый клиент JaCarta" не отображаются закладки, необходимо в левом нижнем углу выбрать опцию "Переключиться в режим администрирования"

Генерация RSA-сертификата

Дальнейшим шагом после получения КЭП, следует выполнить генерацию сертификатов для торговых точек.

Для этого перейдите на страницу https://service.egais.ru/checksystem и нажмите кнопку Ознакомиться с условиями и проверить их выполнение, появится страничка проверки системных требований. К сожалению, другого пути в личный кабинет нет и через проверку придется проходить каждый раз, благо посещать его нужно не столь часто.

Универсальный транспортный модуль (УТМ)

Основным модулем системы ЕГАИС на предприятии является Универсальный транспортный модуль  (далее УТМ)

Назначение модуля УТМ - обеспечить прием и передачу данных между сервером ЕГАИС и системой StoreHouse.

Примечание: Модуль УТМ может использоваться с любым другим учетным ПО на предприятии совместно с системой StoreHouse.

Для подтверждения достоверности передаваемых данных и обеспечения безопасности канала связи применяется токен JaCarta, который содержит квалифицированную электронную подпись (КЭП) и RSA-сертификат для обеспечения безопасного канала связи.

УТМ является сетевым сервисом и работает с любыми поддерживающими его приложениями по протоколу TCP/IP - это позволяет разместить транспортный модуль на любом ПК в пределаз локальной сети.

Важно: Существует законодательно закрепленное требование к физическому расположению УТМ в месте реализации, поэтому варианты с удаленным доступом к УТМ (например, через VPN) следует исключить.

Алкогольная декларация (Sh4Decl)

Установка и настройка алкогольной декларации http://support.ucs.ru/ru/node/8608

Решение проблем

Проблема: SH4Decl выдаёт ошибку: GridDS: Record not found. 

Решение: Обновиться на актуальную версию. 

Настройка печатных форм

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

Система StoreHouse v4 поставляется с предустановленным набором печатных форм, содержание которых в большинстве случае соотв. унифицированным формам, утвержденным Федеральной службой государственной статистики

Некоторые положения, которыми следует руководствоваться в вопросах, связанных с печатными формами:

  • в стандартном дистрибутиве ПО StoreHouse v4 все формы поставляются на русском языке
  • разработка и/или модификация печатных форм выполняется с помощью встроенного в StoreHouse v4 дизайнера отчетов Fast Reports
  • Fast Reports является независимой сторонней разработкой - компания ЮСИЭС обладает лицензией на право распространения встроенных компонентов Fast Reports в своих программных продуктах
  • компания Fast Reports Inc обладает собственной службой поддержки https://www.fast-report.com/ru/support/
  • разработка и/или модификация печатных форм компанией ЮСИЭС возможна после формирования подробного ТЗ (включая предполагаемый внешний вид отчета) и согласования работ с коммерческим отделом
  • допускается разработка и/или модификация печатных форм Дилером или Заказчиком
  • любая модификация печатных форм Дилером или Заказчиком снимает ответственность с компании ЮСИЭС за работоспособность форм
  • техническая поддержка по вопросам разработки и/или модификации печатных форм со стороны компании ЮСИЭС ограничена

Печатные формы

Файлы макетов печатных форм хранятся в подкаталоге клиентской части \SH4\RPT  - все макеты имеют расширение *.FRF и созданы с помощью дизайнера отчетов Fast Reports.

Сопоставление макетов печатных форм и соответствующих им отчетов или типов документов хранится в файле \SH4\SH.RPT

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

Примечание: Понятие "отчет" применяется не только к отчетам в меню "Отчеты", но и к некоторым словарям системы - например, при просмотре "Словари" ⇒ "Валюты" ⇒ "Список валют" доступен отчет "Список валют"

Пример вариантов печатных форм для типа документа "Приходная накладная" (версия StoreHouse 4.99.315):

  • Товарная накладная ТОРГ-12
  • Приходная накладная
  • Требование-накладная М11
  • Приходный ордер M4
  • Закупочный акт ОП5

Пример вариантов печатных форм для отчета "Ведомость остатотков" (версия StoreHouse 4.99.315):

  • Ведомость остатков
  • Бланк инвентаризации
  • Даты сертификатов
  • ведомость остатков с ценой
  • Ведомость остатков ОП16

Структура файла SH.RPT

Стуктура файла \SH4\SH.RPT идентична структуре стандартного INI-файла и состоит из секций, внутри которых определены пары <НазваниеПараметра>=<ЗначениеПараметра>:

Название секции соответствует определенному типу документа или отчету - например, секция [eDoc0] относится к типу документа "Расходная накладная", а секция [rGsRemns] к отчету "Ведомость отстатков":

.....

[fCurrencies]
d_0=Список валют

[eDoc0]
TORG12=Товарная накладная ТОРГ-12
DOC_0=Приходная накладная
M11=Требование-накладная М11
M4=Приходный ордер M4
DOC_0_OP5=Закупочный акт ОП5

.....

[rGsRemns]
REP_0=Ведомость остатков
BLANK=Бланк инвентаризации
REP_0_3=Даты сертификатов
REP_0_2=ведомость остатков с ценой
REP_0_OP16=Ведомость остатков ОП16

.....

В качестве значения <НазваниеПараметра> указывается имя файла макета печатной формы без расширения.

Например, форме "Товарная накладная ТОРГ-12" типа документа "Расходная накладная" соотв. файл печатной формы \SH4\RPT\TORG12.FRF:

[eDoc0]
TORG12=Товарная накладная ТОРГ-12

Включение дизайнера отчетов

Для использования встроенного дизайнера отчетов Fast Reports необходимо с помощью приложения \SH4\SHSetup.exe включить в клиентской конфигурации параметр "Разрешить дизайнер отчетов" :

Создание нового макета

Для создания нового макета печатной формы необходимо:

  • в клиентском приложеним Sh.exe открыть любой отчет или документ либо вызвать форму создания нового документа любого типа
  • перейти в меню "Файл" ⇒ "Дизайнер отчетов..."
  • в окне "Дизайнер отчетов " выбрать операцию "Новый отчет":

Рис. Создание новой печатной формы 

Далее запускается стандартный дизайнер отчетов Fast Reports с пустым макетом:

 

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

Модификация существующего макета

Для модификации существущего макета печатной формы необходимо:

  • в клиентском приложеним Sh.exe открыть отчет или документ, для которого необходимо модифицировать печатную форму
  • перейти в меню "Файл" ⇒ "Дизайнер отчетов..."
  • выбрать в списке форму для модификации и выбрать операцию "Редактировать":

Рис. Редактирование существующей печатной формы для типа документа "Приходная накладная"

  • подвердить запрос на редактирвоание "Начать редактирование существующего отчета?"

Далее запускается стандартный дизайнер отчетов Fast Reports с выбранным для редактирования макетом:

Есть два варианта сохранения модифицированного макета::

  • если сохранить изменения в оригинальный макет (операция в дизайнере File ⇒ Save), они будут доступны сразу после сохранения - такая операция приведет к перезаписи стандартного макета, поставляемого в дистибутиве
  • если сохранить модифицированный макет в новый файл (операция в дизайнере File ⇒ Save as...), для его использования необходимо выполнить подключение печатной формы

Подключение печатной формы

Новый или модифициованный макет можно использовать в качестве дополнительной печатной формы для существующего отчета или типа документа.

Для подключения печатной формы необходимо:

  • скопировать файл макета в директорию \SH4\RPT
  • открыть в любом текстовом редакторе файл  \SH4\SH.RPT
  • найти секцию, соотв. отчету или типу документа
  • прописать в секции параметр <ИмяФайлаМакетаБезРасширения>=<НаименованиеПечатнойФормы>

Например, был модицирован стандартный макет "Товарная накладная ТОРГ-12" для типа документа "Приходная накладная" и сохранен в виде файла TORG12_MOD1.FRF (файл стандартного макета называется TORG12.FRF).

В файле  \SH4\SH.RPT находим секцию [eDoc0], которая соотв. типу документа "Приходная накладная":

[eDoc0]
TORG12=Товарная накладная ТОРГ-12
DOC_0=Приходная накладная
...

Подключаем новый макет:

[eDoc0]
TORG12=Товарная накладная ТОРГ-12
DOC_0=Приходная накладная
...
TORG12_MOD1= Товарная накладная ТОРГ-12 (МОДИФИЦ.)

где

  • TORG12_MOD1 - имя файла макета без расширения
  • Товарная накладная ТОРГ-12 (МОДИФИЦ.) - пример названия формы отчета, которое будет отображаться в списке
  • сохранить файл \SH4\SH.RPT, перезапустить Sh.exe и проверить доступность новой формы:

Ограничения

При создании/модификации печатных форм следует учитывать следующие ограничения:

  • в редакторе Fast Reports существует ограничение на максимальное значение числовой части номера документа - 2147483647

Дизайнер отчетов Fast Reports

Как отмечалось выше, дизайнер (генератор) отчетов Fast Reports является сторонней разработкой компании Fast Reports Inc.

Подробная документация по работе с элементами и объетками дизайнера Fast Reports доступна на оф. сайте https://www.fast-report.com/ru/download/documentation/ , также на сайте представлена документация для разработчиков.

В частности, руководство пользователя по дизайнеру FastReports VCL (генератор отчетов для Delphi), который используется в StoreHouse v4, доступно по ссылке  https://www.fast-report.com/public_download/html/FR5UserManual-HTML-ru/index.html

Для информации по данным StoreHouse v4, используемых в макетах, следует обратить внимание на следующие документы:

Установка модуля Алкогольная декларация

Вводная информация

В качестве дополнительного программного обеспечения расширяющего возможности ПО "Store House v4" может быть настроен и задействован модуль "Алкогольная декларация" (Sh4decl.exe) позволяющий предоставлять отчеты по алкогольной продукции в Федеральную службу по регулированию алкогольного рынка (Росалкогольрегулирование).

Данное приложение актуально в первую очередь для Москвы и Московской области. Остальные регионы при подаче отчетов в региональные филиалы "Росалкогольрегулирования" могут воспользоваться приложением только в том случае, если формируемый в программе Отчет - по форме отчета и по набору данных подходит для предоставления в своем регионе.

На рабочем объекте должен быть установлено и запущено ПО "Store House v4". Установка Sh4decl.exe производиться непосредственно в клиент \SH4 на той клиентской машине, на которой будут пользоваться "Алкогольной декларацией".

Примечание: необходимо учесть, что при работе в модуле "Алкогольная декларация" (Sh4decl.exe) будет задействована лицензия из ключа SH4 (так же как если бы был запущен клиент SH4).

Версии

Для работы с модулем "Алкогольная декларация" рекоммендуется использовать SH v.4.92 и выше. Иначе в базе SH могут отсутствовать необходимые процедуры, корреспонденты и прочее. Таким образом, перед установкой и использованием декларации, может потребоваться апгрейд SH4 до актуальных версий.

Установка и настройка - Sh4decl.exe

  1. Скачать в отдельный каталог с фтп актуальный архив дистрибутива ПО, например, отсюда - ftp://ftp.ucs.ru/storehouse/sh4/sh4_Alc_Declaration/:
  • shdecl_4_61_85_New_client.zip - слово в названии "New" - версия дистрибутива для огранизаций ранее не сдававших алкогольную декларацию средствами SH4.
  • shdecl_4_61_85_Work_client.zip - слово в названии "Work" - версия дистрибутива для организаций уже сдававших декларацию средствами SH4. Ее актуально использовать например, при апгрейде модуля Sh4decl.exe на новые версии.

Примечание: также, с фтп можно скачать файл codes.txt - содержащий установленное законом соответствие кодов алкогольной продукции, которые в дальнейшем необходимо будет занести в SH4 для работы с декларацией. 

  1. Распаковать содержимое в каталог с установленным клиентом SH4 (обычно это каталог - \UCS\SH4).

Содержимое архива:

  • \RPT - содержит печатные формы декларации (должны быть добавлены в общий каталог \SH4\RPT при копировании).
  • Sh4decl.exe - запускной файл модуля "Алкогольная декларация". 
  • SH4DECL.RPT - файл содержащий соответствие задействованных в модуле печатных форм названиям файлов этих форм.
  • Ver4_decl.txt - информация о версионности.
  • sh4decl_hdr.xml - содержится только в дистрибутиве с префиксом "New", т.к. содержит в себе параметры организации по-умолчанию которые, в дальнейшем будут отредактированы при настройке и работе.
  • Алкогольная декларация.doc - пользовательская документация по работе с модулем. Так же, содержится и в пользовательской документации SH4, например здесь - https://docs.ucs.ru/uploads/alc_declaration_user_manual.pdf
  1. В папку с ярлыками SH4 добавить ярлык приложения Sh4decl.exe, дать название - "Алк.Декларация".
  2. Выполнить предварительные операции в SH4 прежде чем начать работу в модуле Sh4decl.exe. Все подробно описано в пользовательской документации, см. - Алкогольная декларация.doc или storehouse_v4_user_manual.pdf.
  3. Запустить приложение, проверить подключение к базе SH. Для подключения к базе SH используются параметры настроенные в ShSetup.exe. То есть, если Sh.exe подключается к базе, то и Sh4decl.exe будет подключаться.

 

Использование Sh4decl с несколькими базами SH

В истории изменений (Ver4_decl.txt) есть след. информация:
 
  • 4.42.52  Имя файла настроек для алк.декларации берется из реестра   'HKLM\Software\UCS\SHTrans\'+cServName, строковый параметр HdrFile , если записи в реестре нет , то имя файла sh4decl_hdr.xml
  • Соотв, в каждом разделе HKLM\Software\UCS\SHTrans\'+cServName надо создать строковую переменную HdrFile и присвоить ей значение, соотв. наименованию файла с параметрами организации.

Вариант 1

  1. Пусть наш сервер называется SDBSERV1 и файл с параметрами компании, соотв. данному серверу, называется sh4decl_sdbserv1.xml
  2. Создать в разделе HKLM\Software\UCS\SHTrans\SDBSERV1 строковую переменную HdrFile и присвоить ей значение sh4decl_sdbserv1.xml
  • Таким образом, при запуске Sh4decl.exe и выборе сервера SDBSERV1 будут автоматически загружены параметры из файла sh4decl_sdbserv1.xml
  • В качестве шаблона параметров используется файл sh4decl_hdr.xml, который идет в дистрибутиве с алк. декларацией.
  1. Содержимое sh4decl_hdr.xml для каждой организации можно отредактировать вручную заполнив нужные тэги, которые должны соответствовать реквизитам из используемой базы SH. Структура xml-файла не сложная:
<?xml version="1.0" encoding="windows-1251"?>
<Файл>
    <gFileName cbBeer="false" cRepDate="06.12.2012" eVersForm="4.20" eGUID="" eTotal="R1__03_06122012_"/>
    <gReport eNomForm="11-о" cbMQ="0" cbPrisFOtch="0" eGodPeriodOtch="" cbFormaOtch="0" eNomerCorr="0"/>
    <gOrgParams eNaimUL="" eINNUL="" eKPPUL="" eTelORG="" eEMailOtpr="" cbUL="Юридическое лицо">
        <Address eKodStrany="" eKodRegiona="" eIndex="" eRayon="" eGorod="" eNaselPunkt="" eUlica="" eDom="" eKorpus="" eLitera="" eKvart=""/>
        <gPers eRukF="" eRukI="" eRukO="" eBucF="" eBucI="" eBucO=""/>
        <Lics/>
        <Departs/>
    </gOrgParams>
    <gDepRep StartDate="01.12.2012" StopDate="" cbDeparts="-1"/>
</Файл>

Вариант 2

Если ручное заполнение не устраивает, можно действовать по следующему сценарию:
  1. Скопировать чистый sh4decl_hdr.xml в директорию с Sh4decl.exe.
  2. В реестре для серверов не прописываем переменную HdrFile, чтобы использовался файл по-умолчанию sh4decl_hdr.xml.
  3. Запустить Sh4decl.exe, подключиться к первому серверу.
  4. Открыть вкладку Отчеты \ Алкогольная декларация, перейти на закладку "Организация" и заполнить все реквизиты (либо выбрать реквизиты из справочника SH4).
  5. Сохранить реквизиты (на панели задач иконка в виде "бочки")
  6. Закрыть Sh4decl.exe и переименовать sh4decl_hdr.xml в sh4decl_organization1.xml (пример)
  7. Далее, зайти в реестр и выполить для первого сервера и файла sh4decl_organization1.xml процедуру, описанную выше.
  8. Сопировать чистый sh4decl_hdr.xml в директорию с Sh4decl.exe и повторяем все действия для следующего сервера.
 

Дополнительные ключи запуска

Ключ "S"

 
При запуске Sh4decl.exe с ключем S (Sh4decl.exe<пробел>S) появляется возможность создавать возврат на неподтвержденной накладной ЕГАИС (при этом накладная в SH4 должна быть активна).

Установка модуля Оператор производства

Введение

Пользовательский мануал ftp://ftpint.ucs.ru/books/Operator_proizvodstva_user_manual.pdf

Дистрибутив лежит в папке на фтп ftp://ftp.ucs.ru/storehouse/sh4/opr/.

Касса используется соответственно для печати наклеек, отчетов при закрытии смены. При закрытии смены данные о проведенной инвентаризации (если осуществляли) и проданных товарах OPR_SH4.exe передает в SH4.

Пошаговая настройка

1. Настройка Сервера весов

Для работы весов необходим сервер весов, при чем для каждого типа весов он уникальный (ftp://ftp.ucs.ru/rk7/other/labelprint/ScaleServer/ ).

Для запуска сервера необходимо использовать параметры: 

/desktop - для запуска в качестве десктопного приложения;

/install - для установки в качестве службы

Рис. Настройка Сервера весов

Для конфигурации сервера его необходимо запустить с парметром /desktop и прописать номер COM-порта, к которому подключены весы и свободный HTTP порт.

2. Настройка связи с сервером SH4 в приложении OPR_SH4Settings.exe

Примечание: рекомендуется зарегистрировать Sh4Ole.dll в операционной системе до начала настройки.

Запустить OPR_SH4Settings.exe и прописать IP, Port, имя пользователя и пароль для подключения к серверу SH4.

Рис. Параметры для подключения к серверу StoreHouse

Нажать кнопку Далее и в открывшемся окне сделать следующее:

  • выбрать место реализации;

  • выбрать корневую ветку товаров, которые будут использоваться в OPR-Board;  

  • в зоне «Склад по-умолчанию» выбрать склад, который по-умолчанию будет использоваться при создании накладных;

  • в зоне «Весовая единица измерений»  указать единицу измерений, в  которой будут поступать данные с весов.

  • в том случае, если импорт товаров без штрих-кода не нужен, выставить галочку «Запретить импорт товаров без штрих-кода»;

  • указать адрес сервера весов и коэффициент взвешивания;

Важно: для определенного типа весов используется свой сервер весов - ScaleServer.exe, в настройках которого прописывается номер COM-порта и HTTP порт.

Параметр HTTP Сервер весов может иметь вид http://127.0.0.1:27722 в зависимости от настроек сервера весов.

  • Выбрать принтер для печати этикеток и для печати отчетов (доступно для версий 42 и выше);
  • нажать кнопку «Завершить».

Рис. Дополнительные параметры OPR_SH4Settings.exe

3. Настройка OPRBoard.ini

Внести изменения в файл, прописав правильные настройки
 
[Server]
;URL сервера
IP=http://127.0.0.1/OPRBoard/api/
;код объекта (может использоваться в макете этикеток)
ObjectCode=199990053
;номер терминала (необходим для сопоставления цен и баркодов (см.п. 3.7))
TerminalNum=01
;Порт принтера отчетов
COMport=COM1
;Порт сканера штрих кода
ScannerCOM=COM2
 
[Proxy]
;прокси сервер
Server=127.0.0.1
;порт прокси
Port=7799
;имя пользователя
UserName=asdf
;пароль
Password=ss
;использовать прокси (1 - да/0-нет)
Useproxy=0
;1 - да
BasicAuthentication=1
 
[Graphic]
;размер шрифта для плиток
DishFontsize=8
 
[Main]
;Оставить без изменений. Это означает, что OPR-Board будет работать напрямую со складом
DirectServerMode=1

4. Настройка атрибутов в SH.exe

4.1. В справочнике Сервис - классификаторы объектов создать новый классификатор с параметрами:

Наименование = Роль, Объект = корреспондент

Рис.3 Расположение справочника Классификаторы объектов

Рис.4 Наполнение справочника Классификаторы объектов

4.2. В справочнике Словари - классификаторы - корреспондентов - Роль добавить две роли: Менеджер и Сотрудники.

Рис.3 Расположение справочника Роль

Рис.4 Наполнение справочника Роль

4.3. В справочнике «Сервис - Дополнительные атрибуты - Атрибуты корреспондентов» добавить атрибут ПИН КОД(PIN) для корреспондентов.

Рис. 5 Расположение справочника Атрибуты корреспондентов

Рис.6 Наполнение справочника Атрибуты корреспондентов

4.4. Добавить сотрудников (как физических лиц) в справочник Словари - Корреспонденты - Список корреспондентов и прописать им Пин код (рис.9), который далее необходимо  будет использовать для входа в приложение OPR-Board.

Рис.7 Расположение справочника Список корреспондентов

Рис.8 Добавление нового корреспондента

Рис. 9 Свойств ПИН КОД сотрудника

4.5. В справочник Сервис - Дополнительные атрибуты - Атрибуты товаров добавить атрибуты для товаров

Рис.10 Расположение справочника Атрибуты товаров

Рис.11 Атрибуты товаров

4.6. Заполнить данные атрибуты у товаров. Штрих коды товаров должны быть уникальные.

Рис.12 Свойства товара

4.7. В справочнике "Словари - Корреспонденты - Места реализации" заполнить места реализации

КОД1 – МАГАЗИН1

КОД2 – МАГАЗИН2

Рис.13 Места реализации

5. Редактирование макета этикетки

Макет лежит в папке с OPR Board и называется sticker.fr3. Список переменных храниться в файле variables.fd3. Файлы можно взять из прикрепленного архива.

Для редактирования можно использовать редактор с ФТП  - ftp://ftp.ucs.ru/rk7/other/labelprint/RK7CashPlugin_old/fr3_editor.exe

Доступен следующий список переменных:

  • SertNo=Номер сертификата качества
  • SertFrom=Начало действия сертификата качества (полная дата и время)
  • SertTo=Окончание действия сертификата качества (полная дата и время)
  • SertDep=Орган сертификации
  • SertKeep=Держатель сертификата
  • KeepPrd=Срок хранения товара (в часах)
  • NDS - НДС (из OPR)
  • Sum - сумма (из OPR)
  • Quantity - количество (из OPR)
  • Packed - имя пользователя, распечатавшего этикетку
  • Price - цена (из SH)
  • DishName - имя товара
  • ObjectName - код объекта (из ini)
  • Text - комментарий
  • Barcode - штрихкод
  • Energy1 - белки
  • Energy2 - жиры
  • Energy3 - углеводы
  • Munit - ед.изм.

6. Работа с кассой (сценарии)

Важно: более актуальную информацию о том как работать с кассой, вы найдете в руководстве пользователя ftp://ftpint.ucs.ru/books/Operator_proizvodstva_user_manual.pdf.

6.1. Начало работы

Включить систему. После запуска ОС выводится окно логина. Система ожидает авторизации пользователя OPRBoard.

6.2. Вход в систему

Требуется ввести ПИН, пин должен быть уникален. Если пин есть в системе - по нему определяется сотрудник и его тип.

Тип сотрудника определяется ролью и определяет уровень прав.

-Простые сотрудники могут выполнить печать этикетки, отменить последнюю операцию, провести инвентаризацию. После логина попадает в список товаров.

-Привилегированные сотрудники - могут закрывать смену и печатать документ сверки. После логина попадает в список операций. Смена открывается в момент первого логина. Дата смены берется по открытию.

6.3. Печать этикеток

В режиме печати этикеток при нажатии на товар (на тач-скрине) печатается этикетка. Есть возможность отменить 1 последнюю операцию кнопкой “отмена последней операции”.

6.4. Инвентаризация

При инвентаризации - сканером ШК считываются штрихкоды оставшихся товаров и вносятся в документ “остатки”. 1 считанный код добавляет 1 единицу товара. Есть возможность отменить 1 последнюю операцию кнопкой “отмена последней операции”. Считанный товар подсвечивается, если он есть в списке или добавляется в него.

6.5. Отмена последней операции

6.5.1. При печати этикеток

Если товар был выбран неверно или при печати произошел брак - операцию можно отменить. При этом сменный счетчик товара декрементируется

6.5.2. При инвентаризации

Если товар был выбран неверно или отсканирован ошибочно - операцию можно отменить. При этом количество товара в инвентаризации уменьшается на 1.

6.6. Генерация отчета

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

Пример отчета:

         Отчет по продажам

дата:                   01.01.2015

объект:               Магазин 1

оператор:           Василий Н. К.

товар                               кол-во

набор товаров №1              123

набор товаров №2                  3

булка с маком                        23

сок апельсиновый                 12

пряник тульский                  234

печать:           01.01.2015 32:50

6.7. Закрытие смены (передача данных в SH4)

Делаются копии всех документов “произведенная продукция” и “остатки”, выполняется попытка их передачи на сервер. Выводится сообщение “смена закрыта”.

ВложениеРазмер
sticker.rar1.04 МБ