Импорт данных из iiko

Инструкция предназначена для ресторанов с системой автоматизации IIKO 4.3 и выше.

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

Скрипты импорта предназначены для выгрузки данных в систему Mozg.Rest. Импорт может производится как из RMS, так и из Chain при его наличии. Предпочтителен импорт из Сhain, так как потребуется настройка одного экземпляра скриптов и единая лицензия на API.

Требования:

у скриптов должен быть доступ в SQL базу данных, можно только на чтение;
в пути к скриптам не должно быть кириллицы;
для импорта себестоимости на сервере должен быть установлен PowerShell версии 3.0 и новее;
для импорта себестоимости на сервере iiko обязательно наличие лицензии iiko server api (OLAP) (Платная).

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

Ссылка на актуальную версию архива с ПО для импорта: https://mozg.rest/mozg_import_iiko.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 сервера

iikoaddr=адрес сервера Tomcat iiko (по умолчанию 127.0.0.1:8080)
iikouser=имя пользователя iiko
iikopass=хэш SHA1 пароля пользователя iiko (можно сделать тут sha1-online.com)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

4 Этап - Импорт себестоимости

Себестоимость берется из отчета OLAP по продажам через подключение к iiko api. Поэтому для импорта с\с обязательно наличие лицензии на api сервер iiko. Если импорт настраивается из нескольких RMS, то лицензия должна быть на каждом из них. Если импорт из сервера Chain, то достаточно единственной лицензии на самом сервере.

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

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

Если во время импорта в консоли появляется ошибка, то в первую очередь необходимо проверить файл token.txt. При правильной работе там должен содержатся код доступа к api iiko, в ином случае - текст ошибки подключения.

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

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

В Бибилиотеке планировщика заданий - создать папку Mozg - в ней Создать простую задачу – Имя imp_yest_iiko – Ежедневно – Начать 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