Импорт данных
Как самостоятельно сделать настройки импорта.
- Как подключиться к Мозгу
- Импорт данных из R-keeper
- Импорт данных из iiko
- Техническое описание импорта данных в систему Мозг
Как подключиться к Мозгу
Вся необходимая информация об импорте продаж и с/с в Mozg.Rest для управляющего и ИТ-менеджера ресторана.
Основные принципы работы Мозга
Мозг является облачным сервисом (также есть коробочное решение), он не интегрируется в вашу систему автоматизации и работает отдельно от нее. Данные в Мозг выгружаются периодически, по защищенному каналу. Клиент имеет полный контроль над импортом данных и может быть уверен, что без его разрешения импорта не будет.
Общая информация для ознакомления
- Импорт данных работает полностью на стороне клиента, а не Мозга.
- Автоматический запуск импорта инициируется на ПК клиента через планировщик заданий Windows.
- Постоянный доступ к it-инфраструктуре клиента не требуется, только на время настройки импорта.
- Во время импорта в базе данных клиента выполняются запросы только на чтение, никаких изменений в базе данных не производится.
- Вся механика импорта открыта, исполняемые файлы импорта можно открыть в текстовом редакторе и увидеть все производимые действия.
- Установка ПО для импорта данных в Мозг производится либо на SQL сервере системы автоматизации клиента, либо на ПК, который удовлетворяет следующим требованиям:
- Операционная система Windows 7 x64 или новее,
- Powershell 3.0 или новее,
- Установлена утилита sqlcmd.exe,
- Интернет и доступ до sql сервера по локальной сети.
Подготовка к подключению
На ПК, на котором будет настроен импорт, необходимы:
- Доступ по tcp/ip до SQL сервера;
- ОС Windows 7 x64 или новее;
- Powershell 3.0 или новее;
- Утилита sqlcmd.exe.
Для iiko:
- Доступ по tcp/ip до сервиса TomCat,
- Пользователь iiko с правами на просмотр отчета по продажам,
- Пользователь SQL с правами на чтение базы данных, Windows пользователь не подходит,
- Модуль restApi(2000) для выгрузки себестоимости. Модуль активируется при покупки в iiko лицензии iikoAPI server либо, connector fog Mozg.
Для R-Keeper:
- Пользователь SQL с правами на чтение базы данных. Windows пользователь не подходит,
- Доступ по tcp/ip до сервера StoreHouse 4/5,
- Пользователь StoreHouse с правами на формирование отчетов.
Если учет себестоимости ведется в 1С, специалист 1С со стороны клиента обеспечивает выгрузку себестоимости в файл CSV по предоставленному специалистом Мозга документу с описанием полей.
Этапы подключения к Мозгу
Импорт состоит из следующих этапов:
|
№ |
Этап |
Ответственный |
|
1 |
Предоставление удаленного доступ (например, по teamviewer) к ПК, на котором будет настроен импорт. |
It-специалист клиента |
|
2 |
Установка и настройка файлов импорта |
Специалист Мозга |
|
3 |
Импорт справочников |
Специалист Мозга |
|
4 |
Выбор ресторанов для импорта |
Специалист Мозга |
|
5 |
Импорт продаж за последние 2 года |
Специалист Мозга |
|
6 |
Импорт себестоимостей за последние 2 года |
Специалист Мозга |
|
7 |
Предоставление отчетов по продажам и себестоимостям, либо предоставление доступа в систему автоматизации клиента для сверки выгруженных данных |
Менеджер проекта Мозг со стороны клиента |
|
8 |
Сверка данных |
Специалист Мозга |
|
9 |
Настройка автозапуска импорта |
Специалист Мозга |
По желанию клиента, все пункты, за исключением 8, может выполнить it-специалист ресторана по инструкции при сопровождении поддержки Мозга. Однако, для быстроты запуска и стабильности импорта, мы рекомендуем оставить этот процесс на стороне Мозга.
Импорт данных из 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
Импорт данных из 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
Техническое описание импорта данных в систему Мозг
Вся необходимая информация для разработки собственного импорта данных в систему Мозг из любой системы автоматизации ресторанов.
Общая информация
Данные в систему Мозг отправляются в виде архива с CSV файлами по протоколу HTTPS по адресу https://mozg.rest/import. В случае коробочной версии системы Мозг, вместо https://mozg.rest указывается ip-адрес виртуальной машины.
Для работы импорта необходима активная лицензия.
Перед импортом данных необходимо выгрузить справочник ресторанов и отметить чекбокс "Импорт" у импортируемых ресторанов в настроках Мозга в разделе "Рестораны".
В случае импорта данных из нескольких источников (серверов баз данных) для каждого из них необходимо создать запись в настроках Мозга в разделе "Источники импорта".
Перед импортом файла order.csv из системы Мозг удалятся все заказы, продажи, оплаты и чеки текущего источника импорта, начиная с самой ранней даты в файле order.csv.
Отправка
| HTTP Метод | POST |
|---|---|
| URI | import |
| Result | Сообщение об успешном добавлении архива в очередь импорта или об ошибке. |
Параметры
| Параметр | Тип, формат | Описание |
| orgid | integer |
Идентификатор организации в системе Мозг, находится в настройках системы Мозг в разделе "Импорт данных". |
| dbid | integer | Идентификатор источника импорта в системе Мозг, находится в настройках системы Мозг в разделе "Импорт данных". |
| impkey | string | Ключ импорта, находится в настройках системы Мозг в разделе "Импорт данных". |
| archive | file | Архив arch.tar.gz с файлами csv. |
Описание файлов для импорта
Разделитель значений - ; (точка с запятой).
Символ экранирования - `.
Символ конца строк - \r\n.
Кодировка CP1251.
Файл categ.csv - справочник категорий меню системы автоматизации
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID категории меню системы автоматизации |
| 3 | desc | varchar(255) | Название категории меню системы автоматизации | |
| 4 | sort | integer | Порядок сортировки |
Файл class1.csv - справочник классификаторов системы автоматизации 1
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID классификатора 1 |
| 3 | desc | varchar(50) | Название классификатора 1 | |
| 4 | sort | integer | Порядок сортировки |
Файл class2.csv - справочник классификаторов системы автоматизации 2
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID классификатора 2 |
| 3 | desc | varchar(50) | Название классификатора 2 | |
| 4 | sort | integer | Порядок сортировки |
Файл cost.csv - себестоимость
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | date | Да | char(7) | Год и месяц в формате ГГГГ-ММ |
| 3 | rest_id | Да | varchar(36) | GUID ресторана |
| 4 | item_id | Да | varchar(36) | GUID позиции меню |
| 5 | cost | double | Себестоимость единицы |
Файл cot.csv - справочник типов заказа
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID типа заказа |
| 3 | desc | varchar(50) | Название типа заказа | |
| 4 | status | integer | Статус. 0 - удален, 1 - черновик, 2 - неактивный, 3 - активный |
Файл curr.csv - справочник методов оплат
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID метода оплаты |
| 3 | desc | varchar(50) | Название метода оплаты | |
| 4 | status | integer | Статус. 0 - удален, 1 - черновик, 2 - неактивный, 3 - активный | |
| 5 | crrg_id | integer | Id группы метода оплаты | |
| 6 | active_in_reps | integer | Участие в расчете себестоимости списаний и служебных методов оплат. 0 - нет, 1 - да. |
Файл deliv_addr.csv - справочник адресов доставки
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID адреса |
| 3 | desc | varchar(255) | Адрес | |
| 4 | active | integer | Активность. 0 - нет, 1 - да. | |
| 5 | city_id | varchar(36) | GUID города |
Файл deliv_city.csv - справочник городов доставки
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID города |
| 3 | desc | varchar(255) | Название | |
| 4 | active | integer | Активность. 0 - нет, 1 - да. |
Файл discount.csv - справочник скидок
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID скидки |
| 3 | desc | varchar(50) | Название скидки | |
| 4 | status | integer | Статус. 0 - удален, 1 - черновик, 2 - неактивный, 3 - активный |
Файл empl.csv - справочник сотрудников
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID сотрудника |
| 3 | desc | varchar(50) | Имя сотрудника | |
| 4 | status | integer | Статус. 0 - удален, 1 - черновик, 2 - неактивный, 3 - активный | |
| 5 | rest_id | varchar(36) | GUID ресторана | |
| 6 | code | integer | Код сотрудника | |
| 7 | cardcode | varchar(50) | Табельный номер сотрудника | |
| 8 | role_name | varchar(50) | Название должности сотрудника |
Файл group.csv - справочник групп меню
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID группы меню |
| 3 | desc | varchar(50) | Название группы меню | |
| 4 | status | integer | Статус. 0 - удален, 1 - черновик, 2 - неактивный, 3 - активный | |
| 5 | parent_id | varchar(36) | GUID родительской группы меню | |
| 6 | rest_id | varchar(36) | GUID ресторана |
Файл hall.csv - справочник залов
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID зала |
| 3 | desc | varchar(50) | Название зала | |
| 4 | status | integer | Статус. 0 - удален, 1 - черновик, 2 - неактивный, 3 - активный | |
| 5 | rest_id | varchar(36) | GUID ресторана | |
| 6 | sort | integer | Порядок сортировки | |
| 7 | hllg_id | integer | Id подразделения | |
| 8 | guest | integer | вместимость гостей |
Файл item.csv - справочник номенклатуры
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID позиции меню |
| 3 | group_id | varchar(36) | GUID группы меню | |
| 4 | desc | varchar(50) | Название позиции меню | |
| 5 | status | integer | Статус. 0 - удален, 1 - черновик, 2 - неактивный, 3 - активный | |
| 6 | print_id | varchar(36) | GUID места приготовления (принтера, цеха) | |
| 7 | categ_id | varchar(36) | GUID категории меню системы автоматизации | |
| 8 | categ_mozg_id | integer | Id категории Мозга | |
| 9 | class1_id | varchar(36) | GUID классификатора 1 | |
| 10 | class2_id | varchar(36) | GUID классификатора 2 | |
| 11 | portion | float | Порционный коэффициент. Если в меню есть позиция, которая в количестве 1 является половиной порции, то ПК равен 0.5. Если позиция является большим блюдом на четверых, тогда ПК равен 4. У незначительных позиций и модификаторов ПК равен нулю. Этот показатель необходим для расчета количества блюд/напитков в чеке на гостя. | |
| 12 | *не используется* | |||
| 13 | *не используется* | |||
| 14 | rest_id | varchar(36) | GUID ресторана | |
| 15 | type | varchar(50) | Тип позиции. DISH - позиция меню, MODIFIER - модификатор, GOODS - товар, PREPARED - полуфабрикат | |
| 16 | *не используется* | |||
| 17 | cooktime | integer | Норматив времени приготовления позиции меню в минутах |
Файл item_scale.csv - справочник шкал размеров
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID шкалы размеров |
| 3 | desc | varchar(50) | Название шкалы размеров | |
| 4 | code | integer | Код шкалы размеров | |
| 5 | status | integer | Статус. 0 - удален, 1 - черновик, 2 - неактивный, 3 - активный |
Файл item_size.csv - справочник приказов (размеров)
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID приказа |
| 3 | desc | varchar(50) | Название приказа | |
| 4 | code | integer | Код приказа | |
| 5 | status | integer | Статус. 0 - удален, 1 - черновик, 2 - неактивный, 3 - активный | |
| 6 | scale_id | varchar(36) | GUID шкалы размеров |
Файл order.csv - заказы
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | visit_id | Да | varchar(36) | GUID заказа |
| 3 | rest_id | varchar(36) | GUID ресторана | |
| 4 | *не используется* | |||
| 5 | uot_id | varchar(36) | GUID маркетингового типа заказа | |
| 6 | cot_id | varchar(36) | GUID типа заказа | |
| 7 | date | date | Бизнес дата (дата смены) | |
| 8 | open | time | Время открытия заказа | |
| 9 | close_date | date | Дата закрытия заказа | |
| 10 | close | time | Время закрытия заказа | |
| 11 | table_id | varchar(36) | GUID стола | |
| 12 | table_desc | varchar(11) | Номер стола | |
| 13 | hall_rest_id | varchar(36) | GUID ресторана зала | |
| 14 | hall_id | varchar(36) | GUID зала | |
| 15 | guest | integer | Количество гостей | |
| 16 | empl_id | varchar(36) | GUID сотрудника, официант | |
| 17 | empl1_id | varchar(36) | GUID сотрудника, кассир | |
| 18 | empl2_id | varchar(36) | GUID сотрудника, дополнительное поле | |
| 19 | drtn | integer | длительность заказа (мин) | |
| 20 | sum | double | Оплаченная сумма заказа | |
| 21 | check | integer | Id чека | |
| 22 | common_visit_id | varchar(36) | GUID основного заказа. Для функции объединения заказов | |
| 23 | precheck | datetime | Дата и время пречека | |
| 24 | deliv_addr_id | varchar(36) | GUID адреса доставки | |
| 25 | source | varchar(36) | Источник заказа | |
| 26 | courier_id | varchar(36) | GUID сотрудника, курьер доставки | |
| 27 | operator_id | varchar(36) | GUID сотрудника, оператор доставки |
Файл pbnd.csv - продажи с методами оплат
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | visit_id | varchar(36) | GUID заказа | |
| 3 | rest_id | varchar(36) | GUID ресторана | |
| 4 | uni | Да | varchar(36) | GUID продажи |
| 5 | *не используется* | |||
| 6 | item_id | varchar(36) | GUID позиции меню | |
| 7 | curr_id | varchar(36) | GUID метода оплаты | |
| 8 | pricesum | double | Сумма без учета скидок (за количество pbnd_qntt, а не за единицу) | |
| 9 | paysum | double | Оплаченная сумма (за количество pbnв_qntt, а не за единицу) | |
| 10 | qntt | double | Количество | |
| 11 | prepay | integer | Предоплата. Да - 1, нет - 0 | |
| 12 | *не используется* | |||
| 13 | service_charge | varchar(100) | Название наценки | |
| 14 | dishId | varchar(36) | GUID блюда, с которым продан модификатор. Если это модификатор, проданный с блюдом, то указать GUID блюда. В другом случае оставить поле пустым. | |
| 15 | *не используется* | |||
| 16 | paysum_base | double | Оплаченная сумма без учета модификаторов | |
| 17 | item_size_id | varchar(36) | GUID приказа | |
| 18 | print_id | varchar(36) | GUID места приготовления (принтера, цеха) | |
| 19 | discount_id | varchar(36) | GUID скидки | |
| 20 | cooktime | integer | Фактическое время приготовления позиции меню в секундах | |
| 21 | waittime | integer | Фактическое время подачи позиции меню в секундах | |
| 22 | cost_sum | double | Себестоимость проданной позиции |
Файл pmnt.csv - оплаты
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | visit_id | varchar(36) | GUID заказа | |
| 3 | rest_id | varchar(36) | GUID ресторана | |
| 4 | uni | Да | varchar(36) | GUID платежа |
| 5 | *не используется* | |||
| 6 | curr_id | varchar(36) | GUID метода оплаты | |
| 7 | sum | double | Оплаченная сумма | |
| 8 | prepay | integer | Предоплата. Да - 1, нет - 0 | |
| 9 | rcpt_uni | varchar(36) | GUID чека | |
| 10 | service_charge | varchar(100) | Название наценки |
Файл print.csv - справочник мест приготовления (принтеров, цехов)
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID места приготовления |
| 3 | desc | varchar(50) | Название места приготовления | |
| 4 | sort | integer | Порядок сортировки |
Файл rcpt.csv - чеки
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | visit_id | varchar(36) | GUID заказа | |
| 3 | rest_id | varchar(36) | GUID ресторана | |
| 4 | uni | Да | varchar(36) | GUID чека |
| 5 | *не используется* | |||
| 6 | date | datetime | Дата и время закрытия чека | |
| 7 | num | integer | Номер чека | |
| 8 | deleted | integer | Чек удален. 0 - нет, 1- да | |
| 9 | sum | double | Оплаченная сумма | |
| 10 | presum | double | Сумма без учета скидок | |
| 11 | service_charge | varchar(100) | Название наценки |
Файл rem.csv - удаления блюд
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | date | datetime | Дата и время заказа | |
| 3 | order_code | integer | Номер чека | |
| 4 | visit_id | varchar(36) | GUID заказа | |
| 5 | rest_id | varchar(36) | GUID ресторана | |
| 6 | uni | Да | varchar(36) | GUID удаления |
| 7 | item_id | varchar(36) | GUID позиции меню | |
| 8 | item_qntt | double | Количество | |
| 9 | item_sum | double | Сумма | |
| 10 | comment | varchar(500) | Комментарий | |
| 11 | reason | varchar(500) | Причина удаления | |
| 12 | writeoff_reason | varchar(500) | Причина списания | |
| 13 | remtype_id | varchar(36) | GUID типа удаления |
Файл remtype.csv - справочник типов удаления блюд
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(50) | GUID типа удаления |
| 3 | code | integer | Код типа удаления | |
| 4 | desc | varchar(255) | Название типа удаления | |
| 5 | status | integer | Статус. 0 - удален, 1 - черновик, 2 - неактивный, 3 - активный |
Файл rest.csv - справочник ресторанов
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID ресторана |
| 3 | desc | varchar(50) | Название ресторана | |
| 4 | status | integer | Статус. 0 - удален, 1 - черновик, 2 - неактивный, 3 - активный | |
| 5 | id | varchar(36) | GUID ресторана | |
| 6 | head | Integer | Центральный офис, 0 - нет, 1 - да | |
| 7 | comment | varchar(255) | Комментарий |
Файл table.csv - справочник столов
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID стола |
| 3 | hall_id | varchar(36) | GUID зала | |
| 4 | desc | varchar(11) | Номер стола | |
| 5 | guest | integer | Вместимость стола | |
| 6 | status | integer | Статус. 0 - удален, 1 - черновик, 2 - неактивный, 3 - активный | |
| 7 | rest_id | varchar(36) | GUID ресторана |
Файл uot.csv - справочник маркетинговых типов заказа
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID маркетингового типа заказа |
| 3 | desc | varchar(50) | Название маркетингового типа заказа | |
| 4 | status | integer | Статус. 0 - удален, 1 - черновик, 2 - неактивный, 3 - активный |
Файл writeoff.csv - списания
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID списания |
| 3 | *не используется* | |||
| 4 | documentnum | integer | Номер документа списания | |
| 5 | rest_id | varchar(36) | GUID ресторана | |
| 6 | date | datetime | Дата и время списания | |
| 7 | item_id | varchar(36) | GUID позиции меню | |
| 8 | qntt | double | Количество | |
| 9 | sum | double | Сумма списания | |
| 10 | operation | varchar(36) | GUID метода оплаты | |
| 11 | automatic | integer | Автоматическое списание. 0 - нет, 1- да | |
| 12 | uom | varchar(10) | Единица измерения | |
| 13 | reason1_id | varchar(36) | GUID причины списания 1 | |
| 14 | reason2_id | varchar(36) | GUID причины списания 2 |
Файл writeoff_reason1.csv - справочник причин списания 1
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID причины списания 1 |
| 3 | desc | varchar(50) | Название причины списания 1 |
Файл writeoff_reason2.csv - справочник причин списания 2
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | Id источника импорта |
| 2 | id | Да | varchar(36) | GUID причины списания 2 |
| 3 | desc | varchar(50) | Название причины списания 2 | |
| 4 | reason1_id | varchar(36) | GUID причины списания 1 |
Файл supplier.csv - справочник поставщиков
|
П/п |
Название поля |
Первичный ключ |
Тип данных |
Описание |
| 1 | db_id | Да | integer | id источника импорта |
| 2 | id | Да | varchar(36) | GUID поставщика |
| 3 | desc | varchar(50) | Название поставщика | |
| 4 | status | integer | Статус. 0 - удален, 1 - черновик, 2 - неактивный, 3 - активный |
Файл store.csv - справочник складов
| П/п | Название поля | Первичный ключ | Тип данных | Описание |
| 1 | db_id | Да | integer | id источника импорта |
| 2 | id | Да | varchar(36) | GUID склада |
| 3 | desc | varchar(50) | Название склада | |
| 4 | rest_id | varchar(36) | GUID ресторана склада по умолчанию |
Файл transaction.csv - проводки (движение товаров)
| П/п | Название поля | Первичный ключ | Тип данных | Описание |
| 1 | db_id | Да | integer | id источника импорта |
| 2 | id | Да | varchar(36) | GUID проводки |
| 3 | rest_id | Да | varchar(36) | GUID ресторана. Не обязательно, связь идет через склады. |
| 4 | store_id | varchar(36) | GUID склада. | |
| 5 | type | varchar(50) |
Тип транзакции из списка: INVOICE - приходная накладная OUTGOING_INVOICE - расходная накладная WRITEOFF - списания INVENTORY_CORRECTION - инвентаризация TRANSFORMATION - акт переработки SESSION_WRITEOFF - реализация PRODUCTION - акт приготовления TRANSFER - внутреннее перемещение DISASSEMBLE - акт разбора RETURNED_INVOICE - возврат поставщику |
|
| 6 | date | date | Дата проведение документа. | |
| 7 | documentnum | varchar(20) | Название (номер) документа проводки. | |
| 8 | item_id | varchar(36) | GUID товара | |
| 9 | supplier_id | varchar(36) | GUID поставщика (только для INVOICE) | |
| 10 | qntt | double | Количество товара | |
| 11 | sum | double | Сумма себестоимости товара | |
| 12 | uom | varchar(10) | Единица измерения товара |
Файл store_balance.csv - остатки на складах
| П/п | Название поля | Первичный ключ | Тип данных | Описание |
| 1 | db_id | Да | integer | id источника импорта |
| 2 | store_id | Да | varchar(36) | GUID склада |
| 3 | item_id | Да | varchar(36) | GUID товара |
| 4 | date | Да | date | Дата среза. Срез берется на самое начало дня (00:00:00 ночи) |
| 5 | qntt | double | Количество остатков | |
| 6 | cost | double | Себестоимость остатков |
Файл shedule.csv - смены сотрудников (явки)
| П/п | Название поля | Первичный ключ | Тип данных | Описание |
| 1 | db_id | Да | integer | id источника импорта |
| 2 | id | Да | varchar(36) | GUID смены сотрудника |
| 3 | rest_id | varchar(36) | GUID ресторана смены | |
| 4 | empl_id | Да | varchar(36) | GUID сотрудника |
| 5 | date | Да | date | Дата начала смены |
| 6 | role_name | varchar(50) | Название должности | |
| 7 | open | time | Время начала смены | |
| 8 | close_date | date | Дата окончания смены | |
| 9 | close | time | Время окончания смены | |
| 10 | drtn | integer | Длительность смены в минутах (не обязательно) | |
| 11 | payment | double | Сумма оплаты за смену |