external:tsd:tsd

Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия		 Предыдущая версия
Последняя версияСледующая версия справа и слева
external:tsd [2020/09/07 13:39] – anton_polovnikovexternal:tsd:tsd [2021/09/26 15:38] – [Интеграция Store House 5 и ТСД] Александр Ильин
Строка 1: Строка 1:
-====== Интеграция SHv5 и ТСД ======+====== Интеграция Store House 5 и ТСД ======
  
-======Внимание! на windows 7 домашняя rest api cleverence не работает====== +**Внимание!** На "windows 7 домашняя" модуль связки SH5-ТСД не работает (причина - ограничения rest api cleverence, используемого при работе)
-\\+
  
-Дистрибутив: 
- 
-[[https://yadi.sk/d/1sDG8hh99oT1-Q|Актуальный дистрибутив]] 
----- 
 Описание: **Сервер обмена данными с ТСД** (далее **SODL**) позволяет осуществить двухсторонний обмен между программными продуктами **StoreHouse_5** (программа складского учета от UCS) и **Mobile SMARTS Магазин 15** (программное обеспечение от Cleverence для мобильных устройств со встроенным сканером штрихкодов). Описание: **Сервер обмена данными с ТСД** (далее **SODL**) позволяет осуществить двухсторонний обмен между программными продуктами **StoreHouse_5** (программа складского учета от UCS) и **Mobile SMARTS Магазин 15** (программное обеспечение от Cleverence для мобильных устройств со встроенным сканером штрихкодов).
  
Строка 15: Строка 10:
  
 Функционал программы: Функционал программы:
 +
   * Загрузка выбранных товарных групп в память ТСД.   * Загрузка выбранных товарных групп в память ТСД.
   * Просмотр и удаление документов в памяти ТСД.   * Просмотр и удаление документов в памяти ТСД.
Строка 21: Строка 17:
  
 Ограничения: Ограничения:
-  * [[https://www.cleverence.ru/RTL15/#hw|Поддерживаемые устройства]]  
-  * Текущая версия программы поддерживает создание в StoreHouse5 следующих типов документов: //сличительная ведомость, приходная накладная, расходная накладная, внутреннее перемещение, комплектация// 
  
-**Стоимость:** 13000 рублей за первый ТСД в ресторане, 6000 рублей за второй и последующие ТСД в ресторане. +  * [[https://www.cleverence.ru/RTL15/#hw|Поддерживаемые устройства]] 
-Лицензия привязывается к конкретному устройству.+  * Операционная система - Win 7  или выше. На редакции "Win 7 Домашняя" работать не будет 
 +  * Текущая версия программы поддерживает создание в StoreHouse5 следующих типов документов: //сличительная ведомость, приходная накладная, расходная накладная, внутреннее перемещение, комплектация*// 
 + 
 +*для документов с вводом цен цену необходимо указывать в самом SH5 после сохранения и выгрузки документа 
 + 
 +**Стоимость:**  13000 рублей за первый ТСД в ресторане, 6000 рублей за второй и последующие ТСД в ресторане. Лицензия привязывается к конкретному устройству. 
 + 
 +**Скачать:** 
 +[[https://int.carbis.ru/download/Carbis%20TSD%20SH5%20(HoReCa).pdf|Презентация решения]] 
 +[[https://yadi.sk/d/1sDG8hh99oT1-Q|Актуальный дистрибутив]]
  
 ---- ----
Строка 31: Строка 34:
 ===== Перед использованием ===== ===== Перед использованием =====
  
-  - Установлен **StoreHouse_5** и **Web API** +  - Установлен **StoreHouse_5**  и **Web API** 
-  - Установлен **Mobile SMARTS: Магазин 15** с интеграцией через **REST API** и приобретена лицензия "Минимум" - [[#Установка Mobile SMARTS|инструкция]] +  - Установлен **Mobile SMARTS: Магазин 15**  с интеграцией через **REST API**  и приобретена лицензия "Минимум" - [[#установка_mobile_smarts|инструкция]] 
-  - Прописаны [[#Настройка SODL|настройки в файле params.ini]]+  - Прописаны [[#настройка_sodl|настройки в файле params.ini]]
   - Убедиться в наличии LicSystem.dll и params.ini рядом (в одной папке) с SODL.exe   - Убедиться в наличии LicSystem.dll и params.ini рядом (в одной папке) с SODL.exe
  
Строка 41: Строка 44:
  
   - Загрузить [[https://www.cleverence.ru/RTL15/#about|Магазин 15]]   - Загрузить [[https://www.cleverence.ru/RTL15/#about|Магазин 15]]
-  - {{external:ms_1.jpg?350}} +  - {{:external:ms_1.jpg?350|ms_1.jpg}} 
-  - {{external:ms_2.jpg?350}} +  - {{:external:ms_2.jpg?350|ms_2.jpg}} 
-  - Выбрать "Интеграция через REST API" {{external:ms_3.jpg?350}} +  - Выбрать "Интеграция через REST API" 
-  - Выбрать уровень лицензии "Магазин 15. Минимум" {{external:ms_4.jpg?350}} +  - {{:external:ms_3.jpg?350|ms_3.jpg}} 
-  - Выбрать Беспроводной способ обмена {{external:ms_5.jpg?350}} +  - Выбрать уровень лицензии "Магазин 15. Минимум" 
-  - Дождаться окончания загрузки платформы с сайта и установить Mobile SMARTS {{external:ms_11.png?350}} +  - {{:external:ms_4.jpg?350|ms_4.jpg}} 
-  - {{external:ms_12.png?350}} +  - Выбрать Беспроводной способ обмена 
-  - {{external:ms_13.png?350}} +  - {{:external:ms_5.jpg?350|ms_5.jpg}} 
-  - Не распаковывать демонстрационные данные {{external:ms_6.jpg?300}} +  - Дождаться окончания загрузки платформы с сайта и установить Mobile SMARTS 
-  - Прервать, если ТСД на базе Android {{external:ms_7.jpg?350}}+  - {{:external:ms_11.png?350}} 
 +  - {{:external:ms_12.png?350}} 
 +  - {{:external:ms_13.png?350}} 
 +  - Не распаковывать демонстрационные данные 
 +  - {{:external:ms_6.jpg?300|ms_6.jpg}} 
 +  - Прервать, если ТСД на базе Android 
 +  - {{:external:ms_7.jpg?350|ms_7.jpg}}
  
 === На терминале === === На терминале ===
  
-  * Установить [[https://play.google.com/store/apps/details?id=com.cleverence.android.MobileSMARTS.v3.Retail&roistat_visit=696213|Магазин 15 из Play Market]] +  * Установить [[https://play.google.com/store/apps/details?id=com.cleverence.android.MobileSMARTS.v3.Retail&roistat_visit=696213|Магазин 15 из Play Market]]
   * Подключиться к базе:   * Подключиться к базе:
  
 Через QR код Через QR код
  
-{{ external:ms_qr_2.jpg }}+{{  :external:ms_qr_2.jpg  |ms_qr_2.jpg}}
  
 Вручную Вручную
  
-{{ external:ms_manual2.jpg }}+{{  :external:ms_manual2.jpg  |ms_manual2.jpg}}
  
 Или Или
  
-{{ external:ms_manual.jpg }}+{{  :external:ms_manual.jpg  |ms_manual.jpg}}
  
 Для ускорения процесса сбора штрихкодов через камеру, можно попробовать различные настройки Для ускорения процесса сбора штрихкодов через камеру, можно попробовать различные настройки
  
-{{ external:ms_settings2.jpg?230 }}+{{  :external:ms_settings2.jpg?230  |ms_settings2.jpg}}
  
 ==== Настройка SODL ==== ==== Настройка SODL ====
  
-Настройки файла **params.ini** (также доступны в разделе Настройки самой программы)+Настройки файла **params.ini**  (также доступны в разделе Настройки самой программы)
  
 ^Секция^Параметр^Описание^По умолчанию| ^Секция^Параметр^Описание^По умолчанию|
-|**STOREHOUSE**|ip|IP адрес сервера Web API|localhost|+|**STOREHOUSE** |ip|IP адрес сервера Web API|localhost|
 | ::: |port|Порт сервера Web API|1330| | ::: |port|Порт сервера Web API|1330|
 | ::: |username|Имя пользователя StoreHouse5|Admin| | ::: |username|Имя пользователя StoreHouse5|Admin|
Строка 86: Строка 95:
 | ::: |deviceName1|Название терминала 1| | | ::: |deviceName1|Название терминала 1| |
 | ::: |device1|Код терминала 1| | | ::: |device1|Код терминала 1| |
-| ::: | ... |||+| ::: |…|||
 | ::: |deviceNameN|Название терминала N| | | ::: |deviceNameN|Название терминала N| |
 | ::: |deviceN|Код терминала N| | | ::: |deviceN|Код терминала N| |
-|**CLEVERENCE**|ip|IP адрес сервера данных Mobile SMARTS|localhost|+|**CLEVERENCE** |ip|IP адрес сервера данных Mobile SMARTS|localhost|
 | ::: |port|Порт сервера данных Mobile SMARTS|9000| | ::: |port|Порт сервера данных Mobile SMARTS|9000|
 | ::: |bdPath|Путь до базы данных Mobile SMARTS|C:\ProgramData\Cleverence\Базы Mobile SMARTS\Магазин 15, Минимум| | ::: |bdPath|Путь до базы данных Mobile SMARTS|C:\ProgramData\Cleverence\Базы Mobile SMARTS\Магазин 15, Минимум|
 | ::: |passRKCode|1 - передавать в Mobile SMARTS код RK (при наличии). 0 - не передавать|0| | ::: |passRKCode|1 - передавать в Mobile SMARTS код RK (при наличии). 0 - не передавать|0|
-|**LOG**|LogLevel|Уровень логирования|2|+|**LOG** |LogLevel|Уровень логирования|2|
 | ::: |OldLogs|Максимальный возраст .log файлов в днях. Старые файлы подлежат удалению.|7| | ::: |OldLogs|Максимальный возраст .log файлов в днях. Старые файлы подлежат удалению.|7|
 | ::: |LogMem|Логирование занимаемой памяти|1| | ::: |LogMem|Логирование занимаемой памяти|1|
Строка 99: Строка 108:
   * Чтобы иметь возможность автоматически добавлять в базу Storehouse неизвестные штрихкоды, отсканированные в ходе сбора штрихкодов, нужно в настройках задать путь до папки с базой данных Mobile SMARTS:   * Чтобы иметь возможность автоматически добавлять в базу Storehouse неизвестные штрихкоды, отсканированные в ходе сбора штрихкодов, нужно в настройках задать путь до папки с базой данных Mobile SMARTS:
  
-{{ external:sodl_7.jpg?500 }} +{{  :external:sodl_7.jpg?500  |sodl_7.jpg}}{{  :external:sodl_8.jpg?500  |sodl_8.jpg}}{{  :external:2020-07-17_15-52-11.png?500  }}
-{{ external:sodl_8.jpg?500 }} +
-{{ :external:2020-07-17_15-52-11.png?500 |}}+
  
 ==== Лицензирование ==== ==== Лицензирование ====
Строка 109: Строка 116:
 Лицензию на модуль выгрузки можно применить, открыв окно лицензирования следующей последовательностью: Лицензию на модуль выгрузки можно применить, открыв окно лицензирования следующей последовательностью:
  
-SODL -> Настройки -> вкладка Лицензирование -> Управление лицензией+SODL → Настройки → вкладка Лицензирование → Управление лицензией
  
 Далее приведено применение лицензии на софт "Магазин 15 Минимум": Далее приведено применение лицензии на софт "Магазин 15 Минимум":
  
-{{ external:ms_8.jpg?500 }} +{{  :external:ms_8.jpg?500  |ms_8.jpg}}{{  :external:ms_9.jpg?350  |ms_9.jpg}}{{  :external:ms_10.jpg?350  |ms_10.jpg}}{{  :external:ms_11.jpg?350  |ms_11.jpg}}
-{{ external:ms_9.jpg?350 }} +
-{{ external:ms_10.jpg?350 }} +
-{{ external:ms_11.jpg?350 }}+
  
-**Для получения лицензии на использование Mobile SMARTS Магазин 15 необходимо прислать __Код терминала__**+**Для получения лицензии на использование Mobile SMARTS Магазин 15 необходимо прислать __Код терминала__ **
  
-{{ external:sodl_9.jpg? }}+{{  :external:sodl_9.jpg  |sodl_9.jpg}}
  
-После получения лицензии на устройство, требуется внести id  пролицензированных терминалов в [[external:tsd#настройки|настройках]] . +После получения лицензии на устройство, требуется внести id пролицензированных терминалов в [[:external:tsd:tsd#настройки|настройках]] .
  
- +При замене оборудования или изменении уникальных строковых идентификаторов в результате поломки Вы имеете право на замену уникальных идентификаторов и выдачу нового файла защиты лицензии только при условии, что будут выполнены оба пункта: 1) обмен производился на оборудование той же модели, либо это был ремонт; 2) Вы предоставили Клеверенс официальное письмо из Сервисного центра, удостоверяющее факт замены оборудования или ремонта (с указанием серийных номеров старого и нового оборудования), заверенное печатью и подписью от лица организации, произведшей замену.
- +
-При замене оборудования или изменении уникальных строковых идентификаторов  в результате поломки Вы имеете право на замену уникальных идентификаторов и выдачу нового файла защиты лицензии только при условии, что будут выполнены оба пункта: +
-1)    обмен производился на оборудование той же модели, либо это был ремонт; +
-2)    Вы предоставили Клеверенс официальное письмо из Сервисного центра, удостоверяющее факт замены оборудования или ремонта (с указанием серийных номеров старого и нового оборудования), заверенное печатью и подписью от лица организации, произведшей замену.+
  
 ===== Использование ===== ===== Использование =====
Строка 134: Строка 134:
 ==== Окно программы ==== ==== Окно программы ====
  
-{{ external:sodl1.png?600 }}+{{  :external:sodl1.png?600  }}
  
 ==== Синхронизация справочников ==== ==== Синхронизация справочников ====
  
-{{ external:sodl_4.png }}+{{  :external:sodl_4.png  }}
  
 После нажатия на кнопку "Синхронизация справочников" актуальная база товаров, собранная из товарных групп, указанных в файле настроек, будет загружена на сервер данных Mobile SMARTS (ТСД). При этом, если часть товаров уже была загружена в Mobile SMARTS ранее, после начала операции будут загружены только недостающие товары. Товары Mobile SMARTS, каким-либо образом отличающиеся от товаров StoreHouse5 (товар изменён в Mobile SMARTS или удалён из StoreHouse), будут перезаписаны/удалены. После нажатия на кнопку "Синхронизация справочников" актуальная база товаров, собранная из товарных групп, указанных в файле настроек, будет загружена на сервер данных Mobile SMARTS (ТСД). При этом, если часть товаров уже была загружена в Mobile SMARTS ранее, после начала операции будут загружены только недостающие товары. Товары Mobile SMARTS, каким-либо образом отличающиеся от товаров StoreHouse5 (товар изменён в Mobile SMARTS или удалён из StoreHouse), будут перезаписаны/удалены.
  
-Далее производится **[[#Процесс инвентаризации|сбор штрихкодов]]** или **[[#Процесс инвентаризации|инвентаризация]]** с помощью ТСД.+Далее производится **[[#процесс_сбора_штрихкодов_или_инвентаризации|сбор штрихкодов]]**  или **[[#процесс_сбора_штрихкодов_или_инвентаризации|инвентаризация]]**  с помощью ТСД.
  
 ==== Загрузка документов из ТСД ==== ==== Загрузка документов из ТСД ====
  
-{{ external:sodl_5.png }}+{{  :external:sodl_5.png  }}
  
-После проведения сбора штрихкодов или инвентаризации документы загружаются в программу нажатием на "Загрузка документов из ТСД". Сперва пользователю будут показаны документы, некорректно сохраненные через ТСД или включающие в себя товары, которые не были синхронизированы (см. [[#Синхронизация справочников|Синхронизация справочников]]), и предложение удалить их. Далее в секции "Список документов в памяти ТСД" будут отображены документы, которые можно загрузить в StoreHouse5 или удалить из Mobile SMARTS (ТСД).+После проведения сбора штрихкодов или инвентаризации документы загружаются в программу нажатием на "Загрузка документов из ТСД". Сперва пользователю будут показаны документы, некорректно сохраненные через ТСД или включающие в себя товары, которые не были синхронизированы (см. [[#синхронизация_справочников|Синхронизация справочников]]), и предложение удалить их. Далее в секции "Список документов в памяти ТСД" будут отображены документы, которые можно загрузить в StoreHouse5 или удалить из Mobile SMARTS (ТСД).
  
-{{ external:sodl2.png?600 }}+{{  :external:sodl2.png?600  }}
  
 Загрузка документа в StoreHouse5 состоит из следующих этапов: Загрузка документа в StoreHouse5 состоит из следующих этапов:
Строка 162: Строка 162:
  
 В конце процесса загрузки документа в StoreHouse5 или непосредственно выбрав документ, его можно удалить. Документ удаляется из сервера обмена данными с ТСД и базы данных Mobile SMARTS. В конце процесса загрузки документа в StoreHouse5 или непосредственно выбрав документ, его можно удалить. Документ удаляется из сервера обмена данными с ТСД и базы данных Mobile SMARTS.
- 
- 
  
 ==== Настройки ==== ==== Настройки ====
  
-{{ external:sodl_6.png }}+{{  :external:sodl_6.png  }}
  
-В настройках SH (StoreHouse5) находятся кнопки: +В настройках SH (StoreHouse5) находятся кнопки: Управление торговыми группами.
-Управление торговыми группами.+
  
-{{ external:2020-07-17_15-12-54.png?300 }}+{{  :external:2020-07-17_15-12-54.png?300  }}
  
 После нажатия кнопки откроется настройка торговых групп После нажатия кнопки откроется настройка торговых групп
  
-Добавляемые: нужно указать коды торговых групп, товары из которых нужно загружать в ТСД. +Добавляемые: нужно указать коды торговых групп, товары из которых нужно загружать в ТСД. Если в добавляемую торговую группу входит группа, которую не нужно выгружать на терминал, используем вкладку Игнорируемые: требуется указать коды торговых группы, например папка Удаленные
-Если в добавляемую торговую группу входит группа, которую не нужно выгружать на терминал, используем вкладку Игнорируемые: требуется указать коды торговых группы, например папка Удаленные+
  
-{{ external:2020-07-17_15-13-16.png?300 }}+{{  :external:2020-07-17_15-13-16.png?300  }}
  
 Управление терминалами Управление терминалами
  
-{{ external:2020-07-17_15-33-42.png?300 }}+{{  :external:2020-07-17_15-33-42.png?300  }}
  
-В данном разделе указывается id терминалов пролицензированных в cleverence. Если id терминала не указан, документы собранные на данном терминале выгружаться в SH не будут. +В данном разделе указывается id терминалов пролицензированных в cleverence. Если id терминала не указан, документы собранные на данном терминале выгружаться в SH не будут.
  
-{{ external:2020-07-17_15-41-55.png?400 }}+{{  :external:2020-07-17_15-41-55.png?400  }}
  
-Генерации штрихкодов. +Генерации штрихкодов. После нажатия на кнопку "Генерация штрихкодов" будут сгенерированы EAN13 штрихкоды и установлены как внутренние для каждой единицы измерения товара, у которой не установлено ни одного штрихкода. Это действие затрагивает все товары базы StoreHouse5.
-После нажатия на кнопку "Генерация штрихкодов" будут сгенерированы EAN13 штрихкоды и установлены как внутренние для каждой единицы измерения товара, у которой не установлено ни одного штрихкода. Это действие затрагивает все товары базы StoreHouse5.+
  
-{{ external:2020-07-17_15-08-43.png?300 }}+{{  :external:2020-07-17_15-08-43.png?300  }}
  
-Выбор валюты для накладных. +Выбор валюты для накладных. Кнопка "Обновить" нужна для загрузки списка валют. Если список валют не пустой, кнопку нажимать не нужно. {{  :external:sodl_20.png?300  }}
-Кнопка "Обновить" нужна для загрузки списка валют. Если список валют не пустой, кнопку нажимать не нужно. +
-{{ external:sodl_20.png?300 }}+
  
 В настройках ТСД, есть возможность передавать код товара r_keeper. Для включения настройки, перейте в раздел настройки ТСД, установить флаг в поле "Передавать в ТСД код RK" В настройках ТСД, есть возможность передавать код товара r_keeper. Для включения настройки, перейте в раздел настройки ТСД, установить флаг в поле "Передавать в ТСД код RK"
  
-{{ external:2020-07-17_15-51-34.png?300 |}}+{{  :external:2020-07-17_15-51-34.png?300  }}
  
 Данная настройка используется на предприятиях работающих с весовым товаром на кассе r_keeper. Произвели фасовку, нанесли штрихкод весового товара на упаковку, при инвентаризации ТСД сканируется данный штрихкод, терминал автоматически распознает вес указанный в штрихкоде. Данная настройка используется на предприятиях работающих с весовым товаром на кассе r_keeper. Произвели фасовку, нанесли штрихкод весового товара на упаковку, при инвентаризации ТСД сканируется данный штрихкод, терминал автоматически распознает вес указанный в штрихкоде.
 +
 === Внимание, код товара r_keeper должен быть не более 5 знаков. === === Внимание, код товара r_keeper должен быть не более 5 знаков. ===
 +
 ===== Процесс Сбора штрихкодов или Инвентаризации ===== ===== Процесс Сбора штрихкодов или Инвентаризации =====
  
Строка 211: Строка 206:
   - Для завершения процесса нажать в левом верхнем углу <- и далее "Завершить".   - Для завершения процесса нажать в левом верхнем углу <- и далее "Завершить".
  
-{{ external:ms_inv.jpg }}+{{  :external:ms_inv.jpg  |ms_inv.jpg}} 
 +