Импорт данных из R-keeper

Инструкция предназначена для ресторанов с системой автоматизации не ниже R-KEEPER 7 и STORE HOUSE 4

Общие сведения и требования

Импорт данных из системы R-Keeper осуществляется с помощью скриптов командной строки Windows и вспомогательных программ для подключения к базе данных, архивирования и отправки данных по протоколу https.

Требования:

у скриптов должен быть доступ в SQL базу данных, можно только на чтение;
в пути к скриптам не должно быть кириллицы;
для импорта себестоимости на сервере должен быть установлен PowerShell версии 3.0 и выше;
для импорта себестоимости из Store House 4/5 должен быть пользователь с правами на получение актов реализации, имя обязательно на латинице;
для Store House 5 должен быть установлен API.

1 Этап - Развертывание ПО и настройка

Ссылка на актуальную версию архива с ПО для импорта: https://mozg.rest/mozg_import_keeper.zip

В архиве находится папка mozg_import с набором скриптов.
Распакуйте папку на диск C:\ любого из компьютеров при условии наличия на компьютере sqlcmd и подключения к SQL-серверу.

В файле variables.ini пропишите параметры:

sqlcmd= путь к программе sqlcmd (устанавливается вместе с SQL-сервером).
ps= путь к исполняемому файлу powershell.
serv=адрес и порт SQL сервера. Если ПО расположено на самом сервере, то можно указать просто .\имя экземпляра (по умолчанию 127.0.0.1:1433)
user=логин для доступа к базе SQL. Обязательно пользователь SQL, не Windows.
pass=пароль для доступа к базе SQL
db=имя базы данных SQL сервера
sh4ip= ip адрес сервера SH4
sh4port= порт нужной базы
sh4user= пользователь для входа
sh4pass= пароль пользователя SH4
sh4usegroups= использование групп меню при сопоставлении позиций между SH4 и RK. Ставить 0, если иначе данные не выгружаются.
sh4special= ведется ли в SH4 спецучет
sh5addr= адрес и порт api сервера SH5
sh5user= пользователь для подключения к api
sh5pass= пароль пользователя
sh5nds= учитывать при импорте НДС
sh5orgid=ID организации в SH5, из которой будет выгружаться с\с. Можно просмотреть список запустив imp_cost_sh5_orgs.bat

orgid= id организации в системе Мозг. Смотреть в mozg.rest- Настройки – Импорт данных
impkey= ключ для импорта, смотреть в mozg.rest
dbid= id базы данных, смотреть в mozg.rest
restid= ID ресторанов, для которых будут выгружены данные по себестоимости. Актуально как при импорте из SH4, так и SH5. Можно просмотреть запустив check_rest.bat

Для каждой отдельной базы данных SQL сервера нужно создавать копию папки mozg_import и в каждой настраивать variables.ini.

ВАЖНО: если для разных БД указать в настройках импорта один и тот же dbid, все ваши данные смешаются и вместо итога по одному филиалу/ресторану вы получите Итого по всем. Для исправления ситуации нужно будет поставить разные dbid во всех variables.ini, удалить все загруженные в Мозг данные и загрузить их заново.

Для проверки настройки подключения к SQL можно запустить check_rest.bat. Если все корректно, то в консоли появится список ресторанов, иначе - ошибка с описанием.

2 Этап - Импорт справочников

ВАЖНО: При первой настройке импорта запустите imp_dict_keeper.bat, чтобы список ресторанов попал в Мозг. После этого в Мозге (Настройки - Рестораны) необходимо поставить галочки в поле “Импорт” у ресторанов, которые планируется выгружать.

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

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

Если у вас нет возможности зайти в Мозг, обратитесь к сотрудникам технической поддержки для настройки списка ресторанов.

3 Этап - Импорт продаж

Для импорта данных о продажах используется скрипт imp_period_keeper.bat. При запуске скрипта укажите период, который необходимо выгрузить. Даты указываются в формате “ГГГГ-ММ-ДД”.

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

Если в предыдущим этапе вы не отметили рестораны на импорт, то данные выгружаться не будут.

Также возможны ошибки входа пользователя sql. Для диагностики вы можете открыть любой из сформированных .csv файлов, либо запустить check_rest.bat

4а Этап - Импорт с\с из SH4

Себестоимость берется из актов реализации через подключение sh4ole.dll. Все необходимые библиотеки идут в комплекте со скриптами. Если импорт настраивается из нескольких баз SH4, то для каждой базы нужно делать отдельную копию папки импорта.

Для импорта используется скрипт imp_cost_sh_period.bat

Перед запуском обязательно нужно зарегистрировать библиотеку sh4ole.dll. Для этого запустите приложение RegOle.exe от имени администратора и нажмите RegisterServer.

При запуске укажите период, за который нужно производить импорт. Так как с\с берется за месяц, то дата в скрипте указываются в формате “ГГГГ-ММ”.

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

Если после импорта данные не появились, а файл cost.csv пустой или отсутствует, то нужно изменить параметры выгрузки, а именно:

sh4usegroups - Если группы меню в RK изменились и отличаются от групп в SH4, то не будет происходить сопоставление. При указании 0 - группы будут проигнорированы. Влияет на производительность.

sh4special - Если все продажи в SH4 ведутся по спецучету, указать 1, иначе 0.

4b Этап - Импорт с\с из SH5

Себестоимость берется из актов реализации через подключения по сети к api сервера SH5. Поэтому для импорта с\с обязательно должно быть установлено api. Если выгружать данные планируется из разных организаций внутри SH5, то их id нужно указать в файле variables.ini через запятую. Список организаций и их id можно просматреть через imp_cost_sh5_orgs.bat. Также если настройки указаны не верно, в консоль будет выведено сообщение об ошибке подключения.

Для импорта используется скрипт imp_cost_sh5_period.bat

4с Этап - Импорт с\с из 1С

По умолчанию Мозг не поддерживает импорт с\с из 1С напрямую, но есть возможность выгрузить данные из 1С в файл .csv в нужном формате и после этого отправить его на сервер.

Если у вас есть необходимость выгружать данные с\с из 1С, то по завершению этапов 1-3 сообщите об этом в техническую поддержку Мозга. Мы предоставим вам набор вспомогательных скриптов и инструкцию для импорта с\с с примерами для вашей организации.

По вопросу формирования .csv файла по данным 1С обратитесь к вашему 1С администратору.

5 Этап - Настройка автоимпорта

Автоимпорт настраивается через планировщик заданий Windows.

В Бибилиотеке планировщика заданий - создать папку Mozg - в ней Создать простую задачу – Имя imp_yest_keeper – Ежедневно – Начать 5:00:00 – Запустить программу – Обзор – mozg_import\auto_import.bat

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

В действиях укажите скрипт для выполнения auto_import.bat. Он выгружает продажи за последние 4 дня и себестоимость за месяц. Для выбора программы, из которой будут выгружаться данные по с\с, откройте скрипт на редактирование и раскомментируйте нужные строки.

Обязательно укажите рабочую папку, иначе при выполнении будет происходить ошибка отсутствия файла (0х1).

В параметрах задачи поставьте отметку “Немедленно запускать задачу, если пропущен плановый запуск”.

Запустите задачу для проверки работоспособности. При корректной работе код выполнения должен быть 0х0.

При возникновении сложностей на любом из этапов настройки, а также по любым другим вопросам, касающимся сервиса Mozg.Rest, вы можете обратится в службу технической поддержки:

Телефон, WhatsApp: +7 (913) 767-18-13

Электронная почта: info@mozg.rest